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;

DESCRIPTION
     SLPerror 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.
SEE ALSO
     SLGetSpoolerError(3), libspool(3)