Struct glommio::CpuSet

pub struct CpuSet(_);

Used to specify a set of permitted CPUs on which executors created by a LocalExecutorPoolBuilder are run.

Please see the documentation for Placement variants to understand how CpuSet restrictions apply to each variant. CPUs are identified via their CpuLocation.

Implementations

impl CpuSet

pub fn online() -> Result<Self, ()>

Creates a CpuSet representing all CPUs that are online. The function will return an Err if the hardware topology could not be obtained from this machine.

pub fn filter<F>(self, f: F) -> Self where
    F: FnMut(&CpuLocation) -> bool, 

This method can be used to restrict the CPUs held by CpuSet. The resulting CpuSet will only include CpuLocations for which the provided closure returns true. Note that each call to filter will use as input the set of CPUs previously selected (i.e. the set is not reset on each call).

use glommio::CpuSet;

// get CPUs on NUMA node 0
let cpus = CpuSet::online()
    .expect("Err: please file an issue with glommio")
    .filter(|l| l.numa_node == 0);

println!("The filtered CPUs are: {:#?}", cpus);

pub fn as_vec(&self) -> &Vec<CpuLocation>

Returns a reference to the CpuLocations currently included in the CpuSet.

pub fn is_empty(&self) -> bool

Checks whether the CpuSet is empty.

pub fn len(&self) -> usize

Returns the number of CPUs included in the CpuSet.

Trait Implementations

impl Clone for CpuSet

fn clone(&self) -> CpuSet

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CpuSet

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

Formats the value using the given formatter.