Struct FileStore 

pub struct FileStore { /* private fields */ }

On-disk store: a real file wrapped in a fixed-size page cache.

This keeps the public FileStore name stable while introducing the 0.11.0 pager/buffer-pool boundary via [crate::pager::PagedStore].

Implementations

impl FileStore

pub fn new(file: File) -> Self

pub fn open_locked( path: impl AsRef<Path>, mode: OpenMode, ) -> Result<Self, DbError>

Open a file store and acquire the process-level lock for the database path.

Locking policy (cross-process):

• ReadWrite: takes an exclusive advisory lock on the sidecar file <db_path>.writer.lock (fail-fast; does not block indefinitely).
• ReadOnly: opens the database read-only and takes a shared advisory lock on the same sidecar file. This prevents new writers from opening while readers are active.

This excludes concurrent writers, but does not prevent read-only opens while a writer is active. Callers that require stronger coordination should implement it at a higher layer.

Trait Implementations

impl Debug for FileStore

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

Formats the value using the given formatter.

impl Store for FileStore

fn len(&self) -> Result<u64, DbError>

fn read_exact_at(&mut self, offset: u64, buf: &mut [u8]) -> Result<(), DbError>

fn write_all_at(&mut self, offset: u64, buf: &[u8]) -> Result<(), DbError>

fn sync(&mut self) -> Result<(), DbError>

fn truncate(&mut self, len: u64) -> Result<(), DbError>

Shrink or grow the logical file to len bytes (used for crash recovery truncation).

fn is_empty(&self) -> Result<bool, DbError>