lpq(1)                  (BSD Compatibility Package)                  lpq(1)


   NAME
         lpq - display the queue of printer jobs

   SYNOPSIS
         /usr/ucb/lpq [ -Pprinter ] [ -l ] [ + [ interval ] ] [ job# ...  ] [
         username ...  ]

   DESCRIPTION
         lpq displays the contents of a printer queue.  It reports the status
         of jobs specified by job#, or all jobs owned by the user specified by
         username.  lpq reports on all jobs in the default printer queue when
         invoked with no arguments.

         For each print job in the queue, lpq reports the user's name, current
         position, the names of input files comprising the job, the job number
         (by which it is referred to when using lprm(1)) and the total size in
         bytes.  Normally, only as much information as will fit on one line is
         displayed.  Jobs are normally queued on a first-in-first-out basis.
         Filenames comprising a job may be unavailable, such as when lpr is
         used at the end of a pipeline; in such cases the filename field
         indicates the standard input.

         If lpq warns that there is no daemon present (that is, due to some
         malfunction), the lpc(1M) command can be used to restart a printer
         daemon.

   OPTIONS
         -P printer     Display information about the queue for the specified
                        printer.  In the absence of the -P option, the queue
                        to the printer specified by the PRINTER variable in
                        the environment is used.  If the PRINTER variable is
                        not set, the queue for the default printer is used.

         -l             Display queue information in long format; includes the
                        name of the host from which the job originated.

         +[ interval ]  Display the spool queue periodically until it empties.
                        This option clears the terminal screen before
                        reporting on the queue.  If an interval is supplied,
                        lpq sleeps that number of seconds in between reports.

   FILES
         /var/spool/lp            spooling directory.
         /var/spool/lp/tmp/system_name/*-0
                                  reqeust files specifying jobs

   DIAGNOSTICS
         printer is printing
               The lpq program queries the spooler LPSCHED about the status of
               the printer.  If the printer is disabled, the superuser can
               restart the spooler using lpc(1M).


   8/91                                                                 Page 1

   lpq(1)                  (BSD Compatibility Package)                  lpq(1)


         printer waiting for auto-retry (offline ?)
               The daemon could not open the printer device.  The printer may
               be turned off-line.  This message can also occur if a printer
               is out of paper, the paper is jammed, and so on.  Another
               possible cause is that a process, such as an output filter, has
               exclusive use of the device.  The only recourse in this case is
               to kill the offending process and restart the printer with lpc.

         waiting for host to come up
               A daemon is trying to connect to the remote machine named host,
               in order to send the files in the local queue.  If the remote
               machine is up, lpd on the remote machine is probably dead or
               hung and should be restarted using lpc.

         sending to host
               The files are being transferred to the remote host, or else the
               local daemon has hung while trying to transfer the files.

         printer disabled reason:
               The printer has been marked as being unavailable with lpc.

         lpq: The LP print service isn't running or can't be reached.
               The lpsched process overseeing the spooling queue does not
               exist.  This normally occurs only when the daemon has
               unexpectedly died.  You can restart the printer daemon with
               lpc.

         lpr: printer: unknown printer
               The printer was not found in the System V LP database.  Usually
               this is a typing mistake; however, it may indicate that the
               printer does not exist on the system.  Use `lptstat -p' to find
               the reason.

         lpr: error on opening queue to spooler
               The connection to lpsched on the local machine failed.  This
               usually means the printer server started at boot time has died
               or is hung.  Check if the printer spooler daemon
               /usr/lib/lpsched is running.

         lpr: Can't send message to LP print service

         lpr: Can't receive message from LP print service
               These indicate that the LP print service has been stopped.  Get
               help from the system administrator.

         lpr: Received unexpected message from LP print service
               It is likely there is an error in this software.  Get help from
               system administrator.





   Page 2                                                                 8/91

   lpq(1)                  (BSD Compatibility Package)                  lpq(1)


   SEE ALSO
         lpr(1), lprm(1),

         lp(1) in the User's Reference Manual.

   NOTES
         Output formatting is sensitive to the line length of the terminal;
         this can result in widely-spaced columns.













































   8/91                                                                 Page 3