Enum SuperviseError 

pub enum SuperviseError {
    InvalidSpec {
        reason: String,
    },
    Spawn {
        program: PathBuf,
        source: Error,
        cgroup_path: Option<PathBuf>,
    },
    Cgroup {
        module_id: String,
        source: Error,
    },
    LaunchNonce {
        reason: String,
    },
    Wait {
        module_id: String,
        source: Error,
    },
    Kill {
        module_id: String,
        source: Error,
    },
    Forwarding(ForwardingError),
    Registry(RegistryError),
    ReloadUnavailable {
        module_id: String,
        reason: String,
    },
    Disabled {
        module_id: String,
    },
    ReloadFailed {
        module_id: String,
        reason: String,
    },
    RegistrationStillActive {
        module_id: String,
        waited: Duration,
    },
    StatePoisoned {
        module_id: Option<String>,
    },
    CommandClosed {
        module_id: String,
    },
    SwapInProgress {
        module_id: String,
    },
    SwapRefused {
        module_id: String,
        reason: SwapRefusal,
    },
    SwapFailed {
        module_id: String,
        arm: SwapFailureArm,
        detail: String,
        candidate_exit: Option<ExitReport>,
    },
}

Variants

InvalidSpec

Fields

reason: String

Spawn

Fields

program: PathBuf

source: Error

cgroup_path: Option<PathBuf>

Cgroup

Fields

module_id: String

source: Error

LaunchNonce

CSPRNG failure generating a reserved module’s launch nonce. Fail loud rather than spawn a reserved module without its identity binding.

Fields

reason: String

Wait

Fields

module_id: String

source: Error

Kill

Fields

module_id: String

source: Error

Forwarding(ForwardingError)

Registry(RegistryError)

ReloadUnavailable

Fields

module_id: String

reason: String

Disabled

An operator restart/reload was requested for a module that is currently disabled. Restart/reload cycle a running module; a disabled module must be explicitly re-enabled (set_enabled(true)) rather than silently started by a restart, so these commands are rejected instead of re-enabling it.

Fields

module_id: String

ReloadFailed

Fields

module_id: String

reason: String

RegistrationStillActive

Fields

module_id: String

waited: Duration

StatePoisoned

Fields

module_id: Option<String>

CommandClosed

Fields

module_id: String

SwapInProgress

A restart or reload arrived while a swap’s candidate was warming. The swap owns the module until it cuts over or fails; a stop or disable would have aborted it instead.

Fields

module_id: String

SwapRefused

A swap was refused before anything was spawned.

Fields

module_id: String

reason: SwapRefusal

SwapFailed

A swap spawned a candidate and gave up on it. The candidate has been killed and its slot freed; the incumbent was left serving and was never drained, except in the one CutoverLost case described on that arm.

Fields

module_id: String

arm: SwapFailureArm

detail: String

candidate_exit: Option<ExitReport>

How the candidate exited, when it exited on its own before the supervisor gave up on it.

Trait Implementations

impl Debug for SuperviseError

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

Formats the value using the given formatter.

impl Display for SuperviseError

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

Formats the value using the given formatter.

impl Error for SuperviseError

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.