---
name: "MPI_T_pvar_session_create"
section: "3"
platform: "linux"
package: "openmpi"
version: "5.0.11-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/MPI_T_pvar_session_create"
---

# MPI\_T\_pvar\_session\_create(3)

*MPI\_T\_pvar\_session\_create*, *MPI\_T\_pvar\_session\_free* - Create/free performance variable session

## 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

*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.

## 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

## COPYRIGHT

2003-2026, The Open MPI Community