17.2.367. MPI_T_pvar_reset

MPI_T_pvar_reset — Reset the value of a performance variable

17.2.367.1. SYNTAX

17.2.367.1.1. C Syntax

#include <mpi.h>

int MPI_T_pvar_reset(MPI_T_pvar_session session, MPI_T_pvar_handle handle)

17.2.367.2. INPUT PARAMETERS

  • session: Performance experiment session.

  • handle: Performance variable handle or MPI_T_PVAR_ALL_HANDLES.

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

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