Enum Error

pub enum Error {
    NotSourcePiece {
        mapping: GlobalObject,
    },
    PieceOffsetTooLarge {
        mapping: GlobalObject,
    },
    ObjectTooLarge {
        data_length: usize,
        max_object_len: usize,
        mapping: GlobalObject,
    },
    LengthPrefixTooLarge {
        length_prefix_len: usize,
        max_object_len: usize,
        mapping: GlobalObject,
    },
    InvalidDataHash {
        data_hash: Blake3Hash,
        data_length: usize,
        mapping: GlobalObject,
    },
    PieceGetterError {
        error: String,
        mapping: GlobalObject,
    },
    PieceNotFound {
        piece_index: PieceIndex,
    },
    PieceOffsetInSegmentHeader {
        mapping: GlobalObject,
    },
    SegmentDecoding {
        source: Error,
        segment_index: SegmentIndex,
        mapping: GlobalObject,
    },
    UnknownSegmentVariant {
        segment_variant: u8,
        segment_index: SegmentIndex,
        mapping: GlobalObject,
    },
    UnexpectedSegmentItem {
        segment_progress: usize,
        segment_index: SegmentIndex,
        segment_item: Box<SegmentItem>,
        mapping: GlobalObject,
    },
    UnexpectedSegmentItemVariant {
        segment_progress: usize,
        segment_index: SegmentIndex,
        segment_item_variant: u8,
        segment_item_lengths: Option<(usize, usize)>,
        mapping: GlobalObject,
    },
    InvalidObject {
        next_source_piece_index: PieceIndex,
        segment_data_length: Option<usize>,
        mapping: GlobalObject,
    },
    InvalidMapping {
        next_source_piece_index: PieceIndex,
        remaining_piece_count: usize,
        object_data_length: usize,
        mapping: GlobalObject,
    },
}

Object fetching errors.

Variants

NotSourcePiece

Supplied piece index is not a source piece

Fields

mapping: GlobalObject

PieceOffsetTooLarge

Supplied piece offset is too large

Fields

mapping: GlobalObject

ObjectTooLarge

Object is too large error

Fields

data_length: usize

max_object_len: usize

mapping: GlobalObject

LengthPrefixTooLarge

Length prefix is too large error

Fields

length_prefix_len: usize

max_object_len: usize

mapping: GlobalObject

InvalidDataHash

Hash doesn’t match data

Fields

data_hash: Blake3Hash

data_length: usize

mapping: GlobalObject

PieceGetterError

Piece getter error

Fields

error: String

The original anyhow::Error, debug-printed as a string. This allows us to check errors for equality in tests.

mapping: GlobalObject

PieceNotFound

Piece getter couldn’t find the piece

Fields

piece_index: PieceIndex

PieceOffsetInSegmentHeader

Supplied piece offset is inside the minimum segment header size

Fields

mapping: GlobalObject

SegmentDecoding

Segment decoding error

Fields

source: Error

segment_index: SegmentIndex

mapping: GlobalObject

UnknownSegmentVariant

Unknown segment variant error

Fields

segment_variant: u8

segment_index: SegmentIndex

mapping: GlobalObject

UnexpectedSegmentItem

Unexpected segment item error

Fields

segment_progress: usize

segment_index: SegmentIndex

segment_item: Box<SegmentItem>

mapping: GlobalObject

UnexpectedSegmentItemVariant

Unexpected segment item variant error

Fields

segment_progress: usize

segment_index: SegmentIndex

segment_item_variant: u8

segment_item_lengths: Option<(usize, usize)>

mapping: GlobalObject

InvalidObject

Object length couldn’t be decoded after downloading two pieces

Fields

next_source_piece_index: PieceIndex

The next source piece index after the first two pieces

segment_data_length: Option<usize>

The available object data in the current segment

mapping: GlobalObject

InvalidMapping

Object extends beyond block continuation, or the mapping is otherwise invalid

Fields

next_source_piece_index: PieceIndex

The next source piece index, before we attempted concurrent downloads

remaining_piece_count: usize

The number of pieces we concurrently downloaded

object_data_length: usize

The object data length, after the concurrent downloads

mapping: GlobalObject

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error