PAPI 7.1.0.0
Loading...
Searching...
No Matches
PAPI_event_code_to_name Class Reference

Convert a numeric hardware event code to a name. More...

Detailed Description

C Interface:
#include <papi.h>
int PAPI_event_code_to_name( int EventCode, char * EventName );

PAPI_event_code_to_name is used to translate a 32-bit integer PAPI event code into an ASCII PAPI event name. Either Preset event codes or Native event codes can be passed to this routine. Native event codes and names differ from platform to platform.

Parameters
EventCodeThe numeric code for the event.
*EventNameA string containing the event name as listed in PAPI_presets or discussed in PAPI_native.
Return values
PAPI_EINVALOne or more of the arguments is invalid.
PAPI_ENOTPRESETThe hardware event specified is not a valid PAPI preset.
PAPI_ENOEVNTThe hardware event is not available on the underlying hardware.
Examples:
int EventCode, EventSet = PAPI_NULL;
int Event, number;
char EventCodeStr[PAPI_MAX_STR_LEN];
// Create the EventSet
handle_error( 1 );
// Add Total Instructions Executed to our EventSet
handle_error( 1 );
number = 1;
if ( PAPI_list_events( EventSet, &Event, &number ) != PAPI_OK )
handle_error(1);
// Convert integer code to name string
if ( PAPI_event_code_to_name( Event, EventCodeStr ) != PAPI_OK )
handle_error( 1 );
printf( "Event Name: %s\n", EventCodeStr );
static int Event[MAX_EVENTS]
add PAPI preset or native hardware event to an event set
Create a new empty PAPI EventSet.
Convert a numeric hardware event code to a name.
list the events in an event set
#define PAPI_OK
Definition: f90papi.h:73
#define PAPI_NULL
Definition: f90papi.h:78
#define PAPI_MAX_STR_LEN
Definition: f90papi.h:77
#define PAPI_TOT_INS
Definition: f90papi.h:317
static int EventSet
Definition: init_fini.c:8
See also
PAPI_event_name_to_code
PAPI_remove_event
PAPI_get_event_info
PAPI_enum_event
PAPI_add_event
PAPI_presets
PAPI_native

The documentation for this class was generated from the following file: