pmerrstr(3) [centos man page]

PMERRSTR(3)						     Library Functions Manual						       PMERRSTR(3)

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(3C).  The larger, negative error codes are Performance Metrics Application Program-
       ming 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(3C).

Performance Co-Pilot							PCP							       PMERRSTR(3)

PMIERRSTR(3)						     Library Functions Manual						      PMIERRSTR(3)

NAME

       pmiErrStr - convert a LOGIMPORT error code into a string

C SYNOPSIS

       #include <pcp/pmapi.h>
       #include <pcp/import.h>

       const char *pmiErrStr(int code);
       char *pmiErrStr_r(int code, char buf, int buflen);

       cc ... -lpcp_import -lpcp

Perl SYNOPSIS
       use PCP::LogImport;

       pmiErrStr($code);

DESCRIPTION

       As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiErrStr translates error codes returned from the other routines in
       the Log Import library into printable error messages.

       code would normally have a negative value.  As a special case, if code is -1 then the error code returned from the last routine	called	in
       the LOGIMPORT library for this context will be used.

       The pmiErrStr_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 PMI_MAXERRMSGLEN bytes.

       The set of possible error codes and messages is all those defined by pmErrStr(3) and  PCPIntro(3),  plus  the  additonal  ones  defined	in
       <pcp/import.h> with error code names of the form PMI_ERR_....

DIAGNOSTICS

       None.

SEE ALSO

       LOGIMPORT(3), PCPIntro(3) and pmErrStr(3).

Performance Co-Pilot							PCP							      PMIERRSTR(3)