Enum MicrosandboxError

pub enum MicrosandboxError {
    Io(Error),
    Custom(AnyError),
    OciDistribution(Error),
    HttpRequest(Error),
    HttpMiddleware(Error),
    Database(Error),
    ManifestNotFound,
    JoinError(JoinError),
    UnsupportedImageHashAlgorithm(String),
    ImageLayerDownloadFailed(String),
    InvalidPathPair(String),
    InvalidPortPair(String),
    InvalidEnvPair(String),
    InvalidMicroVMConfig(InvalidMicroVMConfigError),
    InvalidRLimitFormat(String),
    InvalidRLimitValue(String),
    InvalidRLimitResource(String),
    SerdeJson(Error),
    SerdeYaml(Error),
    Toml(Error),
    ConfigValidation(String),
    ConfigValidationErrors(Vec<String>),
    ServiceBelongsToNoGroup(String),
    ServiceBelongsToWrongGroup(String, String),
    FailedToGetShutdownEventFd(i32),
    FailedToShutdown(String),
    FailedToStartVM(i32),
    PathNotFound(String),
    RootFsPathNotFound(String),
    SupervisorBinaryNotFound(String),
    StartVmFailed(i32),
    ProcessWaitError(String),
    SupervisorError(String),
    ProcessKillError(String),
    ConfigMerge(String),
    NoAvailableIPs,
    WalkDir(Error),
    StripPrefix(StripPrefixError),
    NixError(Error),
    SystemTime(SystemTimeError),
    LayerExtraction(String),
    LayerHandling {
        source: Error,
        layer: String,
    },
    ConfigNotFound(String),
    RootfsNotFound(String),
    ImageReferenceError(String),
    ServiceStillRunning(String),
    InvalidArgument(String),
    PathValidation(String),
    MicrosandboxConfigNotFound(String),
    ConfigParseError(String),
    LogNotFound(String),
    PagerError(String),
    MicrosandboxUtilsError(MicrosandboxUtilsError),
    MigrationError(MigrateError),
    DockerRegistryResponseError(DockerRegistryResponseError),
    InvalidReferenceSelectorFormat(String),
    InvalidReferenceSelectorDigest(String),
    NotImplemented(String),
    SandboxNotFoundInConfig(String, PathBuf),
    InvalidLogLevel(u8),
    EmptyPathSegment,
    InvalidPathComponent(String),
    ScriptNotFoundInSandbox(String, String),
    SandboxServerError(String),
    InvalidNetworkScope(String),
    MissingStartOrExecOrShell,
    CommandExists(String),
    CommandNotFound(String),
}

An error that occurred during a file system operation.

Variants

Io(Error)

An I/O error.

Custom(AnyError)

An error that can represent any error.

OciDistribution(Error)

An error that occurred during an OCI distribution operation.

HttpRequest(Error)

An error that occurred during an HTTP request.

HttpMiddleware(Error)

An error that occurred during an HTTP middleware operation.

Database(Error)

An error that occurred during a database operation.

ManifestNotFound

An error that occurred when a manifest was not found.

JoinError(JoinError)

An error that occurred when a join handle returned an error.

UnsupportedImageHashAlgorithm(String)

An error that occurred when an unsupported image hash algorithm was used.

ImageLayerDownloadFailed(String)

An error that occurred when an image layer download failed.

InvalidPathPair(String)

An error that occurred when an invalid path pair was used.

InvalidPortPair(String)

An error that occurred when an invalid port pair was used.

InvalidEnvPair(String)

An error that occurred when an invalid environment variable pair was used.

InvalidMicroVMConfig(InvalidMicroVMConfigError)

An error that occurred when an invalid MicroVm configuration was used.

InvalidRLimitFormat(String)

An error that occurred when an invalid resource limit format was used.

InvalidRLimitValue(String)

An error that occurred when an invalid resource limit value was used.

InvalidRLimitResource(String)

An error that occurred when an invalid resource limit resource was used.

SerdeJson(Error)

An error that occurred when a Serde JSON error occurred.

SerdeYaml(Error)

An error that occurred when a Serde YAML error occurred.

Toml(Error)

An error that occurred when a TOML error occurred.

ConfigValidation(String)

An error that occurred when a configuration validation error occurred.

ConfigValidationErrors(Vec<String>)

An error that occurred when a configuration validation error occurred.

ServiceBelongsToNoGroup(String)

An error that occurs when trying to access group resources for a service that has no group

ServiceBelongsToWrongGroup(String, String)

An error that occurs when trying to access group resources for a service that belongs to a different group.

FailedToGetShutdownEventFd(i32)

An error that occurred when failed to get shutdown eventfd

FailedToShutdown(String)

An error that occurred when failed to write to shutdown eventfd

FailedToStartVM(i32)

An error that occurred when failed to start VM

PathNotFound(String)

An error that occurred when a path does not exist

RootFsPathNotFound(String)

An error that occurred when a rootfs path does not exist

SupervisorBinaryNotFound(String)

An error that occurred when the supervisor binary was not found

StartVmFailed(i32)

An error that occurred when failed to start VM

ProcessWaitError(String)

An error that occurred when waiting for a process to exit

SupervisorError(String)

An error that occurred running the supervisor.

ProcessKillError(String)

An error that occurred when failed to kill process

ConfigMerge(String)

An error that occurred when merging configurations

NoAvailableIPs

An error that occurred when no more IP addresses are available for assignment

WalkDir(Error)

An error that occurred during a walkdir operation

StripPrefix(StripPrefixError)

An error that occurred when stripping a path prefix

NixError(Error)

An error that occurred during a nix operation

SystemTime(SystemTimeError)

An error that occurred when converting system time

LayerExtraction(String)

An error that occurred during layer extraction. This typically happens when the join handle for the blocking task fails.

LayerHandling

An error that occurred during layer handling operations like opening files or unpacking archives. Contains both the underlying IO error and the path to the layer being processed.

Fields

source: Error

The underlying IO error that occurred

layer: String

The path to the layer being processed when the error occurred

ConfigNotFound(String)

An error that occurred when a configuration file was not found

RootfsNotFound(String)

Error when a service’s rootfs directory is not found

ImageReferenceError(String)

An error that occurred when parsing an image reference

ServiceStillRunning(String)

An error that occurred when trying to remove running services

InvalidArgument(String)

An error that occurred when invalid command line arguments were provided

PathValidation(String)

An error that occurred when validating paths

MicrosandboxConfigNotFound(String)

An error that occurred when the microsandbox config file was not found

ConfigParseError(String)

An error that occurred when failed to parse configuration file

LogNotFound(String)

An error that occurred when a log file was not found

PagerError(String)

An error that occurred when a pager error occurred

MicrosandboxUtilsError(MicrosandboxUtilsError)

An error from microsandbox-utils

MigrationError(MigrateError)

An error that occurred when a migration error occurred

DockerRegistryResponseError(DockerRegistryResponseError)

An error that occurred when a Docker registry response error occurred

InvalidReferenceSelectorFormat(String)

An error that occurred when parsing an image reference selector with an invalid format

InvalidReferenceSelectorDigest(String)

An error that occurred when parsing an invalid digest in an image reference selector

NotImplemented(String)

An error that occurred when a feature is not yet implemented

SandboxNotFoundInConfig(String, PathBuf)

An error that occurred when a sandbox was not found in the configuration

InvalidLogLevel(u8)

An error that occurs when an invalid log level is used.

EmptyPathSegment

Empty path segment

InvalidPathComponent(String)

Invalid path component (e.g. “.”, “..”, “/”)

ScriptNotFoundInSandbox(String, String)

Script not found in sandbox configuration

SandboxServerError(String)

An error that occurred running the sandbox server.

InvalidNetworkScope(String)

An error that occurred when an invalid network scope was used.

MissingStartOrExecOrShell

An error that occurred when a start script or exec command or shell is missing.

CommandExists(String)

An error that occurred when trying to install a script with the same name as an existing command.

CommandNotFound(String)

An error that occurred when a command was not found.

Implementations

impl MicrosandboxError

pub fn custom(error: impl Into<Error>) -> MicrosandboxError

Creates a new Err result.

Trait Implementations

impl Debug for MicrosandboxError

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

Formats the value using the given formatter.

impl Display for MicrosandboxError

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

Formats the value using the given formatter.

impl Error for MicrosandboxError

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<AnyError> for MicrosandboxError

fn from(source: AnyError) -> Self

Converts to this type from the input type.

impl From<DockerRegistryResponseError> for MicrosandboxError

fn from(source: DockerRegistryResponseError) -> Self

Converts to this type from the input type.

impl From<Errno> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MicrosandboxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for MicrosandboxError

fn from(source: JoinError) -> Self

Converts to this type from the input type.

impl From<MicrosandboxUtilsError> for MicrosandboxError

fn from(source: MicrosandboxUtilsError) -> Self

Converts to this type from the input type.

impl From<MigrateError> for MicrosandboxError

fn from(source: MigrateError) -> Self

Converts to this type from the input type.

impl From<StripPrefixError> for MicrosandboxError

fn from(source: StripPrefixError) -> Self

Converts to this type from the input type.

impl From<SystemTimeError> for MicrosandboxError

fn from(source: SystemTimeError) -> Self

Converts to this type from the input type.