18.2.129. PMIx_Info_qualifier

PMIx_Info_qualifier — Mark a pmix_info_t(5) as a qualifier

18.2.129.1. SYNOPSIS

#include <pmix.h>

void PMIx_Info_qualifier(pmix_info_t *p);

18.2.129.1.1. Python Syntax

No Python equivalent

18.2.129.2. INPUT PARAMETERS

p: Pointer to the pmix_info_t(5) structure to be marked as a qualifier.

18.2.129.3. DESCRIPTION

The PMIx_Info_qualifier function sets the PMIX_INFO_QUALIFIER directive bit in the info structure’s flags field. Marking an info as a qualifier indicates that it does not stand on its own but instead refines or scopes a primary value — for example, an info array passed to a query may contain a primary key together with one or more qualifiers that narrow the request.

Whether an info is currently marked as a qualifier can be tested with PMIx_Info_is_qualifier(3).

18.2.129.4. RETURN VALUE

PMIx_Info_qualifier returns no value (void).

18.2.129.5. NOTES

PMIx_Info_qualifier is the OpenPMIx routine underlying the historical PMIX_INFO_SET_QUALIFIER macro. That macro is retained in pmix_deprecated.h for backward compatibility and simply expands to a call to this function.