Struct SharedHandler 

pub struct SharedHandler { /* private fields */ }

A lightweight reflection of the original handler that can be safely sent across threads.

Produced by MatrixHandler::share(). Holds raw pointers into the SHM segment. The originating MatrixHandler must outlive all SharedHandler instances derived from it.

SharedHandler exposes the same allocation, I/O, lifecycle, and escape hatch API as MatrixHandler via the HandlerFunctions trait — it does not own the mmap.

Trait Implementations

impl HandlerFunctions for SharedHandler

fn base_ptr(&self) -> *const u8

Returns the SHM base pointer for this process’s mapping.

fn matrix(&self) -> &AtomicMatrix

Returns a reference to the underlying AtomicMatrix.

fn first_block_offset(&self) -> u32

Returns the offset of the first data block in the segment. Used by internals iterators as the physical chain walk start point.

fn segment_size(&self) -> u32

Returns the total segment size in bytes.

fn allocate<T>(&self) -> Result<Block<T>, HandlerError>

Allocates a block sized to hold T.

fn allocate_raw(&self, size: u32) -> Result<RelativePtr<u8>, HandlerError>

Allocates a raw byte block of the given size.

unsafe fn write<T>(&self, block: &mut Block<T>, value: T)

Writes a value of type T into an allocated block.

unsafe fn read<'a, T>(&self, block: &Block<T>) -> &'a T

Reads a shared reference to T from an allocated block.

unsafe fn read_mut<'a, T>(&self, block: &Block<T>) -> &'a mut T

Reads a mutable reference to T from an allocated block.

fn free<T>(&self, block: Block<T>)

Frees a typed block.

fn free_at(&self, header_offset: u32)

Frees a block by its header offset directly.

fn set_state<T>(&self, block: &Block<T>, state: u32) -> Result<(), HandlerError>

Sets a user-defined lifecycle state on a block.

fn get_state<T>(&self, block: &Block<T>, order: Ordering) -> u32

Returns the current state of a block.

fn transition_state<T>( &self, block: &Block<T>, expected: u32, next: u32, success_order: Ordering, ) -> Result<u32, HandlerError>

Atomically transitions a block from one state to another.

fn raw_matrix(&self) -> &AtomicMatrix

Returns a raw reference to the underlying AtomicMatrix.

fn raw_base_ptr(&self) -> *const u8

Returns the raw SHM base pointer for this process’s mapping.

impl Send for SharedHandler

impl Sync for SharedHandler