Struct FabricFs 

pub struct FabricFs { /* private fields */ }

Distributed filesystem backed by leased block storage.

Stores metadata (inodes, directory entries) and data on one or more BlockLeases. Files larger than stripe_threshold are striped round-robin across all leases.

Implementations

impl FabricFs

pub fn format(leases: Vec<BlockLease>) -> Result<Self>

Format leases with a fresh filesystem and return a mounted instance.

Writes a superblock to block 0, initializes the free bitmap and inode table, and creates the root directory inode.

pub fn mount(leases: Vec<BlockLease>) -> Result<Self>

Mount an existing filesystem from leases.

Reads the superblock, validates the magic and version, and populates the inode and directory caches for the root directory.

pub fn create(&mut self, path: &str) -> Result<FileHandle>

Create a file at the given path and return a writable handle.

pub fn open(&mut self, path: &str, flags: OpenFlags) -> Result<FileHandle>

Open a file at the given path with the specified flags.

pub fn read(&self, handle: &FileHandle, buf: &mut [u8]) -> Result<usize>

Read from an open file handle into buf.

Returns the number of bytes read. Returns 0 at EOF.

pub fn write(&mut self, handle: &mut FileHandle, data: &[u8]) -> Result<usize>

Write data to an open file handle.

Returns the number of bytes written.

pub fn seek(&mut self, handle: &mut FileHandle, pos: SeekFrom) -> Result<u64>

Seek to a position in an open file.

pub fn close(&mut self, _handle: FileHandle) -> Result<()>

Close an open file handle.

pub fn remove(&mut self, path: &str) -> Result<()>

Remove a file at the given path.

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

List entries in the directory at the given path.

pub fn stat(&mut self, path: &str) -> Result<FileStat>

Get file metadata for the given path.

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

Create a directory at the given path.

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

Flush all dirty metadata and data to block storage.

pub fn unmount(self) -> Result<Vec<BlockLease>>

Sync and release all leases.

pub fn set_stripe_threshold(&mut self, threshold: u64)

Set the stripe threshold in bytes.

pub fn set_stripe_size(&mut self, size: u32)

Set the stripe size in blocks.