1MMV_LOOKUP_VALUE_DESC(3)   Library Functions Manual   MMV_LOOKUP_VALUE_DESC(3)
2
3
4

NAME

6       mmv_lookup_value_desc - find a value in the Memory Mapped Value file
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/mmv_stats.h>
11
12       pmAtomValue *mmv_lookup_value_desc(void *addr, const char *metric,
13               const char *inst);
14
15       cc ... -lpcp_mmv -lpcp
16

DESCRIPTION

18       mmv_lookup_value_desc searches for the value of the instance identified
19       by  the  external instance name inst of the metric metric in the MMV(5)
20       file.  addr is the address returned from mmv_stats_init().
21
22       The pointer returned points to a pmAtomValue union, which is defined as
23       follows:
24
25           typedef union {
26               __int32_t   l;      /* 32-bit signed */
27               __uint32_t  ul;     /* 32-bit unsigned */
28               __int64_t   ll;     /* 64-bit signed */
29               __uint64_t  ull;    /* 64-bit unsigned */
30               float       f;      /* 32-bit floating point */
31               double      d;      /* 64-bit floating point */
32               char         *cp;   /* char ptr */
33            pmValueBlock *vbp;  /* pmValueBlock ptr */
34           } pmAtomValue;
35
36       MMV  string  values should be set using either of the mmv_set_string or
37       mmv_set_strlen routines.
38

RETURNS

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

SEE ALSO

44       mmv_stats_init(3), mmv_inc_value(3) and mmv(5).
45
46
47
48Performance Co-Pilot                                  MMV_LOOKUP_VALUE_DESC(3)
Impressum