PMINDOM_BUILD(3)

✨ PMINDOM_BUILD(3) — bestie edition ✨

ok so this is a page about the helper methods for manipulating instance domain identifiers in PCP, and honestly? it's giving tiny-but-mighty. three little functions, zero drama, all vibes. let's get into it 🫶

---

💖 NAME 💖

pmInDom_build, pmInDom_domain, pmInDom_serial — the lil helper squad for manipulating instance domain identifiers. no cap, that's the whole job. ✨

---

🎀 C SYNOPSIS 🎀

first thing's first, bestie, you gotta pull in the header:

#include <pcp/pmapi.h>

then here's the whole crew, exactly as they show up:

pmInDom pmInDom_build(unsigned int domain, unsigned int serial);
unsigned int pmInDom_domain(pmInDom indom);
unsigned int pmInDom_serial(pmInDom indom);

and when you link, you link like this:

cc ... -lpcp

that's it. that's the entry point. 💅

---

🌸 DESCRIPTION 🌸

okay so context, because you deserve it:

Inside the Performance Co-Pilot (aka PCP), every single instance domain gets assigned its own unique Instance Domain Identifier — written as a pmInDom. Iconic. Internally, a pmInDom is built out of 2 fields:

• the domain number — of the associated Performance Metrics Domain Agent, or PMDA
• the serial number — assigned by the PMDA

two fields, one identifier, main character energy. 🦋

---

now the functions themselves:

• pmInDom_build — constructs a pmInDom from domain and serial. you bring the two pieces, it hands you the whole vibe. ✨
• pmInDom_domain and pmInDom_serial — these two are the reverse-engineering besties: they return the respective fields out of indom. lowkey the most satisfying pair ever. 🎀

---

🌈 SEE ALSO 🌈

go read these next, i'm literally obsessed with them:

• PMAPI(3)
• pmInDomStr(3)

---

ngl this page is short and sweet, but every detail here matters — the two fields, the PMDA serial, the linking flag. don't skip the vibes check. 💀

---

ok bye bestie, that's the whole page!! 💜 this one comes from Performance Co-Pilot (PCP) and yeah, it's PMINDOM_BUILD(3). mwah, go forth and build your in-doms. 🧚💖