17.2.372. MPI_T_event_get_num

MPI_T_event_get_num — Query the number of MPI_T event types

17.2.372.1. SYNTAX

17.2.372.1.1. C Syntax

#include <mpi.h>

int MPI_T_event_get_num(int *num_events)

17.2.372.2. OUTPUT PARAMETERS

  • num_events: Returns number of event types

17.2.372.3. DESCRIPTION

MPI_T_event_get_num can be used to query the current number of MPI_T event types.

The number of available event types can be queried with a call to MPI_T_event_get_num. An MPI implementation is allowed to increase the number of event types during the execution of an MPI process. However, MPI implementations are not allowed to change the index of an event type or to delete an event type once it has been made visible to the user.

Note

Open MPI will currently return that there are 0 event types.

17.2.372.4. ERRORS

MPI_T_event_get_num will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface is not initialized