NAME
pmdaStore - store a value into a metric for a PMDA
C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/impl.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 EACCESS 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).