PMLOOKUPINDOM(3)

💖 PMLOOKUPINDOM 💖

okay bestie, welcome to pmLookupInDom from the Library Functions Manual — she's a lil PCP function and she's literally here to translate an instance name into an instance identifier ✨

---

🌸 NAME 🌸

pmLookupInDom — translate an instance name into an instance identifier 🦋

---

💅 C SYNOPSIS 💅

#include <pcp/pmapi.h>

int pmLookupInDom(pmInDom indom, const char *name);

cc ... -lpcp

---

✨ DESCRIPTION ✨

okay so here's the vibe 🫶 — you hand her an instance domain, <pink>indom</pink>, in the current Performance Metrics Application Programming Interface (PMAPI) context, and she goes and finds the instance whose external identification is <pink>name</pink>… and then she hands you back the internal instance identifier 💫

no cap, one lil detail: only the leading non-space characters of <pink>name</pink> get used to identify the instance. so like, don't come at her with trailing nonsense, she's not reading it 🙈

where does <pink>indom</pink> come from, you ask? typically it's extracted from a <pink>pmDesc</pink> structure, right after you've called pmLookupDesc(3) for whatever performance metric you're obsessed with 💖

and the slay part: pmLookupInDom returns a positive instance identifier on success. periodt 👑

---

😭 DIAGNOSTICS 😭

• PM_ERR_INDOM — <pink>indom</pink> is not a valid instance domain identifier. it's giving invalid, bestie 💀
• PM_ERR_INST — the external instance name is not known for the instance domain <pink>indom</pink> in the current PMAPI context. she looked. she did not find. 🥲

---

🎀 SEE ALSO 🎀

PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupDesc(3), pmLookupInDomArchive(3), pmNameInDom(3), pcp.conf(5) and pcp.env(5) 💜

---

and that's the whole page, bestie!! brought to you by Performance Co-Pilot (aka PCP) 💖 this was PMLOOKUPINDOM(3), mwah, go forth and look up those instance domains 🧚✨💅