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