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
23       PMDAs do not support dynamic performance metrics), pmdaPMID is a skele‐
24       ton 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
29       dynamic performance metric name into the associated pmid.
30

DIAGNOSTICS

32       pmdaPMID returns PM_ERR_NAME if the name is not recognized or cannot be
33       translated, else returns 0.
34

CAVEAT

36       The PMDA must be using PMDA_PROTOCOL_4 or later, as  specified  in  the
37       call to pmdaDSO(3) or pmdaDaemon(3).
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