MPI_T_PVAR_RESET(3)				     Open MPI				       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-handle-alloc>

	  • MPI_T_pvar_get_info <#mpi-t-pvar-get-info>

	  • MPI_T_pvar_session_create <#mpi-t-pvar-session-create>

	  • MPI_T_pvar_write <#mpi-t-pvar-write>

Copyright
       2003-2026, The Open MPI Community

						   Mar 05, 2026				       MPI_T_PVAR_RESET(3)
