Enum InitError

pub enum InitError {
    Invalid,
    InvalidVersion,
    Io(Error),
    Corrupt,
    ShuttingDown,
    Unknown(Box<dyn Error + Send + Sync + 'static>),
}

Errors that occur during (Env::open).

Handling

As this is a database initialization error, the correct way to handle any of these occurring is probably just to exit the program.

There is not much we as Cuprate can do to recover from any of these errors.

Variants

Invalid

The given Path/File existed and was accessible, but was not a valid database file.

InvalidVersion

The given Path/File existed, was a valid database, but the version is incorrect.

Io(Error)

I/O error.

Corrupt

The given Path/File existed, was a valid database, but it is corrupt.

ShuttingDown

The database is currently in the process of shutting down and cannot respond.

Notes

This error can only occur with the heed backend when the database environment is opened right at the same time another thread/process is closing it.

This will never occur with other backends.

Unknown(Box<dyn Error + Send + Sync + 'static>)

An unknown error occurred.

This is for errors that cannot be recovered from, but we’d still like to panic gracefully.

Trait Implementations

impl Debug for InitError

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

Formats the value using the given formatter.

impl Display for InitError

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

Formats the value using the given formatter.

impl Error for InitError

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 InitError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for InitError

fn from(source: Error) -> Self

Converts to this type from the input type.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes

Size for each variant:

• Invalid: 0 bytes
• InvalidVersion: 0 bytes
• Io: 8 bytes
• Corrupt: 0 bytes
• ShuttingDown: 0 bytes
• Unknown: 16 bytes