Enum RegistryError 

pub enum RegistryError {
    DuplicateComponent {
        id: ComponentId,
    },
    MissingDependency {
        component: ComponentId,
        required: ComponentId,
    },
    CyclicDependency {
        component: ComponentId,
        required: ComponentId,
    },
    CapabilityConflict {
        capability: String,
        provider: ComponentId,
    },
    InvalidCapabilityScope {
        component: ComponentId,
        request: CapabilityRequest,
        reason: ScopeValidationError,
    },
    InvalidActionDeclaration {
        component: ComponentId,
        action: String,
        detail: String,
    },
    DuplicateActionId {
        component: ComponentId,
        action: String,
    },
    DuplicateActionRequirement {
        component: ComponentId,
        action: String,
        requirement: Capability,
    },
    ActionRequirementUndeclared {
        component: ComponentId,
        action: String,
        requirement: Capability,
    },
    InvalidFragmentDeclaration {
        component: ComponentId,
        fragment: String,
        detail: String,
    },
    DuplicateFragmentId {
        component: ComponentId,
        fragment: String,
    },
    FragmentContentOversize {
        component: ComponentId,
        fragment: String,
        size: usize,
        limit: usize,
    },
    FragmentLimitUnconfigured {
        component: ComponentId,
    },
    UnknownFragment {
        component: ComponentId,
        fragment: String,
    },
    FragmentIncarnationStale {
        component: ComponentId,
        fragment: String,
        held: ComponentIncarnation,
        current: Option<ComponentIncarnation>,
    },
    DuplicateCapabilityNeed {
        component: ComponentId,
        request: CapabilityRequest,
    },
    UndeclaredSupervision {
        id: ComponentId,
    },
    InvalidSupervisionWindow {
        id: ComponentId,
    },
    DuplicateChild {
        id: ComponentId,
        child: String,
    },
    NotRegistered {
        id: ComponentId,
    },
    AlreadyStarting {
        id: ComponentId,
    },
    AlreadyRunning {
        id: ComponentId,
    },
    AlreadyStopping {
        id: ComponentId,
    },
    AlreadyRemoving {
        id: ComponentId,
    },
    AlreadyUpgrading {
        id: ComponentId,
    },
    UpgradeRequiresStopped {
        id: ComponentId,
        state: LifecycleState,
    },
    DependencyNotRunning {
        component: ComponentId,
        required: ComponentId,
        state: LifecycleState,
    },
    RunningDependent {
        dependent: ComponentId,
        required: ComponentId,
    },
    DeferredBifImports {
        id: ComponentId,
        module: String,
        imports: String,
    },
    ModuleLoad {
        id: ComponentId,
        detail: String,
    },
    Spawn {
        id: ComponentId,
        process: String,
        detail: String,
    },
    LivenessTimeout {
        id: ComponentId,
        child: String,
    },
    StartFailed {
        id: ComponentId,
        reason: FailureReason,
    },
    StopFailed {
        id: ComponentId,
        reason: FailureReason,
    },
    ModulePurge {
        id: ComponentId,
        module: String,
        detail: String,
    },
    ModuleDelete {
        id: ComponentId,
        module: String,
    },
    ModuleStillLoaded {
        id: ComponentId,
        module: String,
    },
    CommandDelivery {
        id: ComponentId,
        command: &'static str,
        source: MailboxSendError,
    },
    SupervisorProtocol {
        id: ComponentId,
        detail: String,
    },
    SynchronizationPoisoned,
    MonitorTerminated {
        id: ComponentId,
    },
}

A typed refusal or runtime failure from the component registry.

Variants

DuplicateComponent

Registration attempted to reuse a stable identity.

Fields

id: ComponentId

Conflicting stable identity.

MissingDependency

A declared dependency was not in the registration table.

Fields

component: ComponentId

Component being registered.

required: ComponentId

Missing edge target.

CyclicDependency

A dependency edge would make the graph cyclic.

Fields

component: ComponentId

Source of the cyclic edge.

required: ComponentId

Target of the cyclic edge.

CapabilityConflict

Two registered components claimed the same capability identifier.

Fields

capability: String

Colliding service capability identifier.

provider: ComponentId

Existing provider.

InvalidCapabilityScope

A host-authority declaration used a malformed typed scope.

Fields

component: ComponentId

Component being registered.

request: CapabilityRequest

Offending declaration.

reason: ScopeValidationError

Exact scope validation refusal.

InvalidActionDeclaration

An action declaration failed field validation (empty id, description, or schema source).

Fields

component: ComponentId

Component being registered.

action: String

Offending action id text (possibly empty — the offense itself).

detail: String

Exact field refusal.

DuplicateActionId

A component declared the same local action id twice.

Fields

component: ComponentId

Component being registered.

action: String

Duplicate local id.

DuplicateActionRequirement

One action listed an exact capability requirement twice.

Fields

component: ComponentId

Component being registered.

action: String

Action with the duplicate requirement.

requirement: Capability

Duplicate requirement.

ActionRequirementUndeclared

An action requires a capability its component never declared as a need — a permanently dead tool, refused at registration (F-6a R1).

Fields

component: ComponentId

Component being registered.

action: String

Action naming the undeclared requirement.

requirement: Capability

The requirement no declared need covers.

InvalidFragmentDeclaration

A fragment declaration failed field validation (empty id or kind).

Fields

component: ComponentId

Component being registered.

fragment: String

Offending fragment id text (possibly empty — the offense itself).

detail: String

Exact field refusal.

DuplicateFragmentId

A component declared the same local fragment id twice (F-5a R1’s typed refusal; the whole batch is refused atomically).

Fields

component: ComponentId

Component being registered.

fragment: String

Duplicate local id.

FragmentContentOversize

Fragment content exceeded the registry’s caller-supplied byte limit (registration and content update validate identically — F-5a R2).

Fields

component: ComponentId

Declaring or updating component.

fragment: String

Offending fragment id.

size: usize

Offered content size in bytes.

limit: usize

The caller-supplied limit in force.

FragmentLimitUnconfigured

Fragments were declared but the embedding host supplied no max_fragment_bytes — there is no hidden default limit (F-5a R1); the host states one in its lifecycle configuration or fragments are refused loudly.

Fields

component: ComponentId

Component being registered.

UnknownFragment

A fragment act named a fragment id with no live entry in the authority — an undeclared local id (the ID set is static per incarnation, F-5a R2), or an internal invariant breach surfaced loudly rather than papered over.

Fields

component: ComponentId

Component named by the act.

fragment: String

The fragment id with no live entry.

FragmentIncarnationStale

A fragment act carried an incarnation that is not the live Running incarnation — the typed held-vs-current refusal (F-2a’s rule applied to fragments, F-5a R2). current is absent when no incarnation is live (the component is not Running).

Fields

component: ComponentId

Component named by the act.

fragment: String

Fragment named by the act.

held: ComponentIncarnation

The incarnation the caller holds.

current: Option<ComponentIncarnation>

The live Running incarnation, absent when not Running.

DuplicateCapabilityNeed

A manifest repeated an exact kind-and-scope pair.

Fields

component: ComponentId

Component being registered.

request: CapabilityRequest

Duplicate declaration.

UndeclaredSupervision

Registration omitted the mandatory restart intensity declaration.

Fields

id: ComponentId

Component missing the declaration.

InvalidSupervisionWindow

A restart window of zero cannot define an intensity interval.

Fields

id: ComponentId

Component with the invalid policy.

DuplicateChild

Child names are component-local unique keys.

Fields

id: ComponentId

Component with the duplicate declaration.

child: String

Duplicate child key.

NotRegistered

The requested component is not registered.

Fields

id: ComponentId

Requested identity.

AlreadyStarting

A start is already in flight for this identity.

Fields

id: ComponentId

Busy identity.

AlreadyRunning

The component is already running.

Fields

id: ComponentId

Running identity.

AlreadyStopping

A stop is already in flight for this identity.

Fields

id: ComponentId

Busy identity.

AlreadyRemoving

A remove is already in flight for this identity.

Fields

id: ComponentId

Busy identity.

AlreadyUpgrading

A bytecode upgrade is already in flight for this identity.

Fields

id: ComponentId

Busy identity.

UpgradeRequiresStopped

A bytecode upgrade was requested outside the stopped states.

Fields

id: ComponentId

Requested identity.

state: LifecycleState

The state that refused the upgrade.

DependencyNotRunning

A dependency exists but has not reached Running.

Fields

component: ComponentId

Component whose start was refused.

required: ComponentId

Required component.

state: LifecycleState

Observed dependency state.

RunningDependent

A running component still depends on the removal target.

Fields

dependent: ComponentId

Running dependent preventing removal.

required: ComponentId

Requested removal target.

DeferredBifImports

Hot-loaded bytecode carries erlang:* imports the scheduler composition left Deferred — dispatch would kill the process at first use.

Fields

id: ComponentId

Component whose start was refused.

module: String

Module whose committed import table carries the deferrals.

imports: String

Deferred imports in erlang:name/arity form.

ModuleLoad

beamr refused or could not parse component bytecode.

Fields

id: ComponentId

Component being started.

detail: String

beamr loader detail.

Spawn

A native supervisor or linked child could not be spawned.

Fields

id: ComponentId

Component being started or restarted.

process: String

Supervisor or child name.

detail: String

beamr spawn detail.

LivenessTimeout

A child did not answer its declared mailbox probe in time.

Fields

id: ComponentId

Component being started or probed.

child: String

Child that did not answer.

StartFailed

Start failed after entering Starting; status remains Failed.

Fields

id: ComponentId

Failed identity.

reason: FailureReason

Observable reason retained in status.

StopFailed

Ordered stop observed a non-normal or missing tombstone.

Fields

id: ComponentId

Component being stopped.

reason: FailureReason

Exact observed failure.

ModulePurge

A retained old module generation could not be safely purged.

Fields

id: ComponentId

Component being removed.

module: String

Module display name.

detail: String

beamr purge detail.

ModuleDelete

The current module generation was absent when removal expected it.

Fields

id: ComponentId

Component being removed.

module: String

Module display name.

ModuleStillLoaded

Lookup still found code after deletion.

Fields

id: ComponentId

Component being removed.

module: String

Module display name.

CommandDelivery

beamr refused a typed host command at supervisor mailbox admission.

Fields

id: ComponentId

Affected component.

command: &'static str

Stable command kind whose delivery was attempted.

source: MailboxSendError

Exact beamr mailbox admission refusal.

SupervisorProtocol

Host/supervisor mailbox protocol was violated.

Fields

id: ComponentId

Affected component.

detail: String

Protocol detail.

SynchronizationPoisoned

Internal synchronization was poisoned by a panic.

MonitorTerminated

A component monitor thread terminated without returning its result.

Fields

id: ComponentId

Component whose monitor was lost.

Trait Implementations

impl Debug for RegistryError

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

Formats the value using the given formatter.

impl Display for RegistryError

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

Formats the value using the given formatter.

impl Error for RegistryError

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.