BSD 4_3_Tahoe development
[unix-history] / usr / man / cat1 / lpq.0
CommitLineData
362b077f
C
1
2
3
4LPQ(1) UNIX Programmer's Manual LPQ(1)
5
6
7
8N\bNA\bAM\bME\bE
9 lpq - spool queue examination program
10
11S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
12 l\blp\bpq\bq [ -l ] [ -Pprinter ] [ job # ... ] [ user ... ]
13
14D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
15 _\bl_\bp_\bq examines the spooling area used by _\bl_\bp_\bd(8) for printing
16 files on the line printer, and reports the status of the
17 specified jobs or all jobs associated with a user. _\bl_\bp_\bq
18 invoked without any arguments reports on any jobs currently
19 in the queue. A -\b-P\bP flag may be used to specify a particular
20 printer, otherwise the default line printer is used (or the
21 value of the PRINTER variable in the environment). All other
22 arguments supplied are interpreted as user names or job
23 numbers to filter out only those jobs of interest.
24
25 For each job submitted (i.e. invocation of _\bl_\bp_\br(1)) _\bl_\bp_\bq
26 reports the user's name, current rank in the queue, the
27 names of files comprising the job, the job identifier (a
28 number which may be supplied to _\bl_\bp_\br_\bm(1) for removing a
29 specific job), and the total size in bytes. The -\b-l\bl option
30 causes information about each of the files comprising the
31 job to be printed. Normally, only as much information as
32 will fit on one line is displayed. Job ordering is depen-
33 dent on the algorithm used to scan the spooling directory
34 and is supposed to be FIFO (First in First Out). File names
35 comprising a job may be unavailable (when _\bl_\bp_\br(1) is used as
36 a sink in a pipeline) in which case the file is indicated as
37 ``(standard input)".
38
39 If _\bl_\bp_\bq warns that there is no daemon present (i.e. due to
40 some malfunction), the _\bl_\bp_\bc(8) command can be used to restart
41 the printer daemon.
42
43F\bFI\bIL\bLE\bES\bS
44 /etc/termcap for manipulating the screen for repeated display
45 /etc/printcap to determine printer characteristics
46 /usr/spool/* the spooling directory, as determined from printcap
47 /usr/spool/*/cf* control files specifying jobs
48 /usr/spool/*/lock the lock file to obtain the currently active job
49
50S\bSE\bEE\bE A\bAL\bLS\bSO\bO
51 lpr(1), lprm(1), lpc(8), lpd(8)
52
53B\bBU\bUG\bGS\bS
54 Due to the dynamic nature of the information in the spooling
55 directory lpq may report unreliably. Output formatting is
56 sensitive to the line length of the terminal; this can
57 results in widely spaced columns.
58
59
60
61
62
63Printed 7/9/88 April 30, 1987 1
64
65
66
67
68
69
70LPQ(1) UNIX Programmer's Manual LPQ(1)
71
72
73
74D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
75 Unable to open various files. The lock file being mal-
76 formed. Garbage files when there is no daemon active, but
77 files in the spooling directory.
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129Printed 7/9/88 April 30, 1987 2
130
131
132