Hermes SHM

This library contains a variety of data structures and synchronization primitives which are compatible with shared memory. This library is also compatible with CUDA and ROCm.

Users

Clone the IOWarp Spack Repo

cd ${HOME}
git clone https://github.com/iowarp/iowarp-install.git
spack repo add iowarp-install/iowarp-spack

Install

spack install cte-hermes-shm
spack load cte-hermes-shm

Developers

Clone the IOWarp Spack Repo

cd ${HOME}
git clone https://github.com/iowarp/iowarp-install.git
spack repo add iowarp-install/iowarp-spack

Install Dependencies

spack install cte-hermes-shm +nocompile
spack load cte-hermes-shm

Compile

git clone https://github.com/iowarp/cte-hermes-shm.git
cd hermes-shm
mkdir build
cd build
cmake ../ \
-DHSHM_RPC_THALLIUM=ON \
-DHSHM_ENABLE_COMPRESS=ON \
-DHSHM_ENABLE_ENCRYPT=ON \
-DHSHM_ENABLE_CUDA=OFF \
-DHSHM_ENABLE_ROCM=OFF \
-DBUILD_HSHM_TESTS=ON \
-DHSHM_ENABLE_MPI=ON
make -j8

Verification

To run the tests, do the following:

ctest

To run the MPSC queue tests, do the following:

ctest -VV -R test_mpsc_queue_mpi

CMake

For CPU-Only Version

find_package(HermesShm CONFIG REQUIRED)
message(STATUS "found hermes_shm at ${HermesShm_PREFIX}")
target_link_libraries(hshm::cxx)

For CUDA Version

find_package(HermesShm CONFIG REQUIRED)
message(STATUS "found hermes_shm at ${HermesShm_PREFIX}")
target_link_libraries(hshm::cudacxx)

For ROCM Version

find_package(HermesShm CONFIG REQUIRED)
message(STATUS "found hermes_shm at ${HermesShm_PREFIX}")
target_link_libraries(hshm::rocmcxx_gpu)