cgroups-rs 0.5.0

Native Rust crate for managing control groups on Linux
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

// Copyright (c) 2025 Ant Group
//
// SPDX-License-Identifier: Apache-2.0 or MIT
//

use crate::systemd::error::Result;
use crate::systemd::{CPU_QUOTA_PERIOD_US, CPU_QUOTA_PER_SEC_US, CPU_SHARES, CPU_WEIGHT};

/// Returns the property for CPU shares.
///
/// Please note that if the shares is obtained from OCI runtime spec, it
/// MUST be converted, see [1] and `convert_shares_to_v2()`.
///
/// 1: https://github.com/containers/crun/blob/main/crun.1.md#cgroup-v2
pub fn shares(shares: u64, v2: bool) -> Result<(&'static str, u64)> {
    let id = if v2 { CPU_WEIGHT } else { CPU_SHARES };

    Ok((id, shares))
}

/// Returns the property for CPU period.
pub fn period(period: u64) -> Result<(&'static str, u64)> {
    Ok((CPU_QUOTA_PERIOD_US, period))
}

/// Return the property for CPU quota.
pub fn quota(quota: u64) -> Result<(&'static str, u64)> {
    Ok((CPU_QUOTA_PER_SEC_US, quota))
}