This library provides a thin wrapper around the
memmap crate in order to make file-backed
mapped memory safe in Rust. Although the crate tries it's best at ensuring safety, this can not
be fully guaranteed.
Since Linux and other Unix-Systems currently do not provide mandatory file locks (Linux does but it's buggy and will be removed in the future), it is not possible to prevent parallel access to a certain file. Therefore file-backed mapped memory is inherently unsafe.
However, if you access a file only through this library and not through the
API, you are safe. This crate uses an advisory lock internally to make sure only one
MappedFile instance ever exists at the same time for the same file.
Oh, and don't use it on network filesystems, I haven't tested that.
Mutably mapped file obtained by
A thin, safe wrapper for memory-mapped files.
A file mapped to memory.
A file mutably mapped to memory.