Struct Substrate 

pub struct Substrate {
    pub topology: Topology,
    pub roots: Roots,
}

The structural machine: what exists, and where to look to observe it.

Fields

topology: Topology

roots: Roots

Implementations

impl Substrate

pub fn discover(platform: &dyn Platform) -> Result<Substrate>

Discover the substrate through a platform backend.

pub fn new(topology: Topology, roots: Roots) -> Substrate

pub fn rediscover(&self) -> Result<Substrate>

Re-read the machine’s structure from the same roots.

Used to detect hotplug: a CPU going offline changes the entity set, and every cached row index in every consumer becomes wrong. Cheap enough to call once a second, far too expensive to call every tick.

pub fn structure(&self) -> (Vec<Entity>, Vec<Relation>)

Build the structural entity list and the static edges between them.

“Static” means constant for the lifetime of an epoch: containment, SMT siblinghood, cache membership and NUMA locality do not change while the set of online CPUs is unchanged. Sensors add further entities and edges on top of these.

Trait Implementations

impl Clone for Substrate

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Substrate

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

Formats the value using the given formatter.