Struct UsmSuballocator 

pub struct UsmSuballocator { /* private fields */ }

First-fit free-list sub-allocator over a single USM block.

Mirrors the device-memory-allocator pattern: tracks free spans, splits on allocation, coalesces adjacent spans on free, and honours arbitrary power-of-two alignment (accounting for the introduced leading padding).

The UsmKind is carried so a backend can keep separate suballocators per memory flavour and never mix host and device offsets.

Implementations

impl UsmSuballocator

pub fn new(kind: UsmKind, block_size: u64) -> LevelZeroResult<Self>

Create a suballocator managing block_size bytes of kind memory.

pub fn kind(&self) -> UsmKind

The USM flavour this suballocator manages.

pub fn block_size(&self) -> u64

Total managed size in bytes.

pub fn free_bytes(&self) -> u64

Sum of all currently-free bytes (possibly fragmented).

pub fn largest_free_span(&self) -> u64

The largest single contiguous free span.

pub fn live_count(&self) -> usize

Number of live allocations.

pub fn alloc( &mut self, size: u64, alignment: u64, ) -> LevelZeroResult<UsmSubAllocation>

Allocate size bytes aligned to alignment (a power of two).

pub fn alloc_default(&mut self, size: u64) -> LevelZeroResult<UsmSubAllocation>

Allocate size bytes using the default USM alignment.

pub fn free(&mut self, offset: u64) -> LevelZeroResult<()>

Free a previously-returned allocation by its offset.

Trait Implementations

impl Debug for UsmSuballocator

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

Formats the value using the given formatter.