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).