lpq(1-BSD)        MISC. REFERENCE MANUAL PAGES         lpq(1-BSD)



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 mal-
     function), 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



                                                                1

lpq(1-BSD)        MISC. REFERENCE MANUAL PAGES         lpq(1-BSD)



          superuser can restart the spooler using lpc(1M).

     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 res-
          tarted 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 indi-
          cate 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



                                                                2

lpq(1-BSD)        MISC. REFERENCE MANUAL PAGES         lpq(1-BSD)



          It is likely there is an error in this  software.   Get
          help from system administrator.

SEE ALSO
     lpc(1M),  lpr(1),  lprm(1),  lpsched(1M)   in   the   System
     Administrator's Reference Manual.
     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.












































                                                                3