pmsortinstances(3) — Linux manual page

PMSORTINSTANCES(3)       Library Functions Manual      PMSORTINSTANCES(3)

NAME         top

       pmSortInstances - sort performance metric values on instance
       identifier

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       void pmSortInstances(pmResult *result);

       cc ... -lpcp

DESCRIPTION         top

       The routine pmSortInstances may be used to guarantee that for each
       performance metric in the result from pmFetch(3) the instances are
       in ascending instance identifier sequence.

       This is useful when computing rates from two consecutive samples.

COMPATIBILITY         top

       Prior  to PCP 7.0 the timestamp field in the pmResult struct was a
       struct timeval.  To support PMAPI transition,  the  old  interface
       and  semantics  can  be  used  if applications are recompiled with
       -DPMAPI_VERSION=2.

       For a time in PCP 6.x there was a routine with the same  semantics
       as  the current pmSortInstances called pmSortHighResInstances, and
       a struct with the same definition as the current  pmResult  struct
       called  pmResultHighRes, although both are now deprecated and com‐
       pile-time support for pmSortHighResInstances  and  pmResultHighRes
       will be removed in a future release.

SEE ALSO         top

       PMAPI(3) and pmFetch(3).

COLOPHON         top

       This  page is part of the PCP (Performance Co-Pilot) project.  In‐
       formation about the project can be found at  ⟨http://www.pcp.io/⟩.
       If  you  have  a  bug  report  for  this  manual  page, send it to
       pcp@groups.io.  This page was obtained from the project's upstream
       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩  on
       2025-08-11.   (At  that  time,  the date of the most recent commit
       that was found in the repository was 2025-08-11.)  If you discover
       any rendering problems in this HTML version of the  page,  or  you
       believe  there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page),  send  a
       mail to man-pages@man7.org

Performance Co-Pilot               PCP                 PMSORTINSTANCES(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.