Enum SystemError 

pub enum SystemError {
    NotAbsolute {
        path: String,
    },
    NoHome,
    AlreadyExists {
        path: String,
    },
    Locked {
        action: &'static str,
        path: String,
        holders: String,
        source: Error,
    },
    Io {
        action: &'static str,
        path: String,
        source: Error,
    },
}

Failures of host path resolution and host file operations.

Variants

NotAbsolute

A path that must be absolute was not, and this module refuses to make it absolute against the working directory — that is how an index ends up wherever the binary happened to be started.

Fields

path: String

The offending path.

NoHome

The home directory could not be determined (HOME/USERPROFILE unset).

AlreadyExists

The destination of a move is occupied, and this module never overwrites: the caller decides what to do with the file already there.

Fields

path: String

The occupied path.

Locked

A file could not be renamed or deleted because something still holds it open. Windows only — unix does neither operation on the handle.

Separate from SystemError::Io because the OS message (“the process cannot access the file because it is being used by another process”) never says which process, which leaves both the user and a bug report with nothing to act on. holders is what the Restart Manager reports, or "unknown" when it will not say.

Fields

action: &'static str

What was being attempted, e.g. "move".

path: String

The path that is held open.

holders: String

Processes holding it, as "name (pid N)", comma-separated.

source: Error

The underlying OS error.

Io

A filesystem call failed.

Fields

action: &'static str

What was being attempted, e.g. "create directory".

path: String

The path it was attempted on.

source: Error

The underlying OS error.

Trait Implementations

impl Debug for SystemError

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

Formats the value using the given formatter.

impl Display for SystemError

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

Formats the value using the given formatter.

impl Error for SystemError

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.