1PMAUNDELTAINDOM(3)         Library Functions Manual         PMAUNDELTAINDOM(3)
2
3
4

NAME

6       pmaUndeltaInDom  -  find  ``full'' instance domain matching a ``delta''
7       instance domain
8

C SYNOPSIS

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

CAVEAT

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

DESCRIPTION

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

DIAGNOSTICS AND RETURN VALUES

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

SEE ALSO

51       PMAPI(3),
52
53
54
55Performance Co-Pilot                  PCP                   PMAUNDELTAINDOM(3)
Impressum