Struct CgroupCpuController 

pub struct CgroupCpuController {
    pub shares: u32,
    pub quota_us: u64,
    pub period_us: u64,
    pub burst_us: u64,
    pub stats: CpuBandwidthStats,
    pub throttled: bool,
    pub parent_id: u64,
    pub cgroup_id: u64,
    /* private fields */
}

Cgroup CPU controller with shares and bandwidth limiting.

Fields

shares: u32

CPU shares (weight-based fair scheduling, default 1024).

quota_us: u64

CPU quota in microseconds per period (0 = unlimited).

period_us: u64

CPU period in microseconds (default 100000 = 100ms).

burst_us: u64

Burst capacity in microseconds (0 = no burst).

stats: CpuBandwidthStats

Bandwidth statistics.

throttled: bool

Whether currently throttled.

parent_id: u64

Parent cgroup ID for hierarchical distribution (0 = root).

cgroup_id: u64

Unique cgroup ID.

Implementations

impl CgroupCpuController

pub fn new(cgroup_id: u64) -> Self

pub fn set_shares(&mut self, shares: u32) -> Result<(), KernelError>

Set CPU shares (weight). Minimum 2, maximum 262144.

pub fn set_bandwidth( &mut self, quota_us: u64, period_us: u64, ) -> Result<(), KernelError>

Set CPU bandwidth quota and period. quota_us=0 means unlimited. Period must be >= 1000us and <= 1000000us.

pub fn set_burst(&mut self, burst_us: u64)

Set burst capacity in microseconds.

pub fn consume_runtime(&mut self, ns: u64) -> bool

Consume runtime. Returns true if the task is now throttled.

pub fn new_period(&mut self)

Begin a new scheduling period. Refills runtime and handles burst.

pub fn effective_cpu_percent_x100(&self) -> u64

Calculate the effective CPU percentage (quota/period * 100). Returns percentage * 100 (fixed-point with 2 decimal digits). For example, quota=50000, period=100000 returns 5000 (50.00%).

pub fn proportional_runtime_ns(&self, total_shares: u32) -> u64

Compute the weight-proportional share of CPU time for this cgroup relative to a total weight sum. Returns nanoseconds per period.

Trait Implementations

impl Clone for CgroupCpuController

fn clone(&self) -> CgroupCpuController

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CgroupCpuController

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

Formats the value using the given formatter.