Enum SlotFault 

pub enum SlotFault {
    PlanHalvesDisagree {
        dst_slots: usize,
        src_rows: usize,
    },
    SlotOutOfRange {
        slot: u32,
        slots: usize,
    },
    SlotWrittenTwice {
        slot: u32,
    },
    LayerOutOfRange {
        layer: u32,
        num_layers: usize,
    },
    RowMissing {
        bank: usize,
        layer: u32,
        row: u32,
    },
    RowSizeMismatch {
        bank: usize,
        layer: u32,
        row: u32,
        expected: usize,
        got: usize,
    },
    Residency(ResidencyError),
    Device {
        bank: usize,
        slot: u32,
        detail: String,
    },
    DeviceFlush {
        slots: Vec<u32>,
        detail: String,
    },
}

Why a plan was refused, or how applying it failed.

Variants

PlanHalvesDisagree

The two halves of a CopyPlan have different lengths, so pair i is not a pair. Applying it anyway would write row i into some other expert’s slot – silently wrong weights, the worst outcome available here.

Fields

dst_slots: usize

src_rows: usize

SlotOutOfRange

A plan named a slot the pool does not have. The planner and this pool were built with different cache_size values.

Fields

slot: u32

slots: usize

SlotWrittenTwice

One plan writes the same slot twice. The second write wins and the first expert is simply absent from the slot the plan promised it in, while the cache records both as resident.

Fields

slot: u32

LayerOutOfRange

A plan named a layer the pool was not built for.

Fields

layer: u32

num_layers: usize

RowMissing

The host bank has no such row.

Fields

bank: usize

layer: u32

row: u32

RowSizeMismatch

A host row is not exactly one slot wide – see the module docs on why a short row is worse than a missing one.

Fields

bank: usize

layer: u32

row: u32

expected: usize

got: usize

Residency(ResidencyError)

This layer’s host residency does not permit the copy the plan describes; see crate::residency::CopyRoute.

Device

The device refused a copy. slot has been marked unknown here and must be forgotten by the planner too.

Fields

bank: usize

slot: u32

detail: String

DeviceFlush

The device failed to complete a plan’s deferred copies.

Distinct from Device because no single slot is at fault: a backend that batches its copies cannot say which of them landed, so every slot the plan wrote is suspect. They are all marked unknown here and all named, so the planner can be told to forget the same set – forgetting only the last one would leave the rest reading back as resident.

Fields

slots: Vec<u32>

detail: String

Trait Implementations

impl Clone for SlotFault

fn clone(&self) -> SlotFault

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SlotFault

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

Formats the value using the given formatter.

impl Display for SlotFault

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

Formats the value using the given formatter.

impl Eq for SlotFault

impl Error for SlotFault

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<ResidencyError> for SlotFault

fn from(e: ResidencyError) -> Self

Converts to this type from the input type.

impl PartialEq for SlotFault

fn eq(&self, other: &SlotFault) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SlotFault