README.md

CLaMPI: a Caching LAyer for MPI

Authors: Salvatore Di Girolamo, Flavio Vella, Torsten Hoefler

CLaMPI is the framework described by Di Girolamo et al. [1] to enable low-overhead caching of RMA get operations. It is implemented on top of MPI-3 RMA as a proof-of-concept.

All published work using CLaMPI should cite [1].

[1] Di Girolamo, Salvatore, Flavio Vella, and Torsten Hoefler. "Transparent Caching for RMA Systems." PDF

Compile

On x86

    autoreconf -if
    CC=mpicc ./configure --prefix=$(pwd)/build/ --enable-adaptive --with-liblsb=<liblsb with MPI path>
    make
    make install

On Piz Daint

    module switch PrgEnv-cray PrgEnv-gnu
    export CRAYPE_LINK_TYPE="dynamic"
    autoreconf -if
    CC=cc ./configure --prefix=$(pwd)/build/ --with-fompi=<fompi_path> --with-dmapp=/opt/cray/dmapp/default/include --enable-adaptive --with-liblsb=<liblsb with MPI path>
    make
    make install

Notes:

- If libLSB (--with-liblsb) is not specified, the perf_hash test will not be compiled
- The flag --enable-adaptive enables the adaptive scheme (see Section III.E of the paper)

Window modes:

- Use CLAMPI_MODE as key of the MPI_Info object.
- Possible values are CLAMPI_TRANSPARENT, CLAMPI_ALWAYS_CACHE, CLAMPI_USER_DEFINED. See Section III.A of the paper for their description.