Open MPI logo

Portable Hardware Locality (hwloc) Documentation: v1.2.2

  |   Home   |   Support   |   FAQ   |  
hwloc_obj Struct Reference

Structure of a topology object. More...

#include <hwloc.h>

Data Fields

hwloc_obj_type_t type
 Type of object.
unsigned os_index
 OS-provided physical index number.
char * name
 Object description if any.
struct hwloc_obj_memory_s memory
 Memory attributes.
union hwloc_obj_attr_uattr
 Object type-specific Attributes, may be NULL if no attribute value was found.
unsigned depth
 Vertical index in the hierarchy.
unsigned logical_index
 Horizontal index in the whole list of similar objects, could be a "cousin_rank" since it's the rank within the "cousin" list below.
signed os_level
 OS-provided physical level, -1 if unknown or meaningless.
struct hwloc_objnext_cousin
 Next object of same type and depth.
struct hwloc_objprev_cousin
 Previous object of same type and depth.
struct hwloc_objparent
 Parent, NULL if root (system object)
unsigned sibling_rank
 Index in parent's children[] array.
struct hwloc_objnext_sibling
 Next object below the same parent.
struct hwloc_objprev_sibling
 Previous object below the same parent.
unsigned arity
 Number of children.
struct hwloc_obj ** children
 Children, children[0 .. arity -1].
struct hwloc_objfirst_child
 First child.
struct hwloc_objlast_child
 Last child.
void * userdata
 Application-given private data pointer, initialized to NULL, use it as you wish.
hwloc_cpuset_t cpuset
 CPUs covered by this object.
hwloc_cpuset_t complete_cpuset
 The complete CPU set of logical processors of this object,.
hwloc_cpuset_t online_cpuset
 The CPU set of online logical processors.
hwloc_cpuset_t allowed_cpuset
 The CPU set of allowed logical processors.
hwloc_nodeset_t nodeset
 NUMA nodes covered by this object or containing this object.
hwloc_nodeset_t complete_nodeset
 The complete NUMA node set of this object,.
hwloc_nodeset_t allowed_nodeset
 The set of allowed NUMA memory nodes.
struct hwloc_distances_s ** distances
 Distances between all objects at same depth below this object.
unsigned distances_count
struct hwloc_obj_info_sinfos
 Array of stringified info type=name.
unsigned infos_count
 Size of infos array.

Detailed Description

Structure of a topology object.

Applications must not modify any field except hwloc_obj.userdata.


Field Documentation

The CPU set of allowed logical processors.

This includes the CPUs contained in this object which are allowed for binding, i.e. passing them to the hwloc binding functions should not return permission errors. This is usually restricted by administration rules. Some of them may however be offline so binding to them may still not be possible, see online_cpuset.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.

The set of allowed NUMA memory nodes.

This includes the NUMA memory nodes contained in this object which are allowed for memory allocation, i.e. passing them to NUMA node-directed memory allocation should not return permission errors. This is usually restricted by administration rules.

If there are no NUMA nodes in the machine, all the memory is close to this object, so allowed_nodeset is full.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.
unsigned hwloc_obj::arity

Number of children.

Object type-specific Attributes, may be NULL if no attribute value was found.

Children, children[0 .. arity -1].

The complete CPU set of logical processors of this object,.

This includes not only the same as the cpuset field, but also the CPUs for which topology information is unknown or incomplete, and the CPUs that are ignored when the HWLOC_TOPOLOGY_FLAG_WHOLE_SYSTEM flag is not set. Thus no corresponding PU object may be found in the topology, because the precise position is undefined. It is however known that it would be somewhere under this object.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.

The complete NUMA node set of this object,.

This includes not only the same as the nodeset field, but also the NUMA nodes for which topology information is unknown or incomplete, and the nodes that are ignored when the HWLOC_TOPOLOGY_FLAG_WHOLE_SYSTEM flag is not set. Thus no corresponding NODE object may be found in the topology, because the precise position is undefined. It is however known that it would be somewhere under this object.

If there are no NUMA nodes in the machine, all the memory is close to this object, so complete_nodeset is full.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.

CPUs covered by this object.

This is the set of CPUs for which there are PU objects in the topology under this object, i.e. which are known to be physically contained in this object and known how (the children path between this object and the PU objects).

If the HWLOC_TOPOLOGY_FLAG_WHOLE_SYSTEM configuration flag is set, some of these CPUs may be offline, or not allowed for binding, see online_cpuset and allowed_cpuset.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.
unsigned hwloc_obj::depth

Vertical index in the hierarchy.

Distances between all objects at same depth below this object.

First child.

Array of stringified info type=name.

Size of infos array.

Last child.

Horizontal index in the whole list of similar objects, could be a "cousin_rank" since it's the rank within the "cousin" list below.

Memory attributes.

Object description if any.

Next object of same type and depth.

Next object below the same parent.

NUMA nodes covered by this object or containing this object.

This is the set of NUMA nodes for which there are NODE objects in the topology under or above this object, i.e. which are known to be physically contained in this object or containing it and known how (the children path between this object and the NODE objects).

In the end, these nodes are those that are close to the current object.

If the HWLOC_TOPOLOGY_FLAG_WHOLE_SYSTEM configuration flag is set, some of these nodes may not be allowed for allocation, see allowed_nodeset.

If there are no NUMA nodes in the machine, all the memory is close to this object, so nodeset is full.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.

The CPU set of online logical processors.

This includes the CPUs contained in this object that are online, i.e. draw power and can execute threads. It may however not be allowed to bind to them due to administration rules, see allowed_cpuset.

Note:
Its value must not be changed, hwloc_bitmap_dup must be used instead.

OS-provided physical index number.

OS-provided physical level, -1 if unknown or meaningless.

Parent, NULL if root (system object)

Previous object of same type and depth.

Previous object below the same parent.

Index in parent's children[] array.

Application-given private data pointer, initialized to NULL, use it as you wish.


The documentation for this struct was generated from the following file: