Scroll to navigation

PMIX_PROC_T(5) OpenPMIx PMIX_PROC_T(5)

pmix_proc_t — Identifies a single process in the PMIx universe

SYNTAX

C Syntax

#include <pmix_common.h>
typedef struct pmix_proc {


    pmix_nspace_t nspace;


    pmix_rank_t rank;
} pmix_proc_t;


DESCRIPTION

The pmix_proc_t structure is used to identify a single process in the PMIx universe. It contains a reference to the namespace and the rank within that namespace.

The fields are:

  • nspace — The pmix_nspace_t(5) <#man5-pmix-nspace-t> (a NULL-terminated character array) identifying the job to which the process belongs.
  • rank — The pmix_rank_t(5) <#man5-pmix-rank-t> of the process within that namespace. A number of reserved rank values (e.g., PMIX_RANK_WILDCARD) may be placed in this field to reference groups of processes or to indicate that only the nspace field is significant.

The macro PMIX_PROC_STATIC_INIT is provided to statically initialize the fields of a pmix_proc_t structure, setting nspace to all zeroes and rank to PMIX_RANK_UNDEF.

STATIC INITIALIZER

A statically declared pmix_proc_t may be initialized with the PMIX_PROC_STATIC_INIT macro, which clears nspace and sets rank to PMIX_RANK_UNDEF:

pmix_proc_t proc = PMIX_PROC_STATIC_INIT;


See also:

pmix_nspace_t(5) <#man5-pmix-nspace-t>, pmix_rank_t(5) <#man5-pmix-rank-t>, pmix_proc_info_t(5) <#man5-pmix-proc-info-t>


Copyright

2014-2026, OpenPMIx Community

September 27, 2026