NAME¶

mmv_set_value - set a value in a Memory Mapped Value file

C SYNOPSIS¶

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

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_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_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_value the 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).