18.3.22. pmix_app_t

pmix_app_t — Describes an application context for spawn operations

18.3.22.1. SYNTAX

18.3.22.1.1. 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;

18.3.22.2. DESCRIPTION

The pmix_app_t structure describes the application context for the PMIx_Spawn(3) and PMIx_Spawn_nb operations. Each structure fully specifies one application to be launched.

The fields are:

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

18.3.22.3. 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;