18.3.21. pmix_persistence_t

pmix_persistence_t — Defines the retention policy for data published by a process

18.3.21.1. SYNTAX

18.3.21.1.1. C Syntax

#include <pmix_common.h>

typedef uint8_t pmix_persistence_t;

#define PMIX_PERSIST_INDEF          0   // retain until specifically deleted
#define PMIX_PERSIST_FIRST_READ     1   // delete upon first access
#define PMIX_PERSIST_PROC           2   // retain until publishing process terminates
#define PMIX_PERSIST_APP            3   // retain until application terminates
#define PMIX_PERSIST_SESSION        4   // retain until session/allocation terminates
#define PMIX_PERSIST_INVALID   UINT8_MAX

18.3.21.1.2. Python Syntax

None

18.3.21.2. DESCRIPTION

The pmix_persistence_t type is used to specify how long published data is to be retained by the datastore before being automatically deleted. It is passed as the PMIX_PERSISTENCE attribute to PMIx_Publish(3). Defined values include:

Persistence Values
NAME	VALUE	DESCRIPTION
PMIX_PERSIST_INDEF	0	Retain the data until it is specifically deleted (e.g., via PMIx_Unpublish(3)).
PMIX_PERSIST_FIRST_READ	1	Delete the data upon its first access.
PMIX_PERSIST_PROC	2	Retain the data until the publishing process terminates.
PMIX_PERSIST_APP	3	Retain the data until the application terminates.
PMIX_PERSIST_SESSION	4	Retain the data until the session/allocation terminates.
PMIX_PERSIST_INVALID	UINT8_MAX	An invalid persistence value, used to indicate that no valid persistence policy has been set.

18.3.21.3. ERRORS

PMIx errno values are defined in pmix_common.h.