Crate memmap2

A cross-platform Rust API for memory mapped buffers.

The core functionality is provided by either Mmap or MmapMut, which correspond to mapping a File to a &[u8] or &mut [u8] respectively. Both function by dereferencing to a slice, allowing the Mmap/MmapMut to be used in the same way you would the equivalent slice types.

Examples

For simple cases Mmap can be used directly:

use std::fs::File;
use std::io::Read;

use memmap2::Mmap;

let mut file = File::open("LICENSE-APACHE")?;

let mut contents = Vec::new();
file.read_to_end(&mut contents)?;

let mmap = unsafe { Mmap::map(&file)?  };

assert_eq!(&contents[..], &mmap[..]);

However for cases which require configuration of the mapping, then you can use MmapOptions in order to further configure a mapping before you create it.

Structs

• Mmap
  A handle to an immutable memory mapped buffer.
• MmapMut
  A handle to a mutable memory mapped buffer.
• MmapOptions
  A memory map builder, providing advanced options and flags for specifying memory map behavior.
• MmapRaw
  A handle to a raw memory mapped buffer.
• MmapRawDescriptor
• RemapOptions
  Options for Mmap::remap and MmapMut::remap.

Enums

• Advice
  Values supported by Mmap::advise and MmapMut::advise functions.
• UncheckedAdvice
  Values supported by [Mmap::unsafe_advise][crate::Mmap::unsafe_advise] and [MmapMut::unsafe_advise][crate::MmapMut::unsafe_advise] functions.

Traits

• MmapAsRawDesc