pmdaDesc — get the description of a metric from a PMDA

C Synopsis

#include <pcp/pmapi.h>
#include <pcp/pmda.h>

int pmdaDesc(pmID pmid, pmDesc *desc, pmdaExt *pmda);

cc ... -lpcp_pmda -lpcp

Description

pmdaDesc uses the standard PMDA(3) data structures to return the pmDesc description in desc for the metric identified by pmid.

Diagnostics

If the pmid does not correspond to any metric supported by this PMDA, pmdaDesc returns PM_ERR_PMID.

Caveat

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

See Also

PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3) and pmLookupDesc(3).

Referenced By

PMDA(3), pmdaDaemon(3), pmdaDSO(3), pmdaGetContext(3).

The man page pmdadesc(3) is an alias of pmdaDesc(3).

PCP Performance Co-Pilot