Enum HostError 

#[non_exhaustive]
pub enum HostError {
    Locked {
        path: PathBuf,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    NeedsCheckpoint {
        path: PathBuf,
    },
    Engine(Error),
    Embed(String),
}

Every way the host layer can fail. Engine failures pass through as HostError::Engine; everything filesystem- or network-shaped is typed here.

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.

Locked

The database file is exclusively locked by another process (or another handle in this process). One file has one owner — open a different file, or drop the other handle.

Fields

path: PathBuf

The database base path.

Io

A filesystem operation failed.

Fields

path: PathBuf

The file the operation touched.

source: Error

The underlying error.

NeedsCheckpoint

A read-only open (crate::Database::open_readonly) found a non-empty journal. Replaying it would mutate the engine — copying whole arenas up from the mapped bytes (copy-on-write) — which defeats the zero-copy intent. Open the database read-write once to checkpoint it (fold the journal into the snapshot), then retry

Fields

path: PathBuf

The database base path.

Engine(Error)

The engine returned a typed error.

Embed(String)

The embedder transport or response was unusable (the message names what exactly: status, dimension mismatch, malformed JSON).

Trait Implementations

impl Debug for HostError

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

Formats the value using the given formatter.

impl Display for HostError

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

Formats the value using the given formatter.

impl Error for HostError

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 HostError

fn from(source: Error) -> Self

Converts to this type from the input type.