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).