manpagez: man pages & more
man MPI_T_event_handle_alloc(3)
Home | html | info | man
MPI_T_event_handle_alloc(3)           MPI          MPI_T_event_handle_alloc(3)




NAME

       MPI_T_event_handle_alloc -  Creates a registration handle for the event
       type identified by event_index


SYNOPSIS

       int MPI_T_event_handle_alloc(int event_index, void *obj_handle, MPI_Info info,
       MPI_T_event_registration *event_registration)


INPUT PARAMETERS

       event_index
              - index of event type for which the registration handle is to be
              allocated (integer)
       obj_handle
              - reference to a handle of the mpi object to which this event is
              supposed to be bound (pointer)
       info   - info object (handle)



OUTPUT PARAMETERS

       event_registration
              - event registration (handle)



THREAD AND INTERRUPT SAFETY

       This routine is thread-safe.  This  means  that  this  routine  may  be
       safely  used by multiple threads without the need for any user-provided
       thread locks.  However, the routine is not interrupt safe.   Typically,
       this  is due to the use of memory allocation routines such as malloc or
       other non-MPICH runtime routines that  are  themselves  not  interrupt-
       safe.



ERRORS

       All  MPI  routines  (except  MPI_Wtime  and MPI_Wtick ) return an error
       value; C routines as the value of the function and Fortran routines  in
       the last argument.  Before the value is returned, the current MPI error
       handler is called.  By default, this error handler aborts the MPI  job.
       The error handler may be changed with MPI_Comm_set_errhandler (for com-
       municators),     MPI_File_set_errhandler     (for      files),      and
       MPI_Win_set_errhandler   (for   RMA   windows).    The   MPI-1  routine
       MPI_Errhandler_set may be used but its use is deprecated.   The  prede-
       fined error handler MPI_ERRORS_RETURN may be used to cause error values
       to be returned.  Note that MPI does not guarantee that an  MPI  program
       can  continue  past an error; however, MPI implementations will attempt
       to continue whenever possible.

       MPI_SUCCESS
              - No error; MPI routine completed successfully.

       MPI_ERR_INFO
              - Invalid Info
       MPI_T_ERR_INVALID
              - Invalid use of the interface or bad parameter values(s).
       MPI_T_ERR_INVALID_INDEX
              - Index is invalid or has been deleted.
       MPI_T_ERR_NOT_INITIALIZED
              - The MPI tool information interface is not initialized.
       MPI_ERR_OTHER
              - Other error; use  MPI_Error_string  to  get  more  information
              about this error code.




                                   2/22/2022       MPI_T_event_handle_alloc(3)

mpi 4.0.1 - Generated Sun Apr 10 05:50:39 CDT 2022
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.