logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

pmdaName - translate a PMID to a set of dynamic performance metric names

C Synopsis

#include<pcp/pmapi.h>#include<pcp/pmda.h>intpmdaName(pmIDpmid,char***nameset,pmdaExt*pmda);cc...-lpcp_pmda-lpcp

Caveat

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

Description

       As  part  of  the  Performance  Metrics  Domain  Agent  (PMDA) API (see PMDA(3)), pmdaName is the generic
       callback for translating a pmid into one or more dynamic metric names (nameset).

       Because implementing dynamic performance metrics requires specific PMDA support, and the facility  is  an
       optional  component  of  a  PMDA  (most  PMDAs do not support dynamic performance metrics), pmdaName is a
       skeleton implementation that returns PM_ERR_NAME.

       A PMDA that supports dynamic performance metrics will provide a private callback that  replaces  pmdaName
       (by assignment to version.four.name of the pmdaInterface structure) and implements the translation from a
       pmid to a set of dynamic performance metric names returned via nameset.  The behaviour, return values and
       memory allocation rules for nameset are the same as for pmNameAll(3).

Diagnostics

pmdaName returns PM_ERR_PMID if the name is not recognized or cannot be translated, otherwise the  number
       of metric names found (most commonly 1).

Name

pmdaName - translate a PMID to a set of dynamic performance metric names

See Also

PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3), pmdaMain(3), pmNameAll(3) and pmNameID(3).

Performance Co-Pilot                                   PCP                                           PMDANAME(3)

See Also