Scroll to navigation

MPI_T_EVENT_HANDLE_ALLOC(3) Open MPI MPI_T_EVENT_HANDLE_ALLOC(3)

NAME

MPI_T_event_handle_alloc - UNKNOWN

MPI_T_event_handle_alloc - Allocate event handles

SYNTAX

C Syntax

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.
  • obj_handle: reference to a handle of the MPI object to which this event is supposed to be bound.
  • info: Info object.

OUTPUT PARAMETERS

•
event_registration: Event registration.

DESCRIPTION

MPI_T_event_handle_alloc binds the control variable specified in event_index to the MPI object specified in obj_handle. If MPI_T_event_get_info <#mpi-t-event-get-info> returns MPI_T_BIND_NO_OBJECT as the binding of the variable the obj_handle argument is ignored.

Note:

When the event type is bound to an object, obj_handle is the address of the variable holding that MPI object’s handle, and the resulting registration is notified only when the event occurs for that specific object. For the list of Open MPI’s built-in event types – which are bound to an object and which are MPI_T_BIND_NO_OBJECT – and a fuller description of binding, see MPI_T_Events <#mpi-t-events>.


ERRORS

MPI_T_event_handle_alloc 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