Causally Consistent Reversible Debugger for MPI

---

Running on linux

Currently only x86_64 architecture is supported. Since CRIU requires root it is recommended to run as a container or on a virtual machine. This has been tested with Go/1.21, MPICH/3.4.3, and requires an MPI compiler that is capable of producing level 4 DWARF data. Running might require editing root user $PATH to execute mpirun and CRIU.

build

make

compile target for debugger

There is a compiler included that wraps the mpi library calls, in order to enable the debugger to intercept and record them. Programs must be compiled with the included compiler script:

bin/compiler <path-to-target-MPI-program>

The compiled binary will be written to ./bin/targets/<source-file-name>. This path should be given to the debugger as input.

run

bin/orchestror <num_processes> <path-to-target-mpi-application-binary>

ℹ️ There's a couple of example programs included in the examples directory to test with. Compile them first (bin/compiler examples/<example-application-file>)