17.2.368. MPI_T_pvar_session_create

MPI_T_pvar_session_create, MPI_T_pvar_session_free - Create/free performance variable session

17.2.368.1. SYNTAX

17.2.368.1.1. C Syntax

#include <mpi.h>

int MPI_T_pvar_session_create(MPI_T_pvar_session *session)

int MPI_T_pvar_session_free(MPI_T_pvar_session *session)

17.2.368.2. DESCRIPTION

MPI_T_pvar_session_create creates a session for accessing performance variables. The new session is returned in the session parameter.

MPI_T_pvar_session_free releases a session allocated by MPI_T_pvar_session_create and sets the session parameter to MPI_T_PVAR_SESSION_NULL.

17.2.368.3. ERRORS

MPI_T_pvar_session_create will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface not initialized

  • MPI_T_ERR_MEMORY: Out of memory

  • MPI_T_ERR_OUT_OF_SESSIONS: No more sessions available

MPI_T_pvar_session_free will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface not initialized

  • MPI_T_ERR_INVALID_SESSION: The session parameter is not a valid session