diff --git a/Chap_API_Proc_Mgmt.tex b/Chap_API_Proc_Mgmt.tex index 915c3bdd..084ad4ae 100644 --- a/Chap_API_Proc_Mgmt.tex +++ b/Chap_API_Proc_Mgmt.tex @@ -1148,7 +1148,11 @@ \subsubsection{Topology description} \cspecificend %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\subsubsection{Initialize the topology description structure} +\subsubsection{Topology support macros} + +The following macros support the \refstruct{pmix_topology_t} structure. + +\littleheader{Initialize the topology structure} \declaremacro{PMIX_TOPOLOGY_CONSTRUCT} Initialize the \refstruct{pmix_topology_t} fields to \code{NULL} @@ -1165,6 +1169,24 @@ \subsubsection{Initialize the topology description structure} \end{arglist} +\littleheader{Create a topology array} +\declaremacro{PMIX_TOPOLOGY_CREATE} + +Allocate and initialize a \refstruct{pmix_topology_t} array. + +\versionMarker{4.0} +\cspecificstart +\begin{codepar} +PMIX_TOPOLOGY_CREATE(m, n) +\end{codepar} +\cspecificend + +\begin{arglist} +\arginout{m}{Address where the pointer to the array of \refstruct{pmix_topology_t} structures shall be stored (handle)} +\argin{n}{Number of structures to be allocated (size_t)} +\end{arglist} + + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \subsubsection{Relative locality of two processes} \declarestruct{pmix_locality_t}