Enum ProcError

pub enum ProcError {
    PermissionDenied(Option<PathBuf>),
    NotFound(Option<PathBuf>),
    Incomplete(Option<PathBuf>),
    Io(Error, Option<PathBuf>),
    Other(String),
    InternalError(InternalError),
}

The various error conditions in the procfs crate.

Most of the variants have an Option<PathBuf> component. If the error root cause was related to some operation on a file, the path of this file will be stored in this component.

Variants

PermissionDenied(Option<PathBuf>)

A standard permission denied error.

This will be a common error, since some files in the procfs filesystem are only readable by the root user.

NotFound(Option<PathBuf>)

This might mean that the process no longer exists, or that your kernel doesn’t support the feature you are trying to use.

Incomplete(Option<PathBuf>)

This might mean that a procfs file has incomplete contents.

If you encounter this error, consider retrying the operation.

Io(Error, Option<PathBuf>)

Any other IO error (rare).

Other(String)

Any other non-IO error (very rare).

InternalError(InternalError)

This error indicates that some unexpected error occurred. This is a bug. The inner InternalError struct will contain some more info.

If you ever encounter this error, consider it a bug in the procfs crate and please report it on github.

Trait Implementations

impl Debug for ProcError

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

Formats the value using the given formatter.

impl Display for ProcError

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

Formats the value using the given formatter.

impl Error for ProcError

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<&'static str> for ProcError

fn from(val: &'static str) -> Self

Converts to this type from the input type.

impl From<Error> for ProcError

fn from(io: Error) -> Self

Converts to this type from the input type.

impl From<Infallible> for ProcError

fn from(e: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for ProcError

fn from(val: ParseIntError) -> Self

Converts to this type from the input type.

impl ProcErrorExt for ProcError

fn error_path(self, path: &Path) -> Self

Add path information to the error.