lpstat(1)            (Line Printer Spooling Utilities)            lpstat(1)


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

   SYNOPSIS
         lpstat [options]

   DESCRIPTION
         The lpstat command prints information about the current status of the
         LP print service.

         If no options are given, then lpstat prints the status of all output
         (or print) requests made by lp [see lp(1)].  Any arguments that are
         not options are assumed to be request-IDs as returned by lp.  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.  A list that includes spaces or shell
         special characters must be enclosed in double quotes.  For example:

               -u "user1, user2, user3"

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

               lpstat -o all

         prints the status of all output requests.

         The omission of a list following such key letters causes all
         information relevant to the key letter to be prined.  For example,
         the command

               lpstat -o

         prints the status of all output requests.

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

         -c [list]
              Reports name of all classes and their members.  list is a list
              of class names.

         -d   Reports the system default destination for output requests.





   8/91                                                                 Page 1

   lpstat(1)            (Line Printer Spooling Utilities)            lpstat(1)


         -f [list] [-l]
              Prints a verification 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 descriptions.

         -o [list]
              Reports the status of output requests.  list is a list of
              intermixed printer names, class names, and request-IDs.

         -p [list] [-D] [-l]
              Reports the status of printers.  list is a list of printer
              names.  If the -D option is given, a brief description is
              printed for each printer in list.  If the -l option is given,
              and the printer is on the local machine, 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.  If the -l option is
              given and the printer is remote, the only information given is
              the remote machine and printer names, and the shell-commands
              used for file transfer and remote execution.

         -r   Reports whether the LP request scheduler is on or off.

         -R   Reports a number showing the position of the job in the print
              queue.

         -s   Displays 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 machines sharing print services, a list
              of all forms currently mounted, and a list of all recognized
              character sets and print wheels.

         -S [list] [-l]
              Prints a verification 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 the 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   Displays all status information: all the information obtained
              with the -s option, plus the acceptance and idle/busy status of
              all printers.

         -u [login-ID-list]
              Displays the status of output requests for users.  The login-
              ID-list argument may include any or all of the following
              constructs:


   Page 2                                                                 8/91

   lpstat(1)            (Line Printer Spooling Utilities)            lpstat(1)


              user_name      a user on the local system

              system_name!user_name
                             a user on system_name

              system_name!all
                             all users on system_name

              all!user_name  a user not on the local system

              all!all        all users not on the local system

              all            all users on the local system

         -v [list]
              Reports the names of printers and the pathnames of the devices
              associated with them.  list is a list of printer names.

   FILES
         /var/spool/lp/*
         /etc/lp/*

   SEE ALSO
         enable(1), lp(1).





























   8/91                                                                 Page 3