18.3.5. pmix_proc_t

pmix_proc_t — Identifies a single process in the PMIx universe

18.3.5.1. SYNTAX

18.3.5.1.1. C Syntax

#include <pmix_common.h>

typedef struct pmix_proc {
    pmix_nspace_t nspace;
    pmix_rank_t rank;
} pmix_proc_t;

18.3.5.2. 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) (a NULL-terminated character array) identifying the job to which the process belongs.
rank — The pmix_rank_t(5) 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.

18.3.5.3. 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;