NAME

       pmErrStr, pmErrStr_r - convert a PMAPI error code into a string

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.

NOTES

       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).