Struct MmapWalReader 

pub struct MmapWalReader { /* private fields */ }

Memory-mapped WAL segment reader.

Opens a sealed WAL segment file via mmap and provides zero-copy iteration over records. The mmap’d region is read-only and the kernel manages page residency — no application-level memory pinning.

Implementations

impl MmapWalReader

pub fn open(path: &Path) -> Result<Self>

Open a WAL segment file for mmap’d reading.

pub fn madvise_state(&self) -> Option<c_int>

The madvise hint applied to the mapped segment (if any).

pub fn release_pages(&self)

Hint to the kernel that pages for this segment can be dropped from cache. Call this after a segment has been iterated end-to-end.

pub fn next_record(&mut self) -> Result<Option<WalRecord>>

Read the next record from the mmap’d region.

Returns None at EOF or at the first corruption point. Zero-copy: payload bytes reference the mmap’d region directly.

pub fn records(self) -> MmapRecordIter

Iterator over all valid records in the mmap’d segment.

pub fn offset(&self) -> usize

Current read offset.

pub fn len(&self) -> usize

Total size of the mmap’d region.

pub fn is_empty(&self) -> bool

Whether the mmap’d region is empty.