Trait VirtualFileSystem 

pub trait VirtualFileSystem {
    // Required methods
    fn read_file(&mut self, path: &str) -> Result<Vec<u8>, VfsError>;
    fn read_dir(&mut self, path: &str) -> Result<Vec<String>, VfsError>;
    fn read_dir_with_types(
        &mut self,
        path: &str,
    ) -> Result<Vec<VirtualDirEntry>, VfsError>;
    fn write_file(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
    ) -> Result<(), VfsError>;
    fn create_dir(&mut self, path: &str) -> Result<(), VfsError>;
    fn mkdir(&mut self, path: &str, recursive: bool) -> Result<(), VfsError>;
    fn exists(&self, path: &str) -> bool;
    fn stat(&mut self, path: &str) -> Result<VirtualStat, VfsError>;
    fn remove_file(&mut self, path: &str) -> Result<(), VfsError>;
    fn remove_dir(&mut self, path: &str) -> Result<(), VfsError>;
    fn rename(&mut self, old_path: &str, new_path: &str) -> Result<(), VfsError>;
    fn realpath(&self, path: &str) -> Result<String, VfsError>;
    fn symlink(&mut self, target: &str, link_path: &str) -> Result<(), VfsError>;
    fn read_link(&self, path: &str) -> Result<String, VfsError>;
    fn lstat(&self, path: &str) -> Result<VirtualStat, VfsError>;
    fn link(&mut self, old_path: &str, new_path: &str) -> Result<(), VfsError>;
    fn chmod(&mut self, path: &str, mode: u32) -> Result<(), VfsError>;
    fn chown(&mut self, path: &str, uid: u32, gid: u32) -> Result<(), VfsError>;
    fn utimes(
        &mut self,
        path: &str,
        atime_ms: u64,
        mtime_ms: u64,
    ) -> Result<(), VfsError>;
    fn truncate(&mut self, path: &str, length: u64) -> Result<(), VfsError>;
    fn pread(
        &mut self,
        path: &str,
        offset: u64,
        length: usize,
    ) -> Result<Vec<u8>, VfsError>;

    // Provided methods
    fn read_text_file(&mut self, path: &str) -> Result<String, VfsError> { ... }
    fn read_dir_limited(
        &mut self,
        path: &str,
        max_entries: usize,
    ) -> Result<Vec<String>, VfsError> { ... }
    fn write_file_with_mode(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
        mode: Option<u32>,
    ) -> Result<(), VfsError> { ... }
    fn create_file_exclusive(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
    ) -> Result<(), VfsError> { ... }
    fn create_file_exclusive_with_mode(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
        mode: Option<u32>,
    ) -> Result<(), VfsError> { ... }
    fn append_file(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
    ) -> Result<u64, VfsError> { ... }
    fn create_dir_with_mode(
        &mut self,
        path: &str,
        mode: Option<u32>,
    ) -> Result<(), VfsError> { ... }
    fn mkdir_with_mode(
        &mut self,
        path: &str,
        recursive: bool,
        mode: Option<u32>,
    ) -> Result<(), VfsError> { ... }
    fn utimes_spec(
        &mut self,
        path: &str,
        atime: VirtualUtimeSpec,
        mtime: VirtualUtimeSpec,
        follow_symlinks: bool,
    ) -> Result<(), VfsError> { ... }
    fn pwrite(
        &mut self,
        path: &str,
        content: impl Into<Vec<u8>>,
        offset: u64,
    ) -> Result<(), VfsError> { ... }
}

Required Methods

fn read_file(&mut self, path: &str) -> Result<Vec<u8>, VfsError>

fn read_dir(&mut self, path: &str) -> Result<Vec<String>, VfsError>

fn read_dir_with_types( &mut self, path: &str, ) -> Result<Vec<VirtualDirEntry>, VfsError>

fn write_file( &mut self, path: &str, content: impl Into<Vec<u8>>, ) -> Result<(), VfsError>

Writes caller-owned bytes into the filesystem.

This raw VFS primitive does not enforce VM resource policy. Kernel entry points must preflight file sizes and inode growth before calling it.

fn create_dir(&mut self, path: &str) -> Result<(), VfsError>

fn mkdir(&mut self, path: &str, recursive: bool) -> Result<(), VfsError>

fn exists(&self, path: &str) -> bool

fn stat(&mut self, path: &str) -> Result<VirtualStat, VfsError>

fn remove_file(&mut self, path: &str) -> Result<(), VfsError>

fn remove_dir(&mut self, path: &str) -> Result<(), VfsError>

fn rename(&mut self, old_path: &str, new_path: &str) -> Result<(), VfsError>

fn realpath(&self, path: &str) -> Result<String, VfsError>

fn symlink(&mut self, target: &str, link_path: &str) -> Result<(), VfsError>

fn read_link(&self, path: &str) -> Result<String, VfsError>

fn lstat(&self, path: &str) -> Result<VirtualStat, VfsError>

fn link(&mut self, old_path: &str, new_path: &str) -> Result<(), VfsError>

fn chmod(&mut self, path: &str, mode: u32) -> Result<(), VfsError>

fn chown(&mut self, path: &str, uid: u32, gid: u32) -> Result<(), VfsError>

fn utimes( &mut self, path: &str, atime_ms: u64, mtime_ms: u64, ) -> Result<(), VfsError>

fn truncate(&mut self, path: &str, length: u64) -> Result<(), VfsError>

Resizes a file. VM resource policy must be enforced by the caller.

fn pread( &mut self, path: &str, offset: u64, length: usize, ) -> Result<Vec<u8>, VfsError>

Provided Methods

fn read_text_file(&mut self, path: &str) -> Result<String, VfsError>

fn read_dir_limited( &mut self, path: &str, max_entries: usize, ) -> Result<Vec<String>, VfsError>

fn write_file_with_mode( &mut self, path: &str, content: impl Into<Vec<u8>>, mode: Option<u32>, ) -> Result<(), VfsError>

fn create_file_exclusive( &mut self, path: &str, content: impl Into<Vec<u8>>, ) -> Result<(), VfsError>

fn create_file_exclusive_with_mode( &mut self, path: &str, content: impl Into<Vec<u8>>, mode: Option<u32>, ) -> Result<(), VfsError>

fn append_file( &mut self, path: &str, content: impl Into<Vec<u8>>, ) -> Result<u64, VfsError>

Appends caller-owned bytes into the filesystem after checking that the in-memory file can grow without overflowing addressable memory.

fn create_dir_with_mode( &mut self, path: &str, mode: Option<u32>, ) -> Result<(), VfsError>

fn mkdir_with_mode( &mut self, path: &str, recursive: bool, mode: Option<u32>, ) -> Result<(), VfsError>

fn utimes_spec( &mut self, path: &str, atime: VirtualUtimeSpec, mtime: VirtualUtimeSpec, follow_symlinks: bool, ) -> Result<(), VfsError>

fn pwrite( &mut self, path: &str, content: impl Into<Vec<u8>>, offset: u64, ) -> Result<(), VfsError>

Writes caller-owned bytes at an offset after checking that the in-memory file can grow without overflowing addressable memory.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl VirtualFileSystem for MemoryFileSystem

impl VirtualFileSystem for MountTable

impl VirtualFileSystem for OverlayFileSystem

impl VirtualFileSystem for RootFileSystem

impl<F: VirtualFileSystem> VirtualFileSystem for PermissionedFileSystem<F>

impl<V: VirtualFileSystem> VirtualFileSystem for DeviceLayer<V>