Enum fs_mistrust::Error

#[non_exhaustive]
pub enum Error {
    NotFound(PathBuf),
    BadPermission(PathBuf, u32, u32),
    BadOwner(PathBuf, u32),
    BadType(PathBuf),
    CouldNotInspect(PathBuf, Arc<IoError>),
    Multiple(Vec<Box<Error>>),
    StepsExceeded,
    CurrentDirectory(Arc<IoError>),
    CreatingDir(Arc<IoError>),
    Content(Box<Error>),
    Listing(Arc<Error>),
    InvalidSubdirectory,
    Io(PathBuf, Arc<IoError>),
    NoTempFile(PathBuf),
    MissingField(UninitializedFieldError),
    NoSuchGroup(String),
    NoSuchUser(String),
}

An error returned while checking a path for privacy.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound(PathBuf)

A target (or one of its ancestors) was not found.

BadPermission(PathBuf, u32, u32)

A target (or one of its ancestors) had incorrect permissions.

Only generated on unix-like systems.

The first integer contains the current permission bits, and the second contains the permission bits which were incorrectly set.

BadOwner(PathBuf, u32)

A target (or one of its ancestors) had an untrusted owner.

Only generated on unix-like systems.

The provided integer contains the user_id o

BadType(PathBuf)

A target (or one of its ancestors) had the wrong type.

Ordinarily, the target may be anything at all, though you can override this with require_file and require_directory.

CouldNotInspect(PathBuf, Arc<IoError>)

We were unable to inspect the target or one of its ancestors.

(Ironically, we might lack permissions to see if something’s permissions are correct.)

(The std::io::Error that caused this problem is wrapped in an Arc so that our own Error type can implement Clone.)

Multiple(Vec<Box<Error>>)

Multiple errors occurred while inspecting the target.

This variant will only be returned if the caller specifically asked for it by calling all_errors.

We will never construct an instance of this variant with an empty Vec.

StepsExceeded

We’ve realized that we can’t finish resolving our path without taking more than the maximum number of steps. The likeliest explanation is a symlink loop.

CurrentDirectory(Arc<IoError>)

We can’t find our current working directory, or we found it but it looks impossible.

CreatingDir(Arc<IoError>)

We tried to create a directory, and encountered a failure in doing so.

Content(Box<Error>)

We found a problem while checking the contents of the directory.

Listing(Arc<Error>)

We were unable to inspect the contents of the directory

This error is only present when the walkdir feature is enabled.

InvalidSubdirectory

Tried to use an invalid path with a CheckedDir,

Io(PathBuf, Arc<IoError>)

We encountered an error while attempting an IO operation on a file.

NoTempFile(PathBuf)

We could not create an unused temporary path when trying to write a file.

MissingField(UninitializedFieldError)

A field was missing when we tried to construct a Mistrust.

NoSuchGroup(String)

A group that we were configured to trust could not be found.

NoSuchUser(String)

A user that we were configured to trust could not be found.

Implementations

impl Error

pub fn path(&self) -> Option<&Path>

Return the path, if any, associated with this error.

pub fn is_bad_permission(&self) -> bool

Return true iff this error indicates a problem with filesystem permissions.

(Other errors typically indicate an IO problem, possibly one preventing us from looking at permissions in the first place)

pub fn errors<'a>(&'a self) -> impl Iterator<Item = &Error> + 'a

Return an iterator over all of the errors contained in this Error.

If this is a singleton, the iterator returns only a single element. Otherwise, it returns all the elements inside the Error::Multiple variant.

Does not recurse, since we do not create nested instances of Error::Multiple.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<UninitializedFieldError> for Error

fn from(source: UninitializedFieldError) -> Self

Converts to this type from the input type.

impl FromIterator<Error> for Option<Error>

fn from_iter<T: IntoIterator<Item = Error>>(iter: T) -> Self

Creates a value from an iterator.