Struct cgroups_fs::AutomanagedCgroup

pub struct AutomanagedCgroup { /* private fields */ }

An automatically managed controller of a specific cgroups subsystem.

It is a wrapper around Cgroup type which automatically creates (on init) and removes (on drop) a cgroup in a given subsystem.

Since it is a wrapper, all the methods from Cgroup type are directly available for AutomanagedCgroup instances.

Implementations

impl AutomanagedCgroup

pub fn init(cgroup_name: &CgroupName, subsystem: &str) -> Result<Self>

Inits a cgroup, which means that it creates a cgroup in a given subsystem.

Notes:

• If there is an existing cgroup, it will be recreated from scratch. If that is not what you what, consider using Cgroup type instead.
• The cgroup will be automatically removed once the AutomanagedCgroup instance is dropped.

Methods from Deref<Target = Cgroup>

pub fn create(&self) -> Result<()>

Creates a cgroups namespace.

Notes:

• Keep in mind the usual filesystem permissions (owner, group, and mode bits).

pub fn remove(&self) -> Result<()>

Removes a cgroups namespace.

Notes:

• This method will fail if there are nested cgroups.
• Keep in mind the usual filesystem permissions (owner, group, and mode bits).

pub fn set_raw_value<V>(&self, key: &str, value: V) -> Result<()>where
    V: AsRef<[u8]>,

Sets a binary or string value to the cgroup control file.

pub fn set_value<V>(&self, key: &str, value: V) -> Result<()>where
    V: Copy + ToString,

Sets a value to the cgroup control file.

pub fn get_raw_value(&self, key: &str) -> Result<String>

Gets a string value from cgroup control file.

pub fn get_value<T>(&self, key: &str) -> Result<T>where
    T: FromStr,

Gets a value from cgroup control file.

pub fn add_task(&self, pid: Pid) -> Result<()>

Attaches a task (thread) to the cgroup.

pub fn get_tasks(&self) -> Result<Vec<Pid>>

Lists tasks (threads) attached to the cgroup.

pub fn kill_all_tasks(&self) -> Result<()>

Kills (SIGKILL) all the attached to the cgroup tasks.

Trait Implementations

impl AsRef<Cgroup> for AutomanagedCgroup

fn as_ref(&self) -> &Cgroup

Converts this type into a shared reference of the (usually inferred) input type.

impl Deref for AutomanagedCgroup

type Target = Cgroup

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Drop for AutomanagedCgroup

fn drop(&mut self)

Executes the destructor for this type.