1PMERRSTR(3)                Library Functions Manual                PMERRSTR(3)
2
3
4

NAME

6       pmErrStr - convert a PMAPI error code into a string
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       const char *pmErrStr(int code)
12
13       cc ... -lpcp
14

DESCRIPTION

16       Translate  an  error code into a text string, suitable for generating a
17       diagnostic message.  By convention, all error codes are negative.   The
18       small values are assumed to be negated versions of the Unix error codes
19       as defined in <errno.h> and  the  strings  returned  are  as  per  str‐
20       error(3C).   The  larger,  negative error codes are Performance Metrics
21       Application  Programming  Interface  (PMAPI)   error   conditions   and
22       pmErrStr(3) returns an appropriate PMAPI error string, as determined by
23       code.
24
25       The string value is held in a single static  buffer,  so  the  returned
26       value is only valid until the next call to pmErrStr.
27

SEE ALSO

29       pmerr(1), PMAPI(3) and perror(3C).
30
31
32
33Performance Co-Pilot                  SGI                          PMERRSTR(3)