Enum LifecycleError 

pub enum LifecycleError {
    InvalidState {
        expected: String,
        current: String,
        message: String,
    },
    Destroyed(String),
    Released(String),
    NotReady,
    NotReadyForFork,
    VsockNotConnected,
    VsockUnavailable,
    Other(String),
}

Structured lifecycle error for microVM and pooled VM handles.

This error separates state-machine failures from backend failures so callers can distinguish invalid handle usage from guest or KVM execution problems.

Variants

InvalidState

The current lifecycle state does not permit the requested operation.

Fields

expected: String

Lifecycle state required by the operation.

current: String

Description of the current lifecycle state.

message: String

Stable user-facing error message.

Destroyed(String)

The sandbox has been destroyed and cannot be reused.

Tuple Fields

0: String

Destroyed-state failure message.

Released(String)

The VM handle was released back to its pool and cannot be used again.

Tuple Fields

0: String

Released-handle failure message.

NotReady

Snapshotting was requested while the VM was not ready.

NotReadyForFork

Forking was requested while the VM was not ready.

VsockNotConnected

The vsock command channel is required but not connected.

VsockUnavailable

The vsock command channel is not available for the requested operation.

Other(String)

Any lifecycle error that does not fit a more specific category.

Tuple Fields

0: String

Additional lifecycle failure detail.

Trait Implementations

impl Clone for LifecycleError

fn clone(&self) -> LifecycleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LifecycleError

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

Formats the value using the given formatter.

impl Display for LifecycleError

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

Formats the value using the given formatter.

impl Error for LifecycleError

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.