BSD 4_3_Tahoe development

[unix-history] / usr / man / cat1 / lpq.0

LPQ(1)              UNIX Programmer's Manual               LPQ(1)



N\bNA\bAM\bME\bE
    lpq - spool queue examination program

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
    l\blp\bpq\bq [ -l ] [ -Pprinter ] [ job # ... ] [ user ... ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
    _\bl_\bp_\bq examines the spooling area used by _\bl_\bp_\bd(8) for printing
    files on the line printer, and reports the status of the
    specified jobs or all jobs associated with a user.  _\bl_\bp_\bq
    invoked without any arguments reports on any jobs currently
    in the queue.  A -\b-P\bP 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). 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 _\bl_\bp_\br(1)) _\bl_\bp_\bq
    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 _\bl_\bp_\br_\bm(1) for removing a
    specific job), and the total size in bytes.  The -\b-l\bl option
    causes information about each of the files comprising the
    job to be printed.  Normally, only as much information as
    will fit on one line is displayed.  Job ordering is depen-
    dent on the algorithm used to scan the spooling directory
    and is supposed to be FIFO (First in First Out).  File names
    comprising a job may be unavailable (when _\bl_\bp_\br(1) is used as
    a sink in a pipeline) in which case the file is indicated as
    ``(standard input)".

    If _\bl_\bp_\bq warns that there is no daemon present (i.e. due to
    some malfunction), the _\bl_\bp_\bc(8) command can be used to restart
    the printer daemon.

F\bFI\bIL\bLE\bES\bS
    /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

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
    lpr(1), lprm(1), lpc(8), lpd(8)

B\bBU\bUG\bGS\bS
    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
    results in widely spaced columns.





Printed 7/9/88           April 30, 1987                         1






LPQ(1)              UNIX Programmer's Manual               LPQ(1)



D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
    Unable to open various files.  The lock file being mal-
    formed.  Garbage files when there is no daemon active, but
    files in the spooling directory.



















































Printed 7/9/88           April 30, 1987                         2