PAPI_set_domain(3)

🦋 PAPI_set_domain(3) — PAPI manual, bestie 🦋

✨ NAME ✨

PAPI_set_domain — sets the default counting domain for new event sets bound to the cpu component. That's the assignment, and it understood it. 💅

🌸 SYNOPSIS 🌸

💫 Detailed Description 💫

🧚 C Prototype:

#include <papi.h>
int PAPI_set_domain( int domain );

🍓 Parameters

domain is one of the following constants, as defined in the papi.h header file — no cap:

• PAPI_DOM_USER — User context counted ✨
• PAPI_DOM_KERNEL — Kernel/OS context counted 💜
• PAPI_DOM_OTHER — Exception/transient mode counted 🦋
• PAPI_DOM_SUPERVISOR — Supervisor/hypervisor context counted 👑
• PAPI_DOM_ALL — All above contexts counted 🌈
• PAPI_DOM_MIN — The smallest available context 🎀
• PAPI_DOM_MAX — The largest available context 🔥

💀 Return values

• PAPI_OK — a return value, no extra description attached in the original. ✨
• PAPI_EINVAL — One or more of the arguments is invalid. 😭

Okay so here's the tea: PAPI_set_domain sets the default counting domain for all new event sets created by PAPI_create_eventset in all threads. This call implicitly sets the domain for the cpu component (component 0), and it's included to preserve backward compatibility. Lowkey legacy, highkey still important. 🫶

💖 Example:

int ret;

// Initialize the library
ret = PAPI_library_init(PAPI_VER_CURRENT);
if (ret > 0 && ret != PAPI_VER_CURRENT) {
  fprintf(stderr,"PAPI library version mismatch!\n");
  exit(1);
}
if (ret < 0) handle_error(ret);

// Set the default domain for the cpu component
ret = PAPI_set_domain(PAPI_DOM_KERNEL);
if (ret != PAPI_OK) handle_error(ret);
ret = PAPI_create_eventset(&EventSet);
if (ret != PAPI_OK) handle_error(ret);

🔗 SEE ALSO 🔗

• PAPI_set_cmp_domain
• PAPI_set_granularity
• PAPI_set_opt
• PAPI_get_opt

👑 AUTHOR 👑

The author line says it was generated automatically by Doxygen for PAPI from the source code. So yeah, Doxygen ate that one. 💅

---

Cute sign-off: this page is from PAPI version 7.2.0.0, dated Wed Jun 25 2025 19:30:49, and the footer also says PAPI_set_domain(3). Byeee, bestie — go set that domain! 💖✨🎀