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