1PMDAPMID(3)                Library Functions Manual                PMDAPMID(3)
2
3
4

NAME

6       pmdaPMID - translate a dynamic performance metric name into a PMID
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/pmda.h>
11
12       int pmdaPMID(char *name, pmID *pmid, pmdaExt *pmda);
13
14       cc ... -lpcp_pmda -lpcp
15

DESCRIPTION

17       As  part  of  the  Performance  Metrics  Domain  Agent  (PMDA) API (see
18       PMDA(3)), pmdaPMID is the generic callback for  translating  a  dynamic
19       metric name into a PMID (pmid).
20
21       Because implementing dynamic performance metrics requires specific PMDA
22       support, and the facility is an optional component of a PMDA (most  PM‐
23       DAs do not support dynamic performance metrics), pmdaPMID is a skeleton
24       implementation that returns PM_ERR_NAME.
25
26       A PMDA that supports dynamic performance metrics will provide a private
27       callback  that replaces pmdaPMID (by assignment to version.four.pmid of
28       the pmdaInterface structure) and implements the translation from a  dy‐
29       namic performance metric name into the associated pmid.
30

CAVEAT

32       The  PMDA  must  be using PMDA_PROTOCOL_4 or later, as specified in the
33       call to pmdaDSO(3) or pmdaDaemon(3).
34

DIAGNOSTICS

36       pmdaPMID returns PM_ERR_NAME if the name is not recognized or cannot be
37       translated, else returns 0.
38

SEE ALSO

40       PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3), pmdaMain(3) and pmLookup‐
41       Name(3).
42
43
44
45Performance Co-Pilot                  PCP                          PMDAPMID(3)
Impressum