Struct RecyclePool 

pub struct RecyclePool { /* private fields */ }

A recycling buffer provider with fixed-size slots.

Holds a fixed set of equal-sized buffer addresses in a free list. Alloc and dealloc are O(1). It is intended for bounded scatter/gather descriptor segments that are pre-allocated and recycled after use: alloc_sg splits a logical payload into ceil(total_len / slot_size) fixed-size segments.

Implementations

impl RecyclePool

pub fn new( base_addr: u64, region_len: usize, slot_size: usize, ) -> Result<Self, AllocError>

Create a recycling pool of slot_size-byte slots over a fixed region.

The base address is aligned up to slot_size; the slot count is based on the remaining usable region after alignment.

pub fn restore_allocated(&self, allocated: &[u64]) -> Result<(), AllocError>

Rebuild pool state so that every address in allocated is removed from the free list, matching externally known inflight state.

pub fn slot_addr(&self, index: usize) -> Option<u64>

Compute the address of slot index.

Returns None if index >= count.

pub fn num_free(&self) -> usize

Number of free slots.

pub fn dealloc_addr(&self, addr: u64) -> Result<(), AllocError>

Free a previously allocated slot by address.

pub fn allocation_len(&self, addr: u64) -> Result<usize, AllocError>

Capacity of a live allocation by its start address.

pub fn base_addr(&self) -> u64

Base address of the pool region.

pub fn slot_size(&self) -> usize

Slot size in bytes.

pub fn count(&self) -> usize

Number of slots in the pool.

Trait Implementations

impl BufferProvider for RecyclePool

fn max_alloc_len(&self) -> usize

Preferred maximum size of one allocation segment.

fn alloc(&self, len: usize) -> Result<Allocation, AllocError>

Allocate one buffer that can hold at least len bytes.

fn dealloc(&self, addr: u64) -> Result<(), AllocError>

Free a previously allocated segment by start address.

fn reset(&self)

Reset the pool to initial state.

fn alloc_sg( &self, total_len: usize, ) -> Result<SmallVec<[Allocation; 4]>, AllocError>

Allocate scatter/gather segments for a logical payload of total_len bytes.

impl Clone for RecyclePool

fn clone(&self) -> RecyclePool

Returns a duplicate of the value.

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

Performs copy-assignment from source.