pmid_helper(3) — Linux manual page


PMID_BUILD(3)             Library Functions Manual             PMID_BUILD(3)

NAME         top

       pmID_build, pmID_domain, pmID_cluster, pmID_item - helper methods for
       manipulating PMIDs

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       pmID pmID_build(unsigned int domain, unsigned int cluster, unsigned
       int item);
       unsigned int pmID_domain(pmID pmid);
       unsigned int pmID_cluster(pmID pmid);
       unsigned int pmID_item(pmID pmid);

       cc ... -lpcp

DESCRIPTION         top

       Within the Performance Co-Pilot (PCP) each metric is assigned a
       unique Performance Metric Identifier (pmID).  Internally a pmID is
       constructed from 3 fields: the domain number (of the associated
       Performance Metrics Domain Agent, or PMDA), the cluster number and
       the item number (the last two are assigned by the PMDA).

       pmID_build constructs a pmID from domain, cluster and item.

       pmID_domain, pmID_cluster and pmID_item return the respective fields
       from pmid.

SEE ALSO         top

       PMAPI(3) and pmIDStr(3).

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨⟩ on
       2020-09-18.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-09-18.)  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

Performance Co-Pilot                 PCP                       PMID_BUILD(3)