PAPI_add_named_event(3)

💅 PAPI_add_named_event(3) 💅

okay so welcome to the PAPI manual, section 3, bestie — this is the whole vibe for PAPI_add_named_event, and it's literally about adding a PAPI preset or native hardware event, by name, to an EventSet. 🫶

---

💖 NAME 💖

PAPI_add_named_event — add a PAPI preset or native hardware event by name to an EventSet. no cap, that's the whole mission. ✨

✨ SYNOPSIS ✨

🎀 Detailed Description 🎀

C Interface:

#include <papi.h>
int PAPI_add_named_event( int EventSet, const char *EventName );

PAPI_add_named_event adds one event to a PAPI EventSet. Just one. One event. That's the assignment. 💅

A hardware event can be either a PAPI preset or a native hardware event code — both are valid, fr fr.

For a list of PAPI preset events, see PAPI_presets or run the avail test case in the PAPI distribution. PAPI presets can be passed to PAPI_query_event to see if they exist on the underlying architecture. For a list of native events available on the current platform, run the papi_native_avail utility in the PAPI distribution. iconic. 🌈

🌸 Parameters 🌸

• EventSet — an integer handle for a PAPI Event Set as created by PAPI_create_eventset. 🎀
• EventCode — a defined event such as PAPI_TOT_INS. ⭐

yes bestie, the page really does say EventCode here — I'm not changing the lore, I'm just delivering it exactly. 💀

💅 Return values 💅

• Positive-Integer — the number of consecutive elements that succeeded before the error. 👑
• PAPI_EINVAL — one or more of the arguments is invalid.
• PAPI_ENOINIT — the PAPI library has not been initialized.
• PAPI_ENOMEM — insufficient memory to complete the operation.
• PAPI_ENOEVST — the event set specified does not exist.
• PAPI_EISRUN — the event set is currently counting events.
• PAPI_ECNFLCT — the underlying counter hardware can not count this event and other events in the event set simultaneously.
• PAPI_ENOEVNT — the PAPI preset is not available on the underlying hardware.
• PAPI_EBUG — internal error, please send mail to the developers. 😭
• PAPI_EMULPASS — event exists, but cannot be counted due to multiple passes required by hardware.

🦋 Examples 🦋

           char EventName = "PAPI_TOT_INS";
           int EventSet = PAPI_NULL;
           unsigned int native = 0x0;
           if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
           handle_error( 1 );
           // Add Total Instructions Executed to our EventSet
           if ( PAPI_add_named_event( EventSet, EventName ) != PAPI_OK )
           handle_error( 1 );
           // Add native event PM_CYC to EventSet
           if ( PAPI_add_named_event( EventSet, "PM_CYC" ) != PAPI_OK )
           handle_error( 1 );

🎀 See also 🎀

• PAPI_add_event
• PAPI_query_named_event
• PAPI_remove_named_event

👑 Author 👑

Generated automatically by Doxygen for PAPI from the source code. honestly? slay. ✨

---

💖 cute little sign-off: this page is from PAPI version 7.2.0.0, dated Wed Jun 25 2025 19:30:48, and it's the PAPI_add_named_event(3) page. mwah 💋