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

NAME

6       pmaSortInDom - sort an instance domain
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/libpcp.h>
11       #include <pcp/archive.h>
12
13       void pmaSortInDom(__pmLogInDom *lidp);
14
15       cc ... -lpcp_archive -lpcp
16

CAVEAT

18       This  documentation is intended for internal Performance Co-Pilot (PCP)
19       developer use.
20
21       These interfaces are not part of the PCP APIs that  are  guaranteed  to
22       remain  fixed  across  releases,  and they may not work, or may provide
23       different semantics at some point in the future.
24

DESCRIPTION

26       The instance domain identified by lidp is sorted in ascending  internal
27       instance  identifier  value.   Both  the lidp->instlist[] array and the
28       corresponding lidp->namelist[] array are sorted.
29
30       Since instance domains are usually sorted (at their source by a  PMDA),
31       a  bubble sort is used.  This means that if the caller is unsure if the
32       instance domain is sorted (but it actually  is  already  sorted),  then
33       calling  pmaSortInDom  is as fast as checking if the instance domain is
34       sorted, so when in doubt, simply call pmaSortInDom.
35

DIAGNOSTICS AND RETURN VALUES

37       None.
38

SEE ALSO

40       PMAPI(3) and pmGetInDom(3).
41
42
43
44Performance Co-Pilot                  PCP                      PMASORTINDOM(3)
Impressum