NAME¶
pmTypeStr,
pmTypeStr_r - convert a performance metric type into a
string
C SYNOPSIS¶
#include <pcp/pmapi.h>
const char *pmTypeStr(int
type);
char *pmTypeStr_r(int
type, char *
buf, int
buflen);
cc ... -lpcp
DESCRIPTION¶
Given a performance metric
type,
pmTypeStr produces a terse ASCII
equivalent, appropriate for use in error and diagnostic messages. The
pmTypeStr_r function does the same, but stores the result in a
user-supplied buffer
buf of length
buflen, which should have
room for at least 20 bytes.
The value for
type is typically extracted from a
pmDesc structure,
following a call to
pmLookupDesc(3) for a particular performance
metric.
Examples are
32 (for
type equals
PM_TYPE_32),
U64
(for
type equals
PM_TYPE_U64),
AGGREGATE (for
type
equals
PM_TYPE_AGGREGATE), etc.
The string value result for
pmTypeStr is held in a single static buffer,
so the returned value is only valid until the next call to
pmTypeStr.
NOTES¶
pmTypeStr returns a pointer to a static buffer and hence is not
thread-safe. Multi-threaded applications should use
pmTypeStr_r
instead.
SEE ALSO¶
PMAPI(3),
pmAtomStr(3),
pmConvScale(3),
pmExtractValue(3),
pmLookupDesc(3),
pmPrintValue(3) and
pmUnitsStr(3).