Enum BrokerError 

#[non_exhaustive]
pub enum BrokerError {
    AccessDenied,
    LimitsExceeded,
    InvalidArgs,
    Failed,
    Other,
}

The specific reason a privilege broker REFUSED a grant - the typed form of the D-Bus error name it answered with, carried by AppliedPriority::broker_error when reason is FallbackReason::BrokerRefused.

This is the actionable classification behind a refusal: branch on it to decide whether to retry. We deliberately keep only the well-known names as variants and collapse everything else to Other - the name is the signal, the daemon’s free-text message is not worth a heap allocation for the rare unmapped case (read the rtkit journal for that).

#[non_exhaustive]: brokers can grow error names; matching must carry a _.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

AccessDenied

Policy denied the grant - polkit, rlimits, or no active/seated login session (common over SSH). Treat as persistent for the current process and configuration; retry only after a privilege or session change.

LimitsExceeded

The broker’s rate limit was hit (rtkit caps actions per interval, e.g. 25 / 20 s / UID). Transient - back off and retry later, or elevate fewer threads.

InvalidArgs

The broker rejected the arguments (e.g. a priority out of its range). A bug on our side or a daemon-version skew, not a transient condition.

Failed

A generic daemon-side failure with no more specific name.

Other

An error name this version doesn’t map. The grant was refused; the specific cause is in the rtkit journal.

Trait Implementations

impl Clone for BrokerError

fn clone(&self) -> BrokerError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for BrokerError

impl Debug for BrokerError

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

Formats the value using the given formatter.

impl Display for BrokerError

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

Formats the value using the given formatter.

impl Eq for BrokerError

impl PartialEq for BrokerError

fn eq(&self, other: &BrokerError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BrokerError