17 releases

0.3.4 Oct 25, 2023
0.3.2 Mar 15, 2023
0.2.11 Sep 23, 2022
0.2.10 Jun 29, 2022
0.2.0 Dec 21, 2020

#47 in Unix APIs

Download history 17253/week @ 2023-11-24 20028/week @ 2023-12-01 19995/week @ 2023-12-08 19555/week @ 2023-12-15 11044/week @ 2023-12-22 13018/week @ 2023-12-29 20110/week @ 2024-01-05 19689/week @ 2024-01-12 20443/week @ 2024-01-19 19985/week @ 2024-01-26 19951/week @ 2024-02-02 19415/week @ 2024-02-09 18046/week @ 2024-02-16 22353/week @ 2024-02-23 21063/week @ 2024-03-01 9342/week @ 2024-03-08

74,265 downloads per month
Used in 9 crates (7 directly)

MIT/Apache

255KB
5.5K SLoC

cgroups-rs Build

Native Rust library for managing control groups under Linux

Both v1 and v2 of cgroups are supported.

Examples

Create a control group using the builder pattern



use cgroups_rs::*;
use cgroups_rs::cgroup_builder::*;

// Acquire a handle for the cgroup hierarchy.
let hier = cgroups_rs::hierarchies::auto();

// Use the builder pattern (see the documentation to create the control group)
//
// This creates a control group named "example" in the V1 hierarchy.
    let cg: Cgroup = CgroupBuilder::new("example")
        .cpu()
        .shares(85)
        .done()
        .build(hier);

// Now `cg` is a control group that gets 85% of the CPU time in relative to
// other control groups.

// Get a handle to the CPU controller.
let cpus: &cgroups_rs::cpu::CpuController = cg.controller_of().unwrap();
cpus.add_task(&CgroupPid::from(1234u64));

// [...]

// Finally, clean up and delete the control group.
cg.delete();

// Note that `Cgroup` does not implement `Drop` and therefore when the
// structure is dropped, the Cgroup will stay around. This is because, later
// you can then re-create the `Cgroup` using `load()`. We aren't too set on
// this behavior, so it might change in the feature. Rest assured, it will be a
// major version change.

Disclaimer

This crate is licensed under:

  • MIT License (see LICENSE-MIT); or
  • Apache 2.0 License (see LICENSE-Apache-2.0),

at your option.

Please note that this crate is under heavy development, we will use sematic versioning, but during the 0.0.* phase, no guarantees are made about backwards compatibility.

Regardless, check back often and thanks for taking a look!

Dependencies

~4–5.5MB
~108K SLoC