hwloc_topology_t (3)

typedef struct hwloc_topology* \fBhwloc_topology_t\fP

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

void hwloc_topology_check (\fBhwloc_topology_t\fPtopology)

Run internal checks on a topology structure. The program aborts if an inconsistency is detected in the given topology.

Parameters:

topology is 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 (\fBhwloc_topology_t\fPtopology)

Terminate and free a topology context.

Parameters:

topology is the topology to be freed

int hwloc_topology_init (\fBhwloc_topology_t\fP *topologyp)

Allocate a topology context.

Parameters:

topologyp is assigned a pointer to the new allocated context.

Returns:

0 on success, -1 on error.

int hwloc_topology_load (\fBhwloc_topology_t\fPtopology)

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:

topology is 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

Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code.