PMLOOKUPINDOMARCHIVE(3)

💖 PMLOOKUPINDOMARCHIVE(3) 💖

okay bestie, so this one lives in the Library Functions Manual and it's literally the glow-up era of pmLookupInDomArchive — it's the archived-archive version, the ✨specialized✨ one. Let's get into it 🫶

---

🌸 NAME 🌸

pmLookupInDomArchive — translate an instance name into an instance identifier

no cap, that's the whole job. name in, id out. 💅

---

🎀 C SYNOPSIS 🎀

#include <pcp/pmapi.h>

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

cc ... -lpcp

so you include <pcp/pmapi.h>, you call it with a pmInDom and a const char *name, and when you link you gotta bring -lpcp along for the ride or it will simply not build. that's just the vibe. 🦋

---

✨ DESCRIPTION ✨

okay so here's the tea ☕ — provided the current Performance Metrics Application Programming Interface (PMAPI) context is associated with a set of archives, pmLookupInDomArchive will scan the union of all the instance domain metadata for the instance domain indom, locate the first instance with the external identification given by name, and hand you back the internal instance identifier. iconic behaviour honestly. 👑

This routine is a specialized version of the more general PMAPI routine pmLookupInDom. it's giving "same energy, but archives only" 💜

Only the leading non-space characters of name will be used to identify the instance. so like, trim your whitespace mentally, she's not gonna do it for you 🙈

The value for the instance domain indom is typically extracted from a pmDesc structure, following a call to pmLookupDesc(3) for a particular performance metric. that's the pipeline, bestie — desc first, then this. 🌈

pmLookupInDomArchive will return a positive instance identifier on success. positive vibes only, literally ✨

---

💀 DIAGNOSTICS 💀

these are the "it didn't work" era moments, and you need to know them fr fr:

• PM_ERR_NOTARCHIVE — the current PMAPI context is not associated with a set of archives. wrong context, wrong energy, not it. 😭
• PM_ERR_INDOM_LOG — indom is not a defined instance domain identifier for the set of archives. that domain? unknown to her. 💀
• PM_ERR_INST_LOG — the external instance name is not known for the instance domain indom in the set of archives. the name you're looking for is not in the group chat 🚫

bestie please actually check these. guessing at error codes is not the main character move. 💅

---

🦋 SEE ALSO 🦋

• PMAPI(3)
• pmGetConfig(3)
• pmGetInDomArchive(3)
• pmLookupDesc(3)
• pmLookupInDom(3)
• pmNameInDomArchive(3)
• pcp.conf(5)
• pcp.env(5)

go read these too, they're all part of the same friend group, iykyk 💖

---

and that's the whole page, bestie!! 🎀 this slay of a manual page came to you from Performance Co-Pilot (PCP), and it's filed under PMLOOKUPINDOMARCHIVE(3). obsessed. periodt. 💅✨