


lpstat(1)                                               lpstat(1)


NAME
       lpstat - print information about the status of the LP print service

SYNOPSIS
       lpstat [ -A ] [ -d ] [ -r ] [ -R ] [ -s ] [ -t ] [ -a [list] ]
            [ -c [list] ] [ -f [list] [ -l ] ] [ -o [list] ]
            [ -p [list] [ -D ] [ -l ] ] [ -P ]
            [ -S [list] [ -l ] ] [ -u [login-ID-list] ]
            [ -v [list] ] [ -Tdebugoptions ] [list]

DESCRIPTION
       The  lpstat  command prints information about the current status of the
       LP print service.  This is implemented as a  front  end  to  the  LPRng
       lpq(1)  program, and does not have the full functionality of the native
       lpstat program.

       If no options are given, then lpstat  prints  the  status  of  all  the
       user's  print  requests  made by lp on the default printer.  (see lp(1)
       and lpr(1)).  Any arguments that are not  options  are  assumed  to  be
       request-IDs  as  returned  by  lp or printer names.  The lpstat command
       prints the status of such requests.  The  options  may  appear  in  any
       order and may be repeated and intermixed with other arguments.  Some of
       the keyletters below may be followed by an optional list that can be in
       one  of  two  forms:  a  list  of items separated from one another by a
       comma, or a list of items separated from one another by spaces enclosed
       in quotes.  For example:

               example% lpstat -u "user1 user2 user3"

       Specifying  all  after  any  keyletter  that  takes list as an argument
       causes all information relevant to the keyletter to  be  printed.   For
       example, the command:

              example% lpstat -o all

       prints the status of all output requests.

       The  omission  of a list following such key letters causes all informa-
       tion relevant to the key letter to be printed.  For example,  the  com-
       mand:

              example% lpstat -o

       prints the status of all output requests.

OPTIONS
       The following options are supported:

       -A             Use  authentication  specified  by the value of the AUTH
                      environment variable.

       -a [list]      Reports  whether  print   destinations   are   accepting
                      requests.  list is a list of printer names.




                            7 Feb 1994                          1





lpstat(1)                                               lpstat(1)


       -c [list]      Print  name of all classes and their members.  list is a
                      list of class names.  (Same effect as -o.)

       -d             Print  the  system  default   destination   for   output
                      requests.

       -f [list] [-l] Print  list  of  printers supporting the specified forms
                      option is ignored.

       -o [list]      Print the status of output requests: list is a  list  of
                      intermixed  printer names, class names, and request-IDs.
                      The keyletter -o may be omitted.

       -p [list]      Print the status of printers.  list is a list of printer
                      names.  (Same effect as -o.)

       -P             Print the paper types.  Ignored.

       -r             Print the status of the LP request scheduler.

       -R             Print  a  number showing the position of each job in the
                      print queue.  Ignored.

       -s             Print a status summary.  Produces a short  status  list-
                      ing.

       -S [list] [-l] List or verify character sets of printers.  (Ignored.)

       -t             Print all status information.

       -u [login-ID-list]
                      Print  the  status  of output requests for users.  (Same
                      effect as -o.)

       -v [list]      Print the path names  of  the  printer  output  devices.
                      (Ignored.)  -D Combined with the -p flag prints descrip-
                      tion of printer.

       -Toptions      Set debugging options. Use -T= to get lpstat to  provide
                      a list.

ENVIRONMENT
       By default, the destination printer is taken from the command line dest
       value,  then  the  environment  variables  PRINTER,  LPDEST,  NPRINTER,
       NGPRINTER,  then  first  entry  in  the  printcap  information, and and
       finally the default_printer entry from the configuration file, and then
       the compile time default.

EXIT STATUS
       The following exit values are returned:

       zero (0)       Successful completion.

       non-zero (!=0) An error occurred.



                            7 Feb 1994                          2





lpstat(1)                                               lpstat(1)


FILES
       The  files used by LPRng are set by values in the printer configuration
       file.  The following are a commonly used set of default values.
       /etc/LPRng/lpd.conf                          LPRng configuration file
       ${HOME}/.printcap                            user printer description file
       /etc/printcap                                printer description file
       /etc/LPRng/lpd.perms                         permissions
       /var/run/lpd                                 lock file for queue control
       /var/spool/lpd                               spool directories
       /var/spool/lpd/QUEUE/control                 queue control
       /var/spool/lpd/QUEUE/log                     trace or debug log file
       /var/spool/lpd/QUEUE/acct                    accounting file
       /var/spool/lpd/QUEUE/status                  status file

SEE ALSO
       lpd.conf(5),  lpc(8),  lpd(8),  checkpc(8),  lpr(1),  lpq(1),  lprm(1),
       printcap(5), lpd.perms(5), pr(1), lprng_certs(1), lprng_index_certs(1).

DIAGNOSTICS
       Most of the diagnostics are self explanatory.
       If you are puzzled over the exact cause of failure,
       set the debugging level on (-T5) and run again.
       The debugging information will
       help you to pinpoint the exact cause of failure.

HISTORY
       LPRng is a enhanced printer spooler system with  functionality  similar
       to   the   Berkeley   LPR   software.    The   LPRng  mailing  list  is
       lprng@lprng.com; subscribe by sending mail  to  lprng-request@lprng.com
       with  the  word  subscribe in the body.  The software is available from
       ftp://ftp.lprng.com/pub/LPRng.

AUTHOR
       Patrick Powell <papowell@lprng.com>.























                            7 Feb 1994                          3


