Open MPI logo

Portable Hardware Locality (hwloc) Documentation: v1.8

  |   Home   |   Support   |   FAQ   |  
Looking at Ancestor and Child Objects

Functions

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_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
 
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)
 

Detailed Description

Be sure to see the figure in Terms and Definitions 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 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 ancestor object subtree_root.

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