NAME

       MPI_T_pvar_handle_alloc, MPI_T_pvar_handle_free - Allocate/free MPI performance variable handles

SYNTAX

C Syntax

       #include <mpi.h>
       int MPI_T_pvar_handle_alloc(int pvar_index, void *obj_handle,
                                   MPI_T_pvar_handle *handle, int *count)

       int MPI_T_pvar_handle_free(MPI_T_pvar_handle *handle)

DESCRIPTION

       MPI_T_pvar_handle_alloc  binds  the  performance  variable  specified  in  pvar_index  to  the MPI object
       specified in obj_handle. If MPI_T_pvar_get_info returns  MPI_T_BIND_NO_OBJECT  as  the  binding  for  the
       variable  the  obj_handle  argument  is  ignored.  The  number  of values represented by this performance
       variable is returned in the count parameter.

       MPI_T_pvar_handle_free frees a handle allocated by MPI_T_pvar_handle_alloc and sets the  handle  argument
       to MPI_T_PVAR_HANDLE_NULL.

ERRORS

       MPI_T_pvar_handle_alloc() will fail if:

       [MPI_T_ERR_NOT_INITIALIZED]
                 The MPI Tools interface not initialized

       [MPI_T_ERR_INVALID_INDEX]
                 The performance variable index is invalid

       [MPI_T_ERR_OUT_OF_HANDLES]
                 No more handles available

       MPI_T_pvar_handle_free() will fail if:

       [MPI_T_ERR_NOT_INITIALIZED]
                 The MPI Tools interface not initialized

       [MPI_T_ERR_INVALID_HANDLE]
                 The handle is invalid

SEE ALSO

       MPI_T_pvar_get_info

2.1.1                                             May 10, 2017                        MPI_T_pvar_handle_alloc(3)