mmv_set - Man Page

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


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

Referenced By


The man pages mmv_set_atomvalue(3) and mmv_set_value(3) are aliases of mmv_set(3).

Performance Co-Pilot