Scroll to navigation

MPI_T_EVENT_HANDLE_FREE(3) Open MPI MPI_T_EVENT_HANDLE_FREE(3)

NAME

MPI_T_event_handle_free - UNKNOWN

MPI_T_event_handle_free - Free event handles

SYNTAX

C Syntax

int MPI_T_event_handle_free(MPI_T_event_registration


    event_registration, void* user_data,


    MPI_T_event_free_cb_function free_cb_function)


INPUT PARAMETERS

  • user_data: Pointer to a user-controlled buffer.
  • free_cb_function: Pointer to user-defined callback function.

INPUT/OUTPUT PARAMETERS

•
event_registration: Event registration.

DESCRIPTION

MPI_T_event_handle_free frees a handle allocated by MPI_T_event_handle_alloc <#mpi-t-event-handle-alloc>.

ERRORS

MPI_T_event_handle_free will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface is not initialized.
  • MPI_T_ERR_INVALID_HANDLE: The handle is invalid.
  • MPI_T_ERR_INVALID_HANDLE: Invalid use of the interface or bad parameter values(s).
  • MPI_T_ERR_OTHER: Other error

See also:

  • MPI_T_event_get_info <#mpi-t-event-get-info>
  • MPI_T_Events <#mpi-t-events>
  • MPI_T <#mpi-t>



Author

The Open MPI community

Copyright

2003-2026, The Open MPI Community

October 13, 2026