Struct ControlSnapshot 

pub struct ControlSnapshot {
    pub shutdown: bool,
    pub done_count: u32,
    pub epoch: u32,
    pub metrics: Vec<(u32, u32)>,
    pub tenant_fairness: Vec<u32>,
    pub priority_fairness: Vec<u32>,
}

Structured view of the control buffer.

Fields

shutdown: bool

Shutdown flag.

done_count: u32

Total drained slots.

epoch: u32

Epoch value (batch fences).

metrics: Vec<(u32, u32)>

Non-zero opcode metrics.

tenant_fairness: Vec<u32>

Per-tenant fairness counters (cumulative).

priority_fairness: Vec<u32>

Per-priority fairness counters (cumulative).

Implementations

impl ControlSnapshot

pub fn decode(control_bytes: &[u8]) -> Self

Decode a structured control-buffer view.

Panics

If the control buffer is missing any fixed control word.

This used to answer Self::default() on a decode failure, which hands the caller a snapshot reading zero done-count, zero epoch and no metrics and is indistinguishable from a healthy idle kernel. That is the silent fallback Self::decode_into already refuses to make, and the two shims must not disagree about what a bad buffer means. Callers that can handle the error use Self::try_decode.

pub fn decode_into(control_bytes: &[u8], out: &mut Self)

Decode a structured control-buffer view into caller-owned storage.

pub fn try_decode(control_bytes: &[u8]) -> Result<Self, PipelineError>

Strictly decode a structured control-buffer view into owned storage.

Errors

Returns PipelineError when any fixed control word is missing from the control snapshot.

pub fn try_decode_into( control_bytes: &[u8], out: &mut Self, ) -> Result<(), PipelineError>

Strictly decode a structured control-buffer view.

Errors

Returns PipelineError when any fixed control word is missing from the control snapshot.

Trait Implementations

impl Clone for ControlSnapshot

fn clone(&self) -> ControlSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ControlSnapshot

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

Formats the value using the given formatter.

impl Default for ControlSnapshot

fn default() -> ControlSnapshot

Returns the “default value” for a type.

impl Eq for ControlSnapshot

impl PartialEq for ControlSnapshot

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ControlSnapshot