преобразовать код ошибки PMAPI в строку (convert a PMAPI error code into a string)
Имя (Name)
pmErrStr
, pmErrStr_r
- convert a PMAPI error code into a string
Синопсис C (C Synopsis)
#include <pcp/pmapi.h>
const char *pmErrStr(int
code);
char *pmErrStr_r(int
code, char *
buf, int
buflen);
cc ... -lpcp
Описание (Description)
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 pmErrStr(3) returns an appropriate PMAPI error
string, as determined by code.
Примечание (Note)
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.
Смотри также (See also)
pmerr(1), PMAPI(3) and perror(3).