man/cupsd.conf.man.in

   1 .\"
   2 .\" "$Id: cupsd.conf.man.in 5099 2006-02-13 02:46:10Z mike $"
   3 .\"
   4 .\"   cupsd.conf man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2006 by Easy Software Products.
   7 .\"
   8 .\"   These coded instructions, statements, and computer programs are the
   9 .\"   property of Easy Software Products and are protected by Federal
  10 .\"   copyright law.  Distribution and use rights are outlined in the file
  11 .\"   "LICENSE.txt" which should have been included with this file.  If this
  12 .\"   file is missing or damaged please contact Easy Software Products
  13 .\"   at:
  14 .\"
  15 .\"       Attn: CUPS Licensing Information
  16 .\"       Easy Software Products
  17 .\"       44141 Airport View Drive, Suite 204
  18 .\"       Hollywood, Maryland 20636 USA
  19 .\"
  20 .\"       Voice: (301) 373-9600
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH cupsd.conf 5 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
  25 .SH NAME
  26 cupsd.conf \- server configuration file for cups
  27 .SH DESCRIPTION
  28 The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR.  It
  29 is normally located in the \fI@CUPS_SERVERROOT@\fR directory.
  30 .LP
  31 Each line in the file can be a configuration directive, a blank line,
  32 or a comment. Comment lines start with the # character. The
  33 configuration directives are intentionally similar to those used by the
  34 popular Apache web server software and are described below.
  35 .SH DIRECTIVES
  36 The following directives are understood by \fIcupsd(8)\fR. Consult the
  37 on-line help for detailed descriptions:
  38 .TP 5
  39 AccessLog filename
  40 .TP 5
  41 AccessLog syslog
  42 .br
  43 Defines the access log filename.
  44 .TP 5
  45 Allow all
  46 .TP 5
  47 Allow none
  48 .TP 5
  49 Allow host.domain.com
  50 .TP 5
  51 Allow *.domain.com
  52 .TP 5
  53 Allow ip-address
  54 .TP 5
  55 Allow ip-address/netmask
  56 .TP 5
  57 Allow ip-address/mm
  58 .TP 5
  59 Allow @IF(name)
  60 .TP 5
  61 Allow @LOCAL
  62 .br
  63 Allows access from the named hosts or addresses.
  64 .TP 5
  65 AuthClass User
  66 .TP 5
  67 AuthClass Group
  68 .TP 5
  69 AuthClass System
  70 .br
  71 Specifies the authentication class (User, Group, System) -
  72 \fBthis directive is deprecated\fR.
  73 .TP 5
  74 AuthGroupName group-name
  75 .br
  76 Specifies the authentication group - \fBthis directive is
  77 deprecated\fR.
  78 .TP 5
  79 AuthType None
  80 .TP 5
  81 AuthType Basic
  82 .TP 5
  83 AuthType BasicDigest
  84 .TP 5
  85 AuthType Digest
  86 .br
  87 Specifies the authentication type (None, Basic, BasicDigest, Digest)
  88 .TP 5
  89 AutoPurgeJobs Yes
  90 .TP 5
  91 AutoPurgeJobs No
  92 .br
  93 Specifies whether to purge job history data automatically when
  94 it is no longer required for quotas.
  95 .TP 5
  96 BrowseAddress ip-address
  97 .TP 5
  98 BrowseAddress @IF(name)
  99 .TP 5
 100 BrowseAddress @LOCAL
 101 .br
 102 Specifies a broadcast address for outgoing printer information packets.
 103 .TP 5
 104 BrowseAllow all
 105 .TP 5
 106 BrowseAllow none
 107 .TP 5
 108 BrowseAllow host.domain.com
 109 .TP 5
 110 BrowseAllow *.domain.com
 111 .TP 5
 112 BrowseAllow ip-address
 113 .TP 5
 114 BrowseAllow ip-address/netmask
 115 .TP 5
 116 BrowseAllow ip-address/mm
 117 .TP 5
 118 BrowseAllow @IF(name)
 119 .TP 5
 120 BrowseAllow @LOCAL
 121 .br
 122 Allows incoming printer information packets from the named host or address.
 123 .TP 5
 124 BrowseDeny all
 125 .TP 5
 126 BrowseDeny none
 127 .TP 5
 128 BrowseDeny host.domain.com
 129 .TP 5
 130 BrowseDeny *.domain.com
 131 .TP 5
 132 BrowseDeny ip-address
 133 .TP 5
 134 BrowseDeny ip-address/netmask
 135 .TP 5
 136 BrowseDeny ip-address/mm
 137 .TP 5
 138 BrowseDeny @IF(name)
 139 .TP 5
 140 BrowseDeny @LOCAL
 141 .br
 142 Denies incoming printer information packets from the named host or address.
 143 .TP 5
 144 BrowseInterval seconds
 145 .br
 146 Specifies the maximum interval between printer information broadcasts.
 147 .TP 5
 148 BrowseOrder allow,deny
 149 .TP 5
 150 BrowseOrder deny,allow
 151 .br
 152 Specifies the order of printer information access control (allow,deny or deny,allow)
 153 .TP 5
 154 BrowsePoll host-or-ip-address
 155 .br
 156 Specifies a server to poll for printer information.
 157 .TP 5
 158 BrowsePort port
 159 .br
 160 Specifies the port to listen to for printer information packets.
 161 .TP 5
 162 BrowseProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
 163 .br
 164 Specifies the protocols to use for printer browsing.
 165 .TP 5
 166 BrowseLocalProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
 167 .br
 168 Specifies the protocols to use for local printer browsing.
 169 .TP 5
 170 BrowseRemoteProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
 171 .br
 172 Specifies the protocols to use for remote printer browsing.
 173 .TP 5
 174 BrowseRelay from-address to-address
 175 .br
 176 Specifies that printer information packets should be relayed from one host or
 177 network to another.
 178 .TP 5
 179 BrowseShortNames Yes
 180 .TP 5
 181 BrowseShortNames No
 182 .br
 183 Specifies whether remote printers will use short names ("printer") or not
 184 ("printer@server"). This option is ignored if more than one remote printer
 185 exists with the same name.
 186 .TP 5
 187 BrowseTimeout seconds
 188 .br
 189 Specifies the maximum interval between printer information updates before
 190 remote printers will be removed from the list of available printers.
 191 .TP 5
 192 Browsing Yes
 193 .TP 5
 194 Browsing No
 195 .br
 196 Specifies whether or not remote printer browsing should be enabled.
 197 .TP 5
 198 Classification banner
 199 .br
 200 Specifies the security classification of the server.
 201 .TP 5
 202 ClassifyOverride Yes
 203 .TP 5
 204 ClassifyOverride No
 205 .br
 206 Specifies whether to allow users to override the classification
 207 of individual print jobs.
 208 .TP 5
 209 ConfigFilePerm mode
 210 .br
 211 Specifies the permissions for all configuration files that the scheduler
 212 writes.
 213 .TP 5
 214 DataDir path
 215 .br
 216 Specified the directory where data files can be found.
 217 .TP 5
 218 DefaultAuthType Basic
 219 .TP 5
 220 DefaultAuthType BasicDigest
 221 .TP 5
 222 DefaultAuthType Digest
 223 .br
 224 Specifies the default type of authentication to use.
 225 .TP 5
 226 DefaultCharset charset
 227 .br
 228 Specifies the default character set to use for text.
 229 .TP 5
 230 DefaultLanguage locale
 231 .br
 232 Specifies the default language to use for text and web content.
 233 .TP 5
 234 DefaultPolicy policy-name
 235 .br
 236 Specifies the default access policy to use.
 237 .TP 5
 238 Deny all
 239 .TP 5
 240 Deny none
 241 .TP 5
 242 Deny host.domain.com
 243 .TP 5
 244 Deny *.domain.com
 245 .TP 5
 246 Deny ip-address
 247 .TP 5
 248 Deny ip-address/netmask
 249 .TP 5
 250 Deny ip-address/mm
 251 .TP 5
 252 Deny @IF(name)
 253 .TP 5
 254 Deny @LOCAL
 255 .br
 256 Denies access to the named host or address.
 257 .TP 5
 258 DocumentRoot directory
 259 .br
 260 Specifies the root directory for the internal web server documents.
 261 .TP 5
 262 Encryption IfRequested
 263 .TP 5
 264 Encryption Never
 265 .TP 5
 266 Encryption Required
 267 .br
 268 Specifies the level of encryption that is required for a particular
 269 location.
 270 .TP 5
 271 ErrorLog filename
 272 .TP 5
 273 ErrorLog syslog
 274 .br
 275 Specifies the error log filename.
 276 .TP 5
 277 FileDevice Yes
 278 .TP 5
 279 FileDevice No
 280 .br
 281 Specifies whether the file pseudo-device can be used for new
 282 printer queues.
 283 .TP 5
 284 FilterLimit limit
 285 .br
 286 Specifies the maximum cost of filters that are run concurrently.
 287 .TP 5
 288 FilterNice nice-value
 289 .br
 290 Specifies the scheduling priority ("nice" value) of filters that
 291 are run to print a job.
 292 .TP 5
 293 FontPath directory[:directory:...]
 294 .br
 295 Specifies the search path for fonts.
 296 .TP 5
 297 Group group-name-or-number
 298 .br
 299 Specifies the group name or ID that will be used when executing
 300 external programs.
 301 .TP 5
 302 HideImplicitMembers Yes
 303 .TP 5
 304 HideImplicitMembers No
 305 .br
 306 Specifies whether to hide members of implicit classes.
 307 .TP 5
 308 HostNameLookups Yes
 309 .TP 5
 310 HostNameLookups No
 311 .TP 5
 312 HostNameLookups Double
 313 .br
 314 Specifies whether or not to do reverse lookups on client addresses.
 315 .TP 5
 316 ImplicitAnyClasses Yes
 317 .TP 5
 318 ImplicitAnyClasses No
 319 .br
 320 Specifies whether or not to create implicit classes for local and
 321 remote printers, e.g. "AnyPrinter" from "Printer", "Printer@server1",
 322 and "Printer@server2".
 323 .TP 5
 324 ImplicitClasses Yes
 325 .TP 5
 326 ImplicitClasses No
 327 .br
 328 Specifies whether or not to create implicit classes from identical
 329 remote printers.
 330 .TP 5
 331 Include filename
 332 .br
 333 Includes the named file.
 334 .TP 5
 335 KeepAlive Yes
 336 .TP 5
 337 KeepAlive No
 338 .br
 339 Specifies whether to support HTTP keep-alive connections.
 340 .TP 5
 341 KeepAliveTimeout seconds
 342 .br
 343 Specifies the amount of time that connections are kept alive.
 344 .TP 5
 345 JobRetryInterval seconds
 346 .br
 347 Specifies the interval between retries of jobs in seconds.
 348 .TP 5
 349 JobRetryLimit count
 350 .br
 351 Specifies the number of retries that are done for jobs.
 352 .TP 5
 353 KeepAlive
 354 .br
 355 Specifies whether or not to support HTTP Keep-Alive.
 356 .TP 5
 357 KeepAliveTimeout
 358 .br
 359 Specifies the connection timeout for HTTP Keep-Alive.
 360 .TP 5
 361 <Limit operations> ... </Limit>
 362 .br
 363 Specifies the IPP operations that are being limited inside a policy.
 364 .TP 5
 365 <Limit methods> ... </Limit>
 366 .TP 5
 367 <LimitExcept methods> ... </LimitExcept>
 368 .br
 369 Specifies the HTTP methods that are being limited inside a location.
 370 .TP 5
 371 LimitRequestBody
 372 .br
 373 Specifies the maximum size of any print job request.
 374 .TP 5
 375 Listen ip-address:port
 376 .TP 5
 377 Listen *:port
 378 .br
 379 Listens to the specified address and port.
 380 .TP 5
 381 <Location /path> ... </Location>
 382 .br
 383 Specifies access control for the named location.
 384 .TP 5
 385 LogFilePerm mode
 386 .br
 387 Specifies the permissions for all log files that the scheduler writes.
 388 .TP 5
 389 LogLevel alert
 390 .TP 5
 391 LogLevel crit
 392 .TP 5
 393 LogLevel debug2
 394 .TP 5
 395 LogLevel debug
 396 .TP 5
 397 LogLevel emerg
 398 .TP 5
 399 LogLevel error
 400 .TP 5
 401 LogLevel info
 402 .TP 5
 403 LogLevel none
 404 .TP 5
 405 LogLevel notice
 406 .TP 5
 407 LogLevel warn
 408 .br
 409 Specifies the logging level for the ErrorLog file.
 410 .TP 5
 411 MaxClients number
 412 .br
 413 Specifies the maximum number of simultaneous clients to support.
 414 .TP 5
 415 MaxClientsPerHost number
 416 .br
 417 Specifies the maximum number of simultaneous clients to support from a
 418 single address.
 419 .TP 5
 420 MaxCopies number
 421 .br
 422 Specifies the maximum number of copies that a user can print of each job.
 423 .TP 5
 424 MaxJobs number
 425 .br
 426 Specifies the maximum number of simultaneous jobs to support.
 427 .TP 5
 428 MaxJobsPerPrinter number
 429 .br
 430 Specifies the maximum number of simultaneous jobs per printer to support.
 431 .TP 5
 432 MaxJobsPerUser number
 433 .br
 434 Specifies the maximum number of simultaneous jobs per user to support.
 435 .TP 5
 436 MaxLogSize number-bytes
 437 .br
 438 Specifies the maximum size of the log files before they are
 439 rotated (0 to disable rotation)
 440 .TP 5
 441 MaxRequestSize number-bytes
 442 .br
 443 Specifies the maximum request/file size in bytes (0 for no limit)
 444 .TP 5
 445 Order allow,deny
 446 .TP 5
 447 Order deny,allow
 448 .br
 449 Specifies the order of HTTP access control (allow,deny or deny,allow)
 450 .TP 5
 451 PageLog filename
 452 .TP 5
 453 PageLog syslog
 454 .br
 455 Specifies the page log filename.
 456 .TP 5
 457 PassEnv variable [... variable]
 458 .br
 459 Passes the specified environment variable(s) to child processes.
 460 .TP 5
 461 <Policy name> ... </Policy>
 462 .br
 463 Specifies access control for the named policy.
 464 .TP 5
 465 Port number
 466 .br
 467 Specifies a port number to listen to for HTTP requests.
 468 .TP 5
 469 PreserveJobFiles Yes
 470 .TP 5
 471 PreserveJobFiles No
 472 .br
 473 Specifies whether or not to preserve job files after they are printed.
 474 .TP 5
 475 PreserveJobHistory Yes
 476 .TP 5
 477 PreserveJobHistory No
 478 .br
 479 Specifies whether or not to preserve the job history after they are
 480 printed.
 481 .TP 5
 482 Printcap
 483 .TP 5
 484 Printcap filename
 485 .br
 486 Specifies the filename for a printcap file that is updated
 487 automatically with a list of available printers (needed for
 488 legacy applications); specifying Printcap with no filename
 489 disables printcap generation.
 490 .TP 5
 491 PrintcapFormat bsd
 492 .TP 5
 493 PrintcapFormat solaris
 494 .br
 495 Specifies the format of the printcap file.
 496 .TP 5
 497 PrintcapGUI
 498 .TP 5
 499 PrintcapGUI gui-program-filename
 500 .br
 501 Specifies whether to generate option panel definition files on
 502 some operating systems. When provided with no program filename,
 503 disables option panel definition files.
 504 .TP 5
 505 ReloadTimeout seconds
 506 .br
 507 Specifies the amount of time to wait for job completion before
 508 restarting the scheduler.
 509 .TP 5
 510 RemoteRoot user-name
 511 .br
 512 Specifies the username that is associated with unauthenticated root
 513 accesses.
 514 .TP 5
 515 RequestRoot directory
 516 .br
 517 Specifies the directory to store print jobs and other HTTP request
 518 data.
 519 .TP 5
 520 Require group group-name-list
 521 .TP 5
 522 Require user user-name-list
 523 .TP 5
 524 Require valid-user
 525 .br
 526 Specifies that user or group authentication is required.
 527 .TP 5
 528 RIPCache bytes
 529 .br
 530 Specifies the maximum amount of memory to use when converting images
 531 and PostScript files to bitmaps for a printer.
 532 .TP 5
 533 Satisfy all
 534 .TP 5
 535 Satisfy any
 536 .br
 537 Specifies whether all or any limits set for a Location must be
 538 satisfied to allow access.
 539 .TP 5
 540 ServerAdmin user@domain.com
 541 .br
 542 Specifies the email address of the server administrator.
 543 .TP 5
 544 ServerBin directory
 545 .br
 546 Specifies the directory where backends, CGIs, daemons, and filters may
 547 be found.
 548 .TP 5
 549 ServerCertificate filename
 550 .br
 551 Specifies the encryption certificate to use.
 552 .TP 5
 553 ServerKey filename
 554 .br
 555 Specifies the encryption key to use.
 556 .TP 5
 557 ServerName hostname-or-ip-address
 558 .br
 559 Specifies the fully-qualified hostname of the server.
 560 .TP 5
 561 ServerRoot directory
 562 .br
 563 Specifies the directory where the server configuration files can be found.
 564 .TP 5
 565 ServerTokens Full
 566 .TP 5
 567 ServerTokens Major
 568 .TP 5
 569 ServerTokens Minimal
 570 .TP 5
 571 ServerTokens Minor
 572 .TP 5
 573 ServerTokens None
 574 .TP 5
 575 ServerTokens OS
 576 .TP 5
 577 ServerTokens ProductOnly
 578 .br
 579 Specifies what information is included in the Server header of HTTP
 580 responses.
 581 .TP 5
 582 SetEnv variable value
 583 .br
 584 Set the specified environment variable to be passed to child processes.
 585 .TP 5
 586 SSLListen
 587 .br
 588 Listens on the specified address and port for encrypted connections.
 589 .TP 5
 590 SSLPort
 591 .br
 592 Listens on the specified port for encrypted connections.
 593 .TP 5
 594 SystemGroup group-name [group-name ...]
 595 .br
 596 Specifies the group(s) to use for System class authentication.
 597 .TP 5
 598 TempDir directory
 599 .br
 600 Specifies the directory where temporary files are stored.
 601 .TP 5
 602 Timeout seconds
 603 .br
 604 Specifies the HTTP request timeout in seconds.
 605 .TP 5
 606 User user-name
 607 .br
 608 Specifies the user name or ID that is used when running external programs.
 609 .SH SEE ALSO
 610 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fImime.convs(5)\fR,
 611 \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
 612 \fIsubscriptions.conf(5)\fR,
 613 .br
 614 http://localhost:631/help
 615 .SH COPYRIGHT
 616 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
 617 .\"
 618 .\" End of "$Id: cupsd.conf.man.in 5099 2006-02-13 02:46:10Z mike $".
 619 .\"