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 call‐
       back 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 pm‐
       store(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  pmdaDae‐
       mon(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)