PMASORTINDOM(3)

💖 PMASORTINDOM — sort an instance domain 💖

okay bestie, welcome to pmaSortInDom(3), a lil function from the Performance Co-Pilot library functions manual. she's tiny, she's efficient, and she has ✨ opinions ✨ about sorting. let's get into it 🫶

---

✨ NAME ✨

pmaSortInDom — sort an instance domain, periodt 💅

---

🌸 C SYNOPSIS 🌸

okay so first you gotta pull in the headers, no cap:

#include <pcp/pmapi.h>
#include <pcp/libpcp.h>
#include <pcp/archive.h>

void pmaSortInDom(__pmLogInDom *lidp);

and then when you actually build it, you link like this:

cc ... -lpcp_archive -lpcp

(that's -lpcp_archive and -lpcp, both, don't skip either one 🙈)

---

💀 CAVEAT 💀

bestie, read this part fr fr. this documentation is for internal Performance Co-Pilot (PCP) developer use only.

these interfaces are not part of the PCP APIs that are guaranteed to remain fixed across releases 😭 like, they might not work, or they might provide different semantics at some point in the future. so if you're building something on top of them, just know the vibes could shift under you. lowkey iconic of them, highkey a warning. ⚠️

---

🦋 DESCRIPTION 🦋

so here's the tea: the instance domain identified by lidp gets sorted in ascending internal instance identifier value 📈. and it's not just one array getting the glow-up — both the lidp->instlist[] array and the corresponding lidp->namelist[] array are sorted. they move together, as they should, main character energy 👑

now, why is this fast? because instance domains are usually already sorted — at their source, by a PMDA. so instead of doing something dramatic, pmaSortInDom uses a bubble sort 🫧. yes, a bubble sort. and honestly? in this context she eats. 💅

here's the part that's genuinely so slay: if the caller is unsure whether the instance domain is sorted — but it actually is already sorted — then calling pmaSortInDom is as fast as checking if the instance domain is sorted. so like… why waste time vibing on a vibe check when you could just call the function? when in doubt, simply call pmaSortInDom. that's it, that's the whole strategy 🎀

---

🌈 DIAGNOSTICS AND RETURN VALUES 🌈

None. she returns nothing. she says nothing. she just sorts. silence, but make it effective 🧚

---

⭐ SEE ALSO ⭐

• PMAPI(3)
• pmGetInDom(3)

---

and that's the whole page, bestie!! 🥰 this one came from the Performance Co-Pilot (PCP) library functions manual — PMASORTINDOM(3) — written and shipped by the PCP crew. go forth and sort responsibly 💖✨🌸