Struct CgroupMemoryStats 

#[non_exhaustive]
pub struct CgroupMemoryStats {
    pub current: u64,
    pub max: Option<u64>,
    pub high: Option<u64>,
    pub low: Option<u64>,
    pub min: Option<u64>,
    pub stat: BTreeMap<String, u64>,
    pub events: BTreeMap<String, u64>,
}

Memory controller state for one cgroup. Fields mirror the memory.* cgroup v2 files. stat and events are captured as flat key-value maps so the data model auto-extends when the kernel adds new keys (memory.stat has 71 keys on a recent kernel; the explicit list is scheduler-correctness-relevant but the map preserves regression-detection on lesser-known counters).

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.

current: u64

memory.current, instantaneous RSS of the cgroup in bytes.

max: Option<u64>

memory.max, hard memory limit in bytes. None when the file is absent (root cgroup) OR when the kernel emits the literal “max” token (no hard cap).

high: Option<u64>

memory.high, soft pressure limit in bytes. None when absent or unlimited (same “max”-token semantics as Self::max).

low: Option<u64>

memory.low, best-effort protection floor in bytes. None when the file is absent (no protection configured); Some(u64::MAX) when the kernel emits the literal max token (request maximum protection — every byte under the cgroup is protected). Per the kernel’s cgroup v2 docs, memory under low is protected from reclaim unless no unprotected memory remains. Note the asymmetry vs. limits: None means “no floor” (semantic opposite of “max”-as-no-cap on the limit fields above).

min: Option<u64>

memory.min, hard protection floor in bytes. None when absent (no floor). Some(u64::MAX) when the kernel emits max (full protection). Stronger than low — memory under min is never reclaimed even under memory pressure.

stat: BTreeMap<String, u64>

memory.stat parsed as a key-value map. Keys mirror the kernel-emitted strings (e.g. anon, file, workingset_refault_anon, pgfault, pgmajfault, slab, the active/inactive variants, etc.). Empty when the file is absent.

events: BTreeMap<String, u64>

memory.events parsed as a key-value map. Typical keys: low, high, max, oom, oom_kill, oom_group_kill, sock_throttled (subset varies by kernel version). Empty when the file is absent.

Trait Implementations

impl Clone for CgroupMemoryStats

fn clone(&self) -> CgroupMemoryStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CgroupMemoryStats

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

Formats the value using the given formatter.

impl Default for CgroupMemoryStats

fn default() -> CgroupMemoryStats

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CgroupMemoryStats

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CgroupMemoryStats

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

where __S: Serializer,

Serialize this value into the given Serde serializer.