/usr/lib/cups/man/man.1/lpstat.1

                                   lpstat(1)
     _________________________________________________________________

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

Synopsis

   lpstat [options] [request-ID-list]

Description

   The lpstat command displays information about the current status of
   the LP print service. If no options are given, lpstat displays the
   status of all print requests made by you. (See lp(1) for details.)
   Status messages containing supplementary code set characters are
   displayed according to the locale specified in the LC_CTYPE
   environment variable (see LANG on environ(5)).

   The command lpstat -o printername is used to list all the requests
   queued on the specified printer. If printername points to a remote
   printer (see lpadmin(1M)), then lpstat -o printername lists all the
   requests on the remote printer, not just those submitted locally.

   Any arguments that are not options are assumed to be request-IDs as
   returned by lp. The lpstat command displays 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 by commas, for example, -p
       printer1,printer2
     * a list of items separated by spaces and enclosed in quotes, for
       example, -u "user1 user2 user3"

   Specifying all after any keyletter that takes list as an argument
   causes all information relevant to the keyletter to be displayed. For
   example, the command lpstat -a all lists the accepting status of all
   print destinations.

   The omission of a list following such keyletters causes all
   information relevant to the keyletter to be displayed. For example,
   the command lpstat -a is equivalent to lpstat -a all. The exception to
   the behavior of the all keyword is when it is used in conjunction with
   the -o option: lpstat -o all only lists requests submitted locally to
   remote printers.

   The following options and arguments may be used with lpstat:
   -a [list]
          Report whether print destinations are accepting requests. list
          is a list of intermixed printer names and class names.
   -c [list]
          Report names of all classes and their members. list is a list
          of class names.
   -d
          Report what the system default destination is (if any).
   -f [list] [-l]
          Verify that the forms in list are recognized by the LP print
          service. list is a list of forms; the default is all. The -l
          option will list the form parameters.
   -o [list] [-l]
          Report the status of print requests. list is a list of
          intermixed printer names, class names, and request-IDs. The
          keyletter -o may be omitted. The -l option lists for each
          request whether it is queued for, assigned to, or being printed
          on a local printer, the form required (if any), and the
          character set or print wheel required (if any). Note that
          required forms (if any) are not listed for remote printers.
   -p [list] [-D] [-l]
          If the -D option is given, a brief description is printed for
          each printer in list. If the -l option is given, a full
          description of each printer's configuration is given, including
          the form mounted, the acceptable content and printer types, a
          printer description, the interface used, and so on.
          The information needed to produce the printer status given by
          lpstat -p is available only if the LP scheduler is running.
   -r
          Report the status of the LP request scheduler (whether it is
          running).
   -R
          Report a number showing the rank order of jobs in the print
          queue for each printer.
   -s [-l]
          Display a status summary, including the status of the LP
          scheduler, the system default destination, a list of class
          names and their members, a list of printers and their
          associated devices, a list of the systems sharing print
          services, a list of all forms and their availability, and a
          list of all recognized character sets and print wheels. The -l
          option displays all parameters for each form and the printer
          name where each character set or print wheel is available.
   -S [list] [-l]
          Verify that the character sets or the print wheels specified in
          list are recognized by the LP print service. Items in list can
          be character sets or print wheels; the default for list is all.
          If the -l option is given, each line is appended by a list of
          printers that can handle the print wheel or character set. The
          list also shows whether the print wheel or character set is
          mounted or specifies the built-in character set into which it
          maps.
   -t [-l]
          Display all status information: all the information obtained
          with the -s option, plus the acceptance and idle/busy status of
          all printers and status of all requests. The -l option displays
          more detail as described for the -f, -o, -p, and -s options.
          Supplementary code set characters specified are not printed
          correctly.
   -u [login-ID-list]
          Display the status of output requests for users. The
          login-ID-list argument may include any or all of the following
          constructs:
        login-ID
               a user on the local system
        system-name!login-ID
               a user on system system-name
        system-name!all
               all users on system system-name
        all!login-ID
               a user on all systems
        all
               all users on the local system
        all!all
               all users on all systems
          The default value of login-ID-list is all.

Files

   /etc/lp/ * 
   /var/spool/lp/ * 
   /usr/lib/locale/locale/LC_MESSAGES/uxlp
          language-specific message file. (See LANG on environ(5)).

References

   lp(1)
     _________________________________________________________________

   © 2004 The SCO Group, Inc. All rights reserved.
   UnixWare 7 Release 7.1.4 - 25 April 2004
   
See also lpstat(1)