Struct vfs::async_vfs::impls::altroot::AsyncAltrootFS

pub struct AsyncAltrootFS { /* 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 AsyncAltrootFS

pub fn new(root: AsyncVfsPath) -> Self

Create a new root FileSystem at the given virtual path

Trait Implementations

impl AsyncFileSystem for AsyncAltrootFS

fn read_dir<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<Box<dyn Stream<Item = String> + Send + Unpin>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

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<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Creates the directory at this path

fn open_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<Box<dyn SeekAndRead + Send + Unpin>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Opens the file at this path for reading

fn create_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<Box<dyn Write + Send + Unpin>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Creates a file at this path for writing

fn append_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<Box<dyn Write + Send + Unpin>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Opens the file at this path for appending

fn metadata<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<VfsMetadata>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the file metadata for the file at this path

fn set_creation_time<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, time: SystemTime ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sets the files creation timestamp, if the implementation supports it

fn set_modification_time<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, time: SystemTime ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sets the files modification timestamp, if the implementation supports it

fn set_access_time<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, time: SystemTime ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sets the files access timestamp, if the implementation supports it

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

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

fn remove_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Removes the file at this path

fn remove_dir<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Removes the directory at this path

fn copy_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, src: &'life1 str, dest: &'life2 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

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

fn move_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _src: &'life1 str, _dest: &'life2 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

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

fn move_dir<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _src: &'life1 str, _dest: &'life2 str ) -> Pin<Box<dyn Future<Output = VfsResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

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

impl Clone for AsyncAltrootFS

fn clone(&self) -> AsyncAltrootFS

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AsyncAltrootFS

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

Formats the value using the given formatter.