Struct MmapDriver 

pub struct MmapDriver { /* private fields */ }

Mmap-backed storage driver.

Uses mmap-io for file-backed storage with a lock-free SegQueue for fast-path wait notifications.

Trait Implementations

impl Debug for MmapDriver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Driver for MmapDriver

type Options = MmapOptions

Configuration needed to open/create a driver instance.

fn open(opts: MmapOptions) -> StorageResult<(Self, DriverState)>

Open or create a new driver from options.

impl DriverIo for MmapDriver

fn commit(&self, final_len: Option<u64>) -> StorageResult<()>

Finalize backing store (e.g. mmap: resize + reopen read-only; memory: truncate).

fn notify_write(&self, range: &Range<u64>)

Publish a write range to the fast-path mechanism.

fn path(&self) -> Option<&Path>

Filesystem path, if any.

fn reactivate(&self) -> StorageResult<()>

Reopen for writing (e.g. mmap: reopen as read-write; memory: no-op).

fn read_at( &self, offset: u64, buf: &mut [u8], _effective_len: u64, ) -> StorageResult<usize>

Read bytes at offset into buf.

fn storage_len(&self) -> u64

Physical storage length (for read_at clamping).

fn try_fast_check(&self, range: &Range<u64>) -> bool

Lock-free fast-path check before state mutex.

fn write_at( &self, offset: u64, data: &[u8], committed: bool, ) -> StorageResult<()>

Write bytes at offset.

fn valid_window(&self) -> Option<Range<u64>>

Returns the valid data window for ring buffer drivers.