NAME

       mmv_inc, mmv_inc_value, mmv_inc_atomvalue - update a value in a Memory Mapped Value file

C SYNOPSIS

       #include <pcp/pmapi.h>
       #include <pcp/mmv_stats.h>

       void mmv_inc_value(void *addr, pmAtomValue *av, double inc);
       void mmv_inc_atomvalue(void *addr, pmAtomValue *av, pmAtomValue *inc);

       cc ... -lpcp_mmv -lpcp

DESCRIPTION

       mmv_inc_value  and  mmv_inc_atomvalue  provide  convenient  ways  of  updating a metric av
       previously returned by  the  mmv_lookup_value_desc(3)  interface.   addr  is  the  address
       returned from mmv_stats_init(3).

       These   interfaces   are   most  commonly  used  with  counter  type  metrics.   Refer  to
       mmv_set_value(3) for a mechanism suited to instantaneous and discrete metrics.

       With mmv_inc_atomvalue the value provided via the inc pointer must match the type  of  the
       metric, and will be added to the previous value of the metric.

       In  the case of mmv_inc_value the value of inc is internally cast to match the type of the
       metric and then added to the previous value of the metric.

SEE ALSO

       mmv_set_value(3), mmv_stats_init(3), mmv_lookup_value_desc(3) and mmv(5).