NAME

       pmaSortInDom - sort an instance domain

C SYNOPSIS

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

       void pmaSortInDom(__pmLogInDom *lidp);

       cc ... -lpcp_archive -lpcp

CAVEAT

       This documentation is intended for internal Performance Co-Pilot (PCP) developer use.

       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.

DESCRIPTION

       The instance domain identified by lidp is sorted in ascending internal instance identifier  value.   Both
       the lidp->instlist[] array and the corresponding lidp->namelist[] array are sorted.

       Since instance domains are usually sorted (at their source by a PMDA), a bubble sort is used.  This means
       that  if  the caller is unsure if the instance domain is sorted (but it actually is already sorted), then
       calling pmaSortInDom is as fast as checking if the instance domain is sorted, so when  in  doubt,  simply
       call pmaSortInDom.

DIAGNOSTICS AND RETURN VALUES

       None.

SEE ALSO

       PMAPI(3) and pmGetInDom(3).

Performance Co-Pilot                                   PCP                                       PMASORTINDOM(3)