Struct FrameRegion 

pub struct FrameRegion { /* private fields */ }

Concurrent fixed-block region. Multi-producer alloc, multi-consumer free, any-order reclaim.

Implementations

impl FrameRegion

pub fn create_anon( block_size: usize, block_count: usize, ) -> Result<Self, RingError>

Anonymous in-process region.

pub fn create( path: impl AsRef<Path>, block_size: usize, block_count: usize, ) -> Result<Self, RingError>

File-backed region; cross-process via the page cache.

pub fn open( path: impl AsRef<Path>, block_size: usize, block_count: usize, ) -> Result<Self, RingError>

Open an existing file-backed region. Validates the header.

pub fn create_from_shm( shm: ShmFile, block_size: usize, block_count: usize, ) -> Result<Self, RingError>

Build a region on a named RAM-resident shared-memory backing.

pub fn open_from_shm( shm: ShmFile, block_size: usize, block_count: usize, ) -> Result<Self, RingError>

Open an existing named ShmFs-backed region (no re-init).

pub fn block_size(&self) -> usize

Largest payload a block holds.

pub fn block_count(&self) -> usize

Number of blocks.

pub fn alloc(&self) -> Option<u32>

Allocate a block. Free list first, then bump. None when full.

pub fn free(&self, idx: u32)

Return a block to the free list. Any consumer may free any block.

pub fn write_block(&self, idx: u32, payload: &[u8])

Copy payload into block idx. Caller guarantees payload.len() <= block_size.

pub fn read_block_into(&self, idx: u32, len: usize, out: &mut Vec<u8>)

Copy len bytes out of block idx into out (appended).

Trait Implementations

impl Send for FrameRegion

impl Sync for FrameRegion