Scroll to navigation

PMIX_APP_T(5) OpenPMIx PMIX_APP_T(5)

pmix_app_t — Describes an application context for spawn operations

SYNTAX

C Syntax

#include <pmix_common.h>
typedef struct pmix_app {


    char *cmd;


    char **argv;


    char **env;


    char *cwd;


    int maxprocs;


    pmix_info_t *info;


    size_t ninfo;
} pmix_app_t;


DESCRIPTION

The pmix_app_t structure describes the application context for the PMIx_Spawn(3) <#man3-pmix-spawn> and PMIx_Spawn_nb operations. Each structure fully specifies one application to be launched.

The fields are:

The executable to be launched, given as a string.
A NULL-terminated, argv-style array of argument strings passed to the executable.
A NULL-terminated, argv-style array of environment variable strings to be set in the environment of the spawned processes.
The current working directory in which the spawned processes are to be started.
The maximum number of processes to be started with this application profile.
An array of pmix_info_t <#man5-pmix-info-t> structures containing attributes that describe this application (e.g., directives influencing how it is to be launched).
The number of elements in the info array.

STATIC INITIALIZER

A statically declared pmix_app_t may be initialized with the PMIX_APP_STATIC_INIT macro, which sets cmd, argv, env, cwd, and info to NULL and maxprocs and ninfo to 0:

pmix_app_t app = PMIX_APP_STATIC_INIT;


See also:

PMIx_Spawn(3) <#man3-pmix-spawn>, pmix_info_t(5) <#man5-pmix-info-t>


Copyright

2014-2026, OpenPMIx Community

October 5, 2026