Penguin
Recent Changes
Annotated edit history of lpstat(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 lpstat
2 !!!lpstat
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 ENVIRONMENT
8 EXIT STATUS
9 FILES
10 SEE ALSO
11 DIAGNOSTICS
12 HISTORY
13 AUTHOR
14 ----
15 !!NAME
16
17
18 lpstat - print information about the status of the LP print service
19 !!SYNOPSIS
20
21
22 __lpstat__ [[ __-A__ ] [[ __-d__ ] [[ __-r__ ] [[
23 __-R__ ] [[ __-s__ ] [[ __-t__ ] [[ __-a__
24 [[''list''] ]
25
26
27 [[ __-c__ [[''list''] ] [[ __-f__ [[''list''] [[
28 __-l__ ] ] [[ __-o__ [[''list''] ] [[ __-p__
29 [[''list''] [[ __-D__ ] [[ __-l__ ] ] [[ __-P__ ] [[
30 __-S__ [[''list''] [[ __-l__ ] ] [[ __-u__
31 [[''login-ID-list''] ] [[ __-v__ [[''list''] ] [[
32 __-T__''debugoptions'' ] [[''list'']
33 !!DESCRIPTION
34
35
36 The __lpstat__ command prints information about the
37 current status of the LP print service. This
38 is implemented as a front end to the LPRng lpq(1)
39 program, and does not have the full functionality of the
40 native __lpstat__ program.
41
42
43 If no options are given, then __lpstat__ prints the
44 status of all the user's print requests made by __lp__ on
45 the default printer. (see lp(1) and lpr(1)).
46 Any arguments that are not ''options'' are assumed to be
47 ''request-IDs'' as returned by __lp__ or printer
48 names. The __lpstat__ command prints the status of such
49 requests. The ''options'' may appear in any order and may
50 be repeated and intermixed with other arguments. Some of the
51 keyletters below may be followed by an optional ''list''
52 that can be in one of two forms: a list of items separated
53 from one another by a comma, or a list of items separated
54 from one another by spaces enclosed in quotes. For
55 example:
56
57
58 __example% lpstat -u
59 __
60
61
62 Specifying __all__ after any keyletter that takes
63 ''list'' as an argument causes all information relevant
64 to the keyletter to be printed. For example, the
65 command:
66
67
68 __example% lpstat -o all__
69
70
71 prints the status of all output requests.
72
73
74 The omission of a ''list'' following such key letters
75 causes all information relevant to the key letter to be
76 printed. For example, the command:
77
78
79 __example% lpstat -o__
80
81
82 prints the status of all output requests.
83 !!OPTIONS
84
85
86 The following options are supported:
87
88
89 __-A__ Use authentication specified by the value of the
90 AUTH environment variable.
91
92
93 __-a__ [[''list'']
94
95
96 Reports whether print destinations are accepting requests.
97 ''list'' is a list of printer names.
98
99
100 __-c__ [[''list'']
101
102
103 Print name of all classes and their members. ''list'' is
104 a list of class names. (Same effect as
105 __-o__.)
106
107
108 __-d__ Print the system default destination for output
109 requests.
110
111
112 __-f__ [[''list''] [[__-l__]
113
114
115 Print list of printers supporting the specified forms option
116 is ignored.
117
118
119 __-o__ [[''list'']
120
121
122 Print the status of output requests: ''list'' is a list
123 of intermixed printer names, class names, and
124 ''request-IDs''. The keyletter __-o__ may be
125 omitted.
126
127
128 __-p__ [[''list'']
129
130
131 Print the status of printers. ''list'' is a list of
132 printer names. (Same effect as __-o__.)
133
134
135 __-P__ Print the paper types. Ignored.
136
137
138 __-r__ Print the status of the LP request
139 scheduler.
140
141
142 __-R__ Print a number showing the position of each job in
143 the print queue. Ignored.
144
145
146 __-s__ Print a status summary. Produces a short status
147 listing.
148
149
150 __-S__ [[''list''] [[__-l__]
151
152
153 List or verify character sets of printers.
154 (Ignored.)
155
156
157 __-t__ Print all status information.
158
159
160 __-u__ [[''login-ID-list'']
161
162
163 Print the status of output requests for users. (Same effect
164 as __-o__.)
165
166
167 __-v__ [[''list'']
168
169
170 Print the path names of the printer output devices.
171 (Ignored.) __-D__ Combined with the __-p__ flag prints
172 description of printer.
173
174
175 __-Toptions__
176
177
178 Set debugging options. Use -T= to get lpstat to provide a
179 list.
180 !!ENVIRONMENT
181
182
183 By default, the destination printer is taken from the
184 command line ''dest'' value, then the environment
185 variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
186 entry in the printcap information, and and finally the
187 default_printer entry from the configuration file, and then
188 the compile time default.
189 !!EXIT STATUS
190
191
192 The following exit values are returned:
193
194
195 __zero (0)__
196
197
198 Successful completion.
199
200
201 __non-zero (!=0)__
202
203
204 An error occurred.
205 !!FILES
206
207
208 The files used by LPRng are set by values in the printer
209 configuration file. The following are a commonly used set of
210 default values.
211
212
213 /etc/lprng/lpd.conf LPRng configuration file
214 ${HOME}/.printcap user printer description file
215 /etc/lprng/printcap printer description file
216 /etc/lprng/lpd.perms permissions
217 /var/run/lprng/lpd lock file for queue control
218 /var/spool/lpd spool directories
219 /var/spool/lpd/QUEUE/control queue control
220 /var/spool/lpd/QUEUE/log trace or debug log file
221 /var/spool/lpd/QUEUE/acct accounting file
222 /var/spool/lpd/QUEUE/status status file
223 !!SEE ALSO
224
225
226 lpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lpq(1),
227 lprm(1), printcap(5), lpd.perms(5), pr(1).
228 !!DIAGNOSTICS
229
230
231 Most of the diagnostics are self explanatory.
232 If you are puzzled over the exact cause of failure,
233 set the debugging level on (-T5) and run again.
234 The debugging information will
235 help you to pinpoint the exact cause of failure.
236 !!HISTORY
237
238
239 LPRng is a enhanced printer spooler system with
240 functionality similar to the Berkeley LPR software. The
241 LPRng mailing list is lprng@lprng.com; subscribe by sending
242 mail to lprng-request@lprng.com with the word subscribe in
243 the body. The software is available from
244 ftp://ftp.lprng.com/pub/LPRng.
245 !!AUTHOR
246
247
248 Patrick Powell
249 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.