lpstat(1)       UNIX System V(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 the user's
      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 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 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.

      -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.



10/89                                                                    Page 1

lpstat(1)       UNIX System V(Line Printer Spooling Utilities)        lpstat(1)


      -o [list]
           Reports 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] [-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:

           login-ID       a user on any system

           system_name!login-ID
                          a user on system system_name





Page 2                                                                    10/89

lpstat(1)       UNIX System V(Line Printer Spooling Utilities)        lpstat(1)


           system_name!all
                          all users on system system_name

           all!login-ID   a user on all systems

           all            all users on all systems

      -v [list]
           Reports the names of printers and the pathnames of the devices
           associated with them or remote system names for network printers:
           list is a list of printer names.

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

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




































10/89                                                                    Page 3