Metall (memory allocator for persistent memory)

Provides rich memory allocation interfaces for C++ applications that use persistent memory devices to persistently store heap data on such devices.
Creates files in persistent memory and maps them into virtual memory space so that users can access the mapped region just as normal memory regions allocated in DRAM.
To provide persistent memory allocation, Metall employs concepts and APIs developed by Boost.Interprocess.
Supports multi-threa
Also provides a space-efficient snapshot/versioning leveraging reflink copy mechanism in filesystem. In case reflink is not supported, Metall automatically falls back to regular copy.

Getting Started

Metall consists of only header files and requires some header files in Boost C++ Libraries.

All core files exist under metall/include/metall/.

To build your program with Metall, all you have to do is just setting include paths such as '-I' or CPLUS_INCLUDE_PATH.

For example,

g++ -std=c++17 -lstdc++fs your_program.cpp -I/path/to/metall/include -I/path/to/boost/include

Note GCC requires linking stdc++fs to use the Filesystem library in C++17.

Metall package is also available on Spack.

To install Metall using Spack, just type spack install metall.

As Metall requires Boost C++ Libraries, Spack also install a proper (latest) version of Boost C++ Libraries automatically.

As Spack configure environmental values properly, you can avoid specifying include paths to build your program. For instance,

spack load metall
g++ -std=c++17 -lstdc++fs your_program.cpp

GCC 8.0 or more.
Boost C++ Libraries 1.64 or more (build is not required; needs only their header files).

Metall is distributed under the terms of both the MIT license and the Apache License (Version 2.0). Users may choose either license, at their option.

All new contributions must be made under both the MIT and Apache-2.0 licenses.

SPDX-License-Identifier: (Apache-2.0 OR MIT)

LLNL-CODE-768617