[thirdparty/cups.git] / man / cupsd.conf.man.in

.\"
.\" "$Id: cupsd.conf.man.in 12060 2014-07-28 14:04:41Z msweet $"
.\"
.\"   cupsd.conf man page for CUPS.
.\"
.\"   Copyright 2007-2013 by Apple Inc.
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Apple Inc. and are protected by Federal copyright
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\"   which should have been included with this file.  If this file is
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.TH cupsd.conf 5 "CUPS" "28 July 2014" "Apple Inc."
.SH NAME
cupsd.conf \- server configuration file for cups
.SH DESCRIPTION
The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR.  It
is normally located in the \fI/etc/cups\fR directory. \fBNote:\fR
File, directory, and user configuration directives that used to be allowed in
the \fIcupsd.conf\fR file are now stored in the \fIcups-files.conf(5)\fR instead
in order to prevent certain types of privilege escalation attacks.
.LP
Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character. The
configuration directives are intentionally similar to those used by the
popular Apache web server software and are described below.
.SH DIRECTIVES
The following directives are understood by \fIcupsd(8)\fR. Consult the
on-line help for detailed descriptions:
.TP 5
AccessLogLevel config
.TP 5
AccessLogLevel actions
.TP 5
AccessLogLevel all
.br
Specifies the logging level for the AccessLog file.
.TP 5
Allow all
.TP 5
Allow none
.TP 5
Allow host.domain.com
.TP 5
Allow *.domain.com
.TP 5
Allow ip-address
.TP 5
Allow ip-address/netmask
.TP 5
Allow ip-address/mm
.TP 5
Allow @IF(name)
.TP 5
Allow @LOCAL
.br
Allows access from the named hosts or addresses.
.TP 5
AuthType None
.TP 5
AuthType Basic
.TP 5
AuthType BasicDigest
.TP 5
AuthType Digest
.TP 5
AuthType Negotiate
.br
Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
.TP 5
AutoPurgeJobs Yes
.TP 5
AutoPurgeJobs No
.br
Specifies whether to purge job history data automatically when
it is no longer required for quotas.
.TP 5
BrowseLocalProtocols [All] [DNSSD]
.br
Specifies the protocols to use for local printer sharing.
.TP 5
BrowseWebIF Yes
.TP 5
BrowseWebIF No
.br
Specifies whether the CUPS web interface is advertised via DNS-SD.
.TP 5
Browsing Yes
.TP 5
Browsing No
.br
Specifies whether or not shared printers should be advertised.
.TP 5
Classification banner
.br
Specifies the security classification of the server.
.TP 5
ClassifyOverride Yes
.TP 5
ClassifyOverride No
.br
Specifies whether to allow users to override the classification
of individual print jobs.
.TP 5
DefaultAuthType Basic
.TP 5
DefaultAuthType BasicDigest
.TP 5
DefaultAuthType Digest
.TP 5
DefaultAuthType Negotiate
.br
Specifies the default type of authentication to use.
.TP 5
DefaultEncryption Never
.TP 5
DefaultEncryption IfRequested
.TP 5
DefaultEncryption Required
.br
Specifies the type of encryption to use for authenticated requests.
.TP 5
DefaultLanguage locale
.br
Specifies the default language to use for text and web content.
.TP 5
DefaultPaperSize Auto
.TP 5
DefaultPaperSize None
.TP 5
DefaultPaperSize sizename
.br
Specifies the default paper size for new print queues. "Auto" uses a locale-
specific default, while "None" specifies there is no default paper size.
.TP 5
DefaultPolicy policy-name
.br
Specifies the default access policy to use.
.TP 5
DefaultShared Yes
.TP 5
DefaultShared No
.br
Specifies whether local printers are shared by default.
.TP 5
Deny all
.TP 5
Deny none
.TP 5
Deny host.domain.com
.TP 5
Deny *.domain.com
.TP 5
Deny ip-address
.TP 5
Deny ip-address/netmask
.TP 5
Deny ip-address/mm
.TP 5
Deny @IF(name)
.TP 5
Deny @LOCAL
.br
Denies access to the named host or address.
.TP 5
DirtyCleanInterval seconds
.br
Specifies the delay for updating of configuration and state files. A value of 0
causes the update to happen as soon as possible, typically within a few
milliseconds.
.TP 5
Encryption IfRequested
.TP 5
Encryption Never
.TP 5
Encryption Required
.br
Specifies the level of encryption that is required for a particular
location.
.TP 5
ErrorPolicy abort-job
Specifies that a failed print job should be aborted (discarded) unless otherwise specified for the printer.
.TP 5
ErrorPolicy retry-job
Specifies that a failed print job should be retried at a later time unless otherwise specified for the printer.
.TP 5
ErrorPolicy retry-this-job
Specifies that a failed print job should be retried immediately unless otherwise specified for the printer.
.TP 5
ErrorPolicy stop-printer
Specifies that a failed print job should stop the printer unless otherwise specified for the printer. The 'stop-printer' error policy is the default.
.TP 5
FilterLimit limit
.br
Specifies the maximum cost of filters that are run concurrently.
.TP 5
FilterNice nice-value
.br
Specifies the scheduling priority ("nice" value) of filters that
are run to print a job.
.TP 5
GSSServiceName name
.br
Specifies the service name when using Kerberos authentication. The default
service name is "http".
.TP 5
HostNameLookups On
.TP 5
HostNameLookups Off
.TP 5
HostNameLookups Double
.br
Specifies whether or not to do reverse lookups on client addresses.
.TP 5
Include filename
.br
Includes the named file.
.TP 5
JobKillDelay seconds
.br
Specifies the number of seconds to wait before killing the filters and backend
associated with a canceled or held job.
.TP 5
JobPrivateAccess all
.TP 5
JobPrivateAccess default
.TP 5
JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
.br
Specifies an access list for a job's private values. The "default" access list
is "@OWNER @SYSTEM". "@ACL" maps to the printer's requesting-user-name-allowed
or requesting-user-name-denied values.
.TP 5
JobPrivateValues all
.TP 5
JobPrivateValues default
.TP 5
JobPrivateValues none
.TP 5
JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
Specifies the list of job values to make private. The "default" values are
"job-name", "job-originating-host-name", and "job-originating-user-name".
.TP 5
JobRetryInterval seconds
.br
Specifies the interval between retries of jobs in seconds.
.TP 5
JobRetryLimit count
.br
Specifies the number of retries that are done for jobs.
.TP 5
KeepAlive Yes
.TP 5
KeepAlive No
.br
Specifies whether to support HTTP keep-alive connections.
.TP 5
KeepAliveTimeout seconds
.br
Specifies the amount of time that connections are kept alive.
.TP 5
<Limit operations> ... </Limit>
.br
Specifies the IPP operations that are being limited inside a policy.
.TP 5
<Limit methods> ... </Limit>
.TP 5
<LimitExcept methods> ... </LimitExcept>
.br
Specifies the HTTP methods that are being limited inside a location.
.TP 5
LimitRequestBody
.br
Specifies the maximum size of any print job request.
.TP 5
Listen ip-address:port
.TP 5
Listen *:port
.TP 5
Listen /path/to/domain/socket
.br
Listens to the specified address and port or domain socket path.
.TP 5
<Location /path> ... </Location>
.br
Specifies access control for the named location.
.TP 5
LogDebugHistory #-messages
.br
Specifies the number of debugging messages that are logged when an error
occurs in a print job.
.TP 5
LogLevel alert
.TP 5
LogLevel crit
.TP 5
LogLevel debug2
.TP 5
LogLevel debug
.TP 5
LogLevel emerg
.TP 5
LogLevel error
.TP 5
LogLevel info
.TP 5
LogLevel none
.TP 5
LogLevel notice
.TP 5
LogLevel warn
.br
Specifies the logging level for the ErrorLog file.
.TP 5
LogTimeFormat standard
.TP 5
LogTimeFormat usecs
.br
Specifies the format of the date and time in the log files.
.TP 5
MaxClients number
.br
Specifies the maximum number of simultaneous clients to support.
.TP 5
MaxClientsPerHost number
.br
Specifies the maximum number of simultaneous clients to support from a
single address.
.TP 5
MaxCopies number
.br
Specifies the maximum number of copies that a user can print of each job.
.TP 5
MaxHoldTime seconds
.br
Specifies the maximum time a job may remain in the "indefinite" hold state
before it is canceled. Set to 0 to disable cancellation of held jobs.
.TP 5
MaxJobs number
.br
Specifies the maximum number of simultaneous jobs to support.
.TP 5
MaxJobsPerPrinter number
.br
Specifies the maximum number of simultaneous jobs per printer to support.
.TP 5
MaxJobsPerUser number
.br
Specifies the maximum number of simultaneous jobs per user to support.
.TP 5
MaxJobTime seconds
.br
Specifies the maximum time a job may take to print before it is canceled. The
default is 10800 seconds (3 hours). Set to 0 to disable cancellation of "stuck"
jobs.
.TP 5
MaxLogSize number-bytes
.br
Specifies the maximum size of the log files before they are
rotated (0 to disable rotation)
.TP 5
MaxRequestSize number-bytes
.br
Specifies the maximum request/file size in bytes (0 for no limit)
.TP 5
MultipleOperationTimeout seconds
.br
Specifies the maximum amount of time to allow between files in a multiple file
print job.
.TP 5
Order allow,deny
.TP 5
Order deny,allow
.br
Specifies the order of HTTP access control (allow,deny or deny,allow)
.TP 5
PageLogFormat format string
.br
Specifies the format of page log lines.
.TP 5
PassEnv variable [... variable]
.br
Passes the specified environment variable(s) to child processes.
.TP 5
<Policy name> ... </Policy>
.br
Specifies access control for the named policy.
.TP 5
Port number
.br
Specifies a port number to listen to for HTTP requests.
.TP 5
PreserveJobFiles Yes
.TP 5
PreserveJobFiles No
.br
Specifies whether or not to preserve job files after they are printed.
.TP 5
PreserveJobHistory Yes
.TP 5
PreserveJobHistory No
.br
Specifies whether or not to preserve the job history after they are
printed.
.TP 5
PrintcapFormat bsd
.TP 5
PrintcapFormat plist
.TP 5
PrintcapFormat solaris
.br
Specifies the format of the printcap file.
.TP 5
ReloadTimeout seconds
.br
Specifies the amount of time to wait for job completion before
restarting the scheduler.
.TP 5
Require group group-name-list
.TP 5
Require user user-name-list
.TP 5
Require valid-user
.br
Specifies that user or group authentication is required.
.TP 5
RIPCache bytes
.br
Specifies the maximum amount of memory to use when converting images
and PostScript files to bitmaps for a printer.
.TP 5
Satisfy all
.TP 5
Satisfy any
.br
Specifies whether all or any limits set for a Location must be
satisfied to allow access.
.TP 5
ServerAdmin user@domain.com
.br
Specifies the email address of the server administrator.
.TP 5
ServerAlias hostname [... hostname]
.TP 5
ServerAlias *
.br
Specifies an alternate name that the server is known by. The special name "*"
allows any name to be used.
.TP 5
ServerName hostname-or-ip-address
.br
Specifies the fully-qualified hostname of the server.
.TP 5
ServerTokens Full
.TP 5
ServerTokens Major
.TP 5
ServerTokens Minimal
.TP 5
ServerTokens Minor
.TP 5
ServerTokens None
.TP 5
ServerTokens OS
.TP 5
ServerTokens ProductOnly
.br
Specifies what information is included in the Server header of HTTP
responses.
.TP 5
SetEnv variable value
.br
Set the specified environment variable to be passed to child processes.
.TP 5
SSLListen
.br
Listens on the specified address and port for encrypted connections.
.TP 5
SSLOptions None
.TP 5
SSLOptions NoEmptyFragments
.br
Sets SSL/TLS protocol options for encrypted connections.
.TP 5
SSLPort
.br
Listens on the specified port for encrypted connections.
.TP 5
StrictConformance Yes
.TP 5
StrictConformance No
.br
Specifies whether the scheduler requires clients to strictly adhere to the IPP
specifications. The default is No.
.TP 5
SubscriptionPrivateAccess all
.TP 5
SubscriptionPrivateAccess default
.TP 5
SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
.br
Specifies an access list for a subscription's private values. The "default"
access list is "@OWNER @SYSTEM". "@ACL" maps to the printer's
requesting-user-name-allowed or requesting-user-name-denied values.
.TP 5
SubscriptionPrivateValues all
.TP 5
SubscriptionPrivateValues default
.TP 5
SubscriptionPrivateValues none
.TP 5
SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ]
Specifies the list of job values to make private. The "default" values are
"notify-events", "notify-pull-method", "notify-recipient-uri",
"notify-subscriber-user-name", and "notify-user-data".
.TP 5
Timeout seconds
.br
Specifies the HTTP request timeout in seconds.
.TP 5
WebInterface yes
.TP 5
WebInterface no
Specifies whether the web interface is enabled.
.SH SEE ALSO
\fIclasses.conf(5)\fR, \fIcups-files.conf(5)\fR, \fIcupsd(8)\fR,
\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
\fIsubscriptions.conf(5)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007-2013 by Apple Inc.
.\"
.\" End of "$Id: cupsd.conf.man.in 12060 2014-07-28 14:04:41Z msweet $".
.\"
Commit	Line	Data
ef416fc2	1	.\"
b60086f8	2	.\" "$Id: cupsd.conf.man.in 12060 2014-07-28 14:04:41Z msweet $"
ef416fc2	3	.\"
321d8d57	4	.\" cupsd.conf man page for CUPS.
ef416fc2	5	.\"
0fa6c7fa	6	.\" Copyright 2007-2013 by Apple Inc.
bd7854cb	7	.\" Copyright 1997-2006 by Easy Software Products.
ef416fc2	8	.\"
ef416fc2	9	.\" These coded instructions, statements, and computer programs are the
bc44d920	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/".
ef416fc2	14	.\"
b60086f8	15	.TH cupsd.conf 5 "CUPS" "28 July 2014" "Apple Inc."
ef416fc2	16	.SH NAME
	17	cupsd.conf \- server configuration file for cups
	18	.SH DESCRIPTION
	19	The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR. It
ffa2ca90	20	is normally located in the \fI/etc/cups\fR directory. \fBNote:\fR
c41769ff MS	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.
ef416fc2	24	.LP
	25	Each line in the file can be a configuration directive, a blank line,
	26	or a comment. Comment lines start with the # character. The
	27	configuration directives are intentionally similar to those used by the
	28	popular Apache web server software and are described below.
	29	.SH DIRECTIVES
bd7854cb	30	The following directives are understood by \fIcupsd(8)\fR. Consult the
bd7854cb	31	on-line help for detailed descriptions:
ef416fc2	32	.TP 5
1f0275e3 MS	33	AccessLogLevel config
	34	.TP 5
	35	AccessLogLevel actions
	36	.TP 5
	37	AccessLogLevel all
	38	.br
	39	Specifies the logging level for the AccessLog file.
	40	.TP 5
bd7854cb	41	Allow all
	42	.TP 5
	43	Allow none
	44	.TP 5
	45	Allow host.domain.com
	46	.TP 5
	47	Allow *.domain.com
	48	.TP 5
	49	Allow ip-address
	50	.TP 5
	51	Allow ip-address/netmask
	52	.TP 5
	53	Allow ip-address/mm
	54	.TP 5
	55	Allow @IF(name)
	56	.TP 5
	57	Allow @LOCAL
ef416fc2	58	.br
	59	Allows access from the named hosts or addresses.
	60	.TP 5
bd7854cb	61	AuthType None
	62	.TP 5
	63	AuthType Basic
	64	.TP 5
	65	AuthType BasicDigest
	66	.TP 5
	67	AuthType Digest
f7deaa1a	68	.TP 5
2e4ff8af	69	AuthType Negotiate
ef416fc2	70	.br
2e4ff8af	71	Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
ef416fc2	72	.TP 5
bd7854cb	73	AutoPurgeJobs Yes
	74	.TP 5
	75	AutoPurgeJobs No
ef416fc2	76	.br
	77	Specifies whether to purge job history data automatically when
	78	it is no longer required for quotas.
	79	.TP 5
a2326b5b	80	BrowseLocalProtocols [All] [DNSSD]
749b1e90	81	.br
a2326b5b	82	Specifies the protocols to use for local printer sharing.
ef416fc2	83	.TP 5
b19ccc9e MS	84	BrowseWebIF Yes
	85	.TP 5
	86	BrowseWebIF No
	87	.br
	88	Specifies whether the CUPS web interface is advertised via DNS-SD.
	89	.TP 5
bd7854cb	90	Browsing Yes
	91	.TP 5
	92	Browsing No
ef416fc2	93	.br
c41769ff	94	Specifies whether or not shared printers should be advertised.
ef416fc2	95	.TP 5
bd7854cb	96	Classification banner
ef416fc2	97	.br
	98	Specifies the security classification of the server.
	99	.TP 5
bd7854cb	100	ClassifyOverride Yes
	101	.TP 5
	102	ClassifyOverride No
ef416fc2	103	.br
	104	Specifies whether to allow users to override the classification
	105	of individual print jobs.
	106	.TP 5
bd7854cb	107	DefaultAuthType Basic
	108	.TP 5
	109	DefaultAuthType BasicDigest
	110	.TP 5
	111	DefaultAuthType Digest
f7deaa1a	112	.TP 5
2e4ff8af	113	DefaultAuthType Negotiate
ef416fc2	114	.br
	115	Specifies the default type of authentication to use.
	116	.TP 5
8b450588 MS	117	DefaultEncryption Never
	118	.TP 5
	119	DefaultEncryption IfRequested
	120	.TP 5
	121	DefaultEncryption Required
	122	.br
	123	Specifies the type of encryption to use for authenticated requests.
	124	.TP 5
bd7854cb	125	DefaultLanguage locale
ef416fc2	126	.br
	127	Specifies the default language to use for text and web content.
	128	.TP 5
49d87452 MS	129	DefaultPaperSize Auto
	130	.TP 5
	131	DefaultPaperSize None
	132	.TP 5
	133	DefaultPaperSize sizename
	134	.br
	135	Specifies the default paper size for new print queues. "Auto" uses a locale-
	136	specific default, while "None" specifies there is no default paper size.
	137	.TP 5
bd7854cb	138	DefaultPolicy policy-name
ef416fc2	139	.br
	140	Specifies the default access policy to use.
	141	.TP 5
3d052e43 MS	142	DefaultShared Yes
	143	.TP 5
	144	DefaultShared No
	145	.br
	146	Specifies whether local printers are shared by default.
	147	.TP 5
bd7854cb	148	Deny all
	149	.TP 5
	150	Deny none
	151	.TP 5
	152	Deny host.domain.com
	153	.TP 5
	154	Deny *.domain.com
	155	.TP 5
	156	Deny ip-address
	157	.TP 5
	158	Deny ip-address/netmask
	159	.TP 5
	160	Deny ip-address/mm
	161	.TP 5
	162	Deny @IF(name)
	163	.TP 5
	164	Deny @LOCAL
ef416fc2	165	.br
	166	Denies access to the named host or address.
	167	.TP 5
4a4b4f99 MS	168	DirtyCleanInterval seconds
	169	.br
	170	Specifies the delay for updating of configuration and state files. A value of 0
	171	causes the update to happen as soon as possible, typically within a few
	172	milliseconds.
	173	.TP 5
bd7854cb	174	Encryption IfRequested
	175	.TP 5
	176	Encryption Never
	177	.TP 5
	178	Encryption Required
ef416fc2	179	.br
	180	Specifies the level of encryption that is required for a particular
	181	location.
	182	.TP 5
b60086f8 MS	183	ErrorPolicy abort-job
	184	Specifies that a failed print job should be aborted (discarded) unless otherwise specified for the printer.
	185	.TP 5
	186	ErrorPolicy retry-job
	187	Specifies that a failed print job should be retried at a later time unless otherwise specified for the printer.
	188	.TP 5
	189	ErrorPolicy retry-this-job
	190	Specifies that a failed print job should be retried immediately unless otherwise specified for the printer.
	191	.TP 5
	192	ErrorPolicy stop-printer
	193	Specifies that a failed print job should stop the printer unless otherwise specified for the printer. The 'stop-printer' error policy is the default.
	194	.TP 5
bd7854cb	195	FilterLimit limit
ef416fc2	196	.br
	197	Specifies the maximum cost of filters that are run concurrently.
	198	.TP 5
bd7854cb	199	FilterNice nice-value
ef416fc2	200	.br
	201	Specifies the scheduling priority ("nice" value) of filters that
	202	are run to print a job.
	203	.TP 5
dcb445bc MS	204	GSSServiceName name
	205	.br
	206	Specifies the service name when using Kerberos authentication. The default
ffa2ca90	207	service name is "http".
dcb445bc	208	.TP 5
dd1abb6b	209	HostNameLookups On
bd7854cb	210	.TP 5
dd1abb6b	211	HostNameLookups Off
bd7854cb	212	.TP 5
bd7854cb	213	HostNameLookups Double
ef416fc2	214	.br
	215	Specifies whether or not to do reverse lookups on client addresses.
	216	.TP 5
bd7854cb	217	Include filename
ef416fc2	218	.br
	219	Includes the named file.
	220	.TP 5
238c3832 MS	221	JobKillDelay seconds
	222	.br
	223	Specifies the number of seconds to wait before killing the filters and backend
	224	associated with a canceled or held job.
	225	.TP 5
10d09e33 MS	226	JobPrivateAccess all
	227	.TP 5
	228	JobPrivateAccess default
	229	.TP 5
	230	JobPrivateAccess {user\|@group\|@ACL\|@OWNER\|@SYSTEM}+
	231	.br
	232	Specifies an access list for a job's private values. The "default" access list
	233	is "@OWNER @SYSTEM". "@ACL" maps to the printer's requesting-user-name-allowed
	234	or requesting-user-name-denied values.
	235	.TP 5
	236	JobPrivateValues all
	237	.TP 5
	238	JobPrivateValues default
	239	.TP 5
	240	JobPrivateValues none
	241	.TP 5
	242	JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
	243	Specifies the list of job values to make private. The "default" values are
	244	"job-name", "job-originating-host-name", and "job-originating-user-name".
	245	.TP 5
bd7854cb	246	JobRetryInterval seconds
ef416fc2	247	.br
	248	Specifies the interval between retries of jobs in seconds.
	249	.TP 5
bd7854cb	250	JobRetryLimit count
ef416fc2	251	.br
	252	Specifies the number of retries that are done for jobs.
	253	.TP 5
80ca4592	254	KeepAlive Yes
	255	.TP 5
	256	KeepAlive No
ef416fc2	257	.br
80ca4592	258	Specifies whether to support HTTP keep-alive connections.
ef416fc2	259	.TP 5
80ca4592	260	KeepAliveTimeout seconds
ef416fc2	261	.br
80ca4592	262	Specifies the amount of time that connections are kept alive.
ef416fc2	263	.TP 5
	264	<Limit operations> ... </Limit>
	265	.br
	266	Specifies the IPP operations that are being limited inside a policy.
	267	.TP 5
	268	<Limit methods> ... </Limit>
	269	.TP 5
	270	<LimitExcept methods> ... </LimitExcept>
	271	.br
	272	Specifies the HTTP methods that are being limited inside a location.
	273	.TP 5
	274	LimitRequestBody
	275	.br
	276	Specifies the maximum size of any print job request.
	277	.TP 5
bd7854cb	278	Listen ip-address:port
	279	.TP 5
	280	Listen *:port
ed486911	281	.TP 5
ed486911	282	Listen /path/to/domain/socket
ef416fc2	283	.br
ed486911	284	Listens to the specified address and port or domain socket path.
ef416fc2	285	.TP 5
	286	<Location /path> ... </Location>
	287	.br
	288	Specifies access control for the named location.
	289	.TP 5
178cb736 MS	290	LogDebugHistory #-messages
	291	.br
	292	Specifies the number of debugging messages that are logged when an error
	293	occurs in a print job.
	294	.TP 5
bd7854cb	295	LogLevel alert
	296	.TP 5
	297	LogLevel crit
	298	.TP 5
	299	LogLevel debug2
	300	.TP 5
	301	LogLevel debug
	302	.TP 5
	303	LogLevel emerg
	304	.TP 5
	305	LogLevel error
	306	.TP 5
	307	LogLevel info
	308	.TP 5
	309	LogLevel none
	310	.TP 5
	311	LogLevel notice
	312	.TP 5
	313	LogLevel warn
ef416fc2	314	.br
bd7854cb	315	Specifies the logging level for the ErrorLog file.
ef416fc2	316	.TP 5
dfd5680b MS	317	LogTimeFormat standard
	318	.TP 5
	319	LogTimeFormat usecs
	320	.br
	321	Specifies the format of the date and time in the log files.
	322	.TP 5
bd7854cb	323	MaxClients number
ef416fc2	324	.br
	325	Specifies the maximum number of simultaneous clients to support.
	326	.TP 5
bd7854cb	327	MaxClientsPerHost number
ef416fc2	328	.br
	329	Specifies the maximum number of simultaneous clients to support from a
	330	single address.
	331	.TP 5
bd7854cb	332	MaxCopies number
ef416fc2	333	.br
	334	Specifies the maximum number of copies that a user can print of each job.
	335	.TP 5
3e7fe0ca MS	336	MaxHoldTime seconds
	337	.br
	338	Specifies the maximum time a job may remain in the "indefinite" hold state
	339	before it is canceled. Set to 0 to disable cancellation of held jobs.
	340	.TP 5
bd7854cb	341	MaxJobs number
ef416fc2	342	.br
	343	Specifies the maximum number of simultaneous jobs to support.
	344	.TP 5
bd7854cb	345	MaxJobsPerPrinter number
ef416fc2	346	.br
	347	Specifies the maximum number of simultaneous jobs per printer to support.
	348	.TP 5
bd7854cb	349	MaxJobsPerUser number
ef416fc2	350	.br
	351	Specifies the maximum number of simultaneous jobs per user to support.
	352	.TP 5
dcb445bc MS	353	MaxJobTime seconds
	354	.br
	355	Specifies the maximum time a job may take to print before it is canceled. The
	356	default is 10800 seconds (3 hours). Set to 0 to disable cancellation of "stuck"
	357	jobs.
	358	.TP 5
bd7854cb	359	MaxLogSize number-bytes
ef416fc2	360	.br
	361	Specifies the maximum size of the log files before they are
	362	rotated (0 to disable rotation)
	363	.TP 5
bd7854cb	364	MaxRequestSize number-bytes
ef416fc2	365	.br
	366	Specifies the maximum request/file size in bytes (0 for no limit)
	367	.TP 5
dfd5680b MS	368	MultipleOperationTimeout seconds
	369	.br
	370	Specifies the maximum amount of time to allow between files in a multiple file
	371	print job.
	372	.TP 5
bd7854cb	373	Order allow,deny
	374	.TP 5
	375	Order deny,allow
ef416fc2	376	.br
	377	Specifies the order of HTTP access control (allow,deny or deny,allow)
	378	.TP 5
01ce6322 MS	379	PageLogFormat format string
	380	.br
	381	Specifies the format of page log lines.
	382	.TP 5
ef416fc2	383	PassEnv variable [... variable]
	384	.br
	385	Passes the specified environment variable(s) to child processes.
	386	.TP 5
	387	<Policy name> ... </Policy>
	388	.br
	389	Specifies access control for the named policy.
	390	.TP 5
bd7854cb	391	Port number
ef416fc2	392	.br
	393	Specifies a port number to listen to for HTTP requests.
	394	.TP 5
bd7854cb	395	PreserveJobFiles Yes
	396	.TP 5
	397	PreserveJobFiles No
ef416fc2	398	.br
	399	Specifies whether or not to preserve job files after they are printed.
	400	.TP 5
bd7854cb	401	PreserveJobHistory Yes
	402	.TP 5
	403	PreserveJobHistory No
ef416fc2	404	.br
	405	Specifies whether or not to preserve the job history after they are
	406	printed.
	407	.TP 5
bd7854cb	408	PrintcapFormat bsd
ef416fc2	409	.TP 5
0af14961 MS	410	PrintcapFormat plist
0af14961 MS	411	.TP 5
bd7854cb	412	PrintcapFormat solaris
ef416fc2	413	.br
	414	Specifies the format of the printcap file.
	415	.TP 5
bd7854cb	416	ReloadTimeout seconds
ef416fc2	417	.br
	418	Specifies the amount of time to wait for job completion before
	419	restarting the scheduler.
	420	.TP 5
bd7854cb	421	Require group group-name-list
	422	.TP 5
	423	Require user user-name-list
	424	.TP 5
	425	Require valid-user
ef416fc2	426	.br
	427	Specifies that user or group authentication is required.
	428	.TP 5
bd7854cb	429	RIPCache bytes
ef416fc2	430	.br
	431	Specifies the maximum amount of memory to use when converting images
	432	and PostScript files to bitmaps for a printer.
	433	.TP 5
bd7854cb	434	Satisfy all
ef416fc2	435	.TP 5
bd7854cb	436	Satisfy any
ef416fc2	437	.br
	438	Specifies whether all or any limits set for a Location must be
	439	satisfied to allow access.
	440	.TP 5
bd7854cb	441	ServerAdmin user@domain.com
ef416fc2	442	.br
	443	Specifies the email address of the server administrator.
	444	.TP 5
88f9aafc MS	445	ServerAlias hostname [... hostname]
	446	.TP 5
	447	ServerAlias *
e07d4801 MS	448	.br
	449	Specifies an alternate name that the server is known by. The special name "*"
	450	allows any name to be used.
	451	.TP 5
bd7854cb	452	ServerName hostname-or-ip-address
ef416fc2	453	.br
	454	Specifies the fully-qualified hostname of the server.
	455	.TP 5
bd7854cb	456	ServerTokens Full
	457	.TP 5
	458	ServerTokens Major
	459	.TP 5
	460	ServerTokens Minimal
	461	.TP 5
	462	ServerTokens Minor
	463	.TP 5
	464	ServerTokens None
	465	.TP 5
	466	ServerTokens OS
	467	.TP 5
	468	ServerTokens ProductOnly
ef416fc2	469	.br
	470	Specifies what information is included in the Server header of HTTP
	471	responses.
	472	.TP 5
	473	SetEnv variable value
	474	.br
	475	Set the specified environment variable to be passed to child processes.
	476	.TP 5
	477	SSLListen
	478	.br
	479	Listens on the specified address and port for encrypted connections.
	480	.TP 5
b19ccc9e MS	481	SSLOptions None
	482	.TP 5
	483	SSLOptions NoEmptyFragments
	484	.br
	485	Sets SSL/TLS protocol options for encrypted connections.
	486	.TP 5
ef416fc2	487	SSLPort
	488	.br
	489	Listens on the specified port for encrypted connections.
	490	.TP 5
a29fd7dd MS	491	StrictConformance Yes
	492	.TP 5
	493	StrictConformance No
	494	.br
	495	Specifies whether the scheduler requires clients to strictly adhere to the IPP
	496	specifications. The default is No.
	497	.TP 5
10d09e33 MS	498	SubscriptionPrivateAccess all
	499	.TP 5
	500	SubscriptionPrivateAccess default
	501	.TP 5
	502	SubscriptionPrivateAccess {user\|@group\|@ACL\|@OWNER\|@SYSTEM}+
	503	.br
	504	Specifies an access list for a subscription's private values. The "default"
	505	access list is "@OWNER @SYSTEM". "@ACL" maps to the printer's
	506	requesting-user-name-allowed or requesting-user-name-denied values.
	507	.TP 5
	508	SubscriptionPrivateValues all
	509	.TP 5
	510	SubscriptionPrivateValues default
	511	.TP 5
	512	SubscriptionPrivateValues none
	513	.TP 5
	514	SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ]
	515	Specifies the list of job values to make private. The "default" values are
	516	"notify-events", "notify-pull-method", "notify-recipient-uri",
	517	"notify-subscriber-user-name", and "notify-user-data".
	518	.TP 5
bd7854cb	519	Timeout seconds
ef416fc2	520	.br
	521	Specifies the HTTP request timeout in seconds.
	522	.TP 5
229681c1 MS	523	WebInterface yes
	524	.TP 5
	525	WebInterface no
	526	Specifies whether the web interface is enabled.
ef416fc2	527	.SH SEE ALSO
c41769ff MS	528	\fIclasses.conf(5)\fR, \fIcups-files.conf(5)\fR, \fIcupsd(8)\fR,
c41769ff MS	529	\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
bd7854cb	530	\fIsubscriptions.conf(5)\fR,
	531	.br
	532	http://localhost:631/help
ef416fc2	533	.SH COPYRIGHT
0fa6c7fa	534	Copyright 2007-2013 by Apple Inc.
ef416fc2	535	.\"
b60086f8	536	.\" End of "$Id: cupsd.conf.man.in 12060 2014-07-28 14:04:41Z msweet $".
ef416fc2	537	.\"