Enum StoreError 

#[non_exhaustive]
pub enum StoreError {
    Index {
        path: String,
        message: String,
    },
    Io {
        action: &'static str,
        path: String,
        message: String,
    },
    UnknownImage {
        reference: String,
        known: String,
    },
    LiveBoxes {
        boxes: usize,
    },
    UnrecognisedEntry {
        entry: String,
    },
    BaseOutsideStore {
        path: String,
        root: String,
    },
}

What went wrong, in terms of what to do about it.

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.

Index

The index could not be read. Without it nothing in the store has a name, so neither verb can proceed — see this module’s documentation.

Fields

path: String

The database that could not be read.

message: String

What the database layer said.

Io

A filesystem operation failed.

Fields

action: &'static str

What was being attempted, as a verb phrase.

path: String

The path it was attempted on.

message: String

What the operating system said.

UnknownImage

A per-image request named an image the store is not holding.

Carries what it is holding, because the likely cause is a tag written where the index has a digest reference, and a listing is the way forward.

Fields

reference: String

What was asked for.

known: String

The references the index does have, comma-separated.

LiveBoxes

A box is registered in the store, so something may be using these bytes.

boxlite takes an exclusive flock on <store>/.lock for the lifetime of a runtime, which this crate cannot take back: unsafe_code = "forbid" rules out the libc::flock call that acquires it. So the guard is the evidence a lock would have protected — a registered box — and it is checked rather than assumed absent.

Fields

boxes: usize

How many boxes are registered.

UnrecognisedEntry

Something under the store root that this module does not recognise.

ADR-0014 v1.6’s limit, enforced rather than trusted: clear may drop what a pinned digest re-obtains and may drop nothing else, and an unknown entry is not known to be re-obtainable.

Fields

entry: String

The entry’s name under the store root.

BaseOutsideStore

A base_disk row points outside the store root.

base_path is an absolute path recorded when the base was built, so it is data rather than a derivation, and data can name anywhere. This is the check that a row cannot aim deletion at a path outside the asset cache.

Fields

path: String

Where the row pointed.

root: String

The root it had to be under.

Trait Implementations

impl Debug for StoreError

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

Formats the value using the given formatter.

impl Display for StoreError

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

Formats the value using the given formatter.

impl Error for StoreError

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.