PDPerror(3) Impressario 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 ALSOPDReadStatus(3), PDReadInfo(3), libpod(3)
Page 1