SLGetSpooler(3)

NAME
     SLGetSpooler, SLSetSpooler - gets/sets the default spooling system

SYNOPSIS
     #include <spool.h>

     int SLGetSpooler(unsigned int *defaultp,
                      unsigned int *availablep);
     int SLSetSpooler(unsigned int default);

DESCRIPTION
     The libspool library provides a common C language interface to two UNIX
     print spooling systems, AT&T System V and BSD. The first libspool
     function called automatically determines which of the two spooling
     systems is available and sets a default spooling system for use by
     subsequent libspool functions. The default spooling system set is
     determined by the following table:

                           Available Spoolers   Default
                           _____________________________
                           None                 None
                           BSD                  BSD
                           System V             System V
                           System V and BSD     System V

     A spooling system is considered available if the daemon for the spooling
     system is found to be running on the system.

     The SLGetSpooler function returns the available spooling systems and the
     currently set default spooling system. The SLSetSpooler function allows a
     new default spooling system to be set for use by subsequent libspool
     functions. Note that each libspool function automatically establishes a
     default spooling system if one has not been set. Therefore, a call to
     SLSetSpooler is necessary only when it is desired to set a spooler other
     than the current default.

     defaultp       This is the currently set default spooling system that
                    will be used by subsequent libspool functions. The value
                    is one of:

                    SL_SPOOLER_NONE   - No default currently set
                    SL_SPOOLER_BSD    - BSD is default
                    SL_SPOOLER_SYSV   - System V is default

     default        This value specifies which spooling system is to be the
                    default. The value is one of:

                    SL_SPOOLER_BSD    - Set BSD as default
                    SL_SPOOLER_SYSV   - Set System V as default
     availablep     This parameter indicates the spoolers currently available
                    on the system. The available spooling systems are
                    determined by the presence of the daemon for a given
                    spooling system. The System V spooling system is
                    considered available for use if the lpsched daemon is
                    running. The BSD spooling system is considered available
                    if the lpd daemon is running.  availablep is a bit mask of
                    the available spooling systems. The value is one of:

                    SL_SPOOLER_NONE    - No spooling systems available
                    SL_SPOOLER_BSD     - BSD spooling only
                    SL_SPOOLER_SYSV    - System V spooling only
                    SL_SPOOLER_BSD |
                    SL_SPOOLER_SYSV    - System V and BSD available

RETURN VALUE
     0 is returned if execution was successful. -1 is returned and SLerrno is
     set if an execution error has occurred.

EXECUTION ERROR CODES
     SLGetSpooler and SLSetSpooler will fail under the following
     circumstances.

     SL_ERR_FIND_SPOOLER      An error occurred while attempting to determine
                              the available printer spooling systems.

     In addition, SLSetSpooler will fail under the following circumstances.

     SL_ERR_SPOOLER_NONE      An invalid spooling system (e.g.
                              SL_SPOOLER_NONE) has been specified as the
                              default spooling system.

     SL_ERR_NO_SPOOLERS       There are no printer spooling systems available.


     SL_ERR_SPOOLER_UNKNOWN   The spooling system specified is not available.


SEE ALSO
     SLPerror(3), libspool(3), lpsched(1M), lpd(1M)