Struct DsqState 

#[non_exhaustive]
pub struct DsqState {
    pub id: u64,
    pub origin: String,
    pub nr: u32,
    pub seq: u32,
    pub task_kvas: Vec<u64>,
    pub truncated: bool,
}

Snapshot of one DSQ’s state — built-in (per-CPU local, per-CPU bypass, per-node global) or user-allocated.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: u64

scx_dispatch_q.id — built-in DSQs use synthetic ids (SCX_DSQ_LOCAL, SCX_DSQ_GLOBAL per-node); user DSQs carry the BPF-allocated id.

origin: String

Operator-facing tag describing where the DSQ came from: "local cpu N", "bypass cpu N", "global node N", or "user". Aligned with the kernel’s own scx_dump_state terminology where comparable.

nr: u32

scx_dispatch_q.nr — number of tasks currently queued.

seq: u32

scx_dispatch_q.seq — BPF-iter seq counter, used by the dual-snapshot delta to distinguish dead vs busy DSQs: Δnr=0 + Δseq=0 is a dead DSQ; Δseq>>Δ(seq-nr) indicates unbounded queue growth.

task_kvas: Vec<u64>

task_struct KVAs walked off the DSQ’s list_head. Same shape as RqScxState::runnable_task_kvas — feeds into the same per-task enrichment pipeline.

truncated: bool

True when the DSQ list walk hit the MAX_NODES_PER_LIST cap before reaching the head. Distinct from nr: the kernel may report nr larger than our walk cap on legitimately-deep DSQs.

Trait Implementations

impl Clone for DsqState

fn clone(&self) -> DsqState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DsqState

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

Formats the value using the given formatter.

impl Default for DsqState

fn default() -> DsqState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DsqState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DsqState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.