Struct FileStream 

pub struct FileStream<M = Writer>
where
    M: FilesMode,
{ /* private fields */ }

An open file. A file never changes its bytes, so nothing later changes what it reads. Its shared store lock prevents deletion until the stream and its I/O finish, including reads still running after the store closes or the caller cancels.

Implementations

impl<M> FileStream<M>

where M: FilesMode,

pub fn plaintext_size(&self) -> u64

Complete plaintext size.

pub async fn read_at( &self, offset: u64, len: u64, ) -> Result<Vec<u8>, FileReadError>

Read exactly the requested range. Network requests cover only missing chunks, batching adjacent chunks within 1 MiB. Use read_range to keep returned plaintext bounded independently of the requested range length.

pub async fn read_at_reporting( &self, offset: u64, len: u64, progress: &ReadProgress, ) -> Result<Vec<u8>, FileReadError>

Self::read_at, telling progress how many of the range’s bytes are here each time that grows while the read fetches from storage. A read served from this device’s copy or the cache tells it nothing.

pub fn read_range( &self, offset: u64, len: u64, ) -> Result<FileRangeStream<'_, M>, FileReadError>

Stream a byte range in bounded plaintext buffers, authenticating each fetched chunk before yielding its bytes. For a stored file, the final buffer checks the whole-file hash when reading sequentially from zero through the end.