PDPerror(3)

NAME
     PDPerror, PDErrorString - obtain libpod execution error messages

SYNOPSIS
     #include <pod.h>

     void PDPerror(const char *s);

     char* PDErrorString(int err_code);

     extern int PDerrno;

DESCRIPTION
     PDPerror prints error messages to standard error in a format similar to
     the standard C library function perror(3C). PDErrorString returns the
     error string corresponding to the libspool error code specified by
     err_code.  The function is similar to the C library function
     strerror(3C).

     If an error occurs during a libpod function call, the global error
     variable PDerrno will be set with an error code.  The symbolic names for
     these error codes are defined in pod.h.

     The value of PDerrno is used by PDPerror as an index to a table of error
     messages. PDerrno can be passed to PDErrorString to obtain the libpod
     error message corresponding to the error code.

     A call to PDPerror will print the user-supplied string s followed by a
     colon (:), a space, and the error message corresponding to the current
     value of PDerrno. If the string s is the NULL string (""), no colon or
     space will be printed, only the error message.

     To be of most use, a call to PDPerror should be made immediately
     following the libpod function which failed.

PRINTER OPERATIONAL ERRORS
     The PDPerror function only provides information about libpod function
     execution errors. Information about printer operational errors is not
     provided by PDPerror but rather by querying the printer database using
     the PDReadStatus and PDReadInfo functions.

NOTE
     The global variables PDerrlist and PDnerr should no longer be referenced.
     The function PDErrorString should be used.

SEE ALSO
     PDReadStatus(3), PDReadInfo(3), libpod(3)