PMFREEEVENTRESULT(3)

💖 PMFREEEVENTRESULT 💖

okay bestie, so this is pmFreeHighResEventResult and pmFreeEventResult from the PCP library functions manual — they're the cleanup crew, the little guys who come in after the party and release the storage that got allocated for unpacked event records. very demure, very mindful, extremely necessary. 🧹✨

---

🌸 NAME 🌸

pmFreeHighResEventResult, pmFreeEventResult — release storage allocated for unpacked event records 💅

---

✨ C SYNOPSIS ✨

#include <pcp/pmapi.h>

void pmFreeHighResEventResult(pmResult **hrset);
void pmFreeEventResult(pmResult_v2 **rset);

cc ... -lpcp

like yes, that's the whole vibe. two functions, one header, one link flag, no notes. 🎀

---

🦋 DESCRIPTION 🦋

okay so picture this: you're processing event records, right? and you use pmUnpackHighResEventRecords(3) to unpack event records from a metric inside a pmResult structure where the value is of type PM_TYPE_HIGHRES_EVENT. the structure that comes back from pmUnpackHighResEventRecords(3) is a NULL pointer terminated array of pointers to pmResult structures, one for each event record. iconic data layout honestly. 👑

pmFreeHighResEventResult is the convenience method — the bestie who handles it for you — and it frees all of the pmResult structures and the array of pointers (hrset). all of it. gone. clean. periodt. 💖

similarly, pmFreeEventResult may be used to free the pmResult_v2 structures and array returned from the pmUnpackEventRecords routine when you're working with PM_TYPE_EVENT metrics. same energy, different struct. 🫶

no cap, if you unpack it, you gotta free it. that's the whole plot. 💀

---

🌈 SEE ALSO 🌈

• PMAPI(3)
• pmUnpackEventRecords(3)

---

and that's the tea, bestie 🍓 this lil page is part of the Performance Co-Pilot collection, aka PCP — go forth and free your event results responsibly. mwah. 💜✨🎀