pmErrStr,
pmErrStr_r - convert a PMAPI error code into a string
#include <pcp/pmapi.h>
const char *pmErrStr(int
code);
char *pmErrStr_r(int
code, char *
buf, int
buflen);
cc ... -lpcp
Translate an error code into a text string, suitable for generating a diagnostic
message. The
pmErrStr_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
PM_MAXERRMSGLEN bytes.
By convention, all error codes are negative. The small values are assumed to be
negated versions of the Unix error codes as defined in
<errno.h>
and the strings returned are as per
strerror(3). The larger, negative
error codes are Performance Metrics Application Programming Interface (PMAPI)
error conditions and returns an appropriate PMAPI error
string, as determined by
code.
pmErrStr returns a pointer to a static buffer, so the returned value is
only valid until the next call to
pmErrStr and hence is not
thread-safe. Multi-threaded applications should use
pmErrStr_r instead.
pmerr(1),
PMAPI(3) and
perror(3).