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

.\"
.\" "$Id: cupsd.conf.man.in 11109 2013-07-08 21:15:13Z 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" "8 July 2013" "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
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 11109 2013-07-08 21:15:13Z msweet $".
.\"
Commit	Line	Data
ef416fc2	1	.\"
61515785	2	.\" "$Id: cupsd.conf.man.in 11109 2013-07-08 21:15:13Z 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	.\"
ffa2ca90	15	.TH cupsd.conf 5 "CUPS" "8 July 2013" "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
bd7854cb	183	FilterLimit limit
ef416fc2	184	.br
	185	Specifies the maximum cost of filters that are run concurrently.
	186	.TP 5
bd7854cb	187	FilterNice nice-value
ef416fc2	188	.br
	189	Specifies the scheduling priority ("nice" value) of filters that
	190	are run to print a job.
	191	.TP 5
dcb445bc MS	192	GSSServiceName name
	193	.br
	194	Specifies the service name when using Kerberos authentication. The default
ffa2ca90	195	service name is "http".
dcb445bc	196	.TP 5
dd1abb6b	197	HostNameLookups On
bd7854cb	198	.TP 5
dd1abb6b	199	HostNameLookups Off
bd7854cb	200	.TP 5
bd7854cb	201	HostNameLookups Double
ef416fc2	202	.br
	203	Specifies whether or not to do reverse lookups on client addresses.
	204	.TP 5
bd7854cb	205	Include filename
ef416fc2	206	.br
	207	Includes the named file.
	208	.TP 5
238c3832 MS	209	JobKillDelay seconds
	210	.br
	211	Specifies the number of seconds to wait before killing the filters and backend
	212	associated with a canceled or held job.
	213	.TP 5
10d09e33 MS	214	JobPrivateAccess all
	215	.TP 5
	216	JobPrivateAccess default
	217	.TP 5
	218	JobPrivateAccess {user\|@group\|@ACL\|@OWNER\|@SYSTEM}+
	219	.br
	220	Specifies an access list for a job's private values. The "default" access list
	221	is "@OWNER @SYSTEM". "@ACL" maps to the printer's requesting-user-name-allowed
	222	or requesting-user-name-denied values.
	223	.TP 5
	224	JobPrivateValues all
	225	.TP 5
	226	JobPrivateValues default
	227	.TP 5
	228	JobPrivateValues none
	229	.TP 5
	230	JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
	231	Specifies the list of job values to make private. The "default" values are
	232	"job-name", "job-originating-host-name", and "job-originating-user-name".
	233	.TP 5
bd7854cb	234	JobRetryInterval seconds
ef416fc2	235	.br
	236	Specifies the interval between retries of jobs in seconds.
	237	.TP 5
bd7854cb	238	JobRetryLimit count
ef416fc2	239	.br
	240	Specifies the number of retries that are done for jobs.
	241	.TP 5
80ca4592	242	KeepAlive Yes
	243	.TP 5
	244	KeepAlive No
ef416fc2	245	.br
80ca4592	246	Specifies whether to support HTTP keep-alive connections.
ef416fc2	247	.TP 5
80ca4592	248	KeepAliveTimeout seconds
ef416fc2	249	.br
80ca4592	250	Specifies the amount of time that connections are kept alive.
ef416fc2	251	.TP 5
	252	<Limit operations> ... </Limit>
	253	.br
	254	Specifies the IPP operations that are being limited inside a policy.
	255	.TP 5
	256	<Limit methods> ... </Limit>
	257	.TP 5
	258	<LimitExcept methods> ... </LimitExcept>
	259	.br
	260	Specifies the HTTP methods that are being limited inside a location.
	261	.TP 5
	262	LimitRequestBody
	263	.br
	264	Specifies the maximum size of any print job request.
	265	.TP 5
bd7854cb	266	Listen ip-address:port
	267	.TP 5
	268	Listen *:port
ed486911	269	.TP 5
ed486911	270	Listen /path/to/domain/socket
ef416fc2	271	.br
ed486911	272	Listens to the specified address and port or domain socket path.
ef416fc2	273	.TP 5
	274	<Location /path> ... </Location>
	275	.br
	276	Specifies access control for the named location.
	277	.TP 5
178cb736 MS	278	LogDebugHistory #-messages
	279	.br
	280	Specifies the number of debugging messages that are logged when an error
	281	occurs in a print job.
	282	.TP 5
bd7854cb	283	LogLevel alert
	284	.TP 5
	285	LogLevel crit
	286	.TP 5
	287	LogLevel debug2
	288	.TP 5
	289	LogLevel debug
	290	.TP 5
	291	LogLevel emerg
	292	.TP 5
	293	LogLevel error
	294	.TP 5
	295	LogLevel info
	296	.TP 5
	297	LogLevel none
	298	.TP 5
	299	LogLevel notice
	300	.TP 5
	301	LogLevel warn
ef416fc2	302	.br
bd7854cb	303	Specifies the logging level for the ErrorLog file.
ef416fc2	304	.TP 5
dfd5680b MS	305	LogTimeFormat standard
	306	.TP 5
	307	LogTimeFormat usecs
	308	.br
	309	Specifies the format of the date and time in the log files.
	310	.TP 5
bd7854cb	311	MaxClients number
ef416fc2	312	.br
	313	Specifies the maximum number of simultaneous clients to support.
	314	.TP 5
bd7854cb	315	MaxClientsPerHost number
ef416fc2	316	.br
	317	Specifies the maximum number of simultaneous clients to support from a
	318	single address.
	319	.TP 5
bd7854cb	320	MaxCopies number
ef416fc2	321	.br
	322	Specifies the maximum number of copies that a user can print of each job.
	323	.TP 5
3e7fe0ca MS	324	MaxHoldTime seconds
	325	.br
	326	Specifies the maximum time a job may remain in the "indefinite" hold state
	327	before it is canceled. Set to 0 to disable cancellation of held jobs.
	328	.TP 5
bd7854cb	329	MaxJobs number
ef416fc2	330	.br
	331	Specifies the maximum number of simultaneous jobs to support.
	332	.TP 5
bd7854cb	333	MaxJobsPerPrinter number
ef416fc2	334	.br
	335	Specifies the maximum number of simultaneous jobs per printer to support.
	336	.TP 5
bd7854cb	337	MaxJobsPerUser number
ef416fc2	338	.br
	339	Specifies the maximum number of simultaneous jobs per user to support.
	340	.TP 5
dcb445bc MS	341	MaxJobTime seconds
	342	.br
	343	Specifies the maximum time a job may take to print before it is canceled. The
	344	default is 10800 seconds (3 hours). Set to 0 to disable cancellation of "stuck"
	345	jobs.
	346	.TP 5
bd7854cb	347	MaxLogSize number-bytes
ef416fc2	348	.br
	349	Specifies the maximum size of the log files before they are
	350	rotated (0 to disable rotation)
	351	.TP 5
bd7854cb	352	MaxRequestSize number-bytes
ef416fc2	353	.br
	354	Specifies the maximum request/file size in bytes (0 for no limit)
	355	.TP 5
dfd5680b MS	356	MultipleOperationTimeout seconds
	357	.br
	358	Specifies the maximum amount of time to allow between files in a multiple file
	359	print job.
	360	.TP 5
bd7854cb	361	Order allow,deny
	362	.TP 5
	363	Order deny,allow
ef416fc2	364	.br
	365	Specifies the order of HTTP access control (allow,deny or deny,allow)
	366	.TP 5
01ce6322 MS	367	PageLogFormat format string
	368	.br
	369	Specifies the format of page log lines.
	370	.TP 5
ef416fc2	371	PassEnv variable [... variable]
	372	.br
	373	Passes the specified environment variable(s) to child processes.
	374	.TP 5
	375	<Policy name> ... </Policy>
	376	.br
	377	Specifies access control for the named policy.
	378	.TP 5
bd7854cb	379	Port number
ef416fc2	380	.br
	381	Specifies a port number to listen to for HTTP requests.
	382	.TP 5
bd7854cb	383	PreserveJobFiles Yes
	384	.TP 5
	385	PreserveJobFiles No
ef416fc2	386	.br
	387	Specifies whether or not to preserve job files after they are printed.
	388	.TP 5
bd7854cb	389	PreserveJobHistory Yes
	390	.TP 5
	391	PreserveJobHistory No
ef416fc2	392	.br
	393	Specifies whether or not to preserve the job history after they are
	394	printed.
	395	.TP 5
bd7854cb	396	PrintcapFormat bsd
ef416fc2	397	.TP 5
0af14961 MS	398	PrintcapFormat plist
0af14961 MS	399	.TP 5
bd7854cb	400	PrintcapFormat solaris
ef416fc2	401	.br
	402	Specifies the format of the printcap file.
	403	.TP 5
bd7854cb	404	ReloadTimeout seconds
ef416fc2	405	.br
	406	Specifies the amount of time to wait for job completion before
	407	restarting the scheduler.
	408	.TP 5
bd7854cb	409	Require group group-name-list
	410	.TP 5
	411	Require user user-name-list
	412	.TP 5
	413	Require valid-user
ef416fc2	414	.br
	415	Specifies that user or group authentication is required.
	416	.TP 5
bd7854cb	417	RIPCache bytes
ef416fc2	418	.br
	419	Specifies the maximum amount of memory to use when converting images
	420	and PostScript files to bitmaps for a printer.
	421	.TP 5
bd7854cb	422	Satisfy all
ef416fc2	423	.TP 5
bd7854cb	424	Satisfy any
ef416fc2	425	.br
	426	Specifies whether all or any limits set for a Location must be
	427	satisfied to allow access.
	428	.TP 5
bd7854cb	429	ServerAdmin user@domain.com
ef416fc2	430	.br
	431	Specifies the email address of the server administrator.
	432	.TP 5
88f9aafc MS	433	ServerAlias hostname [... hostname]
	434	.TP 5
	435	ServerAlias *
e07d4801 MS	436	.br
	437	Specifies an alternate name that the server is known by. The special name "*"
	438	allows any name to be used.
	439	.TP 5
bd7854cb	440	ServerName hostname-or-ip-address
ef416fc2	441	.br
	442	Specifies the fully-qualified hostname of the server.
	443	.TP 5
bd7854cb	444	ServerTokens Full
	445	.TP 5
	446	ServerTokens Major
	447	.TP 5
	448	ServerTokens Minimal
	449	.TP 5
	450	ServerTokens Minor
	451	.TP 5
	452	ServerTokens None
	453	.TP 5
	454	ServerTokens OS
	455	.TP 5
	456	ServerTokens ProductOnly
ef416fc2	457	.br
	458	Specifies what information is included in the Server header of HTTP
	459	responses.
	460	.TP 5
	461	SetEnv variable value
	462	.br
	463	Set the specified environment variable to be passed to child processes.
	464	.TP 5
	465	SSLListen
	466	.br
	467	Listens on the specified address and port for encrypted connections.
	468	.TP 5
b19ccc9e MS	469	SSLOptions None
	470	.TP 5
	471	SSLOptions NoEmptyFragments
	472	.br
	473	Sets SSL/TLS protocol options for encrypted connections.
	474	.TP 5
ef416fc2	475	SSLPort
	476	.br
	477	Listens on the specified port for encrypted connections.
	478	.TP 5
a29fd7dd MS	479	StrictConformance Yes
	480	.TP 5
	481	StrictConformance No
	482	.br
	483	Specifies whether the scheduler requires clients to strictly adhere to the IPP
	484	specifications. The default is No.
	485	.TP 5
10d09e33 MS	486	SubscriptionPrivateAccess all
	487	.TP 5
	488	SubscriptionPrivateAccess default
	489	.TP 5
	490	SubscriptionPrivateAccess {user\|@group\|@ACL\|@OWNER\|@SYSTEM}+
	491	.br
	492	Specifies an access list for a subscription's private values. The "default"
	493	access list is "@OWNER @SYSTEM". "@ACL" maps to the printer's
	494	requesting-user-name-allowed or requesting-user-name-denied values.
	495	.TP 5
	496	SubscriptionPrivateValues all
	497	.TP 5
	498	SubscriptionPrivateValues default
	499	.TP 5
	500	SubscriptionPrivateValues none
	501	.TP 5
	502	SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ]
	503	Specifies the list of job values to make private. The "default" values are
	504	"notify-events", "notify-pull-method", "notify-recipient-uri",
	505	"notify-subscriber-user-name", and "notify-user-data".
	506	.TP 5
bd7854cb	507	Timeout seconds
ef416fc2	508	.br
	509	Specifies the HTTP request timeout in seconds.
	510	.TP 5
229681c1 MS	511	WebInterface yes
	512	.TP 5
	513	WebInterface no
	514	Specifies whether the web interface is enabled.
ef416fc2	515	.SH SEE ALSO
c41769ff MS	516	\fIclasses.conf(5)\fR, \fIcups-files.conf(5)\fR, \fIcupsd(8)\fR,
c41769ff MS	517	\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
bd7854cb	518	\fIsubscriptions.conf(5)\fR,
	519	.br
	520	http://localhost:631/help
ef416fc2	521	.SH COPYRIGHT
0fa6c7fa	522	Copyright 2007-2013 by Apple Inc.
ef416fc2	523	.\"
61515785	524	.\" End of "$Id: cupsd.conf.man.in 11109 2013-07-08 21:15:13Z msweet $".
ef416fc2	525	.\"