Struct WalWriter 

pub struct WalWriter { /* private fields */ }

Appends records to a WAL segment and controls the fsync durability policy.

LSNs are assigned by the caller (the engine owns the global counter); the writer only frames, appends, and syncs.

Implementations

impl WalWriter

pub fn create(path: &Path, base_lsn: Lsn) -> Result<Self>

Create a new WAL segment file and write its header. Fails if the file already exists.

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

Open an existing WAL segment for appending, validating its header. New records are written at the end of the file.

pub fn append(&mut self, codec: &dyn PageCodec, entry: &WalEntry) -> Result<()>

Frame and append a record, sealing its bytes with codec first (so an encrypting codec leaves no plaintext in the log). Does not fsync; the record is durable only after a subsequent WalWriter::sync.

pub fn sync(&mut self) -> Result<()>

Flush and fsync the segment, making every appended record durable.

pub fn append_sync( &mut self, codec: &dyn PageCodec, entry: &WalEntry, ) -> Result<()>

Append a record and immediately fsync — strict per-commit durability.

Trait Implementations

impl Debug for WalWriter

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

Formats the value using the given formatter.