#[non_exhaustive]pub enum Error {
Show 13 variants
NotWritten {
cause: NotWrittenCause,
ctx: ErrorContext,
},
DurabilityUnknown {
op: Op,
raw: Option<OsError>,
ctx: ErrorContext,
},
Poisoned {
first: FirstCause,
},
NoSpace {
tag: ReserveTag,
ctx: ErrorContext,
},
Corruption {
kind: CorruptionKind,
ctx: ErrorContext,
},
UnsafeDevice {
reasons: BitSet<Reason>,
},
Unverified {
missing: BitSet<Missing>,
reasons: BitSet<Reason>,
},
Unsupported {
what: Capability,
},
Fenced {
stale: Generation,
},
Locked,
NotFound {
what: Named,
},
AlreadyExists {
what: Named,
},
Io {
op: Op,
raw: OsError,
ctx: ErrorContext,
},
}Expand description
Every error store-io returns.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
NotWritten
Rejected before reaching the device; the media is untouched. Fix the cause and retry.
DurabilityUnknown
Submitted and failed; the bytes may or may not be durable. The barrier domain is now poisoned. Reopen and run recovery.
Fields
ctx: ErrorContextWhere.
Poisoned
The barrier domain failed earlier; no write or barrier will succeed on it. Reads still work. Reopen and run recovery.
Fields
first: FirstCauseThe failure that poisoned the domain.
NoSpace
Reservation or provisioning ran out of space or quota. Nothing was written and nothing is poisoned.
Corruption
store-io’s own metadata or the media is damaged.
UnsafeDevice
The device or stack is known to drop or fake durability. Use another device, or override explicitly (every receipt is then labelled).
Unverified
The evidence is incomplete; durability cannot be confirmed. Attest the device or override explicitly.
Fields
Unsupported
The platform, filesystem or device does not support the operation.
Fields
what: CapabilityThe missing capability.
Fenced
The store was taken over by a newer owner. Never returned today: ownership is the operating system’s lock with the acquire barrier (D-049), which no newer owner passes while a handle holds the store, so no handle can be fenced; reserved until the 1.0 API freeze decides whether it stays.
Fields
stale: GenerationThis handle’s generation.
Locked
Another holder has the lock: a store held by another handle (in this or another process; a writer and a reader exclude each other), or a directory another handle or process is replacing in.
NotFound
The named store, region or slot does not exist.
AlreadyExists
The named store, region or slot already exists.
Io
A setup or metadata operation failed before any data I/O.
Trait Implementations§
impl Eq for Error
Source§impl Error for Error
impl Error for Error
1.30.0 · Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()