Enum VmRuntimeError 

pub enum VmRuntimeError {
    VmAlreadyExists(String),
    VmNotFound(String),
    InvalidTransition {
        vm_id: String,
        from: String,
        to: &'static str,
    },
    SnapshotAlreadyExists {
        vm_id: String,
        snapshot_id: String,
    },
    SnapshotNotFound {
        vm_id: String,
        snapshot_id: String,
    },
    StatePoisoned,
    Unsupported(String),
    Metrics(String),
    Shutdown(String),
    Firewall(String),
    Jailer(String),
    NetworkConfig(String),
    NetworkSetup(String),
    Rootfs(String),
    Uffd(String),
    GuestMetadata(String),
}

Errors that can occur during microVM lifecycle or query operations.

Variants

VmAlreadyExists(String)

Attempted to create a VM with an identifier that is already in use.

VmNotFound(String)

Referenced a VM identifier that does not exist.

InvalidTransition

A lifecycle transition was requested that is not valid from the current state.

Fields

vm_id: String

from: String

to: &'static str

SnapshotAlreadyExists

Attempted to create a snapshot with an identifier that already exists on the VM.

Fields

vm_id: String

snapshot_id: String

SnapshotNotFound

Attempted to restore from a snapshot that does not exist on disk.

Fields

vm_id: String

snapshot_id: String

StatePoisoned

Internal lock was poisoned by a panicking thread.

Unsupported(String)

Backend is not supported in the current build/config.

Metrics(String)

Metrics poller failed to open, parse, or read the FC metrics FIFO.

Shutdown(String)

Graceful shutdown of a child process failed (signal delivery, wait, or escalation step).

Firewall(String)

Host egress firewall (iptables) setup or teardown failed, or input validation rejected a rule before any iptables call was made.

Jailer(String)

Jailer chroot preparation, command construction, or teardown failed.

NetworkConfig(String)

Network configuration is malformed (bad CIDR, prefix out of range, etc).

NetworkSetup(String)

Host network setup or teardown failed (bridge/NAT/forward/TAP).

Rootfs(String)

Rootfs catalog discovery, per-VM clone, or SHA-256 integrity check failed (missing template, stamp mismatch, hash mismatch, I/O error).

Uffd(String)

Userfaultfd page-fault handler failed to bind, hand-shake, or service page faults. The variant is intentionally a free-form message because the failure modes range from libc errno values to JSON parse errors on the region-mapping payload Firecracker sends with the fd.

GuestMetadata(String)

Communication with the in-guest metadata daemon failed (UDS connect, Firecracker CONNECT handshake, JSON encode/decode, request timeout, or guest-reported failure).

Trait Implementations

impl Debug for VmRuntimeError

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

Formats the value using the given formatter.

impl Display for VmRuntimeError

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

Formats the value using the given formatter.

impl Error for VmRuntimeError

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.