Open MPI logo

Portable Hardware Locality (hwloc) Documentation: v1.9.1

  |   Home   |   Support   |   FAQ   |  
Topology Creation and Destruction

Typedefs

typedef struct hwloc_topology * hwloc_topology_t
 

Functions

int hwloc_topology_init (hwloc_topology_t *topologyp)
 
int hwloc_topology_load (hwloc_topology_t topology)
 
void hwloc_topology_destroy (hwloc_topology_t topology)
 
void hwloc_topology_check (hwloc_topology_t topology)
 

Detailed Description

Typedef Documentation

typedef struct hwloc_topology* hwloc_topology_t

Topology context.

To be initialized with hwloc_topology_init() and built with hwloc_topology_load().

Function Documentation

void hwloc_topology_check ( hwloc_topology_t  topology)

Run internal checks on a topology structure.

The program aborts if an inconsistency is detected in the given topology.

Parameters
topologyis the topology to be checked
Note
This routine is only useful to developers.
The input topology should have been previously loaded with hwloc_topology_load().
void hwloc_topology_destroy ( hwloc_topology_t  topology)

Terminate and free a topology context.

Parameters
topologyis the topology to be freed
int hwloc_topology_init ( hwloc_topology_t topologyp)

Allocate a topology context.

Parameters
[out]topologypis assigned a pointer to the new allocated context.
Returns
0 on success, -1 on error.
int hwloc_topology_load ( hwloc_topology_t  topology)

Build the actual topology.

Build the actual topology once initialized with hwloc_topology_init() and tuned with Topology Detection Configuration and Query routines. No other routine may be called earlier using this topology context.

Parameters
topologyis the topology to be loaded with objects.
Returns
0 on success, -1 on error.
Note
On failure, the topology is reinitialized. It should be either destroyed with hwloc_topology_destroy() or configured and loaded again.
This function may be called only once per topology.
See also
Topology Detection Configuration and Query