Enum ContainerError 

pub enum ContainerError {
    EngineUnavailable {
        detail: String,
    },
    NoSuchContainer {
        name: String,
    },
    NotRunning {
        id: String,
    },
    StaleIdentity {
        name: String,
        expected: String,
        found: String,
    },
    NoSuchPath {
        id: String,
        path: String,
    },
    CapabilityRefused {
        what: String,
    },
    PoisonedName {
        name: String,
    },
    OutputTooLarge {
        what: String,
    },
    Protocol {
        detail: String,
    },
    Cancelled,
    Io {
        detail: String,
    },
}

Why a container operation did not produce a result.

Variants

EngineUnavailable

The local engine cannot be reached: the CLI is missing, the daemon is down, or the probe timed out. Retrying later is meaningful.

Fields

detail: String

NoSuchContainer

The name or id resolved to nothing on the engine.

Fields

name: String

NotRunning

The container exists but is not running; attach semantics require a running container even though the engine could read stopped ones.

Fields

id: String

StaleIdentity

A previously resolved identity no longer matches the engine: the name now maps to a different container, or the same container id restarted (a new StartedAt incarnation). Old reads, caches and completions must not attach to the new incarnation.

Fields

name: String

expected: String

found: String

NoSuchPath

A path inside the container does not exist.

Fields

id: String

path: String

CapabilityRefused

The operation is outside this crate’s read-only capability boundary (writes, arbitrary exec, reading a directory as a file). This is a policy answer, not a failure to be retried.

Fields

what: String

PoisonedName

A user-supplied name/id could inject CLI options or otherwise cannot be a Docker name or id prefix. Refused before the engine ever sees it.

Fields

name: String

OutputTooLarge

Bounded capture overflowed: the engine had more to say than the retention limit. A partial listing is never presented as complete.

Fields

what: String

Protocol

The engine answered but not in the shape its CLI contract promises (non-canonical id, malformed JSON, malformed tar).

Fields

detail: String

Cancelled

The caller’s cancellation token fired.

Io

Anything else the supervised subprocess reported: non-zero exit, deadline, pipe failure. The detail carries a bounded stderr tail.

Fields

detail: String

Trait Implementations

impl Clone for ContainerError

fn clone(&self) -> ContainerError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContainerError

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

Formats the value using the given formatter.

impl Display for ContainerError

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

Formats the value using the given formatter.

impl Eq for ContainerError

impl Error for ContainerError

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 PartialEq for ContainerError

fn eq(&self, other: &ContainerError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ContainerError