mmv_set_value(3) — Linux manual page


MMV_SET_VALUE(3)        Library Functions Manual        MMV_SET_VALUE(3)

NAME         top

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

C SYNOPSIS         top

       #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

       cc ... -lpcp_mmv -lpcp

DESCRIPTION         top

       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         top

       mmv_inc_value(3), mmv_stats_init(3), mmv_lookup_value_desc(3) and

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this manual
       page, send it to  This page was obtained from the
       project's upstream Git repository
       ⟨⟩ on 2023-12-22.
       (At that time, the date of the most recent commit that was found
       in the repository was 2023-12-16.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Performance Co-Pilot                                    MMV_SET_VALUE(3)

Pages that refer to this page: mmv_inc_value(3)