1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
|
%%header
# CUPS configuration file, generated by CUPS configuration tool.
# This tool is part of KDEPrint, the printing framework for KDE
# since version 2.2.2 and is used by the CUPS supporting module
# in KDEPrint. The predecessors to KDEPrint in former KDE releases
# were KUPS and QtCUPS; they are deprecated and no longer maintained.
#
# Author: Michael Goffioul <kdeprint@swing.be>
#
# Web site: http://printing.kde.org/
#
########################################################################
# #
# This is the CUPS configuration file. If you are familiar with #
# Apache or any of the other popular web servers, we've followed the #
# same format. Any configuration variable used here has the same #
# semantics as the corresponding variable in Apache. If we need #
# different functionality then a different name is used to avoid #
# confusion... #
# #
########################################################################
@@
%%servername
# <b>Server name (ServerName)</b>
# <p>
# The hostname of your server, as advertised to the world.
# By default CUPS will use the hostname of the system.</p>
# <p>
# To set the default server used by clients, see the client.conf file.</p>
# <p>
# <i>ex</i>: myhost.domain.com</p>
$$
#ServerName myhost.domain.com
@@
%%serveradmin
# <b>Server administrator (ServerAdmin)</b>
# <p>
# The email address to send all complaints or problems to.
# By default CUPS will use "root@hostname".</p>
# <p>
# <i>ex</i>: root@myhost.com</p>
$$
#ServerAdmin root@your.domain.com
@@
%%accesslog
# <b>Access log (AccessLog)</b>
# <p>
# The access log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
# "/var/log/cups/access_log".</p>
# <p>
# You can also use the special name <b>syslog</b> to send the output to the
# syslog file or daemon.</p>
# <p>
# <i>ex</i>: /var/log/cups/access_log</p>
$$
#AccessLog /var/log/cups/access_log
@@
%%datadir
# <b>Data directory (DataDir)</b>
# <p>
# The root directory for the CUPS data files.
# By default /usr/share/cups.</p>
# <p>
# <i>ex</i>: /usr/share/cups</p>
$$
#DataDir /usr/share/cups
@@
%%defaultcharset
# <b>Default character set (DefaultCharset)</b>
# <p>
# The default character set to use. If not specified,
# defaults to utf-8. Note that this can also be overridden in
# HTML documents...</p>
# <p>
# <i>ex</i>: utf-8</p>
$$
#DefaultCharset utf-8
@@
%%defaultlanguage
# <b>Default language (DefaultLanguage)</b>
# <p>
# The default language if not specified by the browser.
# If not specified, the current locale is used.</p>
# <p>
# <i>ex</i>: en</p>
$$
#DefaultLanguage en
@@
%%documentroot
# <b>Document directory (DocumentRoot)</b>
# <p>
# The root directory for HTTP documents that are served.
# By default the compiled-in directory.</p>
# <p>
# <i>ex</i>: /usr/share/cups/doc-root</p>
$$
#DocumentRoot /usr/share/cups/doc-root
@@
%%errorlog
# <b>Error log (ErrorLog)</b>
# <p>
# The error log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
# "/var/log/cups/error_log".</p>
# <p>
# You can also use the special name <b>syslog</b> to send the output to the
# syslog file or daemon.</p>
# <p>
# <i>ex</i>: /var/log/cups/error_log</p>
$$
#ErrorLog /var/log/cups/error_log
@@
%%fontpath
# <b>Font path (FontPath)</b>
# <p>
# The path to locate all font files (currently only for pstoraster).
# By default /usr/share/cups/fonts.</p>
# <p>
# <i>ex</i>: /usr/share/cups/fonts</p>
$$
#FontPath /usr/share/cups/fonts
@@
%%loglevel
# <b>Log level (LogLevel)</b>
# <p>
# Controls the number of messages logged to the ErrorLog
# file and can be one of the following:</p>
# <ul type=circle>
# <li><i>debug2</i>: Log everything.</li>
# <li><i>debug</i>: Log almost everything.</li>
# <li><i>info</i>: Log all requests and state changes.</li>
# <li><i>warn</i>: Log errors and warnings.</li>
# <li><i>error</i>: Log only errors.</li>
# <li><i>none</i>: Log nothing.</li>
# </ul><p>
# <i>ex</i>: info</p>
$$
#LogLevel info
@@
%%maxlogsize
# <b>Max log size (MaxLogSize)</b>
# <p>
# Controls the maximum size of each log file before they are
# rotated. Defaults to 1048576 (1MB). Set to 0 to disable log rotating.</p>
# <p>
# <i>ex</i>: 1048576</p>
$$
#MaxLogSize 0
@@
%%pagelog
# <b>Page log (PageLog)</b>
# <p>
# The page log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
# "/var/log/cups/page_log".</p>
# <p>
# You can also use the special name <b>syslog</b> to send the output to the
# syslog file or daemon.</p>
# <p>
# <i>ex</i>: /var/log/cups/page_log</p>
$$
#PageLog /var/log/cups/page_log
@@
%%preservejobhistory
# <b>Preserve job history (PreserveJobHistory)</b>
# <p>
# Whether or not to preserve the job history after a
# job is completed, canceled, or stopped. Default is Yes.</p>
# <p>
# <i>ex</i>: Yes</p>
$$
#PreserveJobHistory Yes
@@
%%preservejobfiles
# <b>Preserve job files (PreserveJobFiles)</b>
# <p>
# Whether or not to preserve the job files after a
# job is completed, canceled, or stopped. Default is No.</p>
# <p>
# <i>ex</i>: No</p>
$$
#PreserveJobFiles No
@@
%%printcap
# <b>Printcap file (Printcap)</b>
# <p>
# The name of the printcap file. Default is no filename.
# Leave blank to disable printcap file generation.</p>
# <p>
# <i>ex</i>: /etc/printcap</p>
$$
#Printcap /etc/printcap
@@
%%requestroot
# <b>Request directory (RequestRoot)</b>
# <p>
# The directory where request files are stored.
# By default /var/spool/cups.</p>
# <p>
# <i>ex</i>: /var/spool/cups</p>
$$
#RequestRoot /var/spool/cups
@@
%%remoteroot
# <b>Remote root user (RemoteRoot)</b>
# <p>
# The name of the user assigned to unauthenticated accesses
# from remote systems. By default "remroot".</p>
# <p>
# <i>ex</i>: remroot</p>
$$
#RemoteRoot remroot
@@
%%serverbin
# <b>Server binaries (ServerBin)</b>
# <p>
# The root directory for the scheduler executables.
# By default /usr/lib/cups or /usr/lib32/cups (IRIX 6.5).</p>
# <p>
# <i>ex</i>: /usr/lib/cups</p>
$$
#ServerBin /usr/lib/cups
@@
%%serverroot
# <b>Server files (ServerRoot)</b>
# <p>
# The root directory for the scheduler.
# By default /etc/cups.</p>
# <p>
# <i>ex</i>: /etc/cups</p>
$$
#ServerRoot /etc/cups
@@
%%user
# <b>User (User)</b>
# <p>
# The user the server runs under. Normally this
# must be <b>lp</b>, however you can configure things for another user
# as needed.</p>
# <p>
# Note: the server must be run initially as root to support the
# default IPP port of 631. It changes users whenever an external
# program is run...</p>
# <p>
# <i>ex</i>: lp</p>
$$
#User lp
@@
%%group
# <b>Group (Group)</b>
# <p>
# The group the server runs under. Normally this
# must be <b>lpadmin</b>, however you can configure things for another
# group as needed.</p>
# <p>
# <i>ex</i>: lpadmin</p>
$$
#Group lpadmin
@@
%%ripcache
# <b>RIP cache (RIPCache)</b>
# <p>
# The amount of memory that each RIP should use to cache
# bitmaps. The value can be any real number followed by "k" for
# kilobytes, "m" for megabytes, "g" for gigabytes, or "t" for tiles
# (1 tile = 256x256 pixels). Defaults to "8m" (8 megabytes).</p>
# <p>
# <i>ex</i>: 8m</p>
$$
#RIPCache 8m
@@
%%tempdir
# <b>Temporary files (TempDir)</b>
# <p>
# The directory to put temporary files in. This directory must be
# writable by the user defined above! Defaults to "/var/spool/cups/tmp" or
# the value of the TMPDIR environment variable.</p>
# <p>
# <i>ex</i>: /var/spool/cups/tmp</p>
$$
#TempDir /var/spool/cups/tmp
@@
%%filterlimit
# <b>Filter limit (FilterLimit)</b>
# <p>
# Sets the maximum cost of all job filters that can be run
# at the same time. A limit of 0 means no limit. A typical job may need
# a filter limit of at least 200; limits less than the minimum required
# by a job force a single job to be printed at any time.</p>
# <p>
# The default limit is 0 (unlimited).</p>
# <p>
# <i>ex</i>: 200</p>
$$
#FilterLimit 0
@@
%%listen
# <b>Listen to (Port/Listen)</b>
# <p>
# Ports/addresses that are listened to. The default port 631 is reserved
# for the Internet Printing Protocol (IPP) and is what is used here.</p>
# <p>
# You can have multiple Port/Listen lines to listen to more than one
# port or address, or to restrict access.</p>
# <p>
# Note: Unfortunately, most web browsers don't support TLS or HTTP Upgrades
# for encryption. If you want to support web-based encryption you will
# probably need to listen on port 443 (the "HTTPS" port...).</p>
# <p>
# <i>ex</i>: 631, myhost:80, 1.2.3.4:631</p>
$$
# Port 80
# Port 631
# Listen hostname
# Listen hostname:80
# Listen hostname:631
# Listen 1.2.3.4
# Listen 1.2.3.4:631
#
#Port 631
@@
%%hostnamelookups
# <b>Hostname lookups (HostNameLookups)</b>
# <p>
# Whether or not to do lookups on IP addresses to get a
# fully-qualified hostname. This defaults to Off for performance reasons...</p>
# <p>
# <i>ex</i>: On</p>
$$
#HostNameLookups On
@@
%%keepalive
# <b>Keep alive (KeepAlive)</b>
# <p>
# Whether or not to support the Keep-Alive connection
# option. Default is on.</p>
# <p>
# <i>ex</i>: On</p>
$$
#KeepAlive On
@@
%%keepalivetimeout
# <b>Keep-alive timeout (KeepAliveTimeout)</b>
# <p>
# The timeout (in seconds) before Keep-Alive connections are
# automatically closed. Default is 60 seconds.</p>
# <p>
# <i>ex</i>: 60</p>
$$
#KeepAliveTimeout 60
@@
%%maxclients
# <b>Max clients (MaxClients)</b>
# <p>
# Controls the maximum number of simultaneous clients that
# will be handled. Defaults to 100.</p>
# <p>
# <i>ex</i>: 100</p>
$$
#MaxClients 100
@@
%%maxrequestsize
# <b>Max request size (MaxRequestSize)</b>
# <p>
# Controls the maximum size of HTTP requests and print files.
# Set to 0 to disable this feature (defaults to 0).</p>
# <p>
# <i>ex</i>: 0</p>
$$
#MaxRequestSize 0
@@
%%timeout
# <b>Client timeout (Timeout)</b>
# <p>
# The timeout (in seconds) before requests time out. Default is 300 seconds.</p>
# <p>
# <i>ex</i>: 300</p>
$$
#Timeout 300
@@
%%browsing
# <b>Use browsing (Browsing)</b>
# <p>
# Whether or not to <b>listen</b> to printer
# information from other CUPS servers.
# </p>
# <p>
# Enabled by default.
# </p>
# <p>
# Note: to enable the <b>sending</b> of browsing
# information from this CUPS server to the LAN,
# specify a valid <i>BrowseAddress</i>.
# </p>
# <p>
# <i>ex</i>: On</p>
$$
#Browsing On
@@
%%browseshortnames
# <b>Use short names (BrowseShortNames)</b>
# <p>
# Whether or not to use "short" names for remote printers
# when possible (e.g. "printer" instead of "printer@host"). Enabled by
# default.</p>
# <p>
# <i>ex</i>: Yes</p>
$$
#BrowseShortNames Yes
@@
%%browseaddress
# <b>Browse addresses (BrowseAddress)</b>
# <p>
# Specifies a broadcast address to be used. By
# default browsing information is broadcast to all active interfaces.</p>
# <p>
# Note: HP-UX 10.20 and earlier do not properly handle broadcast unless
# you have a Class A, B, C, or D nettqmask (i.e. no CIDR support).</p>
# <p>
# <i>ex</i>: x.y.z.255, x.y.255.255</p>
$$
#BrowseAddress x.y.z.255
#BrowseAddress x.y.255.255
#BrowseAddress x.255.255.255
@@
%%browseallow
# <b>Browse allow/deny (BrowseAllow/BrowseDeny)</b>
# <p>
# <u>BrowseAllow</u>: specifies an address tqmask to allow for incoming browser
# packets. The default is to allow packets from all addresses.</p>
# <p>
# <u>BrowseDeny</u>: specifies an address tqmask to deny for incoming browser
# packets. The default is to deny packets from no addresses.</p>
# <p>
# Both "BrowseAllow" and "BrowseDeny" accept the following notations for
# addresses:</p>
# <pre>
# All
# None
# *.domain.com
# .domain.com
# host.domain.com
# nnn.*
# nnn.nnn.*
# nnn.nnn.nnn.*
# nnn.nnn.nnn.nnn
# nnn.nnn.nnn.nnn/mm
# nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
# </pre><p>
# The hostname/domainname restrictions only work if you have turned hostname
# lookups on!</p>
$$
#BrowseAllow address
#BrowseDeny address
@@
%%browseinterval
# <b>Browse interval (BrowseInterval)</b>
# <p>
# The time between browsing updates in seconds. Default
# is 30 seconds.</p>
# <p>
# Note that browsing information is sent whenever a printer's state changes
# as well, so this represents the maximum time between updates.</p>
# <p>
# Set this to 0 to disable outgoing broadcasts so your local printers are
# not advertised but you can still see printers on other hosts.</p>
# <p>
# <i>ex</i>: 30</p>
$$
#BrowseInterval 30
@@
%%browseorder
# <b>Browse order (BrowseOrder)</b>
# <p>
# Specifies the order of BrowseAllow/BrowseDeny comparisons.</p>
# <p>
# <i>ex</i>: allow,deny</p>
$$
#BrowseOrder allow,deny
#BrowseOrder deny,allow
@@
%%browsepoll
# <b>Browse poll (BrowsePoll)</b>
# <p>
# Poll the named server(s) for printers.</p>
# <p>
# <i>ex</i>: myhost:631</p>
$$
#BrowsePoll address:port
@@
%%browseport
# <b>Browse port (BrowsePort)</b>
# <p>
# The port used for UDP broadcasts. By default this is
# the IPP port; if you change this you need to do it on all servers.
# Only one BrowsePort is recognized.</p>
# <p>
# <i>ex</i>: 631</p>
$$
#BrowsePort 631
@@
%%browserelay
# <b>Browse relay (BrowseRelay)</b>
# <p>
# Relay browser packets from one address/network to another.</p>
# <p>
# <i>ex</i>: src-address dest-address</p>
$$
#BrowseRelay source-address destination-address
@@
%%browsetimeout
# <b>Browse timeout (BrowseTimeout)</b>
# <p>
# The timeout (in seconds) for network printers - if we don't
# get an update within this time the printer will be removed
# from the printer list. This number definitely should not be
# less the BrowseInterval value for obvious reasons. Defaults
# to 300 seconds.</p>
# <p>
# <i>ex</i>: 300</p>
$$
#BrowseTimeout 300
@@
%%implicitclasses
# <b>Implicit classes (ImplicitClasses)</b>
# <p>
# Whether or not to use implicit classes.</p>
# <p>
# Printer classes can be specified explicitly in the classes.conf
# file, implicitly based upon the printers available on the LAN, or
# both.</p>
# <p>
# When ImplicitClasses is On, printers on the LAN with the same name
# (e.g. Acme-LaserPrint-1000) will be put into a class with the same
# name. This allows you to setup multiple redundant queues on a LAN
# without a lot of administrative difficulties. If a user sends a
# job to Acme-LaserPrint-1000, the job will go to the first available
# queue.</p>
# <p>
# Enabled by default.</p>
$$
#ImplicitClasses Off
@@
%%systemgroup
# <b>System group (SystemGroup)</b>
# <p>
# The group name for "System" (printer administration)
# access. The default varies depending on the operating system, but
# will be <b>sys</b>, <b>system</b>, or <b>root</b> (checked for in that order).</p>
# <p>
# <i>ex</i>: lpadmin</p>
$$
#SystemGroup lpadmin
@@
%%servercertificate
# <b>Encryption certificate (ServerCertificate)</b>
# <p>
# The file to read containing the server's certificate.
# Defaults to "/etc/cups/ssl/server.crt".</p>
# <p>
# <i>ex</i>: /etc/cups/ssl/server.crt</p>
$$
#ServerCertificate /etc/cups/ssl/server.crt
@@
%%serverkey
# <b>Encryption key (ServerKey)</b>
# <p>
# The file to read containing the server's key.
# Defaults to "/etc/cups/ssl/server.key".</p>
# <p>
# <i>ex</i>: /etc/cups/ssl/server.key</p>
$$
#ServerKey /etc/cups/ssl/server.key
@@
%%locations
# Access permissions
#
# Access permissions for each directory served by the scheduler.
# Locations are relative to DocumentRoot...
#
# AuthType: the authorization to use:
#
# None - Perform no authentication
# Basic - Perform authentication using the HTTP Basic method.
# Digest - Perform authentication using the HTTP Digest method.
#
# (Note: local certificate authentication can be substituted by
# the client for Basic or Digest when connecting to the
# localhost interface)
#
# AuthClass: the authorization class; currently only Anonymous, User,
# System (valid user belonging to group SystemGroup), and Group
# (valid user belonging to the specified group) are supported.
#
# AuthGroupName: the group name for "Group" authorization.
#
# Order: the order of Allow/Deny processing.
#
# Allow: allows access from the specified hostname, domain, IP address, or
# network.
#
# Deny: denies access from the specified hostname, domain, IP address, or
# network.
#
# Both "Allow" and "Deny" accept the following notations for addresses:
#
# All
# None
# *.domain.com
# .domain.com
# host.domain.com
# nnn.*
# nnn.nnn.*
# nnn.nnn.nnn.*
# nnn.nnn.nnn.nnn
# nnn.nnn.nnn.nnn/mm
# nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
#
# The host and domain address require that you enable hostname lookups
# with "HostNameLookups On" above.
#
# Encryption: whether or not to use encryption; this depends on having
# the OpenSSL library linked into the CUPS library and scheduler.
#
# Possible values:
#
# Always - Always use encryption (SSL)
# Never - Never use encryption
# Required - Use TLS encryption upgrade
# IfRequested - Use encryption if the server requests it
#
# The default value is "IfRequested".
$$
#<Location [resource_name]>
#
# You may wish to limit access to printers and classes, either with Allow
# and Deny lines, or by requiring a username and password.
#
#
## Anonymous access (default)
#AuthType None
#
## Require a username and password (Basic authentication)
#AuthType Basic
#AuthClass User
#
## Require a username and password (Digest/MD5 authentication)
#AuthType Digest
#AuthClass User
#
## Restrict access to local domain
#Order Deny,Allow
#Deny From All
#Allow From .mydomain.com
#
## Use encryption if requested
#Encryption IfRequested
#</Location>
@@
%%authtype
# <b>Authentication (AuthType)</b>
# <p>
# The authorization to use:<p>
# <ul type=circle>
# <li><i>None</i> - Perform no authentication.</li>
# <li><i>Basic</i> - Perform authentication using the HTTP Basic method.</li>
# <li><i>Digest</i> - Perform authentication using the HTTP Digest method.</li>
# </ul><p>
# Note: local certificate authentication can be substituted by
# the client for <i>Basic</i> or <i>Digest</i> when connecting to the
# localhost interface.</p>
@@
%%authclass
# <b>Class (AuthClass)</b>
# <p>
# The authorization class; currently only <i>Anonymous</i>, <i>User</i>,
# <i>System</i> (valid user belonging to group SystemGroup), and <i>Group</i>
# (valid user belonging to the specified group) are supported.</p>
@@
%%authname
# <p>The user/group names allowed to access the resource. The format is a
# comma separated list.</p>
@@
%%satisfy
# <b>Satisfy (Satisfy)</b>
# <p>
# This directive controls whether all specified conditions must
# be satisfied to allow access to the resource. If set to "all",
# then all authentication and access control conditions must be
# satisfied to allow access.
# </p>
# <p>
# Setting Satisfy to "any" allows a user to gain access if the
# authentication <i>or</i> access control requirements are satisfied.
# For example, you might require authentication for remote access,
# but allow local access without authentication.
# </p>
# <p>
# The default is "all".
# </p>
@@
%%authgroupname
# <b>Authentication group name (AuthGroupName)</b>
# <p>
# The group name for <i>Group</i> authorization.</p>
@@
%%order
# <b>ACL order (Order)</b>
# <p>
# The order of Allow/Deny processing.</p>
@@
%%allow
# <b>Allow</b>
# <p>
# Allows access from the specified hostname, domain, IP address, or
# network. Possible values are:</p>
# <pre>
# All
# None
# *.domain.com
# .domain.com
# host.domain.com
# nnn.*
# nnn.nnn.*
# nnn.nnn.nnn.*
# nnn.nnn.nnn.nnn
# nnn.nnn.nnn.nnn/mm
# nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
# </pre><p>
# The host and domain address require that you enable hostname lookups
# with "HostNameLookups On" above.</p>
@@
%%allowdeny
# <b>ACL addresses (Allow/Deny)</b>
# <p>
# Allows/Denies access from the specified hostname, domain, IP address, or
# network. Possible values are:</p>
# <pre>
# All
# None
# *.domain.com
# .domain.com
# host.domain.com
# nnn.*
# nnn.nnn.*
# nnn.nnn.nnn.*
# nnn.nnn.nnn.nnn
# nnn.nnn.nnn.nnn/mm
# nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
# </pre><p>
# The host and domain address require that you enable hostname lookups
# with "HostNameLookups On" above.</p>
@@
%%encryption
# <b>Encryption (Encryption)</b>
# <p>
# Whether or not to use encryption; this depends on having
# the OpenSSL library linked into the CUPS library and scheduler.</p>
# <p>
# Possible values:</p>
# <ul type=circle>
# <li><i>Always</i> - Always use encryption (SSL)</li>
# <li><i>Never</i> - Never use encryption</li>
# <li><i>Required</i> - Use TLS encryption upgrade</li>
# <li><i>IfRequested</i> - Use encryption if the server requests it</li>
# </ul><p>
# The default value is "IfRequested".</p>
@@
%%locationsshort
# <b>Access permissions</b>
# <p>
# Access permissions for each directory served by the scheduler.
# Locations are relative to DocumentRoot...</p>
@@
%%autopurgejobs
# <b>Auto purge jobs (AutoPurgeJobs)</b>
# <p>
# Automatically purge jobs when not needed for quotas.
# Default is No.</p>
$$
#AutoPurgeJobs No
@@
%%browseprotocols
# <b>Browse protocols (BrowseProtocols)</b>
# <p>
# Which protocols to use for browsing. Can be
# any of the following separated by whitespace and/or commas:</p>
# <ul type=circle>
# <li><i>all</i> - Use all supported protocols.</li>
# <li><i>cups</i> - Use the CUPS browse protocol.</li>
# <li><i>slp</i> - Use the SLPv2 protocol.</li>
# </ul><p>
# The default is <b>cups</b>.</p>
# <p>
# Note: If you choose to use SLPv2, it is <b>strongly</b> recommended that
# you have at least one SLP Directory Agent (DA) on your
# network. Otherwise, browse updates can take several seconds,
# during which the scheduler will not response to client
# requests.</p>
$$
#BrowseProtocols cups
@@
%%classification
# <b>Classification (Classification)</b>
# <p>
# The classification level of the server. If set, this
# classification is displayed on all pages, and raw printing is disabled.
# The default is the empty string.</p>
# <p>
# <i>ex</i>: confidential
$$
#Classification classified
@@
%%classifyoverride
# <b>Allow overrides (ClassifyOverride)</b>
# <p>
# Whether to allow users to override the classification
# on printouts. If enabled, users can limit banner pages to before or
# after the job, and can change the classification of a job, but cannot
# completely eliminate the classification or banners.</p>
# <p>
# The default is off.</p>
$$
#ClassifyOverride off
@@
%%hideimplicitmembers
# <b>Hide implicit members (HideImplicitMembers)</b>
# <p>
# Whether or not to show the members of an
# implicit class.</p>
# <p>
# When HideImplicitMembers is On, any remote printers that are
# part of an implicit class are hidden from the user, who will
# then only see a single queue even though many queues will be
# supporting the implicit class.</p>
# <p>
# Enabled by default.</p>
$$
#HideImplicitMembers On
@@
%%implicitanyclasses
# <b>Use "any" classes (ImplicitAnyClasses)</b>
# <p>
# Whether or not to create <b>AnyPrinter</b> implicit
# classes.</p>
# <p>
# When ImplicitAnyClasses is On and a local queue of the same name
# exists, e.g. "printer", "printer@server1", "printer@server1", then
# an implicit class called "Anyprinter" is created instead.</p>
# <p>
# When ImplicitAnyClasses is Off, implicit classes are not created
# when there is a local queue of the same name.</p>
# <p>
# Disabled by default.</p>
$$
#ImplicitAnyCLasses Off
@@
%%maxjobs
# <b>Max jobs (MaxJobs)</b>
# <p>
# Maximum number of jobs to keep in memory (active and completed).
# Default is 0 (no limit).</p>
$$
#MaxJobs 0
@@
%%maxjobsperuser
# <b>Max jobs per user (MaxJobsPerUser)</b>
# <p>
# The MaxJobsPerUser directive controls the maximum number of <i>active</i>
# jobs that are allowed for each user. Once a user reaches the limit, new
# jobs will be rejected until one of the active jobs is completed, stopped,
# aborted, or canceled.</p>
# <p>
# Setting the maximum to 0 disables this functionality.
# Default is 0 (no limit).
# </p>
$$
#MaxJobsPerUser 0
@@
%%maxjobsperprinter
# <b>Max jobs per printer (MaxJobsPerPrinter)</b>
# <p>
# The MaxJobsPerPrinter directive controls the maximum number of <i>active</i>
# jobs that are allowed for each printer or class. Once a printer or class
# reaches the limit, new jobs will be rejected until one of the active jobs
# is completed, stopped, aborted, or canceled.</p>
# <p>
# Setting the maximum to 0 disables this functionality.
# Default is 0 (no limit).
# </p>
$$
#MaxJobsPerPrinter 0
@@
%%port
# <b>Port</b>
# <p>
# The port value that the CUPS daemon is listening to. Default is 631.</p>
@@
%%address
# <b>Address</b>
# <p>
# The address that the CUPS daemon is listening at. Leave it empty or use
# an asterisk (*) to specify a port value on the entire subnetwork.</p>
@@
%%usessl
# <p>Check this box if you want to use SSL encryption with this address/port.
# </p>
@@
|