Umap is a library that provides an mmap()-like interface to a simple, user- space page fault handler based on the userfaultfd Linux feature (starting with 4.3 linux kernel). The use case is to have an application specific buffer of pages cached from a large file, i.e. out-of-core execution using memory map.
The src directory in the top level contains the source code for the library.
The tests directory contains various tests written to test the library including a hello world program for userfaultfd based upon code from the userfaultfd-hello-world project.
The sortbenchmark directory is the original sort benchmark, modified to use threads rather than forking processes.
Building umap is trivial. In the root directory of the repo
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX = <where you want the sofware> ..
make installThe default for cmake is to build a Debug version of the software. If you would like to build an optimized (-O3) version, simply run
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX = <where you want the sofware> ..The interface is currently a work in progress (see umap.h).
- The license is LGPL.
- thirdparty_licenses.md
Primary contact/Lead developer
- Maya Gokhale (gokhale2@llnl.gov)
Other developers
- Marty McFadden (mcfadden8@llnl.gov)
- Xiao Liu (liu61@llnl.gov)