Enum SnapshotError 

#[non_exhaustive]
pub enum SnapshotError {
    Concurrent(AgentId),
    UnknownAgent(AgentId),
    CrossTenant,
    ChecksumMismatch,
    SchemaTooNew {
        bundle: u32,
        runtime: u32,
    },
    MissingArtifact(String),
    RestoreRefused(String),
    Encryption(String),
    Retention(String),
    NotFound(SnapshotId),
    Io(Error),
    Git(Error),
    SerdeJson(Error),
    Sqlx(Error),
}

Failure modes surfaced by every public method on crate::snapshotter::MemorySnapshotter. Each variant maps to a stable CLI exit code + Prometheus outcome label so operators and tests can branch on the failure class without parsing strings.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Concurrent(AgentId)

Another snapshot is already being captured for this agent. Holders release the lock on completion or after the configured timeout.

UnknownAgent(AgentId)

The agent id has no on-disk state under this tenant root.

CrossTenant

A bundle path resolved outside its tenant root. Always a programming error or a hostile bundle name; never a transient failure.

ChecksumMismatch

Either the manifest’s whole-bundle hash or one of the per-artifact hashes did not match the recomputed value.

SchemaTooNew

Bundle’s manifest_version is newer than this binary supports. Operators must upgrade the runtime; older bundles are accepted because the codec is forwards-compatible.

Fields

bundle: u32

runtime: u32

MissingArtifact(String)

A required artifact named in the manifest is missing from the bundle body.

RestoreRefused(String)

Restore preconditions failed (e.g. workers refused to pause, pre-snapshot failed, target dir not empty without --force).

Encryption(String)

Encryption layer failed (key rejected, ciphertext malformed, snapshot-encryption feature off when bundle is age-wrapped).

Retention(String)

Retention sweep refused to delete (e.g. keep_count would drop below 1, or restore-in-progress on the candidate).

NotFound(SnapshotId)

A snapshot id exists in the manifest layout but the file under the tenant root is gone.

Io(Error)

Git(Error)

SerdeJson(Error)

Sqlx(Error)

Trait Implementations

impl Debug for SnapshotError

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

Formats the value using the given formatter.

impl Display for SnapshotError

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

Formats the value using the given formatter.

impl Error for SnapshotError

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 SnapshotError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SnapshotError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SnapshotError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SnapshotError

fn from(source: Error) -> Self

Converts to this type from the input type.