SLPerror(3) Impressario SLPerror(3)NAME
SLPerror, SLErrorString - obtain libspool execution error messages
SYNOPSIS
#include <spool.h>
void SLPerror(const char *s);
char* SLErrorString(int err_code);
extern int SLerrno;
DESCRIPTIONSLPerror prints error messages to standard error in a format similar to
the standard C library function perror(3C). SLErrorString 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 libspool function call, the global error
variable SLerrno will be set with an error code. The symbolic names for
these error codes are defined in spool.h.
The value of SLerrno is used by SLPerror as an index to a table of error
messages. SLerrno can be passed to SLErrorString to obtain the libspool
error message corresponding to the error code. The variable SLerrno is
globally available to user programs.
A call to SLPerror will print the user-supplied string s followed by a
colon (:), a space, and the error message corresponding to the current
value of SLerrno. 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 SLPerror should be made immediately
following the libspool function call where an error has been detected.
SPOOLING SYSTEM ERRORS
libspool provides a C interface to the UNIX print spooling systems. In
fact, many libspool functions execute the spooling system shell commands.
If an error has been detected after the execution of a libspool function
and SLerrno is found to be set to SL_ERR_SPOOLER_ERROR, this indicates
that an error has occurred during the execution of a spooling system
command. Under this condition SLPerror will report only that a spooling
system error has occurred. To obtain the actual spooling system command
error message(s) and exit status, call the function SLGetSpoolerError(3).
NOTE
The global variables SLerrlist and SLnerr should no longer be referenced.
The function SLErrorString should be used.
Page 1
SLPerror(3) Impressario SLPerror(3)SEE ALSOSLGetSpoolerError(3), libspool(3)
Page 2
