Enum ChunkLensError 

pub enum ChunkLensError {
    ChunkCountTooLarge {
        chunk_count: usize,
    },
    AllocationFailed {
        chunk_count: usize,
        bytes: usize,
    },
    EmptyPage {
        offset: u64,
    },
    PageTooLarge {
        entries: usize,
    },
    MisalignedOffset {
        offset: u64,
    },
    OffsetOutOfRange {
        offset: u64,
        chunk_count: usize,
    },
    PageExtendsPastEnd {
        offset: u64,
        entries: usize,
        chunk_count: usize,
    },
    UnexpectedPageLength {
        offset: u64,
        entries: usize,
        expected: usize,
    },
    DuplicatePage {
        offset: u64,
    },
    Incomplete {
        have: usize,
        want: usize,
    },
}

Why a ChunkLensAssembler refused a page, or refused to yield an array.

Each variant is ONE rejection with its own name. That is deliberate: a guard justified by a single attacker behaviour (“a liar sends a short page”) is bypassed by the next variant of it — a middle page rather than a last one, a repeated page rather than a missing one, an offset off by one rather than wildly wrong. Naming each member of the class separately is what lets a consumer report, and a test pin, the specific rule that was broken instead of a generic “bad prologue”.

Variants

ChunkCountTooLarge

The declared chunk_count exceeds MAX_RESOURCE_CHUNK_COUNT. Refused BEFORE allocating.

Fields

chunk_count: usize

The count the sender declared.

AllocationFailed

The array for a legal chunk_count could not be allocated on this host. A resource ceiling is not a memory guarantee, so the reservation is fallible and its failure is an error rather than an abort.

Fields

chunk_count: usize

The count that could not be reserved.

bytes: usize

The reservation size in bytes.

EmptyPage

A page carrying no entries. It fills nothing, so accepting it would let a sender stream frames indefinitely without ever completing the prologue.

Fields

offset: u64

The offset the empty page claimed.

PageTooLarge

A page carrying more than MAX_CHUNK_LENS_PER_FRAME entries — a wire-constant violation, independent of where the page claims to sit.

Fields

entries: usize

The page’s entry count.

MisalignedOffset

A chunk_lens_offset that is not a multiple of MAX_CHUNK_LENS_PER_FRAME. Pages are placed by page index, so a misaligned page would straddle two slots and make occupancy unanswerable.

Fields

offset: u64

The offset the page claimed.

OffsetOutOfRange

A chunk_lens_offset at or beyond the declared chunk_count — there is no such entry to fill.

Fields

offset: u64

The offset the page claimed.

chunk_count: usize

The declared total entry count.

PageExtendsPastEnd

A page whose extent runs past the end of the array — an aligned offset is not sufficient, since a full page at the LAST page’s offset covers entries that do not exist.

Fields

offset: u64

The offset the page claimed.

entries: usize

The page’s entry count.

chunk_count: usize

The declared total entry count.

UnexpectedPageLength

A page that is neither full nor the tail. Pages must tile the array exactly, so a short non-final page leaves a gap that no page-aligned page can ever fill; it is refused on arrival rather than surfacing later as an unexplained incompleteness.

Fields

offset: u64

The offset the page claimed.

entries: usize

The page’s entry count.

expected: usize

The entry count this page slot requires.

DuplicatePage

A page for a slot that is already filled. A duplicate or overlapping page is a REJECT, never an overwrite — otherwise the LAST sender of a page decides its contents.

Fields

offset: u64

The offset of the already-filled slot.

Incomplete

The prologue ended short of chunk_count, so there is no array to yield.

Fields

have: usize

Entries actually accumulated.

want: usize

Entries the declared chunk_count requires.

Trait Implementations

impl Clone for ChunkLensError

fn clone(&self) -> ChunkLensError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ChunkLensError

impl Debug for ChunkLensError

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

Formats the value using the given formatter.

impl Display for ChunkLensError

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

Formats the value using the given formatter.

impl Eq for ChunkLensError

impl Error for ChunkLensError

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 ChunkLensError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ChunkLensError