Struct FileStorage 

pub struct FileStorage { /* private fields */ }

File-backed Storage holding an advisory lock on its database.

Implementations

impl FileStorage

pub fn open( base: impl Into<PathBuf>, fsync: FsyncPolicy, ) -> Result<Self, HostError>

Opens (creating as needed) the database at base and takes the exclusive writer lock — one writer at a time. Readers do not take this lock (they pin a generation file via [pin_current_generation] instead), so a writer and any number of readers coexist across threads or processes (the versioned MVCC layout).

Errors

HostError::Locked when another writer owns the lock; HostError::Io for filesystem failures.

pub fn path(&self) -> &Path

The database base path.

pub fn journal_bytes(&self) -> u64

Current journal size in bytes (drives the snapshot policy).

Trait Implementations

impl Debug for FileStorage

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

Formats the value using the given formatter.

impl Storage for FileStorage

type Error = HostError

Implementation-specific failure (I/O error, host callback error…).

fn read_snapshot(&mut self) -> Result<Option<Vec<u8>>, HostError>

The full snapshot image, or None when no database exists yet (first run).

fn write_snapshot(&mut self, bytes: &[u8]) -> Result<(), HostError>

Atomically replaces the snapshot image.

fn read_journal(&mut self) -> Result<Vec<u8>, HostError>

All journal bytes accumulated since the last snapshot (empty is normal).

fn append_journal(&mut self, entry: &[u8]) -> Result<(), HostError>

Appends one framed journal entry (see crate::journal).

fn clear_journal(&mut self) -> Result<(), HostError>

Discards the journal (called after a successful snapshot).