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

NAME

6       pmaSameInDom  - check if two observations of an instance domain are the
7       same`
8

C SYNOPSIS

10       #include <pcp/pmapi.h>
11       #include <pcp/libpcp.h>
12       #include <pcp/archive.h>
13
14       int pmaSameInDom(__pmLogInDom *old, __pmLogInDom *new);
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       Checks two observations of the same instance domain are identical.  The
28       code assumes (a) old->indom == new->indom and (b) both the instance do‐
29       mains  are  sorted  in ascending internal instance identifier sequence;
30       see pmaSortInDom(3) to see how to make the second condition true.
31
32       pmaSameInDom returns 1 if they are the same, returns 0 otherwise.
33
34       The instance domains are considered different if any of  the  following
35       hold:
36
37       1.  old->numinst != new->numinst
38
39       2.  For some i, old->instlist[i] != new->instlist[i]
40
41       3.  For some i, the strings pointed to by old->namelist[i] and new->in‐
42           stlist[i] are not identical
43
44       For Version 3 archives with "delta indom" support, it  is  more  likely
45       that  pmaDeltaInDom(3)  is more useful than pmaSameInDom, as the former
46       combines the check for two observations of an instance domain being the
47       same  with the optional creation of the "delta indom" format if that is
48       the most efficient encoding.
49

SEE ALSO

51       pmaDeltaInDom(3), PMAPI(3) and pmaSortInDom(3).
52
53
54
55Performance Co-Pilot                  PCP                      PMASAMEINDOM(3)
Impressum