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/impl.h>
11       #include <pcp/pmda.h>
12
13       int pmdaPMID(char *name, pmID *pmid, pmdaExt *pmda)
14
15       cc ... -lpcp_pmda -lpcp
16

DESCRIPTION

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

DIAGNOSTICS

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

CAVEAT

37       The PMDA must be using PMDA_PROTOCOL_4 or later, as  specified  in  the
38       call to pmdaDSO(3) or pmdaDaemon(3).
39

SEE ALSO

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