Enum StorageError 

#[non_exhaustive]
pub enum StorageError {
    AlreadyExists,
    NotFound,
    Io {
        operation: &'static str,
        source: Error,
    },
    InvalidStore {
        message: String,
    },
    UnsupportedFormat {
        found: u32,
        expected: u32,
    },
    LogCorrupt {
        lsn: u64,
        reason: &'static str,
    },
    BaseGenerationMismatch {
        expected: u64,
        found: u64,
    },
}

Errors from the persistence layer: db files, the superblock, the base store format, and the delta log.

Performance

Formatting is O(message length).

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.

AlreadyExists

Db files already exist.

NotFound

Db files do not exist.

Io

Wraps an IO error with operation context.

Fields

operation: &'static str

Operation that failed.

source: Error

Underlying IO error.

InvalidStore

Storage bytes are invalid.

Fields

message: String

Deterministic validation message.

UnsupportedFormat

The store’s OXGDB format version is not supported by this build. A base written under an older format (for example one lacking the persisted SECTION_INDEX_* postings) is rejected here rather than silently rebuilt.

Fields

found: u32

Format version recorded in the store.

expected: u32

Format version this build requires.

LogCorrupt

A delta-log record is corrupt beyond the recoverable torn tail.

Fields

lsn: u64

Log sequence number of the offending record.

reason: &'static str

Deterministic reason the record was rejected.

BaseGenerationMismatch

A delta-log record names a different base generation than the superblock.

Fields

expected: u64

Base generation named by the superblock.

found: u64

Base generation found in the record.

Trait Implementations

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

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<StorageError> for DbError

fn from(error: StorageError) -> Self

Converts to this type from the input type.