PMDUPCONTEXT(3)

✨ NAME ✨

pmDupContext — duplicate a PMAPI context 💖 (yes bestie, it's exactly what it sounds like)

---

🌸 C SYNOPSIS 🌸

#include <pcp/pmapi.h>

int pmDupContext(void);

cc ... -lpcp

---

💅 DESCRIPTION 💅

okay so picture this: your app is out here using the Performance Metrics Application Programming Interface (PMAPI, iykyk) and it's juggling several concurrent contexts at the same time 👑. Each one of those contexts is tied to its own lil source of performance metrics — like pmcd(1) running on some host, or a whole set of archives of performance metrics as created by pmlogger(1) 🗂️.

So when you call pmDupContext, it replicates the current PMAPI context and hands you back a handle for the brand-new context 🔥. That handle is literally made to be passed into subsequent calls of pmUseContext(3), slay.

And here's the part that's giving main character energy: once it's created, the duplicated context and the original context exist independently 🦋. So their instance profiles and their collection time — which, quick note, is only relevant for archive contexts — can each be varied on their own, no strings attached 🎀.

Also, plot twist: the newly replicated context becomes the current context. Periodt 💅.

---

💜 SEE ALSO 💜

• PMAPI(3)
• pmNewContext(3)
• pmUseContext(3)

---

k that's the whole vibe, bestie 🫶 this was Performance Co-Pilot, PCP — mwah, no notes, go duplicate responsibly 💖✨