INC-OC
This repository contains the simulator, linux kernel and benchmarks presented in the paper.
@online{1909.05349,
Author = {Ayoosh Bansal and Jayati Singh and Yifan Hao and Jen-Yang Wen and Renato Mancuso and Marco Caccamo},
Title = {Cache Where you Want! Reconciling Predictability and Coherent Caching},
Year = {2019},
Eprint = {1909.05349},
Eprinttype = {arXiv},
}One time setup
Links are provided for broader understanding only. The commands provided are sufficient.
The following command works well for our Ubuntu 18.04 setup. Adapted from : http://gem5.org/Dependencies
sudo apt install swig gcc m4 python python-dev \
libgoogle-perftools-dev mercurial scons g++ \
build-essential zlib1g-dev gcc-arm-linux-gnueabihf \
gcc-aarch64-linux-gnu device-tree-compiler git \
fakeroot build-essential ncurses-dev xz-utils \
libssl-dev bc kernel-package gcc-aarch64-linux-gnu \
g++-aarch64-linux-gnu libc6-dev-arm64-cross \
protobuf-compiler libprotobuf-dev -ysudo mkdir -p /dist/m5/system && sudo chmod 777 /dist/m5/system
cd /dist/m5/system
sudo wget http://www.gem5.org/dist/current/arm/aarch-system-20170616.tar.xz
sudo tar xvf aarch-system-20170616.tar.xzReturn back to this repository and run
cp disks/aarch64-ubuntu-trusty-headless.img \
/dist/m5/system/disks/aarch64-ubuntu-trusty-headless.imgBuild
./scripts/makeall.sh # Builds everything and forces gem5 to build cleanRun tests on Linux over Simulator i.e. Full System Simulation
./scripts/run_gem5_fs.sh # Boots gem5 in Full System mode, more here: http://gem5.org/Running_gem5#Full_System_.28FS.29_Mode
./scripts/connect_terminal.sh # From another shell, connect to linux serial consoleUsername and password within the booted Ubuntu are both root. The SPLASH2 benchmark suite is modified and can be found in marcobenchmarks/src
cd bin ## contains the benchmark binaries (FFT, Radix, Water N-Squared, Ocean-CP, LU)
./benchmark_cached ## run the benchmark with all memory as L1 and L2 cacheable
./benchmark_ocinc ## (naive INC-OC) run the benchmark with all global variables visible to all threads as INC-OC
./benchmark_ocinc_opt ## run the benchmark with carefully selected variables to be marked as INC-OCTrace mode
Adapted from PMSI
Modify gem5/src/cpu/testers/rubytest/Trace.hh
#define TRACE 0 // 1 for Trace mode
// 1 to Force memory requests to be INC-OC.
// This mode doesn't have a true CPU so
// this is the way to control memory types
#define OCINC 1Clean gem5 build required. ./scripts/makeall.sh forces clean build for gem5 so use that.
For custom use we also provide a utility to convert gem5 protocol trace to a format usable by Trace mode. Note that the file trace.trc in gem5 root is used by trace mode boot. See gem5/bench_traces/make_trace.py
Run Trace mode
./scripts/run_gem5_trace.shCoherence State Machine
The gem5 coherence state machine format is described here
Our state machine can be viewed by opening html/index.html in any web browser.