Struct CpuTopology 

pub struct CpuTopology { /* private fields */ }

Process-visible CPU topology used for execution placement.

Each usable NUMA node contains only CPUs also present in the process affinity mask. Empty nodes are omitted and OS node IDs are not renumbered.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(0)])?);
assert_eq!(topology.allowed_cpus().len(), 1);
assert!(!topology.has_numa_nodes());

Implementations

impl CpuTopology

pub fn all_allowed(allowed_cpus: CpuSet) -> Self

Construct a topology with only the all-allowed execution domain.

This is the portable fallback when NUMA discovery is unavailable.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(2)])?);
assert!(topology.nodes().is_empty());

pub fn allowed_cpus(&self) -> &CpuSet

Return the complete process affinity CPU set.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(1)])?);
assert!(topology.allowed_cpus().contains(CpuId::new(1)));

pub fn nodes(&self) -> &[CpuNode]

Return usable NUMA nodes ordered by their sparse OS node IDs.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(0)])?);
assert!(topology.nodes().is_empty());

pub fn node_ids(&self) -> Vec<NumaNodeId>

Copy the usable sparse operating-system NUMA node IDs.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(0)])?);
assert!(topology.node_ids().is_empty());

pub fn node(&self, id: NumaNodeId) -> Option<&CpuNode>

Look up a usable node by its original OS node ID.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology, NumaNodeId};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(0)])?);
assert!(topology.node(NumaNodeId::new(0)).is_none());

pub fn has_numa_nodes(&self) -> bool

Report whether NUMA discovery produced any usable node domains.

Examples

use tenferro_cpu::{CpuId, CpuSet, CpuTopology};

let topology = CpuTopology::all_allowed(CpuSet::new([CpuId::new(0)])?);
assert!(!topology.has_numa_nodes());

Trait Implementations

impl Clone for CpuTopology

fn clone(&self) -> CpuTopology

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CpuTopology

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

Formats the value using the given formatter.

impl PartialEq for CpuTopology

fn eq(&self, other: &CpuTopology) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CpuTopology

impl StructuralPartialEq for CpuTopology