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 stor­
       ing  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 met­
       rics to be  altered  by  pmstore(1)  is  very  application
       dependent.


DIAGNOSTICS

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


CAVEAT

       The PMDA must be using PMDA_PROTOCOL_2 or later, as speci­
       fied in the call to pmdaDSO(3) or pmdaDaemon(3).


SEE ALSO

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


Man(1) output converted with man2html