Module hwlocality::object

Objects within a hardware topology

A Topology is first and foremost a tree of TopologyObject which represents resource sharing relationships in hardware: an object is considered the parent of all other objects that share the most direct/fastest/lowest-latency route to it. For example, on x86, an L3 cache is the parent of a number of L2 caches, each the parent of one L1 cache, which is in turn the parent of a CPU core that may or may not be shared by multiple hyperthreads (PUs in hwloc’s vocabulary).

This module defines the (very extensive) API through which one can query various properties of topology objects and jump from them to other elements of the surrounding topology.

Modules

• attributes
  Object attributes
• depth
  Object depth
• distance
  Object distances
• search
  Looking for objects using non-hierarchical criteria
• types
  Object types

Structs

• TopologyObject
  Hardware topology object

Type Aliases

• TopologyObjectID
  Global persistent TopologyObject ID