Struct ResidentQueueBuffers 

pub struct ResidentQueueBuffers { /* private fields */ }

Host-side mirror of the four buffers kept resident by the persistent megakernel runtime: control, ring, debug log, and IO queue.

Implementations

impl ResidentQueueBuffers

pub fn new( slot_count: u32, tenant_count: u32, observable_slots: u32, ) -> Result<Self, PipelineError>

Allocate a fresh host mirror for a megakernel’s resident buffers.

Errors

Returns PipelineError when any runtime buffer size overflows.

pub fn reset( &mut self, tenant_count: u32, observable_slots: u32, ) -> Result<(), PipelineError>

Reinitialize this host mirror in place for the same resident geometry.

Errors

Returns PipelineError when any runtime buffer size overflows.

pub fn from_parts( slot_count: u32, control_bytes: Vec<u8>, ring_bytes: Vec<u8>, debug_log_bytes: Vec<u8>, io_queue_bytes: Vec<u8>, ) -> Result<Self, PipelineError>

Build a resident-buffer mirror from caller-owned byte buffers.

Errors

Returns PipelineError when any buffer violates the megakernel ABI.

pub fn publish_slot( &mut self, slot_idx: u32, tenant_id: u32, opcode: u32, args: &[u32], ) -> Result<(), PipelineError>

Publish one work slot into the resident ring mirror.

Errors

Returns PipelineError::QueueFull when the slot is out of bounds or still in flight.

pub fn publish_work_items( &mut self, start_slot: u32, tenant_id: u32, items: &[ResidentWorkItem], ) -> Result<u32, PipelineError>

Publish a contiguous fixed-ABI work-item window into the resident ring mirror without resetting unrelated slots.

Errors

Returns PipelineError::QueueFull when the target slots are outside the resident ring, still in flight, or contain an unpublished opcode.

pub fn apply_readback(&mut self, readback: ResidentQueueReadback)

Apply a strict dispatch readback to the resident host mirror.

pub fn snapshot_readback(&self) -> ResidentQueueReadback

Clone the current host mirror into a strict readback record.

pub fn snapshot_readback_into(&self, out: &mut ResidentQueueReadback)

Clone the current host mirror into caller-owned readback storage.

pub fn control_bytes(&self) -> &[u8]

Control-buffer mirror bytes.

pub fn ring_bytes(&self) -> &[u8]

Ring-buffer mirror bytes.

pub fn ring_bytes_mut(&mut self) -> &mut [u8]

Mutable ring-buffer mirror bytes.

pub fn debug_log_bytes(&self) -> &[u8]

Debug-log mirror bytes.

pub fn io_queue_bytes(&self) -> &[u8]

IO-queue mirror bytes.

pub const fn slot_count(&self) -> u32

Resident ring slot count.

Trait Implementations

impl Clone for ResidentQueueBuffers

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResidentQueueBuffers

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

Formats the value using the given formatter.

impl Eq for ResidentQueueBuffers

impl PartialEq for ResidentQueueBuffers

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.