Enum SpillError 

pub enum SpillError {
    Io(Error),
    InvalidConfig(&'static str),
    BudgetExceeded {
        query_id: QueryId,
        requested: u64,
        query_remaining: u64,
        global_remaining: u64,
    },
    FrameTooLarge {
        bytes: u64,
        limit: u64,
    },
    ChecksumMismatch {
        context: String,
        expected: u32,
        actual: u32,
    },
    Corrupt(String),
    EncryptionRequired,
    EncryptionDisabled,
    Encryption(String),
    Decryption(String),
}

Errors of spill configuration, I/O, budget enforcement, and verification.

Variants

Io(Error)

Filesystem failure on the spill tree.

InvalidConfig(&'static str)

The SpillConfig failed validation.

BudgetExceeded

A frame append would exceed the per-query or the node-global spill budget (S1E-004 “bounded”).

Fields

query_id: QueryId

The query that hit its bound.

requested: u64

Bytes the frame needed.

query_remaining: u64

Per-query budget remaining before the attempt.

global_remaining: u64

Node-global budget remaining before the attempt.

FrameTooLarge

One frame’s plaintext payload exceeded [MAX_FRAME_PAYLOAD].

Fields

bytes: u64

Attempted payload size.

limit: u64

Configured bound.

ChecksumMismatch

A frame’s stored CRC32C did not match its bytes.

Fields

context: String

Which frame/file failed verification.

expected: u32

Stored checksum.

actual: u32

Computed checksum.

Corrupt(String)

Structural corruption: bad magic, version, framing, sequence gap, or a trailer that does not match the streamed frames. Always fail-closed.

EncryptionRequired

An encrypted spill file was opened by a manager without a meta DEK.

EncryptionDisabled

A meta DEK was configured but the encryption feature is disabled.

Encryption(String)

Sealing a frame failed.

Decryption(String)

Opening a sealed frame failed (wrong key or tampering).

Trait Implementations

impl Debug for SpillError

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

Formats the value using the given formatter.

impl Display for SpillError

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

Formats the value using the given formatter.

impl Error for SpillError

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 SpillError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SpillError> for MongrelError

fn from(error: SpillError) -> Self

Converts to this type from the input type.