Enum StoreError 

pub enum StoreError {
    Io(Error),
    CasFailed {
        expected: Option<Vec<u8>>,
        actual: Option<Vec<u8>>,
    },
    CorruptBlob(BlobId),
    MissingBlob(BlobId),
    MissingEncryptionKey(u32),
    BlobIdMismatch {
        expected: BlobId,
        actual: BlobId,
    },
    Encryption(CryptError),
    Keyring(KeyError),
    EncryptedWithoutKey {
        db: String,
        kek: String,
    },
    InvalidKeyManifest(String),
    UnsupportedKeyManifest {
        found: u32,
        supported: u32,
    },
    UnsupportedKeyAlgorithm(String),
    StorageEpochExhausted,
    InvalidRootName(String),
    BlockingTask(String),
    UnreachableLocalStorage(PathBuf),
}

Errors raised by store implementations.

Variants

Io(Error)

I/O failure.

CasFailed

Root compare-and-swap failed because the current fence differed.

Fields

expected: Option<Vec<u8>>

Expected root bytes supplied by the caller.

actual: Option<Vec<u8>>

Actual root bytes currently stored.

CorruptBlob(BlobId)

Blob digest did not match its content.

MissingBlob(BlobId)

A live graph references a blob that is not present.

MissingEncryptionKey(u32)

An encrypted blob references a key epoch that is not configured.

BlobIdMismatch

A wrapped backend returned an id other than the digest of stored bytes.

Fields

expected: BlobId

Digest of the bytes supplied to the backend.

actual: BlobId

Identifier returned by the backend.

Encryption(CryptError)

Encryption, authentication, or encrypted-format failure.

Keyring(KeyError)

A key could not be resolved, wrapped, or unwrapped.

EncryptedWithoutKey

The database is encrypted and this process holds no keyring.

Fields

db: String

Database whose key manifest was found.

kek: String

Key-encryption key the manifest names.

InvalidKeyManifest(String)

The key manifest is malformed.

UnsupportedKeyManifest

The key manifest was written by a newer release.

Fields

found: u32

Format version found in the stored manifest.

supported: u32

Newest format version this release understands.

UnsupportedKeyAlgorithm(String)

The key manifest names an AEAD suite this release does not implement.

StorageEpochExhausted

Storage-key epochs are exhausted.

InvalidRootName(String)

Root name cannot be safely represented on the filesystem.

BlockingTask(String)

A blocking store worker failed before returning its result.

UnreachableLocalStorage(PathBuf)

A local path advertised by a transactor is not reachable from this process. Direct-storage peers must be co-located with local backends.

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.

impl From<CryptError> for StoreError

fn from(source: CryptError) -> Self

Converts to this type from the input type.

impl From<Error> for StoreError

fn from(source: Error) -> Self

Converts to this type from the input type.