Scroll to navigation

MPI_T_EVENT_REGISTER_CALLBACK(3) Open MPI MPI_T_EVENT_REGISTER_CALLBACK(3)

NAME

MPI_T_event_register_callback - Associates a user-defined function with an allocated event-registration handle

MPI_T_event_register_callback — Associates a user-defined function with an allocated event-registration handle

SYNTAX

C Syntax

int MPI_T_event_register_callback(MPI_T_event_registration


    event_registration, MPI_T_cb_safety cb_safety, MPI_Info info,


    void* user_data, MPI_T_event_cb_function event_cb_function)


INPUT PARAMETERS

  • event_registration: Event registration
  • cb_safety: maximum callback safety level
  • info: Info argument
  • user_data: pointer to a user-controlled buffer
  • event_cb_function: pointer to user-defined callback function

DESCRIPTION

MPI_T_event_register_callback associates a user-defined function pointed to by event_cb_function with an allocated event-registration handle. The maximum callback safety level supported by the callback function is passed in the argument cb_safety.

ERRORS

MPI_T_event_register_callback 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_INFO: Invalid info
  • MPI_T_ERR_OTHER: Other error

See also:

  • 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