LPQ(1)                               BSD                                LPQ(1)



NAME
     lpq - spool queue examination program

SYNOPSIS
     lpq [ +[ n ] ] [ -l ] [ -Pprinter ] [ job# ... ] [ user ... ]

DESCRIPTION
     lpq examines the spooling area used by lpd(8) for printing files on the
     line printer, and reports the status of the specified jobs or of all jobs
     associated with a user.  lpq invoked without any arguments reports on any
     jobs currently in the queue.

     For each job submitted (that is, each invocation of lpr(1)), lpq reports
     the user's name, the current rank in the queue, the names of files
     comprising the job, the job identifier (a number which can be supplied to
     lprm(1) for removing a specific job), and the total size in bytes.  Job
     ordering is dependent on the algorithm used to scan the spooling
     directory and is supposed to be first in, first out (FIFO). Filenames
     comprising a job may be unavailable (when lpr(1) is used as a sink in a
     pipeline), in which case the file is indicated as "(standard input)".

     If lpq warns that there is no daemon present, the lpc(8) command can be
     used to restart the printer daemon.

OPTIONS
     -l         Print information about each of the files comprising the job.
                Normally, lpq displays only as much information as fits on one
                line.

     +[n]       Display the spool queue until it empties.  Supplying an
                optional number immediately after the plus sign (+) indicates
                that lpq should sleep n seconds in between scans of the queue.

     -Pprinter  Specify a particular printer; otherwise, lpq uses the default
                line printer or the value of the PRINTER variable in the
                environment.

     job#       Look for the print job with the specified number.

     users      Look for the print jobs owned by the specified users.

FILES
     /etc/termcap            For manipulating the screen for repeated display
     /etc/printcap           To determine printer characteristics
     /usr/spool/*            The spooling directory, as determined from printcap
     /usr/spool/*/cf*        Control files specifying jobs
     /usr/spool/*/lock       The lock file to obtain the currently active job

SEE ALSO
     lpr(1), lprm(1), prf(1), lpc(8), lpd(8)

BUGS
     Due to the dynamic nature of the information in the spooling directory,
     lpq may report unreliably.

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