1cupsd.conf(5) Apple Inc. cupsd.conf(5)
2
3
4
6 cupsd.conf - server configuration file for cups
7
9 The cupsd.conf file configures the CUPS scheduler, cupsd(8). It is
10 normally located in the /etc/cups directory. Note: File, directory,
11 and user configuration directives that used to be allowed in the
12 cupsd.conf file are now stored in the cups-files.conf(5) file instead
13 in order to prevent certain types of privilege escalation attacks.
14
15 Each line in the file can be a configuration directive, a blank line,
16 or a comment. Configuration directives typically consist of a name and
17 zero or more values separated by whitespace. The configuration direc‐
18 tive name and values are case-insensitive. Comment lines start with
19 the # character.
20
21 TOP-LEVEL DIRECTIVES
22 The following top-level directives are understood by cupsd(8):
23
24 AccessLogLevel config
25
26 AccessLogLevel actions
27
28 AccessLogLevel all
29 Specifies the logging level for the AccessLog file. The "config"
30 level logs when printers and classes are added, deleted, or modi‐
31 fied and when configuration files are accessed or updated. The
32 "actions" level logs when print jobs are submitted, held,
33 released, modified, or canceled, and any of the conditions for
34 "config". The "all" level logs all requests. The default access
35 log level is "actions".
36
37 AutoPurgeJobs Yes
38
39 AutoPurgeJobs No
40 Specifies whether to purge job history data automatically when it
41 is no longer required for quotas. The default is "No".
42
43 BrowseLocalProtocols all
44
45 BrowseLocalProtocols dnssd
46
47 BrowseLocalProtocols none
48 Specifies which protocols to use for local printer sharing. The
49 default is "dnssd" on systems that support Bonjour and "none" oth‐
50 erwise.
51
52 BrowseWebIF Yes
53
54 BrowseWebIF No
55 Specifies whether the CUPS web interface is advertised. The
56 default is "No".
57
58 Browsing Yes
59
60 Browsing No
61 Specifies whether shared printers are advertised. The default is
62 "No".
63
64 DefaultAuthType Basic
65
66 DefaultAuthType Negotiate
67 Specifies the default type of authentication to use. The default
68 is "Basic".
69
70 DefaultEncryption Never
71
72 DefaultEncryption IfRequested
73
74 DefaultEncryption Required
75 Specifies whether encryption will be used for authenticated
76 requests. The default is "Required".
77
78 DefaultLanguage locale
79 Specifies the default language to use for text and web content.
80 The default is "en".
81
82 DefaultPaperSize Auto
83
84 DefaultPaperSize None
85
86 DefaultPaperSize sizename
87 Specifies the default paper size for new print queues. "Auto" uses
88 a locale-specific default, while "None" specifies there is no
89 default paper size. Specific size names are typically "Letter" or
90 "A4". The default is "Auto".
91
92 DefaultPolicy policy-name
93 Specifies the default access policy to use. The default access
94 policy is "default".
95
96 DefaultShared Yes
97
98 DefaultShared No
99 Specifies whether local printers are shared by default. The
100 default is "Yes".
101
102 DirtyCleanInterval seconds
103 Specifies the delay for updating of configuration and state files.
104 A value of 0 causes the update to happen as soon as possible, typ‐
105 ically within a few milliseconds. The default value is "30".
106
107 ErrorPolicy abort-job
108 Specifies that a failed print job should be aborted (discarded)
109 unless otherwise specified for the printer.
110
111 ErrorPolicy retry-current-job
112 Specifies that a failed print job should be retried immediately
113 unless otherwise specified for the printer.
114
115 ErrorPolicy retry-job
116 Specifies that a failed print job should be retried at a later
117 time unless otherwise specified for the printer.
118
119 ErrorPolicy stop-printer
120 Specifies that a failed print job should stop the printer unless
121 otherwise specified for the printer. The 'stop-printer' error pol‐
122 icy is the default.
123
124 FilterLimit limit
125 Specifies the maximum cost of filters that are run concurrently,
126 which can be used to minimize disk, memory, and CPU resource prob‐
127 lems. A limit of 0 disables filter limiting. An average print to
128 a non-PostScript printer needs a filter limit of about 200. A
129 PostScript printer needs about half that (100). Setting the limit
130 below these thresholds will effectively limit the scheduler to
131 printing a single job at any time. The default limit is "0".
132
133 FilterNice nice-value
134 Specifies the scheduling priority ( nice(8) value) of filters that
135 are run to print a job. The nice value ranges from 0, the highest
136 priority, to 19, the lowest priority. The default is 0.
137
138 GSSServiceName name
139 Specifies the service name when using Kerberos authentication.
140 The default service name is "http."
141
142 HostNameLookups On
143
144 HostNameLookups Off
145
146 HostNameLookups Double
147 Specifies whether to do reverse lookups on connecting clients.
148 The "Double" setting causes cupsd(8) to verify that the hostname
149 resolved from the address matches one of the addresses returned
150 for that hostname. Double lookups also prevent clients with
151 unregistered addresses from connecting to your server. The
152 default is "Off" to avoid the potential server performance prob‐
153 lems with hostname lookups. Only set this option to "On" or "Dou‐
154 ble" if absolutely required.
155
156 IdleExitTimeout seconds
157 Specifies the length of time to wait before shutting down due to
158 inactivity. The default is "60" seconds. Note: Only applicable
159 when cupsd(8) is run on-demand (e.g., with -l).
160
161 JobKillDelay seconds
162 Specifies the number of seconds to wait before killing the filters
163 and backend associated with a canceled or held job. The default
164 is "30".
165
166 JobRetryInterval seconds
167 Specifies the interval between retries of jobs in seconds. This
168 is typically used for fax queues but can also be used with normal
169 print queues whose error policy is "retry-job" or "retry-current-
170 job". The default is "30".
171
172 JobRetryLimit count
173 Specifies the number of retries that are done for jobs. This is
174 typically used for fax queues but can also be used with normal
175 print queues whose error policy is "retry-job" or "retry-current-
176 job". The default is "5".
177
178 KeepAlive Yes
179
180 KeepAlive No
181 Specifies whether to support HTTP keep-alive connections. The
182 default is "Yes".
183
184 KeepAliveTimeout seconds
185 Specifies how long an idle client connection remains open. The
186 default is "30".
187
188 <Limit operation ...> ... </Limit>
189 Specifies the IPP operations that are being limited inside a Pol‐
190 icy section. IPP operation names are listed below in the section
191 "IPP OPERATION NAMES".
192
193 <Limit method ...> ... </Limit>
194
195 <LimitExcept method ...> ... </LimitExcept>
196 Specifies the HTTP methods that are being limited inside a Loca‐
197 tion section. HTTP method names are listed below in the section
198 "HTTP METHOD NAMES".
199
200 LimitRequestBody size
201 Specifies the maximum size of print files, IPP requests, and HTML
202 form data. The default is "0" which disables the limit check.
203
204 Listen ipv4-address:port
205
206 Listen [ipv6-address]:port
207
208 Listen *:port
209
210 Listen /path/to/domain/socket
211 Listens to the specified address and port or domain socket path
212 for connections. Multiple Listen directives can be provided to
213 listen on multiple addresses. The Listen directive is similar to
214 the Port directive but allows you to restrict access to specific
215 interfaces or networks.
216
217 ListenBackLog number
218 Specifies the number of pending connections that will be allowed.
219 This normally only affects very busy servers that have reached the
220 MaxClients limit, but can also be triggered by large numbers of
221 simultaneous connections. When the limit is reached, the operat‐
222 ing system will refuse additional connections until the scheduler
223 can accept the pending ones. The default is the OS-defined
224 default limit, typically either "5" for older operating systems or
225 "128" for newer operating systems.
226
227 <Location /path> ... </Location>
228 Specifies access control for the named location. Paths are docu‐
229 mented below in the section "LOCATION PATHS".
230
231 LogDebugHistory number
232 Specifies the number of debugging messages that are retained for
233 logging if an error occurs in a print job. Debug messages are
234 logged regardless of the LogLevel setting.
235
236 LogLevel none
237
238 LogLevel emerg
239
240 LogLevel alert
241
242 LogLevel crit
243
244 LogLevel error
245
246 LogLevel warn
247
248 LogLevel notice
249
250 LogLevel info
251
252 LogLevel debug
253
254 LogLevel debug2
255 Specifies the level of logging for the ErrorLog file. The value
256 "none" stops all logging while "debug2" logs everything. The
257 default is "warn".
258
259 LogTimeFormat standard
260
261 LogTimeFormat usecs
262 Specifies the format of the date and time in the log files. The
263 value "standard" is the default and logs whole seconds while
264 "usecs" logs microseconds.
265
266 MaxClients number
267 Specifies the maximum number of simultaneous clients that are
268 allowed by the scheduler. The default is "100".
269
270 MaxClientsPerHost number
271 Specifies the maximum number of simultaneous clients that are
272 allowed from a single address. The default is the MaxClients
273 value.
274
275 MaxCopies number
276 Specifies the maximum number of copies that a user can print of
277 each job. The default is "9999".
278
279 MaxHoldTime seconds
280 Specifies the maximum time a job may remain in the "indefinite"
281 hold state before it is canceled. The default is "0" which dis‐
282 ables cancellation of held jobs.
283
284 MaxJobs number
285 Specifies the maximum number of simultaneous jobs that are
286 allowed. Set to "0" to allow an unlimited number of jobs. The
287 default is "500".
288
289 MaxJobsPerPrinter number
290 Specifies the maximum number of simultaneous jobs that are allowed
291 per printer. The default is "0" which allows up to MaxJobs jobs
292 per printer.
293
294 MaxJobsPerUser number
295 Specifies the maximum number of simultaneous jobs that are allowed
296 per user. The default is "0" which allows up to MaxJobs jobs per
297 user.
298
299 MaxJobTime seconds
300 Specifies the maximum time a job may take to print before it is
301 canceled. Set to "0" to disable cancellation of "stuck" jobs.
302 The default is "10800" (3 hours).
303
304 MaxLogSize size
305 Specifies the maximum size of the log files before they are
306 rotated. The value "0" disables log rotation. The default is
307 "1048576" (1MB).
308
309 MultipleOperationTimeout seconds
310 Specifies the maximum amount of time to allow between files in a
311 multiple file print job. The default is "300" (5 minutes).
312
313 <Policy name> ... </Policy>
314 Specifies access control for the named policy.
315
316 Port number
317 Listens to the specified port number for connections.
318
319 PreserveJobFiles Yes
320
321 PreserveJobFiles No
322
323 PreserveJobFiles seconds
324 Specifies whether job files (documents) are preserved after a job
325 is printed. If a numeric value is specified, job files are pre‐
326 served for the indicated number of seconds after printing. The
327 default is "86400" (preserve 1 day).
328
329 PreserveJobHistory Yes
330
331 PreserveJobHistory No
332
333 PreserveJobHistory seconds
334 Specifies whether the job history is preserved after a job is
335 printed. If a numeric value is specified, the job history is pre‐
336 served for the indicated number of seconds after printing. If
337 "Yes", the job history is preserved until the MaxJobs limit is
338 reached. The default is "Yes".
339
340 ReloadTimeout seconds
341 Specifies the amount of time to wait for job completion before
342 restarting the scheduler. The default is "30".
343
344 ServerAdmin email-address
345 Specifies the email address of the server administrator. The
346 default value is "root@ServerName".
347
348 ServerAlias hostname [ ... hostname ]
349
350 ServerAlias *
351 The ServerAlias directive is used for HTTP Host header validation
352 when clients connect to the scheduler from external interfaces.
353 Using the special name "*" can expose your system to known
354 browser-based DNS rebinding attacks, even when accessing sites
355 through a firewall. If the auto-discovery of alternate names does
356 not work, we recommend listing each alternate name with a Server‐
357 Alias directive instead of using "*".
358
359 ServerName hostname
360 Specifies the fully-qualified hostname of the server. The default
361 is the value reported by the hostname(1) command.
362
363 ServerTokens None
364
365 ServerTokens ProductOnly
366
367 ServerTokens Major
368
369 ServerTokens Minor
370
371 ServerTokens Minimal
372
373 ServerTokens OS
374
375 ServerTokens Full
376 Specifies what information is included in the Server header of
377 HTTP responses. "None" disables the Server header. "ProductOnly"
378 reports "CUPS". "Major" reports "CUPS 2". "Minor" reports "CUPS
379 2.0". "Minimal" reports "CUPS 2.0.0". "OS" reports "CUPS 2.0.0
380 (UNAME)" where UNAME is the output of the uname(1) command.
381 "Full" reports "CUPS 2.0.0 (UNAME) IPP/2.0". The default is "Min‐
382 imal".
383
384 SSLListen ipv4-address:port
385
386 SSLListen [ipv6-address]:port
387
388 SSLListen *:port
389 Listens on the specified address and port for encrypted connec‐
390 tions.
391
392 SSLOptions [AllowDH] [AllowRC4] [AllowSSL3] [DenyCBC] [DenyTLS1.0]
393
394 SSLOptions None
395 Sets encryption options. By default, CUPS only supports encryp‐
396 tion using TLS v1.0 or higher using known secure cipher suites.
397 Security is reduced when Allow options are used. Security is
398 enhanced when Deny options are used. The AllowDH option enables
399 cipher suites using plain Diffie-Hellman key negotiation (not sup‐
400 ported on systems using GNU TLS). The AllowRC4 option enables the
401 128-bit RC4 cipher suites, which are required for some older
402 clients. The AllowSSL3 option enables SSL v3.0, which is required
403 for some older clients that do not support TLS v1.0. The DenyCBC
404 option disables all CBC cipher suites. The DenyTLS1.0 option dis‐
405 ables TLS v1.0 support - this sets the minimum protocol version to
406 TLS v1.1.
407
408 SSLPort port
409 Listens on the specified port for encrypted connections.
410
411 StrictConformance Yes
412
413 StrictConformance No
414 Specifies whether the scheduler requires clients to strictly
415 adhere to the IPP specifications. The default is "No".
416
417 Timeout seconds
418 Specifies the HTTP request timeout. The default is "300" (5 min‐
419 utes).
420
421 WebInterface yes
422
423 WebInterface no
424 Specifies whether the web interface is enabled. The default is
425 "No".
426
427 HTTP METHOD NAMES
428 The following HTTP methods are supported by cupsd(8):
429
430 GET Used by a client to download icons and other printer resources and
431 to access the CUPS web interface.
432
433 HEAD Used by a client to get the type, size, and modification date of
434 resources.
435
436 OPTIONS
437 Used by a client to establish a secure (SSL/TLS) connection.
438
439 POST Used by a client to submit IPP requests and HTML forms from the
440 CUPS web interface.
441
442 PUT Used by a client to upload configuration files.
443
444 IPP OPERATION NAMES
445 The following IPP operations are supported by cupsd(8):
446
447 CUPS-Accept-Jobs
448 Allows a printer to accept new jobs.
449
450 CUPS-Add-Modify-Class
451 Adds or modifies a printer class.
452
453 CUPS-Add-Modify-Printer
454 Adds or modifies a printer.
455
456 CUPS-Authenticate-Job
457 Releases a job that is held for authentication.
458
459 CUPS-Delete-Class
460 Deletes a printer class.
461
462 CUPS-Delete-Printer
463 Deletes a printer.
464
465 CUPS-Get-Classes
466 Gets a list of printer classes.
467
468 CUPS-Get-Default
469 Gets the server default printer or printer class.
470
471 CUPS-Get-Devices
472 Gets a list of devices that are currently available.
473
474 CUPS-Get-Document
475 Gets a document file for a job.
476
477 CUPS-Get-PPD
478 Gets a PPD file.
479
480 CUPS-Get-PPDs
481 Gets a list of installed PPD files.
482
483 CUPS-Get-Printers
484 Gets a list of printers.
485
486 CUPS-Move-Job
487 Moves a job.
488
489 CUPS-Reject-Jobs
490 Prevents a printer from accepting new jobs.
491
492 CUPS-Set-Default
493 Sets the server default printer or printer class.
494
495 Cancel-Job
496 Cancels a job.
497
498 Cancel-Jobs
499 Cancels one or more jobs.
500
501 Cancel-My-Jobs
502 Cancels one or more jobs creates by a user.
503
504 Cancel-Subscription
505 Cancels a subscription.
506
507 Close-Job
508 Closes a job that is waiting for more documents.
509
510 Create-Job
511 Creates a new job with no documents.
512
513 Create-Job-Subscriptions
514 Creates a subscription for job events.
515
516 Create-Printer-Subscriptions
517 Creates a subscription for printer events.
518
519 Get-Job-Attributes
520 Gets information about a job.
521
522 Get-Jobs
523 Gets a list of jobs.
524
525 Get-Notifications
526 Gets a list of event notifications for a subscription.
527
528 Get-Printer-Attributes
529 Gets information about a printer or printer class.
530
531 Get-Subscription-Attributes
532 Gets information about a subscription.
533
534 Get-Subscriptions
535 Gets a list of subscriptions.
536
537 Hold-Job
538 Holds a job from printing.
539
540 Hold-New-Jobs
541 Holds all new jobs from printing.
542
543 Pause-Printer
544 Stops processing of jobs by a printer or printer class.
545
546 Pause-Printer-After-Current-Job
547 Stops processing of jobs by a printer or printer class after the
548 current job is finished.
549
550 Print-Job
551 Creates a new job with a single document.
552
553 Purge-Jobs
554 Cancels one or more jobs and deletes the job history.
555
556 Release-Held-New-Jobs
557 Allows previously held jobs to print.
558
559 Release-Job
560 Allows a job to print.
561
562 Renew-Subscription
563 Renews a subscription.
564
565 Restart-Job
566 Reprints a job, if possible.
567
568 Send-Document
569 Adds a document to a job.
570
571 Set-Job-Attributes
572 Changes job information.
573
574 Set-Printer-Attributes
575 Changes printer or printer class information.
576
577 Validate-Job
578 Validates options for a new job.
579
580 LOCATION PATHS
581 The following paths are commonly used when configuring cupsd(8):
582
583 / The path for all get operations (get-printers, get-jobs, etc.)
584
585 /admin
586 The path for all administration operations (add-printer, delete-
587 printer, start-printer, etc.)
588
589 /admin/conf
590 The path for access to the CUPS configuration files (cupsd.conf,
591 client.conf, etc.)
592
593 /admin/log
594 The path for access to the CUPS log files (access_log, error_log,
595 page_log)
596
597 /classes
598 The path for all printer classes
599
600 /classes/name
601 The resource for the named printer class
602
603 /jobs
604 The path for all jobs (hold-job, release-job, etc.)
605
606 /jobs/id
607 The path for the specified job
608
609 /printers
610 The path for all printers
611
612 /printers/name
613 The path for the named printer
614
615 /printers/name.png
616 The icon file path for the named printer
617
618 /printers/name.ppd
619 The PPD file path for the named printer
620
621 DIRECTIVES VALID WITHIN LOCATION AND LIMIT SECTIONS
622 The following directives may be placed inside Location and Limit sec‐
623 tions in the cupsd.conf file:
624
625 Allow all
626
627 Allow none
628
629 Allow host.domain.com
630
631 Allow *.domain.com
632
633 Allow ipv4-address
634
635 Allow ipv4-address/netmask
636
637 Allow ipv4-address/mm
638
639 Allow [ipv6-address]
640
641 Allow [ipv6-address]/mm
642
643 Allow @IF(name)
644
645 Allow @LOCAL
646 Allows access from the named hosts, domains, addresses, or inter‐
647 faces. The Order directive controls whether Allow lines are eval‐
648 uated before or after Deny lines.
649
650 AuthType None
651
652 AuthType Basic
653
654 AuthType Default
655
656 AuthType Negotiate
657 Specifies the type of authentication required. The value
658 "Default" corresponds to the DefaultAuthType value.
659
660 Deny all
661
662 Deny none
663
664 Deny host.domain.com
665
666 Deny *.domain.com
667
668 Deny ipv4-address
669
670 Deny ipv4-address/netmask
671
672 Deny ipv4-address/mm
673
674 Deny [ipv6-address]
675
676 Deny [ipv6-address]/mm
677
678 Deny @IF(name)
679
680 Deny @LOCAL
681 Denies access from the named hosts, domains, addresses, or inter‐
682 faces. The Order directive controls whether Deny lines are evalu‐
683 ated before or after Allow lines.
684
685 Encryption IfRequested
686
687 Encryption Never
688
689 Encryption Required
690 Specifies the level of encryption that is required for a particu‐
691 lar location. The default value is "IfRequested".
692
693 Order allow,deny
694 Specifies that access is denied by default. Allow lines are then
695 processed followed by Deny lines to determine whether a client may
696 access a particular resource.
697
698 Order deny,allow
699 Specifies that access is allowed by default. Deny lines are then
700 processed followed by Allow lines to determine whether a client
701 may access a particular resource.
702
703 Require group group-name [ group-name ... ]
704 Specifies that an authenticated user must be a member of one of
705 the named groups.
706
707 Require user {user-name|@group-name} ...
708 Specifies that an authenticated user must match one of the named
709 users or be a member of one of the named groups. The group name
710 "@SYSTEM" corresponds to the list of groups defined by the System‐
711 Group directive in the cups-files.conf(5) file. The group name
712 "@OWNER" corresponds to the owner of the resource, for example the
713 person that submitted a print job. Note: The 'root' user is not
714 special and must be granted privileges like any other user
715 account.
716
717 Require valid-user
718 Specifies that any authenticated user is acceptable.
719
720 Satisfy all
721 Specifies that all Allow, AuthType, Deny, Order, and Require con‐
722 ditions must be satisfied to allow access.
723
724 Satisfy any
725 Specifies that any a client may access a resource if either the
726 authentication (AuthType/Require) or address (Allow/Deny/Order)
727 conditions are satisfied. For example, this can be used to
728 require authentication only for remote accesses.
729
730 DIRECTIVES VALID WITHIN POLICY SECTIONS
731 The following directives may be placed inside Policy sections in the
732 cupsd.conf file:
733
734 JobPrivateAccess all
735
736 JobPrivateAccess default
737
738 JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM} ...
739 Specifies an access list for a job's private values. The
740 "default" access list is "@OWNER @SYSTEM". "@ACL" maps to the
741 printer's requesting-user-name-allowed or requesting-user-name-
742 denied values. "@OWNER" maps to the job's owner. "@SYSTEM" maps
743 to the groups listed for the SystemGroup directive in the cups-
744 files.conf(5) file.
745
746 JobPrivateValues all
747
748 JobPrivateValues default
749
750 JobPrivateValues none
751
752 JobPrivateValues attribute-name [ ... attribute-name ]
753 Specifies the list of job values to make private. The "default"
754 values are "job-name", "job-originating-host-name", "job-originat‐
755 ing-user-name", and "phone".
756
757 SubscriptionPrivateAccess all
758
759 SubscriptionPrivateAccess default
760
761 SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM} ...
762 Specifies an access list for a subscription's private values. The
763 "default" access list is "@OWNER @SYSTEM". "@ACL" maps to the
764 printer's requesting-user-name-allowed or requesting-user-name-
765 denied values. "@OWNER" maps to the job's owner. "@SYSTEM" maps
766 to the groups listed for the SystemGroup directive in the cups-
767 files.conf(5) file.
768
769 SubscriptionPrivateValues all
770
771 SubscriptionPrivateValues default
772
773 SubscriptionPrivateValues none
774
775 SubscriptionPrivateValues attribute-name [ ... attribute-name ]
776 Specifies the list of subscription values to make private. The
777 "default" values are "notify-events", "notify-pull-method",
778 "notify-recipient-uri", "notify-subscriber-user-name", and
779 "notify-user-data".
780
781 DEPRECATED DIRECTIVES
782 The following directives are deprecated and will be removed in a future
783 release of CUPS:
784
785 Classification banner
786 Specifies the security classification of the server. Any valid
787 banner name can be used, including "classified", "confidential",
788 "secret", "topsecret", and "unclassified", or the banner can be
789 omitted to disable secure printing functions. The default is no
790 classification banner.
791
792 ClassifyOverride Yes
793
794 ClassifyOverride No
795 Specifies whether users may override the classification (cover
796 page) of individual print jobs using the "job-sheets" option. The
797 default is "No".
798
799 PageLogFormat format-string
800 Specifies the format of PageLog lines. Sequences beginning with
801 percent (%) characters are replaced with the corresponding infor‐
802 mation, while all other characters are copied literally. The fol‐
803 lowing percent sequences are recognized:
804
805 "%%" inserts a single percent character.
806 "%{name}" inserts the value of the specified IPP attribute.
807 "%C" inserts the number of copies for the current page.
808 "%P" inserts the current page number.
809 "%T" inserts the current date and time in common log format.
810 "%j" inserts the job ID.
811 "%p" inserts the printer name.
812 "%u" inserts the username.
813
814 The default is the empty string, which disables page logging. The
815 string "%p %u %j %T %P %C %{job-billing} %{job-originating-host-
816 name} %{job-name} %{media} %{sides}" creates a page log with the
817 standard items.
818
819 RIPCache size
820 Specifies the maximum amount of memory to use when converting doc‐
821 uments into bitmaps for a printer. The default is "128m".
822
824 The cupsd.conf file format is based on the Apache HTTP Server configu‐
825 ration file format.
826
828 Log everything with a maximum log file size of 32 megabytes:
829
830 AccessLogLevel all
831 LogLevel debug2
832 MaxLogSize 32m
833
834 Require authentication for accesses from outside the 10. network:
835
836 <Location />
837 Order allow,deny
838 Allow from 10./8
839 AuthType Basic
840 Require valid-user
841 Satisfy any
842 </Location>
843
845 classes.conf(5), cups-files.conf(5), cupsd(8), mime.convs(5),
846 mime.types(5), printers.conf(5), subscriptions.conf(5), CUPS Online
847 Help (http://localhost:631/help)
848
850 Copyright © 2007-2018 by Apple Inc.
851
852
853
85424 April 2018 CUPS cupsd.conf(5)