Scroll to navigation

PMIX_TOPOLOGY_DESTRUCT(3) OpenPMIx PMIX_TOPOLOGY_DESTRUCT(3)

PMIx_Topology_destruct — Release the contents of a pmix_topology_t(5) <#man5-pmix-topology-t> structure.

SYNOPSIS

#include <pmix.h>
void PMIx_Topology_destruct(pmix_topology_t *topo);


Python Syntax

No Python equivalent

INPUT PARAMETERS

•
topo: Pointer to the pmix_topology_t(5) <#man5-pmix-topology-t> structure whose contents are to be released.

DESCRIPTION

Release the internal payload held within a pmix_topology_t <#man5-pmix-topology-t> structure. When the structure describes an hwloc topology (its source string begins with "hwloc"), the function destroys the embedded hwloc topology object, frees the source string, and sets both pointers to NULL. Structures with any other source (or none) are left untouched, since their topology payload is not owned by the library.

PMIx_Topology_destruct releases only the contents of the structure; it does not free the storage of the pmix_topology_t structure itself. When the structure was allocated on the stack or embedded in another object, that storage is reclaimed by its owner.

RETURN VALUE

PMIx_Topology_destruct returns no value (void).

NOTES

PMIx_Topology_destruct is the counterpart to PMIx_Topology_construct(3) <#man3-pmix-topology-construct>. To release an array of structures that was allocated by PMIx_Topology_create(3) <#man3-pmix-topology-create>, including the array storage itself, use PMIx_Topology_free(3) <#man3-pmix-topology-free> instead.

See also:

PMIx_Topology_construct(3) <#man3-pmix-topology-construct>, PMIx_Topology_create(3) <#man3-pmix-topology-create>, PMIx_Topology_free(3) <#man3-pmix-topology-free>, pmix_topology_t(5) <#man5-pmix-topology-t>


Copyright

2014-2026, OpenPMIx Community

September 27, 2026