PAPI_event_code_to_name(3)

💖 NAME 💖

okay so bestie, welcome to the PAPI_event_code_to_name(3) manual page — this is the PAPI page where PAPI_event_code_to_name converts a numeric hardware event code to a name. ✨

---

🎀 SYNOPSIS 🎀

the C interface is literally right below in Detailed Description, bestie — keep scrolling 💅

---

🦋 DETAILED DESCRIPTION 🦋

so here’s the tea: 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. no cap 💜

💻 C Interface:

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

🌸 Parameters

• EventCode — the numeric code for the event. 🎀
• *EventName — a string containing the event name as listed in PAPI_presets or discussed in PAPI_native. 🦋

⭐ Return values

• PAPI_EINVAL — one or more of the arguments is invalid. 💀
• PAPI_ENOTPRESET — the hardware event specified is not a valid PAPI preset.
• PAPI_ENOEVNT — the 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
if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
handle_error( 1 );
// Add Total Instructions Executed to our EventSet
if ( PAPI_add_event( EventSet, PAPI_TOT_INS ) != PAPI_OK )
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 );

🔗 See also

• PAPI_event_name_to_code
• PAPI_remove_event
• PAPI_get_event_info
• PAPI_enum_event
• PAPI_add_event
• PAPI_presets
• PAPI_native

---

👑 AUTHOR 👑

Generated automatically by Doxygen for PAPI from the source code.

---

that’s the whole page, bestie 🫶 — mwah! This was PAPI version 7.2.0.0, dated Wed Jun 25 2025 19:30:48, and the page is PAPI_event_code_to_name(3). periodt 💅✨