Enum FezError 

pub enum FezError {
    Spawn {
        program: String,
        source: Error,
    },
    Io(Error),
    Decode(Error),
    Timeout,
    BridgeClosed,
    Problem(String),
    Dbus {
        name: String,
        message: String,
    },
    NotFound(String),
    Protected {
        unit: String,
    },
    DependencyMissing {
        component: String,
        dbus_name: String,
        remediation: String,
    },
    DangerousTransaction {
        reason: String,
        removed: Vec<String>,
    },
    Aborted,
    AccessDenied {
        remediation: String,
    },
}

Every error fez can surface to the caller.

Variants

Spawn

A child process (the bridge) could not be spawned.

Fields

program: String

Program that failed to launch.

source: Error

Underlying OS error.

Io(Error)

A generic I/O failure.

Decode(Error)

A protocol message could not be decoded.

Timeout

The bridge did not respond before the deadline.

BridgeClosed

The bridge connection was closed unexpectedly.

Problem(String)

The bridge reported a problem; the string is a problem kind.

Dbus

A D-Bus call returned an error.

Fields

name: String

D-Bus error name.

message: String

D-Bus error message.

NotFound(String)

The requested resource (e.g. a unit) does not exist.

Protected

A protected unit was targeted without --force.

Fields

unit: String

The protected unit that was refused.

DependencyMissing

A required target dependency (e.g. dnf5daemon) is absent or not activatable.

Fields

component: String

Human-facing name of the missing component (e.g. dnf5daemon).

dbus_name: String

The D-Bus name that failed to activate (e.g. org.rpm.dnf.v0).

remediation: String

Actionable guidance to install/enable the dependency and retry.

DangerousTransaction

A resolved transaction was refused by removal guardrails without --force.

Fields

reason: String

Why the transaction was refused (protected package or cascade size).

removed: Vec<String>

Package names the resolved plan would remove.

Aborted

The user declined a confirmation prompt.

AccessDenied

Privilege escalation to root failed (the bridge could not become root, e.g. sudo requires a password fez does not supply).

Fields

remediation: String

Actionable guidance to enable privilege escalation and retry.

Implementations

impl FezError

pub fn code(&self) -> &'static str

Stable machine-readable error code for this error.

pub fn exit_code(&self) -> i32

Process exit code to use when this error is fatal.

Trait Implementations

impl Debug for FezError

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

Formats the value using the given formatter.

impl Display for FezError

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

Formats the value using the given formatter.

impl Error for FezError

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.