Basic Traversal Helpers

Functions
static __hwloc_inline hwloc_obj_t	hwloc_get_root_obj (hwloc_topology_t topology) __hwloc_attribute_pure
static __hwloc_inline hwloc_obj_t	hwloc_get_ancestor_obj_by_depth (hwloc_topology_t topology __hwloc_attribute_unused, unsigned depth, hwloc_obj_t obj) __hwloc_attribute_pure
static __hwloc_inline hwloc_obj_t	hwloc_get_ancestor_obj_by_type (hwloc_topology_t topology __hwloc_attribute_unused, hwloc_obj_type_t type, hwloc_obj_t obj) __hwloc_attribute_pure
static __hwloc_inline hwloc_obj_t	hwloc_get_next_obj_by_depth (hwloc_topology_t topology, unsigned depth, hwloc_obj_t prev)
static __hwloc_inline hwloc_obj_t	hwloc_get_next_obj_by_type (hwloc_topology_t topology, hwloc_obj_type_t type, hwloc_obj_t prev)
static __hwloc_inline hwloc_obj_t	hwloc_get_pu_obj_by_os_index (hwloc_topology_t topology, unsigned os_index) __hwloc_attribute_pure
static __hwloc_inline hwloc_obj_t	hwloc_get_next_child (hwloc_topology_t topology __hwloc_attribute_unused, hwloc_obj_t parent, hwloc_obj_t prev)
static __hwloc_inline hwloc_obj_t	hwloc_get_common_ancestor_obj (hwloc_topology_t topology __hwloc_attribute_unused, hwloc_obj_t obj1, hwloc_obj_t obj2) __hwloc_attribute_pure
static __hwloc_inline int	hwloc_obj_is_in_subtree (hwloc_topology_t topology __hwloc_attribute_unused, hwloc_obj_t obj, hwloc_obj_t subtree_root) __hwloc_attribute_pure

Detailed Description

Be sure to see the figure in termsanddefs that shows a complete topology tree, including depths, child/sibling/cousin relationships, and an example of an asymmetric topology where one socket has fewer caches than its peers.

Function Documentation

static __hwloc_inline hwloc_obj_t hwloc_get_ancestor_obj_by_depth ( hwloc_topology_t topology  __hwloc_attribute_unused, unsigned  depth, hwloc_obj_t  obj  )

static

Returns the ancestor object of obj at depth depth.

static __hwloc_inline hwloc_obj_t hwloc_get_ancestor_obj_by_type ( hwloc_topology_t topology  __hwloc_attribute_unused, hwloc_obj_type_t  type, hwloc_obj_t  obj  )

static

Returns the ancestor object of obj with type type.

static __hwloc_inline hwloc_obj_t hwloc_get_common_ancestor_obj ( hwloc_topology_t topology  __hwloc_attribute_unused, hwloc_obj_t  obj1, hwloc_obj_t  obj2  )

static

Returns the common parent object to objects lvl1 and lvl2.

static __hwloc_inline hwloc_obj_t hwloc_get_next_child ( hwloc_topology_t topology  __hwloc_attribute_unused, hwloc_obj_t  parent, hwloc_obj_t  prev  )

static

Return the next child.

If prev is NULL, return the first child.

static __hwloc_inline hwloc_obj_t hwloc_get_next_obj_by_depth ( hwloc_topology_t  topology, unsigned  depth, hwloc_obj_t  prev  )

static

Returns the next object at depth depth.

If prev is NULL, return the first object at depth depth.

static __hwloc_inline hwloc_obj_t hwloc_get_next_obj_by_type ( hwloc_topology_t  topology, hwloc_obj_type_t  type, hwloc_obj_t  prev  )

static

Returns the next object of type type.

If prev is NULL, return the first object at type type. If there are multiple or no depth for given type, return NULL and let the caller fallback to hwloc_get_next_obj_by_depth().

static __hwloc_inline hwloc_obj_t hwloc_get_pu_obj_by_os_index ( hwloc_topology_t  topology, unsigned  os_index  )

static

Returns the object of type HWLOC_OBJ_PU with os_index.

Note

The os_index field of object should most of the times only be used for pretty-printing purpose. Type HWLOC_OBJ_PU is the only case where os_index could actually be useful, when manually binding to processors. However, using CPU sets to hide this complexity should often be preferred.

static __hwloc_inline hwloc_obj_t hwloc_get_root_obj ( hwloc_topology_t  topology)

static

Returns the top-object of the topology-tree.

Its type is typically HWLOC_OBJ_MACHINE but it could be different for complex topologies. This function replaces the old deprecated hwloc_get_system_obj().

static __hwloc_inline int hwloc_obj_is_in_subtree ( hwloc_topology_t topology  __hwloc_attribute_unused, hwloc_obj_t  obj, hwloc_obj_t  subtree_root  )

static

Returns true if obj is inside the subtree beginning with subtree_root.

Note

This function assumes that both obj and subtree_root have a cpuset.