Struct cgroups_rs::blkio::BlkIoController

pub struct BlkIoController { /* fields omitted */ }

A controller that allows controlling the blkio subsystem of a Cgroup.

In essence, using the blkio controller one can limit and throttle the tasks’ usage of block devices in the control group.

Implementations

impl BlkIoController

pub fn new(root: PathBuf, v2: bool) -> Self

Constructs a new BlkIoController with root serving as the root of the control group.

pub fn blkio(&self) -> BlkIo

Gathers statistics about and reports the state of the block devices used by the control group’s tasks.

pub fn set_leaf_weight(&self, w: u64) -> Result<()>

Set the leaf weight on the control group’s tasks, i.e., how are they weighted against the descendant control groups’ tasks.

pub fn set_leaf_weight_for_device(
    &self,
    major: u64,
    minor: u64,
    weight: u64
) -> Result<()>

Same as set_leaf_weight(), but settable per each block device.

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

Reset the statistics the kernel has gathered so far and start fresh.

pub fn throttle_read_bps_for_device(
    &self,
    major: u64,
    minor: u64,
    bps: u64
) -> Result<()>

Throttle the bytes per second rate of read operation affecting the block device major:minor to bps.

pub fn throttle_read_iops_for_device(
    &self,
    major: u64,
    minor: u64,
    iops: u64
) -> Result<()>

Throttle the I/O operations per second rate of read operation affecting the block device major:minor to bps.

pub fn throttle_write_bps_for_device(
    &self,
    major: u64,
    minor: u64,
    bps: u64
) -> Result<()>

Throttle the bytes per second rate of write operation affecting the block device major:minor to bps.

pub fn throttle_write_iops_for_device(
    &self,
    major: u64,
    minor: u64,
    iops: u64
) -> Result<()>

Throttle the I/O operations per second rate of write operation affecting the block device major:minor to bps.

pub fn set_weight(&self, w: u64) -> Result<()>

Set the weight of the control group’s tasks.

pub fn set_weight_for_device(
    &self,
    major: u64,
    minor: u64,
    weight: u64
) -> Result<()>

Same as set_weight(), but settable per each block device.

Trait Implementations

impl Clone for BlkIoController

fn clone(&self) -> BlkIoController

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BlkIoController

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

Formats the value using the given formatter.

impl<'a> From<&'a Subsystem> for &'a BlkIoController

fn from(sub: &'a Subsystem) -> &'a BlkIoController

Performs the conversion.