Struct vfs::impls::altroot::AltrootFS

pub struct AltrootFS { /* private fields */ }

Similar to a chroot but done purely by path manipulation

NOTE: This mechanism should only be used for convenience, NOT FOR SECURITY

Symlinks, hardlinks, remounts, side channels and other file system mechanisms can be exploited to circumvent this mechanism

Implementations

impl AltrootFS

pub fn new(root: VfsPath) -> Self

Create a new root FileSystem at the given virtual path

Trait Implementations

impl Clone for AltrootFS

fn clone(&self) -> AltrootFS

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AltrootFS

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

Formats the value using the given formatter.

impl FileSystem for AltrootFS

fn read_dir( &self, path: &str ) -> VfsResult<Box<dyn Iterator<Item = String> + Send>>

Iterates over all direct children of this directory path NOTE: the returned String items denote the local bare filenames, i.e. they should not contain “/” anywhere

fn create_dir(&self, path: &str) -> VfsResult<()>

Creates the directory at this path

fn open_file(&self, path: &str) -> VfsResult<Box<dyn SeekAndRead + Send>>

Opens the file at this path for reading

fn create_file(&self, path: &str) -> VfsResult<Box<dyn SeekAndWrite + Send>>

Creates a file at this path for writing

fn append_file(&self, path: &str) -> VfsResult<Box<dyn SeekAndWrite + Send>>

Opens the file at this path for appending

fn metadata(&self, path: &str) -> VfsResult<VfsMetadata>

Returns the file metadata for the file at this path

fn set_creation_time(&self, path: &str, time: SystemTime) -> VfsResult<()>

Sets the files creation timestamp, if the implementation supports it

fn set_modification_time(&self, path: &str, time: SystemTime) -> VfsResult<()>

Sets the files modification timestamp, if the implementation supports it

fn set_access_time(&self, path: &str, time: SystemTime) -> VfsResult<()>

Sets the files access timestamp, if the implementation supports it

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

Returns true if a file or directory at path exists, false otherwise

fn remove_file(&self, path: &str) -> VfsResult<()>

Removes the file at this path

fn remove_dir(&self, path: &str) -> VfsResult<()>

Removes the directory at this path

fn copy_file(&self, src: &str, dest: &str) -> VfsResult<()>

Copies the src path to the destination path within the same filesystem (optional)

fn move_file(&self, _src: &str, _dest: &str) -> VfsResult<()>

Moves the src path to the destination path within the same filesystem (optional)

fn move_dir(&self, _src: &str, _dest: &str) -> VfsResult<()>

Moves the src directory to the destination path within the same filesystem (optional)