---
name: "MPI_T_pvar_reset"
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_reset"
---

# MPI\_T\_pvar\_reset(3)

*MPI\_T\_pvar\_reset* — Reset the value of a performance variable

## SYNTAX

### C Syntax

```
#include <mpi.h>
int MPI_T_pvar_reset(MPI_T_pvar_session session, MPI_T_pvar_handle handle)
```

## INPUT PARAMETERS

- •

  **session**: Performance experiment session.

- •

  **handle**: Performance variable handle or MPI\_T\_PVAR\_ALL\_HANDLES.

## DESCRIPTION

*MPI\_T\_pvar\_reset* sets the performance variable specified by the handle in *handle* to its initial value. The special value MPI\_T\_PVAR\_ALL\_HANDLES can be passed in *handle* to reset all read-write handles in the session specified in *session*.

## ERRORS

*MPI\_T\_pvar\_reset* will fail if:

- •

  **MPI\_T\_ERR\_NOT\_INITIALIZED**: The MPI Tools interface not initialized

- •

  **MPI\_T\_ERR\_INVALID\_HANDLE**: The handle is invalid

- •

  **MPI\_T\_ERR\_INVALID\_SESSION**: Session argument is not a valid session

- •

  **MPI\_T\_ERR\_PVAR\_NO\_WRITE**: Variable cannot be reset

**SEE ALSO:**

- •

  *MPI\_T\_pvar\_handle\_alloc*

- •

  *MPI\_T\_pvar\_get\_info*

- •

  *MPI\_T\_pvar\_session\_create*

- •

  *MPI\_T\_pvar\_write*

## COPYRIGHT

2003-2026, The Open MPI Community