Enum Error 

pub enum Error {
    InvalidSpec(String),
    NotFound(VmId),
    WrongState {
        id: VmId,
        state: VmState,
        expected: &'static str,
    },
    ForeignCheckpoint(CheckpointFormat),
    Driver {
        driver: &'static str,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Io(Error),
    Network(String),
    Unavailable(String),
    PreconditionFailed(String),
}

Errors raised by drivers, handles, and the guest-network port.

Variants

InvalidSpec(String)

A crate::VmSpec (or a piece of it) failed validation.

NotFound(VmId)

No VM with this id is known to the driver or network.

WrongState

The VM is in a state the operation cannot act on (dialing an exited VM, checkpointing one that already exited).

Fields

id: VmId

The VM.

state: VmState

Where it actually is.

expected: &'static str

What the operation needed, e.g. "running".

ForeignCheckpoint(CheckpointFormat)

A restore was asked of a checkpoint another driver (or another version of this one) wrote.

Driver

The adapter itself failed: process spawn, API call, file staging.

driver is the adapter’s crate::VmDriver::name; source carries the underlying error when there is one worth chaining.

Fields

driver: &'static str

The adapter that raised the error.

message: String

What failed, in the adapter’s words.

source: Option<Box<dyn Error + Send + Sync>>

The underlying error, if any.

Io(Error)

A host I/O failure surfaced unchanged.

Network(String)

The guest-network port refused or failed an operation.

Unavailable(String)

The operation cannot proceed yet, and retrying later is the remedy: a startup-cleanup gate still closed, a same-id cleanup the host has not finalized. Separate from Self::Network because a caller surfaces it as “unavailable, come back” rather than as a fault.

PreconditionFailed(String)

A precondition the caller presented does not hold — a cleanup token naming another generation, or naming one that no longer exists. Retrying the same call never helps; the caller needs a current token. Separate from Self::WrongState, which is about where a VM sits in its lifecycle.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.