PMDAPMID(3)

💖 pmdaPMID(3) — the library-functions-manual bestie page 💖

okay so. this is pmdaPMID(3), straight out of the Library Functions Manual, and it's here to help you turn a dynamic performance metric name into a PMID. yes bestie, that's the whole job. let's get into it 🦋

---

✨ NAME ✨

pmdaPMID — translate a dynamic performance metric name into a PMID

---

🌸 C SYNOPSIS 🌸

#include <pcp/pmapi.h>
#include <pcp/pmda.h>

int pmdaPMID(char *name, pmID *pmid, pmdaExt *pmda);

cc ... -lpcp_pmda -lpcp

like. look at her. so compact. so clean. an icon 💅

---

🎀 DESCRIPTION 🎀

so here's the tea, bestie 🫖 — as part of the Performance Metrics Domain Agent (PMDA) API (peep PMDA(3) for the full lore), pmdaPMID is the generic callback for translating a dynamic metric name into a PMID (pmid). that's the assignment. that's the mission. main character energy only 👑

but now for the plot twist 😭 — implementing dynamic performance metrics needs specific PMDA support, and the whole facility is an optional component of a PMDA. and ngl, most PMDAs do not support dynamic performance metrics. so pmdaPMID is just a skeleton implementation that returns PM_ERR_NAME. it's giving placeholder. it's giving "we'll get to it". 🙈

a PMDA that does support dynamic performance metrics will roll up with a private callback that replaces pmdaPMID — by assignment to version.four.pmid of the pmdaInterface structure — and that one actually implements the translation from a dynamic performance metric name into the associated pmid. periodt 💜

---

⚠️ CAVEAT ⚠️

the PMDA must be using PMDA_INTERFACE_4 or later, as specified in the call to pmdaDaemon(3) or pmdaDSO(3). no cap, this is not optional. if you're on an older interface, it's over for you 💀

---

🔥 DIAGNOSTICS 🔥

pmdaPMID returns PM_ERR_NAME if the name is not recognized or cannot be translated. otherwise? it returns 0. slay ✨

---

🌈 SEE ALSO 🌈

• PMAPI(3)
• PMDA(3)
• pmdaDaemon(3)
• pmdaDSO(3)
• pmdaMain(3)
• pmLookupName(3)

---

and that's the whole page bestie 🎀 this one came to you from Performance Co-Pilot (that's the PCP gang, iykyk), filed under PMDAPMID(3). go forth, translate those dynamic metric names, and remember: skeleton implementations are still valid. we love a placeholder that knows what it is 💖🦋✨