PMFREELABELSETS(3)

💖 PMFREELABELSETS 💖

okay bestie, so this is a page from the Library Functions Manual, and it's literally all about one little function that does one very important job. it's giving "clean up your own mess" energy and honestly? iconic. 🫶

---

✨ NAME ✨

pmFreeLabelSets — release storage allocated for performance metric labels

like, it frees the stuff. the label stuff. that's the whole vibe. 🎀

---

✨ C SYNOPSIS ✨

#include <pcp/pmapi.h>

void pmFreeLabelSets(pmLabelSet *sets, int nsets);

cc ... -lpcp

no return value, no drama, just vibes and void. 💅

---

✨ DESCRIPTION ✨

so here's the tea ☕ — the array of label sets that comes back from pmLookupLabels(3) and its related APIs is allocated down below the Performance Metrics Application Programming Interface (PMAPI), and it gets that memory through a whole bunch of calls to the system's dynamic memory allocation interfaces (you know, the malloc(3) girlies).

so when you're done looking at your label sets array and you don't need the structure anymore, you have to call pmFreeLabelSets to release the storage that was allocated for it. that's the rule. that's the assignment. no skipping. 📝

here's the important part tho — the return value from pmLookupLabels tells you how many elements are in that label sets array, and you need to pass that number in through the nsets parameter. so like, keep track of it, bestie. don't just vibe and forget. 😭

🚨 WARNING, NO CAP 🚨 — under NO circumstances should an application use free(labelset) to release storage that was previously allocated for a pmLabelSet by pmLookupLabels(3) or any of the related APIs. like, absolutely not. do not do it. i am begging. 💀

and here's a lil treat to make error handling less of a nightmare: if sets is NULL, then pmFreeLabelSets just simply returns without freeing any storage. so it's safe. it's chill. it's unbothered. 🌸

---

✨ SEE ALSO ✨

• malloc(3)
• PMAPI(3)
• pmLookupLabels(3)

---

and that's the whole page, bestie! 🦋 this one came from Performance Co-Pilot, aka PCP, and the page itself is PMFREELABELSETS(3). go forth and free your label sets properly, i'm so proud of you. mwah. 💜✨👑