PAPI_attach(3)

💅 NAME 💅

ok so listen bestie — PAPI_attach is literally the function that attaches a PAPI event set to a thread id you pick. That's it. That's the whole vibe. This page lives in the PAPI manual, section 3, and it's about to be your new fave ✨

---

🦋 SYNOPSIS 🦋

C Interface

#include <papi.h>
int PAPI_attach( int EventSet, unsigned long tid );

---

🌸 DETAILED DESCRIPTION 🌸

okay so here's the tea 🫖 — PAPI_attach is a wrapper function that calls PAPI_set_opt so PAPI can monitor performance counts on a thread that is not the one currently executing. People sometimes call this third party monitoring, and honestly? main character energy for a monitoring mode.

So what it does: PAPI_attach connects the EventSet you specify to the tid you specify. Then PAPI_detach is the one that breaks that connection and restores the EventSet back to the original executing thread. They're a package deal, iykyk 💖

🎀 Parameters 🎀

• EventSet — an integer handle for a PAPI EventSet, the kind you get from PAPI_create_eventset. Your little event set passport, basically 🛂
• tid — a thread id as obtained from, for example, PAPI_list_threads or PAPI_thread_id. Gotta get it from somewhere legit, no cap.

⭐ Return values ⭐

• PAPI_ECMP — this feature is unsupported on this component. big sad 😭
• PAPI_EINVAL — one or more of the arguments is invalid. check ur args bestie 🙈
• PAPI_ENOEVST — the event set specified does not exist. it's giving "ghosted" 💀
• PAPI_EISRUN — the event set is currently counting events. girl it's busy 🔥

🌈 Examples: 🌈

int EventSet = PAPI_NULL;
unsigned long pid;
pid = fork( );
if ( pid <= 0 )
exit( 1 );
if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
exit( 1 );
// Add Total Instructions Executed to our EventSet
if ( PAPI_add_event( EventSet, PAPI_TOT_INS ) != PAPI_OK )
exit( 1 );
// Attach this EventSet to the forked process
if ( PAPI_attach( EventSet, pid ) != PAPI_OK )
exit( 1 );

👑 See also 👑

• PAPI_set_opt
• PAPI_list_threads
• PAPI_thread_id
• PAPI_thread_init

---

🧚 Author 🧚

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

---

fr fr that's the whole page — go attach something, bestie 🫶

Version 7.2.0.0 — dated Wed Jun 25 2025 19:30:48 — mwah, catch u later, PAPI_attach(3) out 💖✨