pmdaStore - Man Page
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.
Caveat
The PMDA must be using PMDA_INTERFACE_2 or later, as specified in the call to pmdaDSO(3) or pmdaDaemon(3).
Diagnostics
pmdaStore returns PM_ERR_PERMISSION to indicate that no metrics may be modified.
See Also
pmstore(1), PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3) and pmStore(3).
Referenced By
PMDA(3), pmdaDaemon(3), pmdaDSO(3), pmdaMain(3).