.\"
-.\" "$Id: cupsd.conf.man.in 5099 2006-02-13 02:46:10Z mike $"
+.\" "$Id: cupsd.conf.man.in 7935 2008-09-11 01:54:11Z mike $"
.\"
.\" cupsd.conf man page for the Common UNIX Printing System (CUPS).
.\"
+.\" Copyright 2007-2010 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" These coded instructions, statements, and computer programs are the
-.\" property of Easy Software Products 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 missing or damaged please contact Easy Software Products
-.\" at:
+.\" 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/".
.\"
-.\" Attn: CUPS Licensing Information
-.\" Easy Software Products
-.\" 44141 Airport View Drive, Suite 204
-.\" Hollywood, Maryland 20636 USA
-.\"
-.\" Voice: (301) 373-9600
-.\" EMail: cups-info@cups.org
-.\" WWW: http://www.cups.org
-.\"
-.TH cupsd.conf 5 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
+.TH cupsd.conf 5 "CUPS" "28 January 2010" "Apple Inc."
.SH NAME
cupsd.conf \- server configuration file for cups
.SH DESCRIPTION
.br
Defines the access log filename.
.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
AuthType BasicDigest
.TP 5
AuthType Digest
+.TP 5
+AuthType Negotiate
.br
-Specifies the authentication type (None, Basic, BasicDigest, Digest)
+Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
.TP 5
AutoPurgeJobs Yes
.TP 5
.br
Specifies the maximum interval between printer information broadcasts.
.TP 5
+BrowseLDAPBindDN
+.br
+Specifies the LDAP domain name to use when registering printers.
+.TP 5
+BrowseLDAPCACertFile
+.br
+Specifies the SSL certificate authority file to use.
+.TP 5
+BrowseLDAPDN
+.br
+Specifies the LDAP domain name to use when discovering printers.
+.TP 5
+BrowseLDAPPassword
+.br
+Specifies the password to use when accessing the LDAP server.
+.TP 5
+BrowseLDAPServer
+.br
+Specifies the LDAP server to use.
+.TP 5
BrowseOrder allow,deny
.TP 5
BrowseOrder deny,allow
Specifies the maximum interval between printer information updates before
remote printers will be removed from the list of available printers.
.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
DefaultAuthType BasicDigest
.TP 5
DefaultAuthType Digest
+.TP 5
+DefaultAuthType Negotiate
.br
Specifies the default type of authentication to use.
.TP 5
-DefaultCharset charset
+DefaultEncryption Never
+.TP 5
+DefaultEncryption IfRequested
+.TP 5
+DefaultEncryption Required
.br
-Specifies the default character set to use for text.
+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
.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
DocumentRoot directory
.br
Specifies the root directory for the internal web server documents.
.br
Specifies the error log filename.
.TP 5
+FatalErrors none
+.TP 5
+FatalErrors all -kind [... -kind]
+.TP 5
+FatalErrors kind [... kind]
+.br
+Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
+"browse", "config", "listen", "log", or "permissions".
+.TP 5
FileDevice Yes
.TP 5
FileDevice No
.br
Specifies whether to hide members of implicit classes.
.TP 5
-HostNameLookups Yes
+HostNameLookups On
.TP 5
-HostNameLookups No
+HostNameLookups Off
.TP 5
HostNameLookups Double
.br
.br
Includes the named file.
.TP 5
-KeepAlive Yes
-.TP 5
-KeepAlive No
+JobKillDelay seconds
.br
-Specifies whether to support HTTP keep-alive connections.
-.TP 5
-KeepAliveTimeout seconds
-.br
-Specifies the amount of time that connections are kept alive.
+Specifies the number of seconds to wait before killing the filters and backend
+associated with a canceled or held job.
.TP 5
JobRetryInterval seconds
.br
.br
Specifies the number of retries that are done for jobs.
.TP 5
-KeepAlive
+KeepAlive Yes
+.TP 5
+KeepAlive No
.br
-Specifies whether or not to support HTTP Keep-Alive.
+Specifies whether to support HTTP keep-alive connections.
.TP 5
-KeepAliveTimeout
+KeepAliveTimeout seconds
.br
-Specifies the connection timeout for HTTP Keep-Alive.
+Specifies the amount of time that connections are kept alive.
.TP 5
<Limit operations> ... </Limit>
.br
Listen ip-address:port
.TP 5
Listen *:port
+.TP 5
+Listen /path/to/domain/socket
.br
-Listens to the specified address and port.
+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
LogFilePerm mode
.br
Specifies the permissions for all log files that the scheduler writes.
.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.
.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 page log filename.
.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
PrintcapFormat bsd
.TP 5
+PrintcapFormat plist
+.TP 5
PrintcapFormat solaris
.br
Specifies the format of the printcap file.
.br
Specifies the email address of the server administrator.
.TP 5
+ServerAlias hostname
+.br
+Specifies an alternate name that the server is known by. The special name "*"
+allows any name to be used.
+.TP 5
ServerBin directory
.br
Specifies the directory where backends, CGIs, daemons, and filters may
.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.
.br
http://localhost:631/help
.SH COPYRIGHT
-Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
+Copyright 2007-2009 by Apple Inc.
.\"
-.\" End of "$Id: cupsd.conf.man.in 5099 2006-02-13 02:46:10Z mike $".
+.\" End of "$Id: cupsd.conf.man.in 7935 2008-09-11 01:54:11Z mike $".
.\"