mmv_lookup_value_desc - Man Page
find a value in the Memory Mapped Value file
C Synopsis
#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
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
The function returns the address inside of the memory mapped region on success or NULL on failure.
See Also
Referenced By
mmv_inc(3), mmv_set(3), mmv_stats_init(3), mmv_stats_registry(3).
Performance Co-Pilot