]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | <HTML> |
2 | <!-- SECTION: References --> | |
3 | <HEAD> | |
4 | <TITLE>printers.conf</TITLE> | |
5 | </HEAD> | |
6 | <BODY> | |
7 | ||
8 | <P>The CUPS scheduler (cupsd) uses the | |
9 | <VAR>/etc/cups/printers.conf</VAR> file to store the list of | |
10 | available printers. This file contains only locally defined | |
11 | printers, not remote printers that are created automatically via | |
12 | browsing. Each directive is listed on a line by itself followed | |
13 | by its value. Comments are introduced using the number sign ("#") | |
14 | character at the beginning of a line.</P> | |
15 | ||
16 | <P>While the printer configuration file consists of plain text | |
17 | and can be modified using your favorite text editor, you should | |
480ef0fe | 18 | normally use the <A HREF="man-lpadmin.html">lpadmin(8)</A> |
19 | command, web interface, or any of the available GUIs to manage | |
20 | your printers instead. If you do choose to edit this file | |
21 | manually, you will need to restart the scheduler to make them | |
22 | active.</P> | |
ef416fc2 | 23 | |
24 | ||
480ef0fe | 25 | <H2 CLASS="title"><A NAME="Accepting">Accepting</A></H2> |
ef416fc2 | 26 | |
480ef0fe | 27 | <H3>Examples</H3> |
ef416fc2 | 28 | |
29 | <PRE CLASS="command"> | |
480ef0fe | 30 | <Printer name> |
31 | ... | |
32 | Accepting yes | |
33 | </Printer> | |
ef416fc2 | 34 | </PRE> |
35 | ||
480ef0fe | 36 | <H3>Description</H3> |
ef416fc2 | 37 | |
38 | <P>The <CODE>Accepting</CODE> directive defines the initial state | |
39 | of the <VAR>printer-is-accepting-jobs</VAR> attribute. This state | |
58dc1933 MS |
40 | is also set by the <CODE>cupsaccept(8)</CODE> and |
41 | <CODE>cupsreject(8)</CODE> commands:</P> | |
ef416fc2 | 42 | |
43 | <PRE CLASS="command"> | |
58dc1933 MS |
44 | <KBD>/usr/sbin/cupsaccept printername |
45 | /usr/sbin/cupsreject printername</KBD> | |
ef416fc2 | 46 | </PRE> |
47 | ||
48 | <P>This directive must appear inside a <A | |
49 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
50 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 51 | section.</P> |
ef416fc2 | 52 | |
53 | ||
480ef0fe | 54 | <H2 CLASS="title"><A NAME="AllowUser">AllowUser</A></H2> |
ef416fc2 | 55 | |
480ef0fe | 56 | <H3>Examples</H3> |
ef416fc2 | 57 | |
58 | <PRE CLASS="command"> | |
480ef0fe | 59 | <Printer name> |
60 | ... | |
61 | AllowUser foo_user | |
62 | AllowUser @bar_group | |
63 | </Printer> | |
ef416fc2 | 64 | </PRE> |
65 | ||
480ef0fe | 66 | <H3>Description</H3> |
ef416fc2 | 67 | |
68 | <P>The <CODE>AllowUser</CODE> directive adds a username or group | |
69 | name to the <VAR>requesting-user-name-allowed</VAR> attribute | |
70 | which can be set by the <CODE>lpadmin(8)</CODE> command:</P> | |
71 | ||
72 | <PRE CLASS="command"> | |
73 | <KBD>/usr/sbin/lpadmin -p printername -u allow:foo_user,@bar_group</KBD> | |
74 | </PRE> | |
75 | ||
76 | <P>This directive must appear inside a <A | |
77 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
78 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> directive. | |
79 | This directive cannot be used with <A | |
80 | HREF="#DenyUser"><CODE>DenyUser</CODE></A>.</P> | |
81 | ||
82 | ||
480ef0fe | 83 | <H2 CLASS="title"><A NAME="DefaultPrinter">DefaultPrinter</A></H2> |
ef416fc2 | 84 | |
480ef0fe | 85 | <H3>Examples</H3> |
ef416fc2 | 86 | |
87 | <PRE CLASS="command"> | |
88 | <DefaultPrinter name> | |
480ef0fe | 89 | ... |
ef416fc2 | 90 | </Printer> |
91 | </PRE> | |
92 | ||
480ef0fe | 93 | <H3>Description</H3> |
ef416fc2 | 94 | |
95 | <P>The <CODE>DefaultPrinter</CODE> directive begins a printer | |
96 | definition as the default server destination. The default server | |
97 | destination can be set using the <CODE>lpadmin(8)</CODE> | |
98 | command:</P> | |
99 | ||
100 | <PRE CLASS="command"> | |
101 | <KBD>/usr/sbin/lpadmin -d printername</KBD> | |
102 | </PRE> | |
103 | ||
104 | <P>Note that the server default destination settings can be | |
105 | overridden by the user's default destination settings which are | |
106 | normally set using the <CODE>lpoptions(1)</CODE> command.</P> | |
107 | ||
108 | ||
480ef0fe | 109 | <H2 CLASS="title"><A NAME="DenyUser">DenyUser</A></H2> |
ef416fc2 | 110 | |
480ef0fe | 111 | <H3>Examples</H3> |
ef416fc2 | 112 | |
113 | <PRE CLASS="command"> | |
480ef0fe | 114 | <Printer name> |
115 | ... | |
116 | DenyUser foo_user | |
117 | DenyUser @bar_group | |
118 | </Printer> | |
ef416fc2 | 119 | </PRE> |
120 | ||
480ef0fe | 121 | <H3>Description</H3> |
ef416fc2 | 122 | |
123 | <P>The <CODE>DenyUser</CODE> directive adds a username or group | |
124 | name to the <VAR>requesting-user-name-denied</VAR> attribute | |
125 | which can be set by the <CODE>lpadmin(8)</CODE> command:</P> | |
126 | ||
127 | <PRE CLASS="command"> | |
128 | <KBD>/usr/sbin/lpadmin -p printername -u deny:foo_user,@bar_group</KBD> | |
129 | </PRE> | |
130 | ||
131 | <P>This directive must appear inside a <A | |
132 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
133 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> directive. | |
134 | This directive cannot be used with <A | |
135 | HREF="#AllowUser"><CODE>AllowUser</CODE></A></P> | |
136 | ||
137 | ||
480ef0fe | 138 | <H2 CLASS="title"><A NAME="DeviceURI">DeviceURI</A></H2> |
ef416fc2 | 139 | |
480ef0fe | 140 | <H3>Examples</H3> |
ef416fc2 | 141 | |
142 | <PRE CLASS="command"> | |
480ef0fe | 143 | <Printer name> |
144 | ... | |
145 | DeviceURI socket://foo.bar.com:9100 | |
146 | </Printer> | |
ef416fc2 | 147 | </PRE> |
148 | ||
480ef0fe | 149 | <H3>Description</H3> |
ef416fc2 | 150 | |
151 | <P>The <CODE>DeviceURI</CODE> directive defines the value of the | |
152 | <VAR>device-uri-attribute</VAR> attribute. It is normally set | |
153 | using the <CODE>lpadmin(8)</CODE> command:</P> | |
154 | ||
155 | <PRE CLASS="command"> | |
156 | <KBD>/usr/sbin/lpadmin -p printername -v device-uri</KBD> | |
157 | </PRE> | |
158 | ||
159 | <P>This directive must appear inside a <A | |
160 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
161 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 162 | section.</P> |
ef416fc2 | 163 | |
164 | ||
480ef0fe | 165 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="ErrorPolicy">ErrorPolicy</A></H2> |
ef416fc2 | 166 | |
480ef0fe | 167 | <H3>Examples</H3> |
ef416fc2 | 168 | |
169 | <PRE CLASS="command"> | |
480ef0fe | 170 | <Printer name> |
171 | ... | |
07725fee | 172 | ErrorPolicy abort-job |
480ef0fe | 173 | </Printer> |
ef416fc2 | 174 | </PRE> |
175 | ||
480ef0fe | 176 | <H3>Description</H3> |
ef416fc2 | 177 | |
178 | <P>The <CODE>ErrorPolicy</CODE> directive defines the policy that | |
179 | is used when a backend is unable to send a print job to the | |
180 | printer. The <CODE>lpadmin(8)</CODE> command sets the current | |
181 | error policy:</P> | |
182 | ||
183 | <PRE CLASS="command"> | |
184 | <KBD>/usr/sbin/lpadmin -p printername -o printer-error-policy=stop-printer</KBD> | |
185 | </PRE> | |
186 | ||
187 | <P>The following values are supported:</P> | |
188 | ||
189 | <UL> | |
190 | ||
07725fee | 191 | <LI><CODE>abort-job</CODE> - Abort the job and proceed |
ef416fc2 | 192 | with the next job in the queue</LI> |
193 | ||
ee571f26 MS |
194 | <LI><CODE>retry-current-job</CODE> - Retry the current job |
195 | immediately</LI> | |
196 | ||
ef416fc2 | 197 | <LI><CODE>retry-job</CODE> - Retry the job after waiting |
198 | for N seconds; the <VAR>cupsd.conf</VAR> <A | |
4744bd90 | 199 | HREF="ref-cupsd-conf.html#JobRetryInterval"><CODE>JobRetryInterval</CODE></A> |
ef416fc2 | 200 | directive controls the value of N</LI> |
201 | ||
202 | <LI><CODE>stop-printer</CODE> - Stop the printer and keep | |
203 | the job for future printing; this is the default | |
204 | value</LI> | |
205 | ||
206 | </UL> | |
207 | ||
208 | <P>This directive must appear inside a <A | |
209 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
210 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 211 | section.</P> |
ef416fc2 | 212 | |
213 | ||
58dc1933 MS |
214 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="Filter">Filter</A></H2> |
215 | ||
216 | <H3>Examples</H3> | |
217 | ||
218 | <PRE CLASS="command"> | |
219 | <Printer name> | |
220 | ... | |
221 | Filter mime/type 100 program | |
222 | </Printer> | |
223 | </PRE> | |
224 | ||
225 | <H3>Description</H3> | |
226 | ||
227 | <P>The <CODE>Filter</CODE> directive lists a single filter program as defined | |
228 | in the printer's PPD file.</P> | |
229 | ||
230 | <P>This directive must appear inside a | |
231 | <A HREF="#Printer"><CODE>Printer</CODE></A> or | |
232 | <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P> | |
233 | ||
234 | ||
480ef0fe | 235 | <H2 CLASS="title"><A NAME="Info">Info</A></H2> |
ef416fc2 | 236 | |
480ef0fe | 237 | <H3>Examples</H3> |
ef416fc2 | 238 | |
239 | <PRE CLASS="command"> | |
480ef0fe | 240 | <Printer name> |
241 | ... | |
242 | Info My Printer | |
243 | </Printer> | |
ef416fc2 | 244 | </PRE> |
245 | ||
480ef0fe | 246 | <H3>Description</H3> |
ef416fc2 | 247 | |
248 | <P>The <CODE>Info</CODE> directive defines the string for the | |
249 | <VAR>printer-info</VAR> attribute. It is normally set using the | |
250 | <CODE>lpadmin(8)</CODE> command:</P> | |
251 | ||
252 | <PRE CLASS="command"> | |
253 | <KBD>/usr/sbin/lpadmin -p printername -D "My Printer"</KBD> | |
254 | </PRE> | |
255 | ||
256 | <P>This directive must appear inside a <A | |
257 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
258 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 259 | section.</P> |
ef416fc2 | 260 | |
261 | ||
480ef0fe | 262 | <H2 CLASS="title"><A NAME="JobSheets">JobSheets</A></H2> |
ef416fc2 | 263 | |
480ef0fe | 264 | <H3>Examples</H3> |
ef416fc2 | 265 | |
266 | <PRE CLASS="command"> | |
480ef0fe | 267 | <Printer name> |
268 | ... | |
269 | JobSheets none,standard | |
270 | </Printer> | |
ef416fc2 | 271 | </PRE> |
272 | ||
480ef0fe | 273 | <H3>Description</H3> |
ef416fc2 | 274 | |
275 | <P>The <CODE>JobSheets</CODE> directive specifies the default | |
276 | banner pages to print before and after a print job. In the above | |
277 | example, only a <VAR>standard</VAR> banner will print after each | |
278 | job. The <CODE>lpadmin(8)</CODE> command is normally used to set | |
279 | the default banners: | |
280 | ||
281 | <PRE CLASS="command"> | |
282 | <KBD>/usr/sbin/lpadmin -p printername -o job-sheets-default=none,standard</KBD> | |
283 | </PRE> | |
284 | ||
285 | <P>If only one banner file is specified, it will be printed | |
286 | before the files in the job. If a second banner file is | |
287 | specified, it is printed after the files in the job.</P> | |
288 | ||
289 | <P>The available banner pages depend on the local system | |
290 | configuration; CUPS includes the following standard banner | |
291 | files:</P> | |
292 | ||
293 | <UL> | |
294 | ||
295 | <LI><CODE>none</CODE> - Do not produce a banner | |
296 | page.</LI> | |
297 | ||
298 | <LI><CODE>classified</CODE> - A banner page with a | |
299 | "classified" label at the top and bottom.</LI> | |
300 | ||
301 | <LI><CODE>confidential</CODE> - A banner page with a | |
302 | "confidential" label at the top and bottom.</LI> | |
303 | ||
304 | <LI><CODE>secret</CODE> - A banner page with a | |
305 | "secret" label at the top and bottom.</LI> | |
306 | ||
307 | <LI><CODE>standard</CODE> - A banner page with no label | |
308 | at the top and bottom.</LI> | |
309 | ||
310 | <LI><CODE>topsecret</CODE> - A banner page with a | |
311 | "top secret" label at the top and bottom.</LI> | |
312 | ||
313 | <LI><CODE>unclassified</CODE> - A banner page with an | |
314 | "unclassified" label at the top and bottom.</LI> | |
315 | ||
316 | </UL> | |
317 | ||
318 | <P>This directive must appear inside a <A | |
319 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
320 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 321 | section.</P> |
ef416fc2 | 322 | |
323 | ||
480ef0fe | 324 | <H2 CLASS="title"><A NAME="KLimit">KLimit</A></H2> |
ef416fc2 | 325 | |
480ef0fe | 326 | <H3>Examples</H3> |
ef416fc2 | 327 | |
328 | <PRE CLASS="command"> | |
480ef0fe | 329 | <Printer name> |
330 | ... | |
331 | KLimit 1234 | |
332 | </Printer> | |
ef416fc2 | 333 | </PRE> |
334 | ||
480ef0fe | 335 | <H3>Description</H3> |
ef416fc2 | 336 | |
337 | <P>The <CODE>KLimit</CODE> directive defines the value of the | |
338 | <VAR>job-k-limit</VAR> attribute. It is normally set using the | |
339 | <CODE>lpadmin(8)</CODE> command:</P> | |
340 | ||
341 | <PRE CLASS="command"> | |
342 | <KBD>/usr/sbin/lpadmin -p printername -o job-k-limit=1234</KBD> | |
343 | </PRE> | |
344 | ||
345 | <P>This directive must appear inside a <A | |
346 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
347 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 348 | section.</P> |
ef416fc2 | 349 | |
350 | ||
480ef0fe | 351 | <H2 CLASS="title"><A NAME="Location">Location</A></H2> |
ef416fc2 | 352 | |
480ef0fe | 353 | <H3>Examples</H3> |
ef416fc2 | 354 | |
355 | <PRE CLASS="command"> | |
480ef0fe | 356 | <Printer name> |
357 | ... | |
358 | Location Building 3321 | |
359 | </Printer> | |
ef416fc2 | 360 | </PRE> |
361 | ||
480ef0fe | 362 | <H3>Description</H3> |
ef416fc2 | 363 | |
364 | <P>The <CODE>Location</CODE> directive defines the string for the | |
365 | <VAR>printer-location</VAR> attribute. It is normally set using the | |
366 | <CODE>lpadmin(8)</CODE> command:</P> | |
367 | ||
368 | <PRE CLASS="command"> | |
369 | <KBD>/usr/sbin/lpadmin -p printername -L "Building 3321"</KBD> | |
370 | </PRE> | |
371 | ||
372 | <P>This directive must appear inside a <A | |
373 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
374 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 375 | section.</P> |
ef416fc2 | 376 | |
377 | ||
480ef0fe | 378 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="OpPolicy">OpPolicy</A></H2> |
ef416fc2 | 379 | |
480ef0fe | 380 | <H3>Examples</H3> |
ef416fc2 | 381 | |
382 | <PRE CLASS="command"> | |
480ef0fe | 383 | <Printer name> |
384 | ... | |
385 | OpPolicy default | |
386 | </Printer> | |
ef416fc2 | 387 | </PRE> |
388 | ||
480ef0fe | 389 | <H3>Description</H3> |
ef416fc2 | 390 | |
391 | <P>The <CODE>OpPolicy</CODE> directive sets the operation policy | |
392 | that is used for the printer. The <CODE>lpadmin(8)</CODE> command | |
393 | sets the current operation policy:</P> | |
394 | ||
395 | <PRE CLASS="command"> | |
396 | <KBD>/usr/sbin/lpadmin -p printername -o printer-op-policy=default</KBD> | |
397 | </PRE> | |
398 | ||
399 | <P>The default policy is named "default". All policies correspond | |
400 | to those defined using the <VAR>cupsd.conf</VAR> <A | |
4744bd90 | 401 | HREF="ref-cupsd-conf.html#Policy"><CODE>Policy</CODE></A> |
480ef0fe | 402 | section.</P> |
ef416fc2 | 403 | |
404 | <P>This directive must appear inside a <A | |
405 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
406 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 407 | section.</P> |
ef416fc2 | 408 | |
409 | ||
480ef0fe | 410 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="Option">Option</A></H2> |
ef416fc2 | 411 | |
480ef0fe | 412 | <H3>Examples</H3> |
ef416fc2 | 413 | |
414 | <PRE CLASS="command"> | |
480ef0fe | 415 | <Printer name> |
416 | ... | |
417 | Option name value | |
418 | Option scaling 100 | |
419 | Option page-left 72 | |
420 | </Printer> | |
ef416fc2 | 421 | </PRE> |
422 | ||
480ef0fe | 423 | <H3>Description</H3> |
424 | ||
425 | <P>The <CODE>Option</CODE> directive specifies a default job | |
426 | template attribute value. It is mapped to | |
427 | <CODE>name-default</CODE> in the printer attributes and applied | |
428 | to jobs as <CODE>name</CODE>.</P> | |
429 | ||
430 | <P>This directive must appear inside a <A | |
431 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
432 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
433 | section.</P> | |
434 | ||
435 | ||
436 | <H2 CLASS="title"><A NAME="PageLimit">PageLimit</A></H2> | |
437 | ||
438 | <H3>Examples</H3> | |
439 | ||
440 | <PRE CLASS="command"> | |
441 | <Printer name> | |
442 | ... | |
443 | PageLimit 1234 | |
444 | </Printer> | |
445 | </PRE> | |
446 | ||
447 | <H3>Description</H3> | |
ef416fc2 | 448 | |
449 | <P>The <CODE>PageLimit</CODE> directive defines the value of the | |
450 | <VAR>job-page-limit</VAR> attribute. It can be set using the | |
451 | <CODE>lpadmin(8)</CODE> command:</P> | |
452 | ||
453 | <PRE CLASS="command"> | |
454 | <KBD>/usr/sbin/lpadmin -p printername -o job-page-limit=1234</KBD> | |
455 | </PRE> | |
456 | ||
457 | <P>This directive must appear inside a <A | |
458 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
459 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 460 | section.</P> |
ef416fc2 | 461 | |
462 | ||
480ef0fe | 463 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="PortMonitor">PortMonitor</A></H2> |
ef416fc2 | 464 | |
480ef0fe | 465 | <H3>Examples</H3> |
ef416fc2 | 466 | |
467 | <PRE CLASS="command"> | |
480ef0fe | 468 | <Printer name> |
469 | ... | |
470 | PortMonitor bcp | |
471 | </Printer> | |
ef416fc2 | 472 | </PRE> |
473 | ||
480ef0fe | 474 | <H3>Description</H3> |
ef416fc2 | 475 | |
476 | <P>The <CODE>PortMonitor</CODE> directive sets the filter program that | |
477 | is used for every print job, typically to encode or package the print | |
478 | data in a format acceptable for a particular printer interface. It is | |
479 | set using the <CODE>lpadmin(8)</CODE> command:</P> | |
480 | ||
481 | <PRE CLASS="command"> | |
482 | <KBD>/usr/sbin/lpadmin -p printername -o port-monitor=tbcp</KBD> | |
483 | </PRE> | |
484 | ||
485 | <P>The following standard port monitors are included with CUPS:</P> | |
486 | ||
487 | <UL> | |
488 | ||
489 | <LI><CODE>bcp</CODE> - Encode PostScript print data using | |
490 | the Adobe Binary Control Protocol (BCP)</LI> | |
491 | ||
492 | <LI><CODE>none</CODE> - Do not use a port monitor</LI> | |
493 | ||
494 | <LI><CODE>tbcp</CODE> - Encode PostScript print data | |
495 | using the Adobe Tagged Binary Control Protocol | |
496 | (TBCP)</LI> | |
497 | ||
498 | </UL> | |
499 | ||
500 | <P>This directive must appear inside a <A | |
501 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
502 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 503 | section.</P> |
ef416fc2 | 504 | |
505 | ||
58dc1933 MS |
506 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="PreFilter">PreFilter</A></H2> |
507 | ||
508 | <H3>Examples</H3> | |
509 | ||
510 | <PRE CLASS="command"> | |
511 | <Printer name> | |
512 | ... | |
513 | PreFilter mime/type 100 program | |
514 | </Printer> | |
515 | </PRE> | |
516 | ||
517 | <H3>Description</H3> | |
518 | ||
519 | <P>The <CODE>PreFilter</CODE> directive lists a single pre-filter program as | |
520 | defined in the printer's PPD file.</P> | |
521 | ||
522 | <P>This directive must appear inside a | |
523 | <A HREF="#Printer"><CODE>Printer</CODE></A> or | |
524 | <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P> | |
525 | ||
526 | ||
480ef0fe | 527 | <H2 CLASS="title"><A NAME="Printer">Printer</A></H2> |
ef416fc2 | 528 | |
480ef0fe | 529 | <H3>Examples</H3> |
ef416fc2 | 530 | |
531 | <PRE CLASS="command"> | |
532 | <Printer name> | |
480ef0fe | 533 | ... |
ef416fc2 | 534 | </Printer> |
535 | </PRE> | |
536 | ||
480ef0fe | 537 | <H3>Description</H3> |
ef416fc2 | 538 | |
539 | <P>The <CODE>Printer</CODE> directive begins a printer | |
540 | definition. Printers are added using the <CODE>lpadmin(8)</CODE> | |
541 | command: | |
542 | ||
543 | <PRE CLASS="command"> | |
544 | <KBD>/usr/sbin/lpadmin -p printername ...</KBD> | |
545 | </PRE> | |
546 | ||
547 | ||
58dc1933 MS |
548 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="Product">Product</A></H2> |
549 | ||
550 | <H3>Examples</H3> | |
551 | ||
552 | <PRE CLASS="command"> | |
553 | <Printer name> | |
554 | ... | |
555 | Product Acme PaperWriter | |
556 | </Printer> | |
557 | </PRE> | |
558 | ||
559 | <H3>Description</H3> | |
560 | ||
561 | <P>The <CODE>Product</CODE> directive defines the main product string from the | |
562 | printer's PPD file and is used when advertising the queue via DNS-SD.</P> | |
563 | ||
564 | <P>This directive must appear inside a | |
565 | <A HREF="#Printer"><CODE>Printer</CODE></A> or | |
566 | <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P> | |
567 | ||
568 | ||
480ef0fe | 569 | <H2 CLASS="title"><A NAME="QuotaPeriod">QuotaPeriod</A></H2> |
ef416fc2 | 570 | |
480ef0fe | 571 | <H3>Examples</H3> |
ef416fc2 | 572 | |
573 | <PRE CLASS="command"> | |
480ef0fe | 574 | <Printer name> |
575 | ... | |
576 | QuotaPeriod 604800 | |
577 | </Printer> | |
ef416fc2 | 578 | </PRE> |
579 | ||
480ef0fe | 580 | <H3>Description</H3> |
ef416fc2 | 581 | |
582 | <P>The <CODE>QuotaPeriod</CODE> directive defines the value of | |
583 | the <VAR>job-quota-period</VAR> attribute. Typical values are | |
584 | 86400 (1 day), 604800 (1 week), 2592000 (1 month), and 31536000 | |
585 | (1 year). It is set using the <CODE>lpadmin(8)</CODE> | |
586 | command:</P> | |
587 | ||
588 | <PRE CLASS="command"> | |
589 | <KBD>/usr/sbin/lpadmin -p printername -o job-quota-period=604800</KBD> | |
590 | </PRE> | |
591 | ||
592 | <P>This directive must appear inside a <A | |
593 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
594 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 595 | section.</P> |
ef416fc2 | 596 | |
597 | ||
480ef0fe | 598 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="Shared">Shared</A></H2> |
ef416fc2 | 599 | |
480ef0fe | 600 | <H3>Examples</H3> |
ef416fc2 | 601 | |
602 | <PRE CLASS="command"> | |
480ef0fe | 603 | <Printer name> |
604 | ... | |
605 | Shared yes | |
606 | </Printer> | |
ef416fc2 | 607 | </PRE> |
608 | ||
480ef0fe | 609 | <H3>Description</H3> |
ef416fc2 | 610 | |
611 | <P>The <CODE>Shared</CODE> directive defines the initial value of | |
612 | the <VAR>printer-is-shared</VAR> attribute. The strings | |
613 | <VAR>yes</VAR> and <VAR>no</VAR> correspond to the true and false | |
614 | values, respectively. The <CODE>lpadmin(8)</CODE> command sets | |
615 | the current state:</P> | |
616 | ||
617 | <PRE CLASS="command"> | |
618 | <KBD>/usr/sbin/lpadmin -p printername -o printer-is-shared=true</KBD> | |
619 | </PRE> | |
620 | ||
621 | <P>This directive must appear inside a <A | |
622 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
623 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 624 | section.</P> |
ef416fc2 | 625 | |
626 | ||
480ef0fe | 627 | <H2 CLASS="title"><A NAME="State">State</A></H2> |
ef416fc2 | 628 | |
480ef0fe | 629 | <H3>Examples</H3> |
ef416fc2 | 630 | |
631 | <PRE CLASS="command"> | |
480ef0fe | 632 | <Printer name> |
633 | ... | |
634 | State idle | |
635 | </Printer> | |
ef416fc2 | 636 | </PRE> |
637 | ||
480ef0fe | 638 | <H3>Description</H3> |
ef416fc2 | 639 | |
640 | <P>The <CODE>State</CODE> directive defines the initial value of | |
641 | the <VAR>printer-state</VAR> attribute. The strings | |
642 | <VAR>idle</VAR> and <VAR>stopped</VAR> correspond to the IPP | |
643 | enumeration values 3 and 5, respectively. The | |
644 | <CODE>cupsenable(8)</CODE> and <CODE>cupsdisable(8)</CODE> | |
645 | commands set the current state:</P> | |
646 | ||
647 | <PRE CLASS="command"> | |
648 | <KBD>/usr/sbin/cupsenable printername</KBD> | |
649 | <KBD>/usr/sbin/cupsdisable printername</KBD> | |
650 | </PRE> | |
651 | ||
652 | <P>This directive must appear inside a <A | |
653 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
654 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 655 | section.</P> |
ef416fc2 | 656 | |
657 | ||
480ef0fe | 658 | <H2 CLASS="title"><A NAME="StateMessage">StateMessage</A></H2> |
ef416fc2 | 659 | |
480ef0fe | 660 | <H3>Examples</H3> |
ef416fc2 | 661 | |
662 | <PRE CLASS="command"> | |
480ef0fe | 663 | <Printer name> |
664 | ... | |
665 | StateMessage Ready to print. | |
666 | </Printer> | |
ef416fc2 | 667 | </PRE> |
668 | ||
480ef0fe | 669 | <H3>Description</H3> |
ef416fc2 | 670 | |
671 | <P>The <CODE>StateMessage</CODE> directive defines the initial | |
672 | string for the <VAR>printer-state-message</VAR> attribute. The | |
673 | following are some example messages:</P> | |
674 | ||
675 | <PRE CLASS="command"> | |
676 | StateMessage Connected to host_name... | |
677 | StateMessage Connecting to printer_queue on port port_number... | |
678 | StateMessage Network host host_name is busy; will retry in 30 seconds... | |
679 | StateMessage Printer busy; will retry in 10 seconds... | |
680 | StateMessage Printer is busy; retrying print job... | |
681 | StateMessage Print file accepted - job ID id_number. | |
682 | StateMessage Ready to print. | |
683 | StateMessage Waiting for job to complete | |
684 | </PRE> | |
685 | ||
686 | <P>This directive must appear inside a <A | |
687 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
688 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 689 | section.</P> |
ef416fc2 | 690 | |
691 | ||
480ef0fe | 692 | <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="StateTime">StateTime</A></H2> |
ef416fc2 | 693 | |
480ef0fe | 694 | <H3>Examples</H3> |
ef416fc2 | 695 | |
696 | <PRE CLASS="command"> | |
480ef0fe | 697 | <Printer name> |
698 | ... | |
699 | StateTime 1133542425 | |
700 | </Printer> | |
ef416fc2 | 701 | </PRE> |
702 | ||
480ef0fe | 703 | <H3>Description</H3> |
ef416fc2 | 704 | |
705 | <P>The <CODE>StateTime</CODE> directive defines the UNIX time | |
706 | (seconds since Jan 1, 1970) for the last state change of the | |
707 | queue. It is mapped to the <VAR>printer-state-change-time</VAR> | |
708 | attribute.</P> | |
709 | ||
710 | <P>This directive must appear inside a <A | |
711 | HREF="#Printer"><CODE>Printer</CODE></A> or <A | |
712 | HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> | |
480ef0fe | 713 | section.</P> |
ef416fc2 | 714 | |
715 | ||
716 | </BODY> | |
717 | </HTML> |