mmv_lookup_value_desc(3) — Linux manual page

NAME | C SYNOPSIS | DESCRIPTION | RETURNS | SEE ALSO | COLOPHON

MMV_LOOK...ALUE_DESC(3) Library Functions Manual MMV_LOOK...ALUE_DESC(3)

NAME         top

       mmv_lookup_value_desc - find a value in the Memory Mapped Value
       file

C SYNOPSIS         top

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

       pmAtomValue *mmv_lookup_value_desc(void *addr, const char
               *metric, const char *inst);

       cc ... -lpcp_mmv -lpcp

DESCRIPTION         top

       mmv_lookup_value_desc searches for the value of the instance
       identified by the external instance name inst of the metric
       metric in the MMV(5) file.  addr is the address returned from
       mmv_stats_init().

       The pointer returned points to a pmAtomValue union, which is
       defined as follows:

           typedef union {
               __int32_t   l;      /* 32-bit signed */
               __uint32_t  ul;     /* 32-bit unsigned */
               __int64_t   ll;     /* 64-bit signed */
               __uint64_t  ull;    /* 64-bit unsigned */
               float       f;      /* 32-bit floating point */
               double      d;      /* 64-bit floating point */
               char         *cp;   /* char ptr */
            pmValueBlock *vbp;  /* pmValueBlock ptr */
           } pmAtomValue;

       MMV string values should be set using either of the
       mmv_set_string or mmv_set_strlen routines.

RETURNS         top

       The function returns the address inside of the memory mapped
       region on success or NULL on failure.

SEE ALSO         top

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

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨http://www.pcp.io/⟩.  If you have a bug report for this manual
       page, send it to pcp@groups.io.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/performancecopilot/pcp.git⟩ 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
       man-pages@man7.org

Performance Co-Pilot                             MMV_LOOK...ALUE_DESC(3)

Pages that refer to this page: mmv_inc_value(3)mmv_set_value(3)mmv_stats_init(3)mmv_stats_registry(3)