Struct CgroupProcsSnapshot 

#[non_exhaustive]
pub struct CgroupProcsSnapshot {
    pub tag: String,
    pub cgroup: String,
    pub pids: Vec<pid_t>,
}

A single cgroup.procs snapshot captured by Op::CaptureCgroupProcs.

Tests drain the per-bridge log of these via SnapshotBridge::drain_cgroup_procs after the scenario completes, then assert on the captured pids (membership, count, identity) against the workload they spawned. Carries:

• tag: the snapshot key supplied in the Op (lets a scenario capture pre/post snapshots of the same cgroup at different points and disambiguate them on drain).
• cgroup: the cgroup name the kernel read returned PIDs for.
• pids: the thread-group leaders (PIDs / TGIDs) the kernel reported in cgroup.procs at capture time. An empty Vec means the cgroup existed but held no tasks. A read against a missing cgroup directory errors at the dispatch arm and never produces a snapshot — so the presence of a CgroupProcsSnapshot in the drain log implies the read succeeded.

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.

tag: String

Snapshot key supplied to Op::CaptureCgroupProcs. Distinguishes multiple captures of the same cgroup.

cgroup: String

Cgroup name the kernel read returned PIDs for.

pids: Vec<pid_t>

Thread-group leaders in the cgroup at capture time. libc::pid_t is i32 on Linux; compare against other ktstr pid surfaces (WorkloadHandle::worker_pids(), etc.) via the matching integer type or as i32 cast when types differ.

Implementations

impl CgroupProcsSnapshot

pub fn new( tag: impl Into<String>, cgroup: impl Into<String>, pids: Vec<pid_t>, ) -> Self

Construct a CgroupProcsSnapshot. The struct is #[non_exhaustive] so external callers cannot use struct-literal syntax — use this constructor instead. The framework’s SnapshotBridge::record_cgroup_procs dispatch site routes through here so test fixtures that synthesise snapshots for drain-consumer testing share the same construction path.

Trait Implementations

impl Clone for CgroupProcsSnapshot

fn clone(&self) -> CgroupProcsSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CgroupProcsSnapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CgroupProcsSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for CgroupProcsSnapshot

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CgroupProcsSnapshot

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CgroupProcsSnapshot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CgroupProcsSnapshot

impl StructuralPartialEq for CgroupProcsSnapshot