Struct FilesystemRoot 

pub struct FilesystemRoot { /* private fields */ }

A canonicalized sandbox root. All paths resolved through this instance are guaranteed to live under the root directory on the local filesystem.

Implementations

impl FilesystemRoot

pub fn new(root: impl Into<PathBuf>) -> Result<FilesystemRoot, String>

Construct a sandbox rooted at root. The directory must exist and be canonicalizable (symlinks resolved). Returns Err if the root does not exist or is not accessible.

pub fn root(&self) -> &Path

Return the canonical root directory.

pub fn resolve(&self, input: &str) -> Result<PathBuf, String>

Resolve a user-supplied path against the sandbox root.

Returns the absolute, canonical path if it is (or — for not-yet-existing paths — would be) under the root. Rejects:

• any path whose components contain ..
• any path that canonicalizes outside the root (symlink escape)
• for new files: any parent path that escapes the root

Trait Implementations

impl Clone for FilesystemRoot

fn clone(&self) -> FilesystemRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilesystemRoot

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

Formats the value using the given formatter.