Struct Topology 

pub struct Topology {
    pub nodes: BTreeMap<usize, Node>,
    pub span: Cpumask,
    pub smt_enabled: bool,
    pub all_llcs: BTreeMap<usize, Arc<Llc>>,
    pub all_cores: BTreeMap<usize, Arc<Core>>,
    pub all_cpus: BTreeMap<usize, Arc<Cpu>>,
}

Fields

nodes: BTreeMap<usize, Node>

span: Cpumask

Cpumask all CPUs in the system.

smt_enabled: bool

True if SMT is enabled in the system, false otherwise.

all_llcs: BTreeMap<usize, Arc<Llc>>

Skip indices to access lower level members easily.

all_cores: BTreeMap<usize, Arc<Core>>

all_cpus: BTreeMap<usize, Arc<Cpu>>

Implementations

impl Topology

fn instantiate(span: Cpumask, nodes: BTreeMap<usize, Node>) -> Result<Self>

pub fn new() -> Result<Topology>

Build a complete host Topology

pub fn with_virt_llcs( nr_cores_per_vllc: Option<(usize, usize)>, ) -> Result<Topology>

pub fn with_flattened_llc_node() -> Result<Topology>

pub fn with_args(topology_args: &TopologyArgs) -> Result<Topology>

Build a topology with configuration from CLI arguments. This method integrates with the TopologyArgs from the cli module to create a topology based on command line parameters.

pub fn has_little_cores(&self) -> bool

Returns whether the Topology has a hybrid architecture of big and little cores.

pub fn sibling_cpus(&self) -> Vec<i32>

Returns a vector that maps the index of each logical CPU to the sibling CPU. This represents the “next sibling” CPU within a package in systems that support SMT. The sibling CPU is the other logical CPU that shares the physical resources of the same physical core.

Assuming each core holds exactly at most two cpus.

pub fn cpumask_nr_cores(&self, cpumask: &Cpumask) -> usize

Count how many physical cores have at least one CPU set in the cpumask.

pub fn format_cpumask_grid<W: Write>( &self, w: &mut W, cpumask: &Cpumask, indent: &str, max_width: usize, ) -> Result<()>

Format a cpumask as a topology-aware visual grid.

Each physical core is represented by a single character:

• ░ = no CPUs set
• ▀ = first HT only (top half)
• ▄ = second HT only (bottom half)
• █ = both HTs (or all HTs for >2-way SMT)

Cores within an LLC are split into evenly-sized groups of at most 8 with spaces. LLCs are separated by |. Wrapping happens at LLC boundaries. One line per NUMA node (may wrap).

pub fn format_cpumask_header( &self, cpumask: &Cpumask, min_cpus: u32, max_cpus: u32, ) -> String

Format a cpumask header line with cpu count, core count, and range.

Trait Implementations

impl Debug for Topology

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

Formats the value using the given formatter.