MPI\_T\_PVAR\_SESSION\_FREE(3) Open MPI MPI\_T\_PVAR\_SESSION\_FREE(3)

MPI\_T\_pvar\_session\_create <#mpi-t-pvar-session-create>, MPI\_T\_pvar\_session\_free - Create/free performance variable session

# [SYNTAX](#SYNTAX)

## [C Syntax](#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)
```

# [DESCRIPTION](#DESCRIPTION)

MPI\_T\_pvar\_session\_create &lt;#mpi-t-pvar-session-create&gt; 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 &lt;#mpi-t-pvar-session-create&gt; and sets the *session* parameter to MPI\_T\_PVAR\_SESSION\_NULL.

# [ERRORS](#ERRORS)

MPI\_T\_pvar\_session\_create &lt;#mpi-t-pvar-session-create&gt; 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

# [Copyright](#Copyright)

2003-2026, The Open MPI Community

October 11, 2026

---

Document: MPI_T_pvar_session_free(3) from openmpi-cuda-13.4 5.0.11-r1 (Chainguard OS)