Enum ContainError 

#[non_exhaustive]
pub enum ContainError {
    InvalidRelative,
    NotAbsolute,
    Escapes,
    Symlink,
    NotAFile,
    HardLinked,
    Io(Error),
}

Why a path was refused or could not be resolved.

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.

InvalidRelative

rel is empty, absolute, has a root or drive prefix, has a .. component or a NUL byte, or (on Windows) a name Windows cannot use as a plain component; or a path ends in .. or has a .. in its not-yet-existing part.

NotAbsolute

An absolute path was required (a Roots method, or a root given to Roots::add).

Escapes

The resolved path is not inside the resolved root (a symlink or junction leads out, the path is outside every approved root, or an approved root was replaced after it was approved).

Symlink

A no-follow open met a symbolic link or reparse point (anywhere, even one that points inside).

NotAFile

A confined open found something that is not a regular file (a directory, a FIFO, a device).

HardLinked

A confined open with ConfinedOptions::require_single_link found a file with more than one hard link.

Io(Error)

The root, the path, or an entry on the way could not be resolved. This includes a symlink that dangles or loops: its target is unknown, so it is never trusted.

Trait Implementations

impl Debug for ContainError

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

Formats the value using the given formatter.

impl Display for ContainError

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

Formats the value using the given formatter.

impl Error for ContainError

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

Returns the lower-level source of this error, if any.

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<ContainError> for Error

An io::Error of the kind a std::io caller expects: InvalidInput for a malformed path or a link, PermissionDenied for an escape or a hard link; an ContainError::Io keeps its own error.

fn from(e: ContainError) -> Self

Converts to this type from the input type.

impl From<Error> for ContainError

fn from(e: Error) -> Self

Converts to this type from the input type.