PMTYPESTR(3)

💅 PMTYPESTR(3) — the pmTypeStr / pmTypeStr_r glow-up 💅

okay bestie, welcome to the Library Functions Manual section, PCP edition ✨ this is where we turn a performance metric type into a cute little string, no cap.

---

🌸 NAME 🌸

pmTypeStr, pmTypeStr_r — convert a performance metric type into a string 🦋

---

✨ C SYNOPSIS ✨

#include <pcp/pmapi.h>

const char *pmTypeStr(int type);
char *pmTypeStr_r(int type, char *buf, int buflen);

cc ... -lpcp

yes queen, that's the whole vibe. two functions, one include, one linker flag. iconic. 💖

---

🎀 DESCRIPTION 🎀

so here's the tea ☕ — you hand pmTypeStr a performance metric type, and it hands you back a terse ASCII equivalent, which is exactly what you want for error and diagnostic messages. it's giving "short and useful", fr fr.

The pmTypeStr_r function does the same thing, except it stores the result in a user-supplied buffer — that's buf, with length buflen. and bestie, listen: that buffer should have room for at least 20 bytes. don't skimp on the buffer, it's not the moment 🙈

The value for type is typically extracted from a pmDesc structure, following a call to pmLookupDesc(3) for a particular performance metric. iykyk 💅

Examples are 32 (for type equals PM_TYPE_32), U64 (for type equals PM_TYPE_U64), STRING (for type equals PM_TYPE_STRING), etc. etc. etc. — the whole type lineup showing out in its string form ✨

---

🦋 NOTES 🦋

Both of these functions are safe to call from threaded contexts. slay, go forth and thread responsibly 👑

---

🔥 SEE ALSO 🔥

the whole friend group, no one left out 🫶

• PMAPI(3)
• pmAtomStr(3)
• pmConvScale(3)
• pmExtractValue(3)
• pmLookupDesc(3)
• pmPrintValue(3)
• pmIDStr(3)
• pmInDomStr(3)
• pmSemStr(3)
• pmUnitsStr(3)

---

and that's the page, bestie 💖 brought to you by Performance Co-Pilot (PCP), filed under PMTYPESTR(3) — go convert those types and be the main character of your own diagnostics 🌈⭐