2 .\" "$Id: cupsd.conf.man.in 7645 2008-06-16 17:21:10Z mike $"
4 .\" cupsd.conf man page for the Common UNIX Printing System (CUPS).
6 .\" Copyright 2007-2008 by Apple Inc.
7 .\" Copyright 1997-2006 by Easy Software Products.
9 .\" These coded instructions, statements, and computer programs are the
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/".
15 .TH cupsd.conf 5 "Common UNIX Printing System" "16 June 2008" "Apple Inc."
17 cupsd.conf \- server configuration file for cups
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.
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.
27 The following directives are understood by \fIcupsd(8)\fR. Consult the
28 on-line help for detailed descriptions:
34 Defines the access log filename.
38 AccessLogLevel actions
42 Specifies the logging level for the AccessLog file.
54 Allow ip-address/netmask
62 Allows access from the named hosts or addresses.
70 Specifies the authentication class (User, Group, System) -
71 \fBthis directive is deprecated\fR.
73 AuthGroupName group-name
75 Specifies the authentication group - \fBthis directive is
88 Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
94 Specifies whether to purge job history data automatically when
95 it is no longer required for quotas.
97 BrowseAddress ip-address
99 BrowseAddress @IF(name)
103 Specifies a broadcast address for outgoing printer information packets.
109 BrowseAllow host.domain.com
111 BrowseAllow *.domain.com
113 BrowseAllow ip-address
115 BrowseAllow ip-address/netmask
117 BrowseAllow ip-address/mm
119 BrowseAllow @IF(name)
123 Allows incoming printer information packets from the named host or address.
129 BrowseDeny host.domain.com
131 BrowseDeny *.domain.com
133 BrowseDeny ip-address
135 BrowseDeny ip-address/netmask
137 BrowseDeny ip-address/mm
143 Denies incoming printer information packets from the named host or address.
145 BrowseInterval seconds
147 Specifies the maximum interval between printer information broadcasts.
149 BrowseOrder allow,deny
151 BrowseOrder deny,allow
153 Specifies the order of printer information access control (allow,deny or deny,allow)
155 BrowsePoll host-or-ip-address
157 Specifies a server to poll for printer information.
161 Specifies the port to listen to for printer information packets.
163 BrowseProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
165 Specifies the protocols to use for printer browsing.
167 BrowseLocalProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
169 Specifies the protocols to use for local printer browsing.
171 BrowseRemoteProtocols [All] [CUPS] [DNSSD] [LDAP] [SLP]
173 Specifies the protocols to use for remote printer browsing.
175 BrowseRelay from-address to-address
177 Specifies that printer information packets should be relayed from one host or
184 Specifies whether remote printers will use short names ("printer") or not
185 ("printer@server"). This option is ignored if more than one remote printer
186 exists with the same name.
188 BrowseTimeout seconds
190 Specifies the maximum interval between printer information updates before
191 remote printers will be removed from the list of available printers.
197 Specifies whether or not remote printer browsing should be enabled.
199 Classification banner
201 Specifies the security classification of the server.
207 Specifies whether to allow users to override the classification
208 of individual print jobs.
212 Specifies the permissions for all configuration files that the scheduler
217 Specified the directory where data files can be found.
219 DefaultAuthType Basic
221 DefaultAuthType BasicDigest
223 DefaultAuthType Digest
225 DefaultAuthType Negotiate
227 Specifies the default type of authentication to use.
229 DefaultCharset charset
231 Specifies the default character set to use for text.
233 DefaultLanguage locale
235 Specifies the default language to use for text and web content.
237 DefaultPolicy policy-name
239 Specifies the default access policy to use.
245 Specifies whether local printers are shared by default.
257 Deny ip-address/netmask
265 Denies access to the named host or address.
267 DocumentRoot directory
269 Specifies the root directory for the internal web server documents.
271 Encryption IfRequested
277 Specifies the level of encryption that is required for a particular
284 Specifies the error log filename.
290 Specifies whether the file pseudo-device can be used for new
295 Specifies the maximum cost of filters that are run concurrently.
297 FilterNice nice-value
299 Specifies the scheduling priority ("nice" value) of filters that
300 are run to print a job.
302 FontPath directory[:directory:...]
304 Specifies the search path for fonts.
306 Group group-name-or-number
308 Specifies the group name or ID that will be used when executing
311 HideImplicitMembers Yes
313 HideImplicitMembers No
315 Specifies whether to hide members of implicit classes.
321 HostNameLookups Double
323 Specifies whether or not to do reverse lookups on client addresses.
325 ImplicitAnyClasses Yes
327 ImplicitAnyClasses No
329 Specifies whether or not to create implicit classes for local and
330 remote printers, e.g. "AnyPrinter" from "Printer", "Printer@server1",
331 and "Printer@server2".
337 Specifies whether or not to create implicit classes from identical
342 Includes the named file.
344 JobRetryInterval seconds
346 Specifies the interval between retries of jobs in seconds.
350 Specifies the number of retries that are done for jobs.
356 Specifies whether to support HTTP keep-alive connections.
358 KeepAliveTimeout seconds
360 Specifies the amount of time that connections are kept alive.
364 Overrides the Kerberos key tab location.
366 <Limit operations> ... </Limit>
368 Specifies the IPP operations that are being limited inside a policy.
370 <Limit methods> ... </Limit>
372 <LimitExcept methods> ... </LimitExcept>
374 Specifies the HTTP methods that are being limited inside a location.
378 Specifies the maximum size of any print job request.
380 Listen ip-address:port
384 Listen /path/to/domain/socket
386 Listens to the specified address and port or domain socket path.
388 <Location /path> ... </Location>
390 Specifies access control for the named location.
394 Specifies the permissions for all log files that the scheduler writes.
416 Specifies the logging level for the ErrorLog file.
420 Specifies the maximum number of simultaneous clients to support.
422 MaxClientsPerHost number
424 Specifies the maximum number of simultaneous clients to support from a
429 Specifies the maximum number of copies that a user can print of each job.
433 Specifies the maximum number of simultaneous jobs to support.
435 MaxJobsPerPrinter number
437 Specifies the maximum number of simultaneous jobs per printer to support.
439 MaxJobsPerUser number
441 Specifies the maximum number of simultaneous jobs per user to support.
443 MaxLogSize number-bytes
445 Specifies the maximum size of the log files before they are
446 rotated (0 to disable rotation)
448 MaxRequestSize number-bytes
450 Specifies the maximum request/file size in bytes (0 for no limit)
456 Specifies the order of HTTP access control (allow,deny or deny,allow)
462 Specifies the page log filename.
464 PageLogFormat format string
466 Specifies the format of page log lines.
468 PassEnv variable [... variable]
470 Passes the specified environment variable(s) to child processes.
472 <Policy name> ... </Policy>
474 Specifies access control for the named policy.
478 Specifies a port number to listen to for HTTP requests.
484 Specifies whether or not to preserve job files after they are printed.
486 PreserveJobHistory Yes
488 PreserveJobHistory No
490 Specifies whether or not to preserve the job history after they are
497 Specifies the filename for a printcap file that is updated
498 automatically with a list of available printers (needed for
499 legacy applications); specifying Printcap with no filename
500 disables printcap generation.
504 PrintcapFormat solaris
506 Specifies the format of the printcap file.
510 PrintcapGUI gui-program-filename
512 Specifies whether to generate option panel definition files on
513 some operating systems. When provided with no program filename,
514 disables option panel definition files.
516 ReloadTimeout seconds
518 Specifies the amount of time to wait for job completion before
519 restarting the scheduler.
523 Specifies the username that is associated with unauthenticated root
526 RequestRoot directory
528 Specifies the directory to store print jobs and other HTTP request
531 Require group group-name-list
533 Require user user-name-list
537 Specifies that user or group authentication is required.
541 Specifies the maximum amount of memory to use when converting images
542 and PostScript files to bitmaps for a printer.
548 Specifies whether all or any limits set for a Location must be
549 satisfied to allow access.
551 ServerAdmin user@domain.com
553 Specifies the email address of the server administrator.
557 Specifies the directory where backends, CGIs, daemons, and filters may
560 ServerCertificate filename
562 Specifies the encryption certificate to use.
566 Specifies the encryption key to use.
568 ServerName hostname-or-ip-address
570 Specifies the fully-qualified hostname of the server.
574 Specifies the directory where the server configuration files can be found.
588 ServerTokens ProductOnly
590 Specifies what information is included in the Server header of HTTP
593 SetEnv variable value
595 Set the specified environment variable to be passed to child processes.
599 Listens on the specified address and port for encrypted connections.
603 Listens on the specified port for encrypted connections.
605 SystemGroup group-name [group-name ...]
607 Specifies the group(s) to use for System class authentication.
611 Specifies the directory where temporary files are stored.
615 Specifies the HTTP request timeout in seconds.
619 Specifies the user name or ID that is used when running external programs.
621 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fImime.convs(5)\fR,
622 \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
623 \fIsubscriptions.conf(5)\fR,
625 http://localhost:631/help
627 Copyright 2007-2008 by Apple Inc.
629 .\" End of "$Id: cupsd.conf.man.in 7645 2008-06-16 17:21:10Z mike $".