lpq(1)                                                     lpq(1)



     NAME
          lpq - spool queue examination program

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

     DESCRIPTION
          lpq invoked without any arguments reports on any jobs
          currently in the line printer queue.  A -P flag may be used
          to specify a particular printer, otherwise the default line
          printer is used (or the value of the PRINTER variable in the
          environment).  If a + argument is supplied, lpq displays the
          spool queue until it empties.  Supplying a number (n)
          immediately after the + sign indicates that lpq should sleep
          n seconds in between scans of the queue.  All other
          arguments supplied are interpreted as user names or job
          numbers to filter out only those jobs of interest.

          For each job submitted (i.e., invocation of lpr(1)), lpq
          reports the user's name, current rank in the queue, the
          names of files comprising the job, the job identifier (a
          number which may be supplied to lprm(1) for removing a
          specific job), and the total size in bytes.

          lpq will accept arguments which are undocumented but used in
          the lpstat command, because lpq is written as a script which
          uses lpstat(1).

     FILES
          /usr/ucb/lineprinter/lpq

          /etc/termcap       for manipulating the screen for repeated
                             display

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

     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.

     DIAGNOSTICS
          lpq may report that it is unable to open various files.

          The lock file may be malformed.

          Garbage files may be printed when there is no daemon active,
          but the files are found in the spooling directory.




     Page 1                                        (last mod. 1/20/87)