Scroll to navigation

MPI_T_SOURCE_GET_NUM(3) Open MPI MPI_T_SOURCE_GET_NUM(3)

NAME

MPI_T_source_get_num - Query the number of MPI_T event sources

MPI_T_source_get_num — Query the number of MPI_T event sources

OUTPUT PARAMETERS

•
num_sources: Current number of sources

DESCRIPTION

MPI_T_source_get_num can be used to query the current number of MPI_T event sources.

The number of available event sources can be queried with a call to MPI_T_source_get_num. An MPI implementation is allowed to increase the number of sources during the execution of an MPI process. However, MPI implementations are not allowed to change the index of an event source or to delete an event source once it has been made visible to the user (e.g., if new event sources become available via dynamic loading of additional components in the MPI implementation).

Note:

The set of event sources Open MPI exports depends on the platform and on MCA parameters. With all built-in producers disabled (the MCA parameter mca_base_event_register_producers set to 0) the count is 0. Use ompi_info --event to list the registered sources and event types.


ERRORS

MPI_T_source_get_num will fail if:

•
MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface is not initialized

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 18, 2026