Module hwlocality::object::distance

Object distances

Modern computer components are not usually connected via all-to-all networks. Instead, more scalable network topologies like rings or meshes are preferred. As a result, some components can communicate more quickly with each other than others, and the hwloc object distance API is meant to expose this information.

At the time of writing, hwloc can only measure distances between NUMA nodes and between GPUs.

Most of this module’s functionality is exposed via methods of the Topology struct. The module itself only hosts type definitions that are related to this functionality.

Structs

• AddDistancesFlags
  Flags to be given to TopologyEditor::add_distances()
• Distances
  Matrix of distances between a set of objects
• DistancesKind
  Kinds of distance matrices
• TransformErrorhwloc-2_5_0
  Error returned when attempting to remove all distances using DistancesTransform::RemoveNone.

Enums

• AddDistancesErrorhwloc-2_5_0
  Failed to add a new distance matrix to the topology
• DistancesTransformhwloc-2_5_0
  Transformations of distances structures