Enum AcquireFailure 

pub enum AcquireFailure {
    NameNotRegistered,
    CapTableFull,
    Refused,
}

Why a reacquire_cap_detail failed. The two real cases want OPPOSITE responses, which is the entire reason this type exists rather than a bool.

NameNotRegistered is transient and expected: peers are acquired before they are spawned at boot, and again while one is mid-restart. Retry; it heals. CapTableFull is permanent: this service cannot hold another capability, so it can never reacquire anything again and will not recover until it is restarted - a failed recovery, which §26.7 says must stay exactly as visible as the original failure.

Collapsed into one value (as reacquire_cap still does, for callers that only retry) a service can only print both and commit to neither. That ambiguity cost a full debugging pass on the Pi 2: a block-driver that was alive the whole time produced the same line as a reader out of cap slots.

Variants

NameNotRegistered

The name does not resolve right now - no live instance is registered under it. Transient.

CapTableFull

The name resolved, but this service’s own capability table is full. Terminal until restart.

Refused

The request itself was refused (name empty, too long, or not a declared peer).

Implementations

impl AcquireFailure

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

One clause naming the cause, for a caller assembling a log line.

Trait Implementations

impl Clone for AcquireFailure

fn clone(&self) -> AcquireFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcquireFailure

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

Formats the value using the given formatter.

impl PartialEq for AcquireFailure

fn eq(&self, other: &AcquireFailure) -> 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 Copy for AcquireFailure

impl Eq for AcquireFailure

impl StructuralPartialEq for AcquireFailure