Enum WarmSwapError 

pub enum WarmSwapError {
    NotWarm(Compatibility),
    Admission(String),
    Drain(String),
    Lease {
        op: &'static str,
        reason: String,
    },
    Stage(StageError),
    Resume(String),
    ResumeMismatch {
        resumed_from: String,
        expected: String,
    },
}

Why a warm swap was refused or could not complete.

Variants

NotWarm(Compatibility)

The release did not classify Compatibility::Warm, so it does not take the click-to-restart path. A hot change reloads with no restart, a cold change needs a coordinated redeploy, and an incompatible bundle was built for a runtime this binary cannot satisfy.

Admission(String)

Admission could not be closed, so new turns cannot be reliably stopped and the swap is abandoned before the lease is touched.

Drain(String)

The drain could not reach a committed checkpoint, so the swap is abandoned with the lease still held — nothing was released or swapped.

Lease

A lease operation failed — either releasing the lease before the swap or re-acquiring it after.

Fields

op: &'static str

Which lease operation failed: "release" or "re-acquire".

reason: String

The underlying failure.

Stage(StageError)

The stager could not verify or apply the binary swap. Wraps the underlying StageError — most importantly StageError::Unverified, which means the new binary’s signature did not verify and nothing was swapped.

Resume(String)

Resume could not restart the conversation from the checkpoint after the swap. The lease has already been re-acquired, so this is a resume failure on a live binary, not a lost lease.

ResumeMismatch

Resume restarted from a different turn than the one drained — a dropped or duplicated turn. Named separately from Self::Resume because it is a correctness violation, not a transport failure.

Fields

resumed_from: String

The turn resume actually restarted from.

expected: String

The checkpoint turn it should have restarted from.

Trait Implementations

impl Debug for WarmSwapError

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

Formats the value using the given formatter.

impl Display for WarmSwapError

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

Formats the value using the given formatter.

impl Error for WarmSwapError

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<StageError> for WarmSwapError

fn from(source: StageError) -> Self

Converts to this type from the input type.