Struct ProcessorTopology

pub struct ProcessorTopology<T: ArchTopology = TargetTopology> { /* private fields */ }

A description of the VM’s processor topology.

Currently this just tracks the APIC IDs for the processors.

Build one with TopologyBuilder.

Implementations

impl ProcessorTopology<Aarch64Topology>

pub fn gic_distributor_base(&self) -> u64

Returns the GIC distributor base

pub fn gic_redistributors_base(&self) -> u64

Returns the GIC redistributors base

impl ProcessorTopology<X86Topology>

pub fn max_apic_id(&self) -> u32

Returns the largest APIC ID in use.

pub fn apic_mode(&self) -> ApicMode

Returns the APIC mode configured for the processors.

impl<T: ArchTopology + Inspect> ProcessorTopology<T>

pub fn vp_count(&self) -> u32

Returns the number of VPs.

pub fn vp(&self, vp_index: VpIndex) -> VpInfo

Returns information for the given processor by VP index.

Panics if the VP index is out of range.

pub fn vp_arch(&self, vp_index: VpIndex) -> T::ArchVpInfo

Returns information for the given processor by VP index, including architecture-specific information.

Panics if the VP index is out of range.

pub fn vps(&self) -> impl '_ + ExactSizeIterator<Item = VpInfo> + Clone

Returns an iterator over all VPs.

pub fn vps_arch( &self, ) -> impl '_ + ExactSizeIterator<Item = T::ArchVpInfo> + Clone

Returns an iterator over all VPs, including architecture-specific information.

pub fn smt_enabled(&self) -> bool

Returns whether SMT (hyperthreading) is enabled.

pub fn reserved_vps_per_socket(&self) -> u32

Returns the number of VPs per socket.

This will always be a power of 2. The number of VPs actually populated in a socket may be smaller than this.

pub fn vp_topology(&self, vp_index: VpIndex) -> VpTopologyInfo

Computes the processor topology information for a VP.

Trait Implementations

impl<T: Clone + ArchTopology> Clone for ProcessorTopology<T>

where T::ArchVpInfo: Clone,

fn clone(&self) -> ProcessorTopology<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + ArchTopology> Debug for ProcessorTopology<T>

where T::ArchVpInfo: Debug,

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

Formats the value using the given formatter.

impl<T> Inspect for ProcessorTopology<T>

where T: Inspect + ArchTopology, T::ArchVpInfo: Inspect,

fn inspect(&self, req: Request<'_>)

Inspects the object.