Struct SpanMeta 

pub struct SpanMeta {
    pub class: u8,
    pub live: u16,
    pub high_water: u16,
    pub discarded: u16,
    /* private fields */
}

Per-span bookkeeping. Deliberately not small: the bitmap is the price of page-granular reclaim, and it lives in the header span, which exists to be spent on exactly this.

Fields

class: u8

Size class this span serves, or NO_CLASS.

live: u16

Slots handed out and not yet freed.

high_water: u16

Slots at or above this index have never been handed out; their pages were never touched and are not resident.

discarded: u16

Pages returned to the OS (MADV_DONTNEED) while the span stays assigned. Cleared per page when an allocation lands back in one.

Implementations

impl SpanMeta

pub fn reset(&mut self, class: u8)

Assign this span to a class, forgetting everything it held. Only legal when nothing in it is live.

pub fn capacity(&self) -> u32

Slots this span can hold, given its class.

pub fn alloc_slot(&mut self) -> Option<u32>

Take the lowest free slot, or None when the span is full.

pub fn claim_word(&mut self) -> Option<(u8, u64)>

Claim every free bit of the lowest holed word for local handout: the bits are marked live in the bitmap (a claimed bit pins its pages exactly as a live slot does, which is what makes the claim invisible to reclaim), and the caller hands them out from its own copy without touching this header again. Returns (word_index, claimed_mask), or None when the span is full.

The far-line arithmetic this exists for: one header round-trip claims up to 64 slots, so the per-allocation touch that profiled at 17.3% of collection-write self time amortizes 64:1. Position-awareness coarsens from bit to word — the claim still takes the LOWEST holed word, so densification’s lowest-first semantics survive at word granularity.

pub fn retire_word(&mut self, w: u8, unused: u64)

Return the bits of a claimed word that were never handed out (or were handed out and locally freed). The exact inverse of the claim’s marking; the hint walks back so lowest-first allocation sees the holes again.

pub fn free_slot(&mut self, i: u32)

Mark slot i free.

pub fn is_live(&self, i: u32) -> bool

Whether slot i is live (or parked foreign, which pins pages identically).

pub fn range_has_live(&self, first: u32, last: u32) -> bool

Whether any slot in first..=last is live.

Trait Implementations

impl Clone for SpanMeta

fn clone(&self) -> SpanMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SpanMeta