PAPI_remove_named_event(3)

💅 PAPI_remove_named_event(3) — the "bye bestie" page 💅

okay so this is a page from the PAPI manual, bestie, and it's lowkey so useful. It's all about PAPI_remove_named_event — the function that removes a named hardware event from a PAPI event set. Think of it as the un-invite button for an event you already added to your set 🎀

---

✨ NAME ✨

PAPI_remove_named_event — removes a named hardware event from a PAPI event set. periodt 💅

---

🌸 SYNOPSIS 🌸

Detailed Description 🦋

so listen. A hardware event can be either a PAPI Preset or a native hardware event code — those are the two flavors, iykyk.

• Wanna see the list of PAPI preset events? Check out PAPI_presets, or just run the papi_avail utility that ships in the PAPI distribution ✨
• You can also pass PAPI Presets to PAPI_query_event to find out if they even exist on the underlying architecture 👀
• Wanna see the native events your current platform actually has? Run papi_native_avail from the PAPI distribution 🌈

C Interface 🎀

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

Parameters 🫶

• EventSet — an integer handle for a PAPI event set, as created by PAPI_create_eventset
• EventName — a defined event such as PAPI_TOT_INS, or a native event

Return values ⭐

• PAPI_OK — Everything worked. slay 💖
• PAPI_EINVAL — One or more of the arguments is invalid.
• PAPI_ENOINIT — The PAPI library has not been initialized.
• PAPI_ENOEVST — The EventSet specified does not exist.
• PAPI_EISRUN — The EventSet is currently counting events. 😭
• PAPI_ECNFLCT — The underlying counter hardware can not count this event and other events in the EventSet simultaneously. not the conflict 💀
• PAPI_ENOEVNT — The PAPI preset is not available on the underlying hardware. rude, honestly 🙈

Example 💜

char EventName = "PAPI_TOT_INS";
int EventSet = PAPI_NULL;
int ret;

// Create an empty EventSet
ret = PAPI_create_eventset(&EventSet);
if (ret != PAPI_OK) handle_error(ret);

// Add Total Instructions Executed to our EventSet
ret = PAPI_add_named_event(EventSet, EventName);
if (ret != PAPI_OK) handle_error(ret);

// Start counting
ret = PAPI_start(EventSet);
if (ret != PAPI_OK) handle_error(ret);

// Stop counting, ignore values
ret = PAPI_stop(EventSet, NULL);
if (ret != PAPI_OK) handle_error(ret);

// Remove event
ret = PAPI_remove_named_event(EventSet, EventName);
if (ret != PAPI_OK) handle_error(ret);

See also 👑

• PAPI_remove_event
• PAPI_query_named_event
• PAPI_add_named_event

---

👑 Author 👑

Generated automatically by Doxygen for PAPI from the source code. (not a human, just a very efficient little bot 🧚)

---

aaaand that's the whole page, bestie!! 🍓 this doc is Version 7.2.0.0, dated Wed Jun 25 2025 19:30:48 — so go forth and remove those named events with main character energy 💅✨🔥