Enum FormatActivationError 

pub enum FormatActivationError {
    NotLeader,
    TargetOutOfRange {
        target: u8,
        min: u8,
        max: u8,
    },
    MembersBelowTarget {
        target: u8,
        incapable: Vec<(u64, u8)>,
    },
    MemberUnreachable {
        node_id: u64,
        detail: String,
    },
    MembershipChangedSinceGate {
        target: u8,
    },
    ProposalFailed(String),
}

Why an operator-initiated format activation could not proceed past the gate.

Returned by StandaloneHost::initiate_format_activation. None of these are retryable in place by the caller without remediation: NotLeader means re-issue against the leader; MembersBelowTarget means upgrade or remove the named members and re-issue; MemberUnreachable means the cluster could not confirm a member’s capability and the gate fails closed rather than guess; TargetOutOfRange means re-issue with a target the local binary can actually read or upgrade the binary.

Variants

NotLeader

This node is not the raft leader, so it cannot drive an activation.

TargetOutOfRange

target is outside the local binary’s readable range [min, max]. The gate short-circuits here before any peer RPC: an out-of-range target is the same answer regardless of peer reports, and the operator gets a fast, unambiguous rejection. The same surface is used by the apply arm’s defense-in-depth — see ApplyOutcome::FormatActivationTargetOutOfRange.

Fields

target: u8

min: u8

max: u8

MembersBelowTarget

At least one current member cannot read target. incapable lists the offending (node_id, max_readable_version) pairs for the operator.

Fields

target: u8

incapable: Vec<(u64, u8)>

MemberUnreachable

A member could not be queried for its capabilities; the gate fails closed.

Fields

node_id: u64

detail: String

MembershipChangedSinceGate

The membership committed as of the bump’s own log position was no longer a subset of the set the gate observed — an un-gated member was added or promoted between the live gate query and the entry’s commit/apply, so the bump applied as a no-op. Re-gate and re-issue.

Fields

target: u8

ProposalFailed(String)

The proposal (raft.client_write) failed before / during commit — e.g. lost leadership, the cluster lost quorum, or a fatal raft error.

Trait Implementations

impl Debug for FormatActivationError

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

Formats the value using the given formatter.

impl Display for FormatActivationError

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

Formats the value using the given formatter.

impl Error for FormatActivationError

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.