pmdaStore — store a value into a metric for a PMDA

C Synopsis

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

int pmdaStore(pmResult *result, pmdaExt *pmda);

cc ... -lpcp_pmda -lpcp

Description

As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaStore is the generic callback for storing a value into a metric. pmdaStore is usually a no-op as, by default, no metrics can be altered.   Also, the implementation of a store callback which does permit metrics to be altered by pmstore(1) is very application dependent.

Diagnostics

pmdaStore returns PM_ERR_PERMISSION to indicate that no metrics may be modified.

Caveat

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

See Also

pmstore(1), PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3) and pmStore(3).

Referenced By

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

The man page pmdastore(3) is an alias of pmdaStore(3).

PCP Performance Co-Pilot