Get Source

git clone --recursive https://github.com/mars-research/DRAMHiT.git

Dependencies

Nix manages all project dependencies. Install nix if your system doesn't have nix

curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install | sh -s -- --no-daemon

Use following script to enter nix development shell

./nix-dev-shell.sh

Setup the machine

Option 1(recommended): Express setup

• Apply constant frequency, enable hugepages, and disable hardware prefetching.

./scripts/setup.sh

You alternatively can do similar for amd machine

./scripts/setup_amd.sh

Config build

• Setup build directory

cmake -S . -B build -DCPUFREQ_MHZ=XXXX

You can find XXXX by looking at constant frequency pinned by setup scripts. Those setup scripts are machine specific.

Build

cmake --build build/

Configure build with ccmake (optional)

This is cmd line gui tool you can use to see all build time configuration if you don't want to use standard cmake ways -DVAR.

On command line, install and start ccmake

sudo apt install cmake-curses-gui
ccmake ./build

Run

./build/dramhit --help

Test

Run all tests.

ctest --test-dir=build

Run individual test binary. For example, the hashmap test:

./build/unittests/hashmap_test