Scroll to navigation

PMIX_CHECK_PROCID(3) OpenPMIx PMIX_CHECK_PROCID(3)

PMIx_Check_procid — Compare two pmix_proc_t(5) <#man5-pmix-proc-t> process identifiers for equality

SYNOPSIS

#include <pmix.h>
bool PMIx_Check_procid(const pmix_proc_t *a,


                       const pmix_proc_t *b);


Python Syntax

No Python equivalent

INPUT PARAMETERS

  • a: Pointer to the first pmix_proc_t(5) <#man5-pmix-proc-t> to be compared.
  • b: Pointer to the second pmix_proc_t(5) <#man5-pmix-proc-t> to be compared.

DESCRIPTION

Compare two process identifiers for equality. The two are considered equal when both their namespaces match (as determined by PMIx_Check_nspace(3) <#man3-pmix-check-nspace>) and their ranks match (as determined by PMIx_Check_rank(3) <#man3-pmix-check-rank>).

Because the underlying namespace and rank comparisons both apply wildcard semantics, this is a matching test rather than a strict byte-for-byte comparison: an invalid namespace matches any namespace, and PMIX_RANK_WILDCARD matches any rank. Both wildcards are easy to inherit by accident from data that is legitimately unset. Where the question being asked is “do these two name the same process” rather than “does this match the specification”, use PMIx_Check_procid_strict(3) <#man3-pmix-check-procid-strict>.

A NULL argument is accepted: two absent procIDs are reported as equal, and an absent one is not equal to a present one.

RETURN VALUE

Returns true if both the namespace and rank of a and b are considered equal, and false otherwise.

NOTES

PMIx_Check_procid is an OpenPMIx convenience routine and is the backing implementation of the PMIX_CHECK_PROCID macro.

See also:

PMIx_Check_procid_strict(3) <#man3-pmix-check-procid-strict>, PMIx_Load_procid(3) <#man3-pmix-load-procid>, PMIx_Check_nspace(3) <#man3-pmix-check-nspace>, PMIx_Check_rank(3) <#man3-pmix-check-rank>, PMIx_Procid_invalid(3) <#man3-pmix-procid-invalid>, pmix_proc_t(5) <#man5-pmix-proc-t>


Copyright

2014-2026, OpenPMIx Community

September 27, 2026