PMAUNDELTAINDOM(3)

💖 pmaUndeltaInDom — NAME energy 💖

ok so this is pmaUndeltaInDom from section 3 of the Library Functions Manual (the C library calls girlies, you know the vibe) ✨ and what it does is literally find a full'' instance domain that matches a delta'' instance domain. that's it. that's the whole job. slay.

---

🎀 C SYNOPSIS 🎀

like, here's how you actually summon her:

#include <pcp/pmapi.h>
#include <pcp/libpcp.h>
#include <pcp/archive.h>

__pmLogInDom *pmaUndeltaInDom(__pmLogCtl *lcp, __int32_t *buf);

and you gotta link it up bestie:

cc ... -lpcp_archive -lpcp

---

💀 CAVEAT 💀

bestie. listen. this documentation is for internal Performance Co-Pilot (PCP) developer use only. like, it's giving "staff only" door, okay?

these interfaces are not part of the PCP APIs that are guaranteed to remain fixed across releases 😭 and they may not work, or may provide different semantics at some point in the future. so don't build your whole personality on them. fr fr.

---

✨ DESCRIPTION ✨

so the whole mission is: find the loaded full'' instance domain that matches a delta'' instance domain. iconic behaviour honestly.

here's the tea 🍓 — the caller has to make sure the physical metadata record for the ``delta'' instance domain has already been read into buf. that's your job, not hers. she's not doing that for you. periodt.

the associated archive control structure is identified by lcp, which implies the input archive has also been opened with pmNewContext(3). so like, no context, no service 💅

then pmaUndeltaInDom starts by extracting the timestamp and the instance domain number for the delta'' instance domain from `buf`. with that info in hand, `__pmLogSearchInDom(3)` gets called to find the matching loaded instance domain — and that one will have been converted from a delta'' instance domain to a ``full'' instance domain in the process. the glow-up is real 🌈

and when is she most useful? pmaUndeltaInDom is **most useful for applications that read physical metadata records and need to operate on full'' instance domains**, rather than the delta'' instance domains that occur in Version 3 archives. if that's your situation, she's your main character 👑

---

🫶 DIAGNOSTICS AND RETURN VALUES 🫶

if the matching loaded instance domain cannot be found? lots of warning babble 😭 like she will literally just yell at you in warnings, and the return value is NULL in this case. no cap.

---

🌸 SEE ALSO 🌸

• PMAPI(3)

---

okay that's the whole page, mwah 💜 this came to you from Performance Co-Pilot (that's the source, that's the PCP, that's the whole brand bestie) and it lives in the Library Functions Manual as PMAUNDELTAINDOM(3) — go forth and undelta your instance domains, you absolute legend 🌟