Struct CgroupCpuStats 

#[non_exhaustive]
pub struct CgroupCpuStats {
    pub usage_usec: u64,
    pub nr_throttled: u64,
    pub throttled_usec: u64,
    pub max_quota_us: Option<u64>,
    pub max_period_us: u64,
    pub weight: Option<u64>,
    pub weight_nice: Option<i32>,
}

CPU controller state for one cgroup. Fields mirror the cpu.* cgroup v2 files exposed under <cgroup>/cpu.stat, <cgroup>/cpu.max, <cgroup>/cpu.weight, and <cgroup>/cpu.weight.nice.

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.

usage_usec: u64

usage_usec from cpu.stat. Cumulative CPU time consumed by tasks in this cgroup, in microseconds.

nr_throttled: u64

nr_throttled from cpu.stat. Cumulative count of CFS-bandwidth throttling events that paused this cgroup.

throttled_usec: u64

throttled_usec from cpu.stat. Cumulative wall-clock time the cgroup spent throttled by CFS bandwidth.

max_quota_us: Option<u64>

cpu.max quota in microseconds. None when the file is absent (root cgroup) OR when the kernel emits the literal “max” token (no CFS bandwidth cap configured for this cgroup).

max_period_us: u64

cpu.max period in microseconds. Default 100_000 (100ms) per the kernel default. Always present alongside the quota half on a child cgroup; defaults to 100_000 when the file is absent (root cgroup).

weight: Option<u64>

cpu.weight (1..=10_000, default 100). None when the file is absent (root cgroup); the kernel does not allow 0 as a value, so the absent-vs-zero distinction is load-bearing.

weight_nice: Option<i32>

cpu.weight.nice (-20..=19, default 0). None when the file is absent. Alias-domain for Self::weight — the kernel writes both files in lockstep but they’re captured independently to surface any kernel-version-specific divergence.

Trait Implementations

impl Clone for CgroupCpuStats

fn clone(&self) -> CgroupCpuStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CgroupCpuStats

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

Formats the value using the given formatter.

impl Default for CgroupCpuStats

fn default() -> CgroupCpuStats

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CgroupCpuStats

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CgroupCpuStats

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

where __S: Serializer,

Serialize this value into the given Serde serializer.