Enum MongrelError 

#[non_exhaustive]
pub enum MongrelError {
    Io(Error),
    DatabaseLocked {
        path: PathBuf,
        message: String,
    },
    DatabaseBusy {
        strong_handles: usize,
    },
    ForkedProcess {
        owner_pid: u32,
        current_pid: u32,
    },
    Serialization(Error),
    CorruptWal {
        offset: u64,
        reason: String,
    },
    TornWrite {
        offset: u64,
    },
    ChecksumMismatch {
        expected: u64,
        actual: u64,
        context: String,
    },
    MagicMismatch {
        what: &'static str,
        expected: [u8; 8],
        got: [u8; 8],
    },
    UnsupportedStorageVersion {
        component: &'static str,
        found: u16,
        supported: u16,
    },
    Schema(String),
    ColumnNotFound(String),
    EncryptionDisabled,
    Encryption(String),
    Decryption(String),
    EntropyUnavailable(String),
    NotFound(String),
    InvalidArgument(String),
    Full(String),
    Conflict(String),
    Deadlock {
        victim: u64,
        cycle: String,
    },
    SerializationFailure {
        message: String,
    },
    TriggerValidation(String),
    ReadOnlyReplica,
    AuthRequired,
    AuthNotRequired,
    InvalidCredentials {
        username: String,
    },
    PermissionDenied {
        required: Permission,
        principal: String,
    },
    DeadlineExceeded,
    WorkBudgetExceeded,
    ResourceLimitExceeded {
        resource: &'static str,
        requested: usize,
        limit: usize,
    },
    Cancelled,
    DurableCommit {
        epoch: u64,
        message: String,
    },
    CommitOutcomeUnknown {
        epoch: u64,
        message: String,
    },
    CursorStale(String),
    CursorExpired,
    Other(String),
}

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.

Io(Error)

DatabaseLocked

Fields

path: PathBuf

message: String

DatabaseBusy

Fields

strong_handles: usize

ForkedProcess

Fields

owner_pid: u32

current_pid: u32

Serialization(Error)

CorruptWal

Fields

offset: u64

reason: String

TornWrite

Fields

offset: u64

ChecksumMismatch

Fields

expected: u64

actual: u64

context: String

MagicMismatch

Fields

what: &'static str

expected: [u8; 8]

got: [u8; 8]

UnsupportedStorageVersion

Fields

component: &'static str

found: u16

supported: u16

Schema(String)

ColumnNotFound(String)

EncryptionDisabled

Encryption(String)

Decryption(String)

EntropyUnavailable(String)

NotFound(String)

InvalidArgument(String)

Full(String)

Conflict(String)

Deadlock

Fields

victim: u64

cycle: String

SerializationFailure

Fields

message: String

TriggerValidation(String)

ReadOnlyReplica

AuthRequired

AuthNotRequired

InvalidCredentials

Fields

username: String

PermissionDenied

Fields

required: Permission

principal: String

DeadlineExceeded

WorkBudgetExceeded

ResourceLimitExceeded

Fields

resource: &'static str

requested: usize

limit: usize

Cancelled

DurableCommit

Fields

epoch: u64

message: String

CommitOutcomeUnknown

Fields

epoch: u64

message: String

CursorStale(String)

CursorExpired

Other(String)

Implementations

impl MongrelError

pub fn category(&self) -> ErrorCategory

Maps this error onto the stable cross-language error taxonomy (spec section 9.7, FND-007).

The taxonomy is deliberately coarser than MongrelError: bindings and gateways only see the [ErrorCategory], while the full variant and message remain available in-process. The mapping is total; several single-node variants have no exact cluster counterpart, so non-obvious choices are documented at the arm.

Trait Implementations

impl Debug for MongrelError

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

Formats the value using the given formatter.

impl Display for MongrelError

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

Formats the value using the given formatter.

impl Error for MongrelError

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<Box<ErrorKind>> for MongrelError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MongrelError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JobError> for MongrelError

fn from(error: JobError) -> Self

Converts to this type from the input type.

impl From<LockError> for MongrelError

fn from(error: LockError) -> Self

Maps onto the matching MongrelError variant. A deadlock becomes MongrelError::Deadlock — victim and cycle preserved — so callers see the precise ErrorCategory::Deadlock with the same retry-the-whole-transaction discipline as Conflict.

impl From<SpillError> for MongrelError

fn from(error: SpillError) -> Self

Converts to this type from the input type.

impl From<StorageModeError> for MongrelError

fn from(error: StorageModeError) -> Self

Converts to this type from the input type.