LPSTAT(1)           RISC/os Reference Manual            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.




                        Printed 11/19/92                   Page 1

LPSTAT(1)           RISC/os Reference Manual            LPSTAT(1)



     -f [list] [-l]
          Prints a verification that the forms in list are recog-
          nized 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.  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 confi-
          guration 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 shar-
          ing 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.



 Page 2                 Printed 11/19/92

LPSTAT(1)           RISC/os Reference Manual            LPSTAT(1)



     -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

          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.

INTERNATIONAL FUNCTIONALITY
     Status messages containing characters from supplementary
     code sets can be displayed.

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

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























                        Printed 11/19/92                   Page 3