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


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.


pmdaStore returns PM_ERR_PERMISSION to indicate that no metrics may be modified.


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

PCP Performance Co-Pilot