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>,
    },
    Usage(String),
    Aborted,
    AccessDenied {
        remediation: String,
    },
    UnsupportedApi(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.

Usage(String)

A CLI usage error (clap parse failure: missing/invalid argument or unknown flag) surfaced as a fez/v1 envelope because --json was requested. The plain-text path keeps clap’s own rendering.

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.

UnsupportedApi(String)

The managed subsystem is present but does not expose a D-Bus method fez needs (the call returned UnknownMethod), e.g. an older firewalld without getMasquerade. Distinct from a missing dependency: the service is reachable but its API surface is too old.

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.

pub fn detail(&self) -> Option<Value>

Structured detail for the fez/v1 error envelope.

Returns the machine-readable payload for the error variants that carry one (DependencyMissing, DangerousTransaction, UnsupportedApi); every other variant has no structured detail and yields None. Capabilities call this when rendering an error envelope so the mapping lives in one place.

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.