pmaSortInDom - Man Page

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

Referenced By

pmaDeltaInDom(3), pmaSameInDom(3).

PCP Performance Co-Pilot