MMV_LOOKUP_VALUE_DESC(3) | Library Functions Manual | MMV_LOOKUP_VALUE_DESC(3) |
NAME
mmv_lookup_value_desc - 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
Performance Co-Pilot |