Struct DurableFileCacheWriter 

pub struct DurableFileCacheWriter { /* private fields */ }

File writer that synchronizes and releases completed page-cache windows.

Implementations

impl DurableFileCacheWriter

pub fn new(file: File) -> Result<Self>

Wrap file with the default 1 GiB durable cache window.

Errors

Returns an error when the current descriptor offset cannot be observed.

pub fn with_window_bytes(file: File, window_bytes: NonZeroU64) -> Result<Self>

Wrap file with an explicit non-zero durable cache window.

Errors

Returns an error when the current descriptor offset cannot be observed.

pub fn with_window_bytes_checked( file: File, window_bytes: NonZeroU64, setup_check: impl FnOnce() -> Result<()>, ) -> Result<Self>

Wrap file and run one caller-supplied setup check after observing the real descriptor offset but before constructing the writer.

This exists so higher layers can deterministically exercise constructor failure without bypassing the actual descriptor setup path.

Errors

Returns an error when offset observation or setup_check fails.

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

Complete the final durability barrier and release its remaining cache window.

Errors

Returns an error if synchronization or a supported cache-release request fails.

pub fn file(&self) -> &File

Borrow the underlying file.

pub const fn evidence(&self) -> FileCacheReleaseEvidence

Return content-free synchronization and cache-release evidence.

pub const fn window_bytes(&self) -> NonZeroU64

Return this writer’s configured synchronization/release window.

pub fn into_file(self) -> File

Consume the writer and return its underlying file.

Trait Implementations

impl Debug for DurableFileCacheWriter

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

Formats the value using the given formatter.

impl Write for DurableFileCacheWriter

fn write(&mut self, buffer: &[u8]) -> Result<usize>

Writes a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.