Scroll to navigation

PMIX_APP_INFO_CREATE(3) OpenPMIx PMIX_APP_INFO_CREATE(3)

PMIx_App_info_create — Allocate and attach an array of pmix_info_t(5) <#man5-pmix-info-t> structures to the info field of a pmix_app_t(5) <#man5-pmix-app-t>.

SYNOPSIS

#include <pmix.h>
void PMIx_App_info_create(pmix_app_t *p, size_t n);


Python Syntax

No Python equivalent

INPUT PARAMETERS

  • p: Pointer to the pmix_app_t(5) <#man5-pmix-app-t> structure whose info array is to be created.
  • n: Number of pmix_info_t(5) <#man5-pmix-info-t> structures to allocate.

DESCRIPTION

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

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.

NOTES

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

See also:

PMIx_App_construct(3) <#man3-pmix-app-construct>, PMIx_App_destruct(3) <#man3-pmix-app-destruct>, PMIx_App_create(3) <#man3-pmix-app-create>, PMIx_App_free(3) <#man3-pmix-app-free>, PMIx_App_release(3) <#man3-pmix-app-release>, PMIx_Info_create(3) <#man3-pmix-info-create>, pmix_app_t(5) <#man5-pmix-app-t>, pmix_info_t(5) <#man5-pmix-info-t>


Copyright

2014-2026, OpenPMIx Community

September 27, 2026