Enum AccessError 

pub enum AccessError {
    Path(String),
    Link(String),
    Unexpected(String),
    TooLarge(String),
    Locked,
    Io(String, Error),
}

Why a path beneath the root could not be used.

Variants

Path(String)

The path has an empty, . or .. component, or a component with \, : or NUL; or a name has a /.

Link(String)

A symbolic link at this prefix of the path.

Unexpected(String)

The entry is not a regular file or directory, as the access needs.

TooLarge(String)

The file is larger than the limit of the read.

Locked

Another holder has the root’s lock.

Io(String, Error)

Implementations

impl AccessError

pub fn removal_pending(&self) -> bool

Whether this is a removal that took effect but is not finished: on Windows a removed entry stays, on some file systems, until another program closes it, and goes then.

pub fn already_exists(&self) -> bool

Whether this is SourceDirectory::create refusing because something is already at the name: a file, a directory, a link (dangling or not, on Windows any reparse point), or any other entry, which it left as it was. It is an AccessError::Io whose error is of kind std::io::ErrorKind::AlreadyExists.

pub fn may_be_left(&self) -> bool

Whether this is SourceDirectory::create failing after it made its file and not removing it, so that the file, partly written, may be left at the name: always on Windows, and on Unix where the entry at the name could not be told to be still that file. It is an AccessError::Io of the failure’s own kind. When create fails otherwise, nothing it made is left.

Trait Implementations

impl Debug for AccessError

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

Formats the value using the given formatter.

impl Display for AccessError

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

Formats the value using the given formatter.

impl Error for AccessError

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.