jammy (3) pmdaStore.3.gz

Provided by: libpcp-pmda3-dev_5.3.6-1build1_amd64 bug

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