Enum SwimError 

pub enum SwimError {
    UnknownMember {
        node_id: NodeId,
    },
    StaleIncarnation {
        node_id: NodeId,
        received: Incarnation,
        local: Incarnation,
    },
    SelfSuspected {
        incarnation: Incarnation,
    },
    InvalidTransition {
        from: MemberState,
        to: MemberState,
    },
    InvalidConfig {
        field: &'static str,
        reason: &'static str,
    },
    Encode {
        detail: String,
    },
    Decode {
        detail: String,
    },
    TransportClosed,
    ProbeInflightOverflow,
}

Errors produced by the SWIM failure detector and membership layer.

Variants

UnknownMember

A message or update referenced a node id not present in the membership list. This is non-fatal — the detector will request a full sync from the sender.

Fields

node_id: NodeId

StaleIncarnation

Received update carries an incarnation strictly older than the locally recorded value, so the update is refuted.

Fields

node_id: NodeId

received: Incarnation

local: Incarnation

SelfSuspected

Received a Suspect update targeting the local node. The failure detector must bump its own incarnation and broadcast an Alive refutation. Callers treat this as a signal, not a fatal error.

Fields

incarnation: Incarnation

InvalidTransition

A state transition violated the SWIM state machine (e.g. attempting to move a Left member back to Alive). Always a bug.

Fields

from: MemberState

to: MemberState

InvalidConfig

Configuration validation failed. Returned by super::SwimConfig::validate.

Fields

field: &'static str

reason: &'static str

Encode

zerompk failed to serialize a SwimMessage. In practice this is infallible for the current message schema — the variant exists so future additions to the wire format cannot silently panic.

Fields

detail: String

Decode

zerompk failed to parse incoming bytes as a SwimMessage. Common causes: truncated datagram, version skew, random UDP noise.

Fields

detail: String

TransportClosed

Transport backend has been closed; no further I/O is possible. Returned by super::detector::Transport::recv on shutdown.

ProbeInflightOverflow

The in-flight probe map is full. Should never happen in practice — the detector caps concurrent probes at a few tens — but the error exists so a runaway bug cannot corrupt the detector state.

Trait Implementations

impl Debug for SwimError

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

Formats the value using the given formatter.

impl Display for SwimError

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

Formats the value using the given formatter.

impl Error for SwimError

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.

impl From<SwimError> for ClusterError

fn from(err: SwimError) -> Self

Converts to this type from the input type.