Struct Fs 

pub struct Fs<T: TimeProvider = MonotonicCounter> { /* private fields */ }

Main filesystem structure. See the module-level comment for an overview of the two storage flavours.

Implementations

impl<T: TimeProvider> Fs<T>

pub fn with_time_provider(time_provider: T) -> Self

Build an empty filesystem with the supplied time provider. A root directory is created automatically with timestamps populated by the provider.

pub fn open_path(&self, path: &str) -> Result<Fd, FsError>

pub fn open_at(&self, dir_fd: Fd, path: &str, flags: u32) -> Result<Fd, FsError>

pub fn open_path_with_flags( &self, path: &str, flags: u32, ) -> Result<Fd, FsError>

pub fn write(&self, fd: Fd, buf: &[u8]) -> Result<usize, FsError>

pub fn write_at( &self, fd: Fd, offset: u64, buf: &[u8], ) -> Result<usize, FsError>

Write data at a specific offset atomically (seek + write in one lock acquisition). Does not touch O_APPEND.

pub fn append_write(&self, fd: Fd, buf: &[u8]) -> Result<usize, FsError>

Append data to file atomically (always writes at end of file).

pub fn read(&self, fd: Fd, out: &mut [u8]) -> Result<usize, FsError>

pub fn read_at( &self, fd: Fd, offset: u64, out: &mut [u8], ) -> Result<usize, FsError>

Read data at a specific offset atomically (seek + read in one lock acquisition).

pub fn ftruncate(&self, fd: Fd, size: u64) -> Result<(), FsError>

pub fn close(&self, fd: Fd) -> Result<(), FsError>

pub fn stat(&self, path: &str) -> Result<Metadata, FsError>

pub fn fstat(&self, fd: Fd) -> Result<Metadata, FsError>

pub fn seek(&self, fd: Fd, offset: i64, whence: i32) -> Result<u64, FsError>

pub fn mkdir(&self, path: &str) -> Result<(), FsError>

pub fn mkdir_p(&self, path: &str) -> Result<(), FsError>

pub fn unlink(&self, path: &str) -> Result<(), FsError>

pub fn readdir(&self, path: &str) -> Result<Vec<String>, FsError>

pub fn readdir_fd(&self, fd: Fd) -> Result<Vec<(String, bool)>, FsError>

Read directory entries from an open file descriptor. Returns a list of (name, is_dir) tuples.

pub fn rmdir(&self, path: &str) -> Result<(), FsError>

Remove an empty directory.

pub fn rename(&self, old_path: &str, new_path: &str) -> Result<(), FsError>

Rename or move a file or directory.

impl Fs<MonotonicCounter>

pub fn new() -> Self

impl<T: TimeProvider> Fs<T>

pub fn to_snapshot(&self) -> FsSnapshot

Create a snapshot of the current filesystem state.

pub fn from_snapshot(snapshot: FsSnapshot, time_provider: T) -> Self

Restore filesystem state from a snapshot.

Trait Implementations

impl Default for Fs<MonotonicCounter>

fn default() -> Self

Returns the “default value” for a type.