Struct SwimConfig 

pub struct SwimConfig {
    pub probe_interval: Duration,
    pub probe_timeout: Duration,
    pub indirect_probes: u8,
    pub suspicion_mult: u8,
    pub min_suspicion: Duration,
    pub initial_incarnation: Incarnation,
    pub max_piggyback: usize,
    pub fanout_lambda: u32,
}

Configuration for the SWIM failure detector.

All fields are validated at construction time via SwimConfig::validate; an invalid config is a programmer error and returns a typed SwimError::InvalidConfig rather than panicking.

Fields

probe_interval: Duration

Time between probe rounds (T’ in the SWIM paper). One randomly-chosen alive peer is pinged per interval.

probe_timeout: Duration

Round-trip deadline for a direct ping before falling back to k indirect pings. Must be strictly less than probe_interval.

indirect_probes: u8

Number of indirect probe helpers (k in the paper).

suspicion_mult: u8

Multiplier on probe_interval used to compute the suspicion timeout before a Suspect member is declared Dead. Lifeguard §3.1.

min_suspicion: Duration

Minimum value for the suspicion timeout; protects small clusters from sub-second suspicion windows. The effective timeout is max(min_suspicion, suspicion_mult * log2(n) * probe_interval).

initial_incarnation: Incarnation

Seed incarnation for a freshly-booted local node. Always 0 in production; exposed for deterministic unit tests.

max_piggyback: usize

Maximum number of membership deltas to piggyback on a single outgoing SWIM datagram. Caps per-message bandwidth and bounds the encoded payload size below a UDP MTU.

fanout_lambda: u32

Gossip fanout multiplier (lambda in Das §4.3). The dissemination queue drops a rumour after it has been carried on ceil(fanout_lambda * log2(n+1)) outgoing messages, which with high probability reaches every member.

Implementations

impl SwimConfig

pub fn production() -> Self

Production defaults from Lifeguard, tuned for a ≤ 256-node cluster.

pub fn validate(&self) -> Result<(), SwimError>

Validate the configuration. Returns InvalidConfig if any invariant fails. Callers should treat validation failure as a fatal startup error — SWIM cannot run with incoherent timing parameters.

Trait Implementations

impl Clone for SwimConfig

fn clone(&self) -> SwimConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SwimConfig

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

Formats the value using the given formatter.

impl Default for SwimConfig

fn default() -> Self

Returns the “default value” for a type.