]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
b19ccc9e | 2 | .\" "$Id: cupsd.conf.man.in 7935 2008-09-11 01:54:11Z mike $" |
ef416fc2 | 3 | .\" |
4 | .\" cupsd.conf man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
f8b3a85b | 6 | .\" Copyright 2007-2010 by Apple Inc. |
bd7854cb | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 14 | .\" |
10d09e33 | 15 | .TH cupsd.conf 5 "CUPS" "5 November 2010" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
17 | cupsd.conf \- server configuration file for cups | |
18 | .SH DESCRIPTION | |
19 | The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR. It | |
bd7854cb | 20 | is normally located in the \fI@CUPS_SERVERROOT@\fR directory. |
ef416fc2 | 21 | .LP |
22 | Each line in the file can be a configuration directive, a blank line, | |
23 | or a comment. Comment lines start with the # character. The | |
24 | configuration directives are intentionally similar to those used by the | |
25 | popular Apache web server software and are described below. | |
26 | .SH DIRECTIVES | |
bd7854cb | 27 | The following directives are understood by \fIcupsd(8)\fR. Consult the |
28 | on-line help for detailed descriptions: | |
ef416fc2 | 29 | .TP 5 |
bd7854cb | 30 | AccessLog filename |
31 | .TP 5 | |
32 | AccessLog syslog | |
ef416fc2 | 33 | .br |
34 | Defines the access log filename. | |
35 | .TP 5 | |
1f0275e3 MS |
36 | AccessLogLevel config |
37 | .TP 5 | |
38 | AccessLogLevel actions | |
39 | .TP 5 | |
40 | AccessLogLevel all | |
41 | .br | |
42 | Specifies the logging level for the AccessLog file. | |
43 | .TP 5 | |
bd7854cb | 44 | Allow all |
45 | .TP 5 | |
46 | Allow none | |
47 | .TP 5 | |
48 | Allow host.domain.com | |
49 | .TP 5 | |
50 | Allow *.domain.com | |
51 | .TP 5 | |
52 | Allow ip-address | |
53 | .TP 5 | |
54 | Allow ip-address/netmask | |
55 | .TP 5 | |
56 | Allow ip-address/mm | |
57 | .TP 5 | |
58 | Allow @IF(name) | |
59 | .TP 5 | |
60 | Allow @LOCAL | |
ef416fc2 | 61 | .br |
62 | Allows access from the named hosts or addresses. | |
63 | .TP 5 | |
bd7854cb | 64 | AuthClass User |
65 | .TP 5 | |
66 | AuthClass Group | |
67 | .TP 5 | |
68 | AuthClass System | |
ef416fc2 | 69 | .br |
bd7854cb | 70 | Specifies the authentication class (User, Group, System) - |
71 | \fBthis directive is deprecated\fR. | |
ef416fc2 | 72 | .TP 5 |
bd7854cb | 73 | AuthGroupName group-name |
ef416fc2 | 74 | .br |
bd7854cb | 75 | Specifies the authentication group - \fBthis directive is |
76 | deprecated\fR. | |
ef416fc2 | 77 | .TP 5 |
bd7854cb | 78 | AuthType None |
79 | .TP 5 | |
80 | AuthType Basic | |
81 | .TP 5 | |
82 | AuthType BasicDigest | |
83 | .TP 5 | |
84 | AuthType Digest | |
f7deaa1a | 85 | .TP 5 |
2e4ff8af | 86 | AuthType Negotiate |
ef416fc2 | 87 | .br |
2e4ff8af | 88 | Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate) |
ef416fc2 | 89 | .TP 5 |
bd7854cb | 90 | AutoPurgeJobs Yes |
91 | .TP 5 | |
92 | AutoPurgeJobs No | |
ef416fc2 | 93 | .br |
94 | Specifies whether to purge job history data automatically when | |
95 | it is no longer required for quotas. | |
96 | .TP 5 | |
bd7854cb | 97 | BrowseAddress ip-address |
98 | .TP 5 | |
99 | BrowseAddress @IF(name) | |
100 | .TP 5 | |
101 | BrowseAddress @LOCAL | |
ef416fc2 | 102 | .br |
103 | Specifies a broadcast address for outgoing printer information packets. | |
104 | .TP 5 | |
bd7854cb | 105 | BrowseAllow all |
106 | .TP 5 | |
107 | BrowseAllow none | |
108 | .TP 5 | |
109 | BrowseAllow host.domain.com | |
110 | .TP 5 | |
111 | BrowseAllow *.domain.com | |
112 | .TP 5 | |
113 | BrowseAllow ip-address | |
114 | .TP 5 | |
115 | BrowseAllow ip-address/netmask | |
116 | .TP 5 | |
117 | BrowseAllow ip-address/mm | |
118 | .TP 5 | |
119 | BrowseAllow @IF(name) | |
120 | .TP 5 | |
121 | BrowseAllow @LOCAL | |
ef416fc2 | 122 | .br |
123 | Allows incoming printer information packets from the named host or address. | |
124 | .TP 5 | |
bd7854cb | 125 | BrowseDeny all |
126 | .TP 5 | |
127 | BrowseDeny none | |
128 | .TP 5 | |
129 | BrowseDeny host.domain.com | |
130 | .TP 5 | |
131 | BrowseDeny *.domain.com | |
132 | .TP 5 | |
133 | BrowseDeny ip-address | |
134 | .TP 5 | |
135 | BrowseDeny ip-address/netmask | |
136 | .TP 5 | |
137 | BrowseDeny ip-address/mm | |
138 | .TP 5 | |
139 | BrowseDeny @IF(name) | |
140 | .TP 5 | |
141 | BrowseDeny @LOCAL | |
ef416fc2 | 142 | .br |
143 | Denies incoming printer information packets from the named host or address. | |
144 | .TP 5 | |
bd7854cb | 145 | BrowseInterval seconds |
ef416fc2 | 146 | .br |
147 | Specifies the maximum interval between printer information broadcasts. | |
148 | .TP 5 | |
749b1e90 MS |
149 | BrowseLDAPBindDN |
150 | .br | |
151 | Specifies the LDAP domain name to use when registering printers. | |
152 | .TP 5 | |
153 | BrowseLDAPCACertFile | |
154 | .br | |
155 | Specifies the SSL certificate authority file to use. | |
156 | .TP 5 | |
157 | BrowseLDAPDN | |
158 | .br | |
159 | Specifies the LDAP domain name to use when discovering printers. | |
160 | .TP 5 | |
161 | BrowseLDAPPassword | |
162 | .br | |
163 | Specifies the password to use when accessing the LDAP server. | |
164 | .TP 5 | |
165 | BrowseLDAPServer | |
166 | .br | |
167 | Specifies the LDAP server to use. | |
168 | .TP 5 | |
bd7854cb | 169 | BrowseOrder allow,deny |
170 | .TP 5 | |
171 | BrowseOrder deny,allow | |
ef416fc2 | 172 | .br |
173 | Specifies the order of printer information access control (allow,deny or deny,allow) | |
174 | .TP 5 | |
bd7854cb | 175 | BrowsePoll host-or-ip-address |
ef416fc2 | 176 | .br |
177 | Specifies a server to poll for printer information. | |
178 | .TP 5 | |
bd7854cb | 179 | BrowsePort port |
ef416fc2 | 180 | .br |
181 | Specifies the port to listen to for printer information packets. | |
182 | .TP 5 | |
bd7854cb | 183 | BrowseProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP] |
ef416fc2 | 184 | .br |
185 | Specifies the protocols to use for printer browsing. | |
186 | .TP 5 | |
bd7854cb | 187 | BrowseLocalProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP] |
ef416fc2 | 188 | .br |
189 | Specifies the protocols to use for local printer browsing. | |
190 | .TP 5 | |
bd7854cb | 191 | BrowseRemoteProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP] |
ef416fc2 | 192 | .br |
193 | Specifies the protocols to use for remote printer browsing. | |
194 | .TP 5 | |
bd7854cb | 195 | BrowseRelay from-address to-address |
ef416fc2 | 196 | .br |
197 | Specifies that printer information packets should be relayed from one host or | |
198 | network to another. | |
199 | .TP 5 | |
bd7854cb | 200 | BrowseShortNames Yes |
201 | .TP 5 | |
202 | BrowseShortNames No | |
ef416fc2 | 203 | .br |
204 | Specifies whether remote printers will use short names ("printer") or not | |
205 | ("printer@server"). This option is ignored if more than one remote printer | |
206 | exists with the same name. | |
207 | .TP 5 | |
bd7854cb | 208 | BrowseTimeout seconds |
ef416fc2 | 209 | .br |
210 | Specifies the maximum interval between printer information updates before | |
211 | remote printers will be removed from the list of available printers. | |
212 | .TP 5 | |
b19ccc9e MS |
213 | BrowseWebIF Yes |
214 | .TP 5 | |
215 | BrowseWebIF No | |
216 | .br | |
217 | Specifies whether the CUPS web interface is advertised via DNS-SD. | |
218 | .TP 5 | |
bd7854cb | 219 | Browsing Yes |
220 | .TP 5 | |
221 | Browsing No | |
ef416fc2 | 222 | .br |
223 | Specifies whether or not remote printer browsing should be enabled. | |
224 | .TP 5 | |
bd7854cb | 225 | Classification banner |
ef416fc2 | 226 | .br |
227 | Specifies the security classification of the server. | |
228 | .TP 5 | |
bd7854cb | 229 | ClassifyOverride Yes |
230 | .TP 5 | |
231 | ClassifyOverride No | |
ef416fc2 | 232 | .br |
233 | Specifies whether to allow users to override the classification | |
234 | of individual print jobs. | |
235 | .TP 5 | |
bd7854cb | 236 | ConfigFilePerm mode |
ef416fc2 | 237 | .br |
238 | Specifies the permissions for all configuration files that the scheduler | |
239 | writes. | |
240 | .TP 5 | |
bd7854cb | 241 | DataDir path |
ef416fc2 | 242 | .br |
243 | Specified the directory where data files can be found. | |
244 | .TP 5 | |
bd7854cb | 245 | DefaultAuthType Basic |
246 | .TP 5 | |
247 | DefaultAuthType BasicDigest | |
248 | .TP 5 | |
249 | DefaultAuthType Digest | |
f7deaa1a | 250 | .TP 5 |
2e4ff8af | 251 | DefaultAuthType Negotiate |
ef416fc2 | 252 | .br |
253 | Specifies the default type of authentication to use. | |
254 | .TP 5 | |
8b450588 MS |
255 | DefaultEncryption Never |
256 | .TP 5 | |
257 | DefaultEncryption IfRequested | |
258 | .TP 5 | |
259 | DefaultEncryption Required | |
260 | .br | |
261 | Specifies the type of encryption to use for authenticated requests. | |
262 | .TP 5 | |
bd7854cb | 263 | DefaultLanguage locale |
ef416fc2 | 264 | .br |
265 | Specifies the default language to use for text and web content. | |
266 | .TP 5 | |
49d87452 MS |
267 | DefaultPaperSize Auto |
268 | .TP 5 | |
269 | DefaultPaperSize None | |
270 | .TP 5 | |
271 | DefaultPaperSize sizename | |
272 | .br | |
273 | Specifies the default paper size for new print queues. "Auto" uses a locale- | |
274 | specific default, while "None" specifies there is no default paper size. | |
275 | .TP 5 | |
bd7854cb | 276 | DefaultPolicy policy-name |
ef416fc2 | 277 | .br |
278 | Specifies the default access policy to use. | |
279 | .TP 5 | |
3d052e43 MS |
280 | DefaultShared Yes |
281 | .TP 5 | |
282 | DefaultShared No | |
283 | .br | |
284 | Specifies whether local printers are shared by default. | |
285 | .TP 5 | |
bd7854cb | 286 | Deny all |
287 | .TP 5 | |
288 | Deny none | |
289 | .TP 5 | |
290 | Deny host.domain.com | |
291 | .TP 5 | |
292 | Deny *.domain.com | |
293 | .TP 5 | |
294 | Deny ip-address | |
295 | .TP 5 | |
296 | Deny ip-address/netmask | |
297 | .TP 5 | |
298 | Deny ip-address/mm | |
299 | .TP 5 | |
300 | Deny @IF(name) | |
301 | .TP 5 | |
302 | Deny @LOCAL | |
ef416fc2 | 303 | .br |
304 | Denies access to the named host or address. | |
305 | .TP 5 | |
4a4b4f99 MS |
306 | DirtyCleanInterval seconds |
307 | .br | |
308 | Specifies the delay for updating of configuration and state files. A value of 0 | |
309 | causes the update to happen as soon as possible, typically within a few | |
310 | milliseconds. | |
311 | .TP 5 | |
bd7854cb | 312 | DocumentRoot directory |
ef416fc2 | 313 | .br |
314 | Specifies the root directory for the internal web server documents. | |
315 | .TP 5 | |
bd7854cb | 316 | Encryption IfRequested |
317 | .TP 5 | |
318 | Encryption Never | |
319 | .TP 5 | |
320 | Encryption Required | |
ef416fc2 | 321 | .br |
322 | Specifies the level of encryption that is required for a particular | |
323 | location. | |
324 | .TP 5 | |
bd7854cb | 325 | ErrorLog filename |
326 | .TP 5 | |
327 | ErrorLog syslog | |
ef416fc2 | 328 | .br |
329 | Specifies the error log filename. | |
330 | .TP 5 | |
49d87452 MS |
331 | FatalErrors none |
332 | .TP 5 | |
333 | FatalErrors all -kind [... -kind] | |
334 | .TP 5 | |
335 | FatalErrors kind [... kind] | |
336 | .br | |
337 | Specifies which errors are fatal, causing the scheduler to exit. "Kind" is | |
338 | "browse", "config", "listen", "log", or "permissions". | |
339 | .TP 5 | |
bd7854cb | 340 | FileDevice Yes |
341 | .TP 5 | |
342 | FileDevice No | |
ef416fc2 | 343 | .br |
344 | Specifies whether the file pseudo-device can be used for new | |
345 | printer queues. | |
346 | .TP 5 | |
bd7854cb | 347 | FilterLimit limit |
ef416fc2 | 348 | .br |
349 | Specifies the maximum cost of filters that are run concurrently. | |
350 | .TP 5 | |
bd7854cb | 351 | FilterNice nice-value |
ef416fc2 | 352 | .br |
353 | Specifies the scheduling priority ("nice" value) of filters that | |
354 | are run to print a job. | |
355 | .TP 5 | |
bd7854cb | 356 | FontPath directory[:directory:...] |
ef416fc2 | 357 | .br |
358 | Specifies the search path for fonts. | |
359 | .TP 5 | |
bd7854cb | 360 | Group group-name-or-number |
ef416fc2 | 361 | .br |
362 | Specifies the group name or ID that will be used when executing | |
363 | external programs. | |
364 | .TP 5 | |
bd7854cb | 365 | HideImplicitMembers Yes |
366 | .TP 5 | |
367 | HideImplicitMembers No | |
ef416fc2 | 368 | .br |
369 | Specifies whether to hide members of implicit classes. | |
370 | .TP 5 | |
dd1abb6b | 371 | HostNameLookups On |
bd7854cb | 372 | .TP 5 |
dd1abb6b | 373 | HostNameLookups Off |
bd7854cb | 374 | .TP 5 |
375 | HostNameLookups Double | |
ef416fc2 | 376 | .br |
377 | Specifies whether or not to do reverse lookups on client addresses. | |
378 | .TP 5 | |
bd7854cb | 379 | ImplicitAnyClasses Yes |
380 | .TP 5 | |
381 | ImplicitAnyClasses No | |
ef416fc2 | 382 | .br |
383 | Specifies whether or not to create implicit classes for local and | |
384 | remote printers, e.g. "AnyPrinter" from "Printer", "Printer@server1", | |
385 | and "Printer@server2". | |
386 | .TP 5 | |
bd7854cb | 387 | ImplicitClasses Yes |
388 | .TP 5 | |
389 | ImplicitClasses No | |
ef416fc2 | 390 | .br |
391 | Specifies whether or not to create implicit classes from identical | |
392 | remote printers. | |
393 | .TP 5 | |
bd7854cb | 394 | Include filename |
ef416fc2 | 395 | .br |
396 | Includes the named file. | |
397 | .TP 5 | |
238c3832 MS |
398 | JobKillDelay seconds |
399 | .br | |
400 | Specifies the number of seconds to wait before killing the filters and backend | |
401 | associated with a canceled or held job. | |
402 | .TP 5 | |
10d09e33 MS |
403 | JobPrivateAccess all |
404 | .TP 5 | |
405 | JobPrivateAccess default | |
406 | .TP 5 | |
407 | JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+ | |
408 | .br | |
409 | Specifies an access list for a job's private values. The "default" access list | |
410 | is "@OWNER @SYSTEM". "@ACL" maps to the printer's requesting-user-name-allowed | |
411 | or requesting-user-name-denied values. | |
412 | .TP 5 | |
413 | JobPrivateValues all | |
414 | .TP 5 | |
415 | JobPrivateValues default | |
416 | .TP 5 | |
417 | JobPrivateValues none | |
418 | .TP 5 | |
419 | JobPrivateValues attribute-name-1 [ ... attribute-name-N ] | |
420 | Specifies the list of job values to make private. The "default" values are | |
421 | "job-name", "job-originating-host-name", and "job-originating-user-name". | |
422 | .TP 5 | |
bd7854cb | 423 | JobRetryInterval seconds |
ef416fc2 | 424 | .br |
425 | Specifies the interval between retries of jobs in seconds. | |
426 | .TP 5 | |
bd7854cb | 427 | JobRetryLimit count |
ef416fc2 | 428 | .br |
429 | Specifies the number of retries that are done for jobs. | |
430 | .TP 5 | |
80ca4592 | 431 | KeepAlive Yes |
432 | .TP 5 | |
433 | KeepAlive No | |
ef416fc2 | 434 | .br |
80ca4592 | 435 | Specifies whether to support HTTP keep-alive connections. |
ef416fc2 | 436 | .TP 5 |
80ca4592 | 437 | KeepAliveTimeout seconds |
ef416fc2 | 438 | .br |
80ca4592 | 439 | Specifies the amount of time that connections are kept alive. |
ef416fc2 | 440 | .TP 5 |
441 | <Limit operations> ... </Limit> | |
442 | .br | |
443 | Specifies the IPP operations that are being limited inside a policy. | |
444 | .TP 5 | |
445 | <Limit methods> ... </Limit> | |
446 | .TP 5 | |
447 | <LimitExcept methods> ... </LimitExcept> | |
448 | .br | |
449 | Specifies the HTTP methods that are being limited inside a location. | |
450 | .TP 5 | |
451 | LimitRequestBody | |
452 | .br | |
453 | Specifies the maximum size of any print job request. | |
454 | .TP 5 | |
bd7854cb | 455 | Listen ip-address:port |
456 | .TP 5 | |
457 | Listen *:port | |
ed486911 | 458 | .TP 5 |
459 | Listen /path/to/domain/socket | |
ef416fc2 | 460 | .br |
ed486911 | 461 | Listens to the specified address and port or domain socket path. |
ef416fc2 | 462 | .TP 5 |
463 | <Location /path> ... </Location> | |
464 | .br | |
465 | Specifies access control for the named location. | |
466 | .TP 5 | |
178cb736 MS |
467 | LogDebugHistory #-messages |
468 | .br | |
469 | Specifies the number of debugging messages that are logged when an error | |
470 | occurs in a print job. | |
471 | .TP 5 | |
bd7854cb | 472 | LogFilePerm mode |
ef416fc2 | 473 | .br |
474 | Specifies the permissions for all log files that the scheduler writes. | |
475 | .TP 5 | |
bd7854cb | 476 | LogLevel alert |
477 | .TP 5 | |
478 | LogLevel crit | |
479 | .TP 5 | |
480 | LogLevel debug2 | |
481 | .TP 5 | |
482 | LogLevel debug | |
483 | .TP 5 | |
484 | LogLevel emerg | |
485 | .TP 5 | |
486 | LogLevel error | |
487 | .TP 5 | |
488 | LogLevel info | |
489 | .TP 5 | |
490 | LogLevel none | |
491 | .TP 5 | |
492 | LogLevel notice | |
493 | .TP 5 | |
494 | LogLevel warn | |
ef416fc2 | 495 | .br |
bd7854cb | 496 | Specifies the logging level for the ErrorLog file. |
ef416fc2 | 497 | .TP 5 |
dfd5680b MS |
498 | LogTimeFormat standard |
499 | .TP 5 | |
500 | LogTimeFormat usecs | |
501 | .br | |
502 | Specifies the format of the date and time in the log files. | |
503 | .TP 5 | |
bd7854cb | 504 | MaxClients number |
ef416fc2 | 505 | .br |
506 | Specifies the maximum number of simultaneous clients to support. | |
507 | .TP 5 | |
bd7854cb | 508 | MaxClientsPerHost number |
ef416fc2 | 509 | .br |
510 | Specifies the maximum number of simultaneous clients to support from a | |
511 | single address. | |
512 | .TP 5 | |
bd7854cb | 513 | MaxCopies number |
ef416fc2 | 514 | .br |
515 | Specifies the maximum number of copies that a user can print of each job. | |
516 | .TP 5 | |
bd7854cb | 517 | MaxJobs number |
ef416fc2 | 518 | .br |
519 | Specifies the maximum number of simultaneous jobs to support. | |
520 | .TP 5 | |
bd7854cb | 521 | MaxJobsPerPrinter number |
ef416fc2 | 522 | .br |
523 | Specifies the maximum number of simultaneous jobs per printer to support. | |
524 | .TP 5 | |
bd7854cb | 525 | MaxJobsPerUser number |
ef416fc2 | 526 | .br |
527 | Specifies the maximum number of simultaneous jobs per user to support. | |
528 | .TP 5 | |
bd7854cb | 529 | MaxLogSize number-bytes |
ef416fc2 | 530 | .br |
531 | Specifies the maximum size of the log files before they are | |
532 | rotated (0 to disable rotation) | |
533 | .TP 5 | |
bd7854cb | 534 | MaxRequestSize number-bytes |
ef416fc2 | 535 | .br |
536 | Specifies the maximum request/file size in bytes (0 for no limit) | |
537 | .TP 5 | |
dfd5680b MS |
538 | MultipleOperationTimeout seconds |
539 | .br | |
540 | Specifies the maximum amount of time to allow between files in a multiple file | |
541 | print job. | |
542 | .TP 5 | |
bd7854cb | 543 | Order allow,deny |
544 | .TP 5 | |
545 | Order deny,allow | |
ef416fc2 | 546 | .br |
547 | Specifies the order of HTTP access control (allow,deny or deny,allow) | |
548 | .TP 5 | |
bd7854cb | 549 | PageLog filename |
550 | .TP 5 | |
551 | PageLog syslog | |
ef416fc2 | 552 | .br |
553 | Specifies the page log filename. | |
554 | .TP 5 | |
01ce6322 MS |
555 | PageLogFormat format string |
556 | .br | |
557 | Specifies the format of page log lines. | |
558 | .TP 5 | |
ef416fc2 | 559 | PassEnv variable [... variable] |
560 | .br | |
561 | Passes the specified environment variable(s) to child processes. | |
562 | .TP 5 | |
563 | <Policy name> ... </Policy> | |
564 | .br | |
565 | Specifies access control for the named policy. | |
566 | .TP 5 | |
bd7854cb | 567 | Port number |
ef416fc2 | 568 | .br |
569 | Specifies a port number to listen to for HTTP requests. | |
570 | .TP 5 | |
bd7854cb | 571 | PreserveJobFiles Yes |
572 | .TP 5 | |
573 | PreserveJobFiles No | |
ef416fc2 | 574 | .br |
575 | Specifies whether or not to preserve job files after they are printed. | |
576 | .TP 5 | |
bd7854cb | 577 | PreserveJobHistory Yes |
578 | .TP 5 | |
579 | PreserveJobHistory No | |
ef416fc2 | 580 | .br |
581 | Specifies whether or not to preserve the job history after they are | |
582 | printed. | |
583 | .TP 5 | |
584 | Printcap | |
bd7854cb | 585 | .TP 5 |
586 | Printcap filename | |
ef416fc2 | 587 | .br |
bd7854cb | 588 | Specifies the filename for a printcap file that is updated |
589 | automatically with a list of available printers (needed for | |
590 | legacy applications); specifying Printcap with no filename | |
591 | disables printcap generation. | |
592 | .TP 5 | |
593 | PrintcapFormat bsd | |
ef416fc2 | 594 | .TP 5 |
0af14961 MS |
595 | PrintcapFormat plist |
596 | .TP 5 | |
bd7854cb | 597 | PrintcapFormat solaris |
ef416fc2 | 598 | .br |
599 | Specifies the format of the printcap file. | |
600 | .TP 5 | |
601 | PrintcapGUI | |
bd7854cb | 602 | .TP 5 |
603 | PrintcapGUI gui-program-filename | |
ef416fc2 | 604 | .br |
bd7854cb | 605 | Specifies whether to generate option panel definition files on |
606 | some operating systems. When provided with no program filename, | |
607 | disables option panel definition files. | |
ef416fc2 | 608 | .TP 5 |
bd7854cb | 609 | ReloadTimeout seconds |
ef416fc2 | 610 | .br |
611 | Specifies the amount of time to wait for job completion before | |
612 | restarting the scheduler. | |
613 | .TP 5 | |
bd7854cb | 614 | RemoteRoot user-name |
ef416fc2 | 615 | .br |
616 | Specifies the username that is associated with unauthenticated root | |
617 | accesses. | |
618 | .TP 5 | |
bd7854cb | 619 | RequestRoot directory |
ef416fc2 | 620 | .br |
621 | Specifies the directory to store print jobs and other HTTP request | |
622 | data. | |
623 | .TP 5 | |
bd7854cb | 624 | Require group group-name-list |
625 | .TP 5 | |
626 | Require user user-name-list | |
627 | .TP 5 | |
628 | Require valid-user | |
ef416fc2 | 629 | .br |
630 | Specifies that user or group authentication is required. | |
631 | .TP 5 | |
bd7854cb | 632 | RIPCache bytes |
ef416fc2 | 633 | .br |
634 | Specifies the maximum amount of memory to use when converting images | |
635 | and PostScript files to bitmaps for a printer. | |
636 | .TP 5 | |
bd7854cb | 637 | Satisfy all |
ef416fc2 | 638 | .TP 5 |
bd7854cb | 639 | Satisfy any |
ef416fc2 | 640 | .br |
641 | Specifies whether all or any limits set for a Location must be | |
642 | satisfied to allow access. | |
643 | .TP 5 | |
bd7854cb | 644 | ServerAdmin user@domain.com |
ef416fc2 | 645 | .br |
646 | Specifies the email address of the server administrator. | |
647 | .TP 5 | |
e07d4801 MS |
648 | ServerAlias hostname |
649 | .br | |
650 | Specifies an alternate name that the server is known by. The special name "*" | |
651 | allows any name to be used. | |
652 | .TP 5 | |
bd7854cb | 653 | ServerBin directory |
ef416fc2 | 654 | .br |
655 | Specifies the directory where backends, CGIs, daemons, and filters may | |
656 | be found. | |
657 | .TP 5 | |
bd7854cb | 658 | ServerCertificate filename |
ef416fc2 | 659 | .br |
660 | Specifies the encryption certificate to use. | |
661 | .TP 5 | |
bd7854cb | 662 | ServerKey filename |
ef416fc2 | 663 | .br |
664 | Specifies the encryption key to use. | |
665 | .TP 5 | |
bd7854cb | 666 | ServerName hostname-or-ip-address |
ef416fc2 | 667 | .br |
668 | Specifies the fully-qualified hostname of the server. | |
669 | .TP 5 | |
bd7854cb | 670 | ServerRoot directory |
ef416fc2 | 671 | .br |
672 | Specifies the directory where the server configuration files can be found. | |
673 | .TP 5 | |
bd7854cb | 674 | ServerTokens Full |
675 | .TP 5 | |
676 | ServerTokens Major | |
677 | .TP 5 | |
678 | ServerTokens Minimal | |
679 | .TP 5 | |
680 | ServerTokens Minor | |
681 | .TP 5 | |
682 | ServerTokens None | |
683 | .TP 5 | |
684 | ServerTokens OS | |
685 | .TP 5 | |
686 | ServerTokens ProductOnly | |
ef416fc2 | 687 | .br |
688 | Specifies what information is included in the Server header of HTTP | |
689 | responses. | |
690 | .TP 5 | |
691 | SetEnv variable value | |
692 | .br | |
693 | Set the specified environment variable to be passed to child processes. | |
694 | .TP 5 | |
695 | SSLListen | |
696 | .br | |
697 | Listens on the specified address and port for encrypted connections. | |
698 | .TP 5 | |
b19ccc9e MS |
699 | SSLOptions None |
700 | .TP 5 | |
701 | SSLOptions NoEmptyFragments | |
702 | .br | |
703 | Sets SSL/TLS protocol options for encrypted connections. | |
704 | .TP 5 | |
ef416fc2 | 705 | SSLPort |
706 | .br | |
707 | Listens on the specified port for encrypted connections. | |
708 | .TP 5 | |
10d09e33 MS |
709 | SubscriptionPrivateAccess all |
710 | .TP 5 | |
711 | SubscriptionPrivateAccess default | |
712 | .TP 5 | |
713 | SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+ | |
714 | .br | |
715 | Specifies an access list for a subscription's private values. The "default" | |
716 | access list is "@OWNER @SYSTEM". "@ACL" maps to the printer's | |
717 | requesting-user-name-allowed or requesting-user-name-denied values. | |
718 | .TP 5 | |
719 | SubscriptionPrivateValues all | |
720 | .TP 5 | |
721 | SubscriptionPrivateValues default | |
722 | .TP 5 | |
723 | SubscriptionPrivateValues none | |
724 | .TP 5 | |
725 | SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ] | |
726 | Specifies the list of job values to make private. The "default" values are | |
727 | "notify-events", "notify-pull-method", "notify-recipient-uri", | |
728 | "notify-subscriber-user-name", and "notify-user-data". | |
729 | .TP 5 | |
bd7854cb | 730 | SystemGroup group-name [group-name ...] |
ef416fc2 | 731 | .br |
bd7854cb | 732 | Specifies the group(s) to use for System class authentication. |
ef416fc2 | 733 | .TP 5 |
bd7854cb | 734 | TempDir directory |
ef416fc2 | 735 | .br |
736 | Specifies the directory where temporary files are stored. | |
737 | .TP 5 | |
bd7854cb | 738 | Timeout seconds |
ef416fc2 | 739 | .br |
740 | Specifies the HTTP request timeout in seconds. | |
741 | .TP 5 | |
bd7854cb | 742 | User user-name |
ef416fc2 | 743 | .br |
744 | Specifies the user name or ID that is used when running external programs. | |
745 | .SH SEE ALSO | |
bd7854cb | 746 | \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fImime.convs(5)\fR, |
747 | \fImime.types(5)\fR, \fIprinters.conf(5)\fR, | |
748 | \fIsubscriptions.conf(5)\fR, | |
749 | .br | |
750 | http://localhost:631/help | |
ef416fc2 | 751 | .SH COPYRIGHT |
10d09e33 | 752 | Copyright 2007-2010 by Apple Inc. |
ef416fc2 | 753 | .\" |
b19ccc9e | 754 | .\" End of "$Id: cupsd.conf.man.in 7935 2008-09-11 01:54:11Z mike $". |
ef416fc2 | 755 | .\" |