pmdastore(3) - Linux man page

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