Struct CgroupGroup 

pub struct CgroupGroup<'a> { /* private fields */ }

RAII guard that removes cgroups on drop.

Prevents cgroup leaks when workload spawning or other operations fail between cgroup creation and cleanup.

Implementations

impl<'a> CgroupGroup<'a>

pub fn new(cgroups: &'a dyn CgroupOps) -> Self

Create an empty group. Cgroups added via add_cgroup or add_cgroup_no_cpuset are removed when the group is dropped.

pub fn add_cgroup(&mut self, name: &str, cpuset: &BTreeSet<usize>) -> Result<()>

Create a cgroup and set its cpuset. The cgroup is tracked for cleanup on drop.

Auto-enables Controller::Cpuset on the parent’s cgroup.subtree_control before creating the child so the child’s cpuset.cpus file is exposed and the subsequent set_cpuset write lands. Direct CgroupGroup users (the custom_* scenarios in crate::scenario::nested / crate::scenario::stress) don’t go through run_scenario’s controller-resolution hook, so the controller enable has to happen here. The setup call is idempotent on real cgroupfs (a +cpuset write into cgroup.subtree_control that already contains cpuset is a no-op at the kernel level per cgroup_subtree_control_write in kernel/cgroup/cgroup.c).

pub fn add_cgroup_no_cpuset(&mut self, name: &str) -> Result<()>

Create a cgroup without a cpuset. The cgroup is tracked for cleanup on drop.

No controller enablement: callers explicitly opting out of a cpuset signal that they don’t need any cgroup v2 controller surface beyond the cgroup-core knobs (cgroup.procs, cgroup.freeze) which are ungated. If a future caller needs e.g. memory limits on a no-cpuset cgroup, add a with_controllers overload rather than auto-enabling — the “no-cpuset” name is load-bearing for the absent-controller behavior pinned by tests in crate::scenario::nested::custom_nested_cgroup_no_ctrl.

pub fn names(&self) -> &[String]

Names of all tracked cgroups.

Trait Implementations

impl Debug for CgroupGroup<'_>

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

Formats the value using the given formatter.

impl Drop for CgroupGroup<'_>

fn drop(&mut self)

Executes the destructor for this type.