17.2.399. MPI_T_source_get_info

MPI_T_source_get_info — Query information from a source

17.2.399.1. SYNTAX

17.2.399.1.1. C Syntax

int MPI_T_source_get_info(int source_index, char* name, int*
    name_len, char* desc, int* desc_len, MPI_T_source_order*
    ordering, MPI_Count* ticks_per_second, MPI_Count* max_ticks,
    MPI_Info* info)

17.2.399.2. INPUT PARAMETERS

  • source_index: Index of the source to be queried.

17.2.399.3. INPUT/OUTPUT PARAMETERS

  • name_len: Length of the string and/or buffer for name.

  • desc_len: Length of the string and/or buffer for desc.

17.2.399.4. OUTPUT PARAMETERS

  • name: Buffer to return the string containing the name of the source.

  • desc: Buffer to return the string containing the description of the source.

  • ordering: Flag indicating chronological ordering guarantees given by the source.

  • ticks_per_second: The number of ticks per second for the timer of this source.

  • max_ticks: The maximum count of ticks reported by this source before overflow occurs.

  • info: Info argument.

17.2.399.5. DESCRIPTION

MPI_T_source_get_info can be used to query information from a source.

17.2.399.6. ERRORS

MPI_T_source_get_info will fail if:

  • MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface not initialized

  • MPI_T_ERR_INVALID_INDEX: The source index is invalid