PMDASTORE(3)               Library Functions Manual               PMDASTORE(3)

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

CAVEAT
       The PMDA must be using PMDA_INTERFACE_2 or later, as specified in the
       call to pmdaDSO(3) or pmdaDaemon(3).

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

SEE ALSO
       pmstore(1), PMAPI(3), PMDA(3), pmdaDaemon(3), pmdaDSO(3) and
       pmStore(3).


Performance Co-Pilot                  PCP                         PMDASTORE(3)