18.2.151. PMIx_App_info_create

PMIx_App_info_create — Allocate and attach an array of pmix_info_t(5) structures to the info field of a pmix_app_t(5).

18.2.151.1. SYNOPSIS

#include <pmix.h>

void PMIx_App_info_create(pmix_app_t *p, size_t n);

18.2.151.1.1. Python Syntax

No Python equivalent

18.2.151.2. INPUT PARAMETERS

p: Pointer to the pmix_app_t(5) structure whose info array is to be created.
n: Number of pmix_info_t(5) structures to allocate.

18.2.151.3. DESCRIPTION

Allocate an array of n pmix_info_t structures (equivalent to PMIx_Info_create(3)), store the resulting pointer in the info field of the supplied pmix_app_t, and set the ninfo field to n. This is a convenience routine for populating an app’s directive array.

18.2.151.4. RETURN VALUE

PMIx_App_info_create returns no value (void). The result is delivered by setting p->info and p->ninfo; p->info will be NULL if n is zero or the allocation fails.

18.2.151.5. NOTES

The info array created here is released when the enclosing app is destructed or freed — via PMIx_App_destruct(3), PMIx_App_free(3), or PMIx_App_release(3). Do not separately free p->info after handing the app to one of those routines.