1PMAUNDELTAINDOM(3) Library Functions Manual PMAUNDELTAINDOM(3)
2
3
4
6 pmaUndeltaInDom - find ``full'' instance domain matching a ``delta''
7 instance domain
8
10 #include <pcp/pmapi.h>
11 #include <pcp/libpcp.h>
12 #include <pcp/archive.h>
13
14 __pmLogInDom *pmaUndeltaInDom(__pmLogCtl *lcp, __int32_t *buf);
15
16 cc ... -lpcp_archive -lpcp
17
19 This documentation is intended for internal Performance Co-Pilot (PCP)
20 developer use.
21
22 These interfaces are not part of the PCP APIs that are guaranteed to
23 remain fixed across releases, and they may not work, or may provide
24 different semantics at some point in the future.
25
27 Find the loaded ``full'' instance domain that matches a ``delta'' in‐
28 stance domain.
29
30 The caller ensures the physical metadata record for the ``delta'' in‐
31 stance domain has been read into buf. The associated archive control
32 structure is identified by lcp, which implies the input archive has
33 also been opened with pmNewContext(3).
34
35 pmaUndeltaInDom starts by extracting the timestamp and the instance do‐
36 main number for the ``delta'' instance domain from buf. With this in‐
37 formation, __pmLogSearchInDom(3) is called to find the matching loaded
38 instance domain, which will have been converted from a ``delta'' in‐
39 stance domain to a ``full'' instance domain in the process.
40
41 pmaUndeltaInDom is most useful for applications that read physical
42 metadata records and need to operate on ``full'' instance domains,
43 rather than the ``delta'' instance domains that occur in Version 3 ar‐
44 chives.
45
47 Lots of warning babble if the matching loaded instance domain cannot be
48 found, and the return value is NULL in this case.
49
51 PMAPI(3),
52
53
54
55Performance Co-Pilot PCP PMAUNDELTAINDOM(3)