NAME

       mmv_set, mmv_set_value, mmv_set_atomvalue - set a value in a Memory Mapped Value file

C SYNOPSIS

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

       void mmv_set(void *addr, pmAtomValue *av, void *val);
       void mmv_set_value(void *addr, pmAtomValue *av, double val);
       void mmv_set_atomvalue(void *addr, pmAtomValue *av, pmAtomValue *val);

       cc ... -lpcp_mmv -lpcp

DESCRIPTION

       mmv_set,  mmv_set_value  and  mmv_set_atomvalue provide convenient ways of directly setting a value for 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 typically used with instantaneous and discrete metrics.  Refer to mmv_inc_value(3)
       for a mechanism suited to monotonic increasing counter metrics.

       With mmv_set and mmv_set_atomvalue the value provided via the inc pointer must  match  the  type  of  the
       metric and will be used as the new value of the metric.

       In  the  case of mmv_set and mmv_set_value, the pointer value val is internally cast to match the type of
       the metric and then used as the value for the metric.

SEE ALSO

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