Movatterモバイル変換

pmdapmid(3) — Linux manual page

PMDAPMID(3)              Library Functions ManualPMDAPMID(3)

NAME        top

pmdaPMID- translate a dynamic performance metric name into a PMID

C SYNOPSIS        top

#include <pcp/pmapi.h>#include <pcp/pmda.h>int pmdaPMID(char *name, pmID *pmid, pmdaExt *pmda);cc ... -lpcp_pmda -lpcp

DESCRIPTION        top

       As  part  of  the Performance Metrics Domain Agent (PMDA) API (seePMDA(3)),pmdaPMIDis the generic callback for translating  a  dy‐       namic metricname into a PMID (pmid).       Because implementing dynamic performance metrics requires specific       PMDA  support, and the facility is an optional component of a PMDA       (most PMDAs donotsupport dynamic performance metrics),pmdaPMID       is a skeleton implementation that returnsPM_ERR_NAME.       A  PMDA  that  supports dynamic performance metrics will provide a       private callback that replacespmdaPMID(by  assignment  tover‐sion.four.pmid  of thepmdaInterface structure) and implements the       translation from a dynamic performance metricname into the  asso‐       ciatedpmid.

CAVEAT        top

       The  PMDA must be usingPMDA_INTERFACE_4or later, as specified in       the call topmdaDSO(3) orpmdaDaemon(3).

DIAGNOSTICS        top

pmdaPMIDreturnsPM_ERR_NAMEif the name is not recognized or can‐       not be translated, else returns 0.

SEE ALSO        top

PMAPI(3),PMDA(3),pmdaDaemon(3),pmdaDSO(3),pmdaMain(3)  andpmLookupName(3).

COLOPHON        top

       This  page is part of thePCP (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 isnot part of the original manual page),  send  a       mail to man-pages@man7.orgPerformance Co-Pilot               PCPPMDAPMID(3)

Pages that refer to this page:pmdamain(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.