17.2.397. MPI_T_source_get_num

MPI_T_source_get_num — Query the number of MPI_T event sources

17.2.397.1. SYNTAX

17.2.397.1.1. C Syntax

#include <mpi.h>

int MPI_T_source_get_num(int *num_sources)

17.2.397.2. OUTPUT PARAMETERS

  • num_sources: Current number of sources

17.2.397.3. 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

Open MPI will currently return that there are 0 sources of MPI_T events.

17.2.397.4. ERRORS

MPI_T_source_get_num will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface is not initialized