← Back to branch summary

~ubuntu-branches/ubuntu/precise/cups/precise-security

« back to all changes in this revision

Viewing changes to man/cupsd.conf.man.in

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2012-12-03 09:05:49 UTC
  • mfrom: (97.1.4 precise-proposed)
  • Revision ID: package-import@ubuntu.com-20121203090549-z6f07kt2atlpxjpa
Tags: 1.5.3-0ubuntu5.1
* SECURITY UPDATE: privilege escalation via config file editing
  - debian/patches/CVE-2012-5519.patch: split configuration file into
    two, to isolate options that have a security impact.
  - debian/cups.install: also install cups-files.conf
  - debian/patches/removecvstag.patch: updated to remove tag from
    cups-files.conf.
  - CVE-2012-5519
* debian/control: remove libtiff5-dev alternate build-depends so this
  package can build in a schroot.
* NOTE: this package does _not_ include the changes from 1.5.3-0ubuntu5
  in precise-proposed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/cupsd.conf.man.in
17
17
cupsd.conf \- server configuration file for cups
18
18
.SH DESCRIPTION
19
19
The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR.  It
20
 
is normally located in the \fI@CUPS_SERVERROOT@\fR directory.
 
20
is normally located in the \fI@CUPS_SERVERROOT@\fR directory. \fBNote:\fR
 
21
File, directory, and user configuration directives that used to be allowed in
 
22
the \fIcupsd.conf\fR file are now stored in the \fIcups-files.conf(5)\fR instead
 
23
in order to prevent certain types of privilege escalation attacks.
21
24
.LP
22
25
Each line in the file can be a configuration directive, a blank line,
23
26
or a comment. Comment lines start with the # character. The
27
30
The following directives are understood by \fIcupsd(8)\fR. Consult the
28
31
on-line help for detailed descriptions:
29
32
.TP 5
30
 
AccessLog filename
31
 
.TP 5
32
 
AccessLog syslog
33
 
.br
34
 
Defines the access log filename.
35
 
.TP 5
36
33
AccessLogLevel config
37
34
.TP 5
38
35
AccessLogLevel actions
61
58
.br
62
59
Allows access from the named hosts or addresses.
63
60
.TP 5
64
 
AuthClass User
65
 
.TP 5
66
 
AuthClass Group
67
 
.TP 5
68
 
AuthClass System
69
 
.br
70
 
Specifies the authentication class (User, Group, System) -
71
 
\fBthis directive is deprecated\fR.
72
 
.TP 5
73
 
AuthGroupName group-name
74
 
.br
75
 
Specifies the authentication group - \fBthis directive is
76
 
deprecated\fR.
77
 
.TP 5
78
61
AuthType None
79
62
.TP 5
80
63
AuthType Basic
220
203
.TP 5
221
204
Browsing No
222
205
.br
223
 
Specifies whether or not remote printer browsing should be enabled.
 
206
Specifies whether or not shared printers should be advertised.
224
207
.TP 5
225
208
Classification banner
226
209
.br
233
216
Specifies whether to allow users to override the classification
234
217
of individual print jobs.
235
218
.TP 5
236
 
ConfigFilePerm mode
237
 
.br
238
 
Specifies the permissions for all configuration files that the scheduler
239
 
writes.
240
 
.TP 5
241
 
DataDir path
242
 
.br
243
 
Specified the directory where data files can be found.
244
 
.TP 5
245
219
DefaultAuthType Basic
246
220
.TP 5
247
221
DefaultAuthType BasicDigest
309
283
causes the update to happen as soon as possible, typically within a few
310
284
milliseconds.
311
285
.TP 5
312
 
DocumentRoot directory
313
 
.br
314
 
Specifies the root directory for the internal web server documents.
315
 
.TP 5
316
286
Encryption IfRequested
317
287
.TP 5
318
288
Encryption Never
322
292
Specifies the level of encryption that is required for a particular
323
293
location.
324
294
.TP 5
325
 
ErrorLog filename
326
 
.TP 5
327
 
ErrorLog syslog
328
 
.br
329
 
Specifies the error log filename.
330
 
.TP 5
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
340
 
FileDevice Yes
341
 
.TP 5
342
 
FileDevice No
343
 
.br
344
 
Specifies whether the file pseudo-device can be used for new
345
 
printer queues.
346
 
.TP 5
347
295
FilterLimit limit
348
296
.br
349
297
Specifies the maximum cost of filters that are run concurrently.
353
301
Specifies the scheduling priority ("nice" value) of filters that
354
302
are run to print a job.
355
303
.TP 5
356
 
FontPath directory[:directory:...]
357
 
.br
358
 
Specifies the search path for fonts.
359
 
.TP 5
360
 
Group group-name-or-number
361
 
.br
362
 
Specifies the group name or ID that will be used when executing
363
 
external programs.
364
 
.TP 5
365
304
HideImplicitMembers Yes
366
305
.TP 5
367
306
HideImplicitMembers No
469
408
Specifies the number of debugging messages that are logged when an error
470
409
occurs in a print job.
471
410
.TP 5
472
 
LogFilePerm mode
473
 
.br
474
 
Specifies the permissions for all log files that the scheduler writes.
475
 
.TP 5
476
411
LogLevel alert
477
412
.TP 5
478
413
LogLevel crit
546
481
.br
547
482
Specifies the order of HTTP access control (allow,deny or deny,allow)
548
483
.TP 5
549
 
PageLog filename
550
 
.TP 5
551
 
PageLog syslog
552
 
.br
553
 
Specifies the page log filename.
554
 
.TP 5
555
484
PageLogFormat format string
556
485
.br
557
486
Specifies the format of page log lines.
581
510
Specifies whether or not to preserve the job history after they are
582
511
printed.
583
512
.TP 5
584
 
Printcap
585
 
.TP 5
586
 
Printcap filename
587
 
.br
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
513
PrintcapFormat bsd
594
514
.TP 5
595
515
PrintcapFormat plist
598
518
.br
599
519
Specifies the format of the printcap file.
600
520
.TP 5
601
 
PrintcapGUI
602
 
.TP 5
603
 
PrintcapGUI gui-program-filename
604
 
.br
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.
608
 
.TP 5
609
521
ReloadTimeout seconds
610
522
.br
611
523
Specifies the amount of time to wait for job completion before
612
524
restarting the scheduler.
613
525
.TP 5
614
 
RemoteRoot user-name
615
 
.br
616
 
Specifies the username that is associated with unauthenticated root
617
 
accesses.
618
 
.TP 5
619
 
RequestRoot directory
620
 
.br
621
 
Specifies the directory to store print jobs and other HTTP request
622
 
data.
623
 
.TP 5
624
526
Require group group-name-list
625
527
.TP 5
626
528
Require user user-name-list
652
554
Specifies an alternate name that the server is known by. The special name "*"
653
555
allows any name to be used.
654
556
.TP 5
655
 
ServerBin directory
656
 
.br
657
 
Specifies the directory where backends, CGIs, daemons, and filters may
658
 
be found.
659
 
.TP 5
660
 
ServerCertificate filename
661
 
.br
662
 
Specifies the encryption certificate to use.
663
 
.TP 5
664
 
ServerKey filename
665
 
.br
666
 
Specifies the encryption key to use.
667
 
.TP 5
668
557
ServerName hostname-or-ip-address
669
558
.br
670
559
Specifies the fully-qualified hostname of the server.
671
560
.TP 5
672
 
ServerRoot directory
673
 
.br
674
 
Specifies the directory where the server configuration files can be found.
675
 
.TP 5
676
561
ServerTokens Full
677
562
.TP 5
678
563
ServerTokens Major
729
614
"notify-events", "notify-pull-method", "notify-recipient-uri",
730
615
"notify-subscriber-user-name", and "notify-user-data".
731
616
.TP 5
732
 
SystemGroup group-name [group-name ...]
733
 
.br
734
 
Specifies the group(s) to use for System class authentication.
735
 
.TP 5
736
 
TempDir directory
737
 
.br
738
 
Specifies the directory where temporary files are stored.
739
 
.TP 5
740
617
Timeout seconds
741
618
.br
742
619
Specifies the HTTP request timeout in seconds.
743
620
.TP 5
744
 
User user-name
745
 
.br
746
 
Specifies the user name or ID that is used when running external programs.
747
 
.TP 5
748
621
WebInterface yes
749
622
.TP 5
750
623
WebInterface no
751
624
Specifies whether the web interface is enabled.
752
625
.SH SEE ALSO
753
 
\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fImime.convs(5)\fR,
754
 
\fImime.types(5)\fR, \fIprinters.conf(5)\fR,
 
626
\fIclasses.conf(5)\fR, \fIcups-files.conf(5)\fR, \fIcupsd(8)\fR,
 
627
\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
755
628
\fIsubscriptions.conf(5)\fR,
756
629
.br
757
630
http://localhost:631/help