help/raster-driver.html \
help/ref-access_log.html \
help/ref-classes-conf.html \
- help/ref-cupsd-conf.html \
- help/ref-cups-files-conf.html \
help/ref-error_log.html \
help/ref-mailto-conf.html \
help/ref-page_log.html \
<h2 class="title"><a name="NAME">Name</a></h2>
classes.conf - class configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>classes.conf</i> file defines the local printer classes that are
-available. It is normally located in the <i>/etc/cups</i> directory and
-is generated automatically by the <i>cupsd(8)</i> program when printer
-classes are added or deleted.
-<p>Each line in the file can be a configuration directive, a blank line,
-or a comment. Comment lines start with the # character.
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl class="man">
-<dt><Class name> ... </Class>
-<dd style="margin-left: 5.0em"><br>
-Defines a specific printer class.
-<dt><DefaultClass name> ... </Class>
-<dd style="margin-left: 5.0em"><br>
-Defines a default printer class.
-<dt>Accepting Yes
-<dd style="margin-left: 5.0em"><dt>Accepting No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether the printer is accepting new jobs.
-<dt>AllowUser [ user @group ... ]
-<dd style="margin-left: 5.0em"><br>
-Allows specific users and groups to print to the printer.
-<dt>DenyUser [ user @group ... ]
-<dd style="margin-left: 5.0em"><br>
-Prevents specific users and groups from printing to the printer.
-<dt>Info text
-<dd style="margin-left: 5.0em"><br>
-Specifies human-readable text describing the printer.
-<dt>JobSheets banner banner
-<dd style="margin-left: 5.0em"><br>
-Specifies the banner pages to use for the printer.
-<dt>KLimit number
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-k-limit value for the printer.
-<dt>Location text
-<dd style="margin-left: 5.0em"><br>
-Specifies human-readable text describing the location of the printer.
-<dt>OpPolicy name
-<dd style="margin-left: 5.0em"><br>
-Specifies the operation policy for the printer.
-<dt>PageLimit number
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-page-limit value for the printer.
-<dt>Printer
-<dd style="margin-left: 5.0em"><br>
-Specifies a printer that is a member of the printer class.
-<dt>QuotaPeriod seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-quota-period value for the printer.
-<dt>Shared Yes
-<dd style="margin-left: 5.0em"><dt>Shared No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether the printer is shared.
-<dt>State idle
-<dd style="margin-left: 5.0em"><dt>State stopped
-<dd style="margin-left: 5.0em"><br>
-Specifies the initial state of the printer (Idle or Stopped)
-<dt>StateMessage text
-<dd style="margin-left: 5.0em"><br>
-Specifies the message associated with the state.
-<dt>StateTime seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the date/time associated with the state.
-</dl>
+The <b>classes.conf</b> file defines the local printer classes that are available. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+program. This file is not intended to be edited or managed manually.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>cupsd(8)</i>, <i>cupsd.conf(5)</i>, <i>mime.convs(5)</i>,
-<i>mime.types(5)</i>, <i>printers.conf(5)</i>,
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
+<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
+<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
cups-config - get cups api, compiler, directory, and link information.
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cups-config</b>
---api-version
+<i>--api-version</i>
<br>
<b>cups-config</b>
---build
+<i>--build</i>
<br>
<b>cups-config</b>
---cflags
+<i>--cflags</i>
<br>
<b>cups-config</b>
---datadir
+<i>--datadir</i>
<br>
<b>cups-config</b>
---help
+<i>--help</i>
<br>
<b>cups-config</b>
---ldflags
+<i>--ldflags</i>
<br>
<b>cups-config</b>
[
<i>--image</i>
] [
<i>--static</i>
-] --libs
+]
+<i>--libs</i>
<br>
<b>cups-config</b>
---serverbin
+<i>--serverbin</i>
<br>
<b>cups-config</b>
---serverroot
+<i>--serverroot</i>
<br>
<b>cups-config</b>
---version
+<i>--version</i>
<br>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cups-config</b> is the CUPS program configuration utility. It should be
-used by application developers to determine the necessary command-line
-options for the compiler and linker, as well as determining installation
-directories for filters, configuration files, and drivers.
+The <b>cups-config</b> command allows application developers to determine the necessary command-line options for the compiler and linker, as well as the installation directories for filters, configuration files, and drivers.
+All values are reported to the standard output.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
+The <b>cups-config</b> command accepts the following command-line options:
<dl class="man">
-<dt>--api-version
-<dd style="margin-left: 5.0em"><br>
-Displays the current API version (major.minor).
-<dt>--build
-<dd style="margin-left: 5.0em"><br>
-Displays a system-specific build number.
-<dt>--cflags
-<dd style="margin-left: 5.0em"><br>
-Displays the necessary compiler options.
-<dt>--datadir
-<dd style="margin-left: 5.0em"><br>
-Displays the default CUPS data directory.
-<dt>--help
-<dd style="margin-left: 5.0em"><br>
-Displays the program usage message.
-<dt>--image
-<dd style="margin-left: 5.0em"><br>
-When used with <i>--libs</i>, adds the CUPS imaging library to the
-list of displayed libraries.
-<dt>--ldflags
-<dd style="margin-left: 5.0em"><br>
-Displays the necessary linker options.
-<dt>--libs
-<dd style="margin-left: 5.0em"><br>
-Displays the necessary librarys to link to.
-<dt>--serverbin
-<dd style="margin-left: 5.0em"><br>
-Displays the default CUPS binary directory,
-where filters and backends are stored.
-<dt>--serverroot
-<dd style="margin-left: 5.0em"><br>
-Displays the default CUPS configuration file directory.
-<dt>--static
-<dd style="margin-left: 5.0em"><br>
-When used with <i>--libs</i>, shows the static libraries instead
-of the default (shared) libraries.
-<dt>--version
-<dd style="margin-left: 5.0em"><br>
-Displays the full version number of the CUPS installation
-(major.minor.patch).
+<dt><b>--api-version</b>
+<dd style="margin-left: 5.0em">Reports the current API version (major.minor).
+<dt><b>--build</b>
+<dd style="margin-left: 5.0em">Reports a system-specific build number.
+<dt><b>--cflags</b>
+<dd style="margin-left: 5.0em">Reports the necessary compiler options.
+<dt><b>--datadir</b>
+<dd style="margin-left: 5.0em">Reports the default CUPS data directory.
+<dt><b>--help</b>
+<dd style="margin-left: 5.0em">Reports the program usage message.
+<dt><b>--image</b>
+<dd style="margin-left: 5.0em">When used with <i>--libs</i>, adds the CUPS imaging library to the
+list of libraries.
+<dt><b>--ldflags</b>
+<dd style="margin-left: 5.0em">Reports the necessary linker options.
+<dt><b>--libs</b>
+<dd style="margin-left: 5.0em">Reports the necessary libraries to link to.
+<dt><b>--serverbin</b>
+<dd style="margin-left: 5.0em">Reports the default CUPS binary directory, where filters and backends are stored.
+<dt><b>--serverroot</b>
+<dd style="margin-left: 5.0em">Reports the default CUPS configuration file directory.
+<dt><b>--static</b>
+<dd style="margin-left: 5.0em">When used with <i>--libs</i>, reports the static libraries instead of the default (shared) libraries.
+<dt><b>--version</b>
+<dd style="margin-left: 5.0em">Reports the full version number of the CUPS installation (major.minor.patch).
</dl>
+<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
+Show the currently installed version of CUPS:
+<pre class="man">
+
+ cups-config --version
+
+</pre>
+Compile a simple one-file CUPS filter:
+<pre class="man">
+
+ cc `cups-config --cflags --ldflags` -o filter filter.c \
+ `cups-config --libs`
+</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-files.conf - file and directory configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>cups-files.conf</i> file configures the files and directories used by the
-CUPS scheduler, <i>cupsd(8)</i>. It is normally located in the
-<i>/etc/cups</i> directory.
+The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+It is normally located in the <i>/etc/cups</i> directory.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsd.conf - server configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>cupsd.conf</i> file configures the CUPS scheduler, <i>cupsd(8)</i>. It
-is normally located in the <i>/etc/cups</i> directory. <b>Note:</b>
-File, directory, and user configuration directives that used to be allowed in
-the <i>cupsd.conf</i> file are now stored in the <i>cups-files.conf(5)</i> instead
-in order to prevent certain types of privilege escalation attacks.
-<p>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.
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-The following directives are understood by <i>cupsd(8)</i>. Consult the
-on-line help for detailed descriptions:
+The
+<i>cupsd.conf</i>
+file configures the CUPS scheduler,
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+It is normally located in the
+<i>/etc/cups</i>
+directory. <b>Note:</b> File, directory, and user configuration directives that used to be allowed in the <i>cupsd.conf</i> file are now stored in the <i>cups-files.conf(5)</i> instead in order to prevent certain types of privilege escalation attacks.
+<p>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.
+<h2 class="title"><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h2>
+The following directives are understood by
+<b>cupsd</b><b>(8).</b>
+Consult the online help (<a href="http://localhost:631/help">http://localhost:631/help</a>) for detailed descriptions:
<dl class="man">
<dt>AccessLogLevel config
<dd style="margin-left: 5.0em"><dt>AccessLogLevel actions
<dd style="margin-left: 5.0em"><dt>AccessLogLevel all
-<dd style="margin-left: 5.0em"><br>
-Specifies the logging level for the AccessLog file.
-<dt>Allow all
-<dd style="margin-left: 5.0em"><dt>Allow none
-<dd style="margin-left: 5.0em"><dt>Allow host.domain.com
-<dd style="margin-left: 5.0em"><dt>Allow *.domain.com
-<dd style="margin-left: 5.0em"><dt>Allow ip-address
-<dd style="margin-left: 5.0em"><dt>Allow ip-address/netmask
-<dd style="margin-left: 5.0em"><dt>Allow ip-address/mm
-<dd style="margin-left: 5.0em"><dt>Allow @IF(name)
-<dd style="margin-left: 5.0em"><dt>Allow @LOCAL
-<dd style="margin-left: 5.0em"><br>
-Allows access from the named hosts or addresses.
-<dt>AuthType None
-<dd style="margin-left: 5.0em"><dt>AuthType Basic
-<dd style="margin-left: 5.0em"><dt>AuthType BasicDigest
-<dd style="margin-left: 5.0em"><dt>AuthType Digest
-<dd style="margin-left: 5.0em"><dt>AuthType Negotiate
-<dd style="margin-left: 5.0em"><br>
-Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
+<dd style="margin-left: 5.0em">Specifies the logging level for the AccessLog file.
<dt>AutoPurgeJobs Yes
<dd style="margin-left: 5.0em"><dt>AutoPurgeJobs No
<dd style="margin-left: 5.0em"><br>
Specifies whether to purge job history data automatically when
it is no longer required for quotas.
-<dt>BrowseLocalProtocols [All] [DNSSD]
-<dd style="margin-left: 5.0em"><br>
+<dt>BrowseLocalProtocols [
+<dd style="margin-left: 5.0em"><i>All</i>
+] [
+<i>DNSSD</i>
+]
Specifies the protocols to use for local printer sharing.
<dt>BrowseWebIF Yes
<dd style="margin-left: 5.0em"><dt>BrowseWebIF No
Specifies whether to allow users to override the classification
of individual print jobs.
<dt>DefaultAuthType Basic
-<dd style="margin-left: 5.0em"><dt>DefaultAuthType BasicDigest
-<dd style="margin-left: 5.0em"><dt>DefaultAuthType Digest
<dd style="margin-left: 5.0em"><dt>DefaultAuthType Negotiate
<dd style="margin-left: 5.0em"><br>
Specifies the default type of authentication to use.
<dt>DefaultEncryption Never
<dd style="margin-left: 5.0em"><dt>DefaultEncryption IfRequested
<dd style="margin-left: 5.0em"><dt>DefaultEncryption Required
-<dd style="margin-left: 5.0em"><br>
-Specifies the type of encryption to use for authenticated requests.
+<dd style="margin-left: 5.0em">Specifies the type of encryption to use for authenticated requests.
<dt>DefaultLanguage locale
-<dd style="margin-left: 5.0em"><br>
-Specifies the default language to use for text and web content.
+<dd style="margin-left: 5.0em">Specifies the default language to use for text and web content.
<dt>DefaultPaperSize Auto
<dd style="margin-left: 5.0em"><dt>DefaultPaperSize None
<dd style="margin-left: 5.0em"><dt>DefaultPaperSize sizename
-<dd style="margin-left: 5.0em"><br>
-Specifies the default paper size for new print queues. "Auto" uses a locale-
+<dd style="margin-left: 5.0em">Specifies the default paper size for new print queues. "Auto" uses a locale-
specific default, while "None" specifies there is no default paper size.
<dt>DefaultPolicy policy-name
-<dd style="margin-left: 5.0em"><br>
-Specifies the default access policy to use.
+<dd style="margin-left: 5.0em">Specifies the default access policy to use.
<dt>DefaultShared Yes
<dd style="margin-left: 5.0em"><dt>DefaultShared No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether local printers are shared by default.
-<dt>Deny all
-<dd style="margin-left: 5.0em"><dt>Deny none
-<dd style="margin-left: 5.0em"><dt>Deny host.domain.com
-<dd style="margin-left: 5.0em"><dt>Deny *.domain.com
-<dd style="margin-left: 5.0em"><dt>Deny ip-address
-<dd style="margin-left: 5.0em"><dt>Deny ip-address/netmask
-<dd style="margin-left: 5.0em"><dt>Deny ip-address/mm
-<dd style="margin-left: 5.0em"><dt>Deny @IF(name)
-<dd style="margin-left: 5.0em"><dt>Deny @LOCAL
-<dd style="margin-left: 5.0em"><br>
-Denies access to the named host or address.
+<dd style="margin-left: 5.0em">Specifies whether local printers are shared by default.
<dt>DirtyCleanInterval seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the delay for updating of configuration and state files. A value of 0
+<dd style="margin-left: 5.0em">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.
-<dt>Encryption IfRequested
-<dd style="margin-left: 5.0em"><dt>Encryption Never
-<dd style="margin-left: 5.0em"><dt>Encryption Required
-<dd style="margin-left: 5.0em"><br>
-Specifies the level of encryption that is required for a particular
-location.
<dt>FilterLimit limit
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum cost of filters that are run concurrently.
+<dd style="margin-left: 5.0em">Specifies the maximum cost of filters that are run concurrently.
<dt>FilterNice nice-value
-<dd style="margin-left: 5.0em"><br>
-Specifies the scheduling priority ("nice" value) of filters that
+<dd style="margin-left: 5.0em">Specifies the scheduling priority ("nice" value) of filters that
are run to print a job.
<dt>GSSServiceName name
-<dd style="margin-left: 5.0em"><br>
-Specifies the service name when using Kerberos authentication. The default
+<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication. The default
service name is "http".
<dt>HostNameLookups On
<dd style="margin-left: 5.0em"><dt>HostNameLookups Off
<dd style="margin-left: 5.0em"><dt>HostNameLookups Double
-<dd style="margin-left: 5.0em"><br>
-Specifies whether or not to do reverse lookups on client addresses.
+<dd style="margin-left: 5.0em">Specifies whether or not to do reverse lookups on client addresses.
<dt>Include filename
-<dd style="margin-left: 5.0em"><br>
-Includes the named file.
+<dd style="margin-left: 5.0em">Includes the named file.
<dt>JobKillDelay seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the number of seconds to wait before killing the filters and backend
+<dd style="margin-left: 5.0em">Specifies the number of seconds to wait before killing the filters and backend
associated with a canceled or held job.
-<dt>JobPrivateAccess all
-<dd style="margin-left: 5.0em"><dt>JobPrivateAccess default
-<dd style="margin-left: 5.0em"><dt>JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
-<dd style="margin-left: 5.0em"><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.
-<dt>JobPrivateValues all
-<dd style="margin-left: 5.0em"><dt>JobPrivateValues default
-<dd style="margin-left: 5.0em"><dt>JobPrivateValues none
-<dd style="margin-left: 5.0em"><dt>JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
-<dd style="margin-left: 5.0em">Specifies the list of job values to make private. The "default" values are
-"job-name", "job-originating-host-name", and "job-originating-user-name".
<dt>JobRetryInterval seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the interval between retries of jobs in seconds.
+<dd style="margin-left: 5.0em">Specifies the interval between retries of jobs in seconds.
<dt>JobRetryLimit count
-<dd style="margin-left: 5.0em"><br>
-Specifies the number of retries that are done for jobs.
+<dd style="margin-left: 5.0em">Specifies the number of retries that are done for jobs.
<dt>KeepAlive Yes
<dd style="margin-left: 5.0em"><dt>KeepAlive No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether to support HTTP keep-alive connections.
+<dd style="margin-left: 5.0em">Specifies whether to support HTTP keep-alive connections.
<dt>KeepAliveTimeout seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the amount of time that connections are kept alive.
+<dd style="margin-left: 5.0em">Specifies the amount of time that connections are kept alive.
<dt><Limit operations> ... </Limit>
-<dd style="margin-left: 5.0em"><br>
-Specifies the IPP operations that are being limited inside a policy.
+<dd style="margin-left: 5.0em">Specifies the IPP operations that are being limited inside a policy.
<dt><Limit methods> ... </Limit>
<dd style="margin-left: 5.0em"><dt><LimitExcept methods> ... </LimitExcept>
-<dd style="margin-left: 5.0em"><br>
-Specifies the HTTP methods that are being limited inside a location.
+<dd style="margin-left: 5.0em">Specifies the HTTP methods that are being limited inside a location.
<dt>LimitRequestBody
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum size of any print job request.
+<dd style="margin-left: 5.0em">Specifies the maximum size of any print job request.
<dt>Listen ip-address:port
<dd style="margin-left: 5.0em"><dt>Listen *:port
<dd style="margin-left: 5.0em"><dt>Listen /path/to/domain/socket
-<dd style="margin-left: 5.0em"><br>
-Listens to the specified address and port or domain socket path.
+<dd style="margin-left: 5.0em">Listens to the specified address and port or domain socket path.
<dt><Location /path> ... </Location>
-<dd style="margin-left: 5.0em"><br>
-Specifies access control for the named location.
+<dd style="margin-left: 5.0em">Specifies access control for the named location.
<dt>LogDebugHistory #-messages
-<dd style="margin-left: 5.0em"><br>
-Specifies the number of debugging messages that are logged when an error
+<dd style="margin-left: 5.0em">Specifies the number of debugging messages that are logged when an error
occurs in a print job.
<dt>LogLevel alert
<dd style="margin-left: 5.0em"><dt>LogLevel crit
<dd style="margin-left: 5.0em"><dt>LogLevel none
<dd style="margin-left: 5.0em"><dt>LogLevel notice
<dd style="margin-left: 5.0em"><dt>LogLevel warn
-<dd style="margin-left: 5.0em"><br>
-Specifies the logging level for the ErrorLog file.
+<dd style="margin-left: 5.0em">Specifies the logging level for the ErrorLog file.
<dt>LogTimeFormat standard
<dd style="margin-left: 5.0em"><dt>LogTimeFormat usecs
-<dd style="margin-left: 5.0em"><br>
-Specifies the format of the date and time in the log files.
+<dd style="margin-left: 5.0em">Specifies the format of the date and time in the log files.
<dt>MaxClients number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of simultaneous clients to support.
+<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients to support.
<dt>MaxClientsPerHost number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of simultaneous clients to support from a
+<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients to support from a
single address.
<dt>MaxCopies number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of copies that a user can print of each job.
+<dd style="margin-left: 5.0em">Specifies the maximum number of copies that a user can print of each job.
<dt>MaxHoldTime seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum time a job may remain in the "indefinite" hold state
+<dd style="margin-left: 5.0em">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.
<dt>MaxJobs number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of simultaneous jobs to support.
+<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs to support.
<dt>MaxJobsPerPrinter number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of simultaneous jobs per printer to support.
+<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs per printer to support.
<dt>MaxJobsPerUser number
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of simultaneous jobs per user to support.
+<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs per user to support.
<dt>MaxJobTime seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum time a job may take to print before it is canceled. The
+<dd style="margin-left: 5.0em">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.
<dt>MaxLogSize number-bytes
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum size of the log files before they are
+<dd style="margin-left: 5.0em">Specifies the maximum size of the log files before they are
rotated (0 to disable rotation)
<dt>MaxRequestSize number-bytes
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum request/file size in bytes (0 for no limit)
+<dd style="margin-left: 5.0em">Specifies the maximum request/file size in bytes (0 for no limit)
<dt>MultipleOperationTimeout seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum amount of time to allow between files in a multiple file
+<dd style="margin-left: 5.0em">Specifies the maximum amount of time to allow between files in a multiple file
print job.
-<dt>Order allow,deny
-<dd style="margin-left: 5.0em"><dt>Order deny,allow
-<dd style="margin-left: 5.0em"><br>
-Specifies the order of HTTP access control (allow,deny or deny,allow)
<dt>PageLogFormat format string
-<dd style="margin-left: 5.0em"><br>
-Specifies the format of page log lines.
+<dd style="margin-left: 5.0em">Specifies the format of page log lines.
<dt>PassEnv variable [... variable]
-<dd style="margin-left: 5.0em"><br>
-Passes the specified environment variable(s) to child processes.
+<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
<dt><Policy name> ... </Policy>
-<dd style="margin-left: 5.0em"><br>
-Specifies access control for the named policy.
+<dd style="margin-left: 5.0em">Specifies access control for the named policy.
<dt>Port number
-<dd style="margin-left: 5.0em"><br>
-Specifies a port number to listen to for HTTP requests.
+<dd style="margin-left: 5.0em">Specifies a port number to listen to for HTTP requests.
<dt>PreserveJobFiles Yes
<dd style="margin-left: 5.0em"><dt>PreserveJobFiles No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether or not to preserve job files after they are printed.
+<dd style="margin-left: 5.0em">Specifies whether or not to preserve job files after they are printed.
<dt>PreserveJobHistory Yes
<dd style="margin-left: 5.0em"><dt>PreserveJobHistory No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether or not to preserve the job history after they are
+<dd style="margin-left: 5.0em">Specifies whether or not to preserve the job history after they are
printed.
<dt>PrintcapFormat bsd
<dd style="margin-left: 5.0em"><dt>PrintcapFormat plist
<dd style="margin-left: 5.0em"><dt>PrintcapFormat solaris
-<dd style="margin-left: 5.0em"><br>
-Specifies the format of the printcap file.
+<dd style="margin-left: 5.0em">Specifies the format of the printcap file.
<dt>ReloadTimeout seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the amount of time to wait for job completion before
+<dd style="margin-left: 5.0em">Specifies the amount of time to wait for job completion before
restarting the scheduler.
-<dt>Require group group-name-list
-<dd style="margin-left: 5.0em"><dt>Require user user-name-list
-<dd style="margin-left: 5.0em"><dt>Require valid-user
-<dd style="margin-left: 5.0em"><br>
-Specifies that user or group authentication is required.
<dt>RIPCache bytes
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum amount of memory to use when converting images
+<dd style="margin-left: 5.0em">Specifies the maximum amount of memory to use when converting images
and PostScript files to bitmaps for a printer.
<dt>Satisfy all
<dd style="margin-left: 5.0em"><dt>Satisfy any
-<dd style="margin-left: 5.0em"><br>
-Specifies whether all or any limits set for a Location must be
+<dd style="margin-left: 5.0em">Specifies whether all or any limits set for a Location must be
satisfied to allow access.
<dt>ServerAdmin user@domain.com
-<dd style="margin-left: 5.0em"><br>
-Specifies the email address of the server administrator.
+<dd style="margin-left: 5.0em">Specifies the email address of the server administrator.
<dt>ServerAlias hostname [... hostname]
<dd style="margin-left: 5.0em"><dt>ServerAlias *
-<dd style="margin-left: 5.0em"><br>
-Specifies an alternate name that the server is known by. The special name "*"
+<dd style="margin-left: 5.0em">Specifies an alternate name that the server is known by. The special name "*"
allows any name to be used.
<dt>ServerName hostname-or-ip-address
-<dd style="margin-left: 5.0em"><br>
-Specifies the fully-qualified hostname of the server.
+<dd style="margin-left: 5.0em">Specifies the fully-qualified hostname of the server.
<dt>ServerTokens Full
<dd style="margin-left: 5.0em"><dt>ServerTokens Major
<dd style="margin-left: 5.0em"><dt>ServerTokens Minimal
<dd style="margin-left: 5.0em"><dt>ServerTokens None
<dd style="margin-left: 5.0em"><dt>ServerTokens OS
<dd style="margin-left: 5.0em"><dt>ServerTokens ProductOnly
-<dd style="margin-left: 5.0em"><br>
-Specifies what information is included in the Server header of HTTP
+<dd style="margin-left: 5.0em">Specifies what information is included in the Server header of HTTP
responses.
<dt>SetEnv variable value
-<dd style="margin-left: 5.0em"><br>
-Set the specified environment variable to be passed to child processes.
+<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
<dt>SSLListen
-<dd style="margin-left: 5.0em"><br>
-Listens on the specified address and port for encrypted connections.
+<dd style="margin-left: 5.0em">Listens on the specified address and port for encrypted connections.
<dt>SSLPort
-<dd style="margin-left: 5.0em"><br>
-Listens on the specified port for encrypted connections.
+<dd style="margin-left: 5.0em">Listens on the specified port for encrypted connections.
<dt>StrictConformance Yes
<dd style="margin-left: 5.0em"><dt>StrictConformance No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether the scheduler requires clients to strictly adhere to the IPP
+<dd style="margin-left: 5.0em">Specifies whether the scheduler requires clients to strictly adhere to the IPP
specifications. The default is No.
+<dt>Timeout seconds
+<dd style="margin-left: 5.0em">Specifies the HTTP request timeout in seconds.
+<dt>WebInterface yes
+<dd style="margin-left: 5.0em"><dt>WebInterface no
+<dd style="margin-left: 5.0em">Specifies whether the web interface is enabled.
+</dl>
+<h2 class="title"><a name="DIRECTIVES_VALID_WITHIN_LOCATION_AND_LIMIT_SECTIONS">Directives Valid Within Location And Limit Sections</a></h2>
+The following directives may be placed inside Location and Limit sections in the <i>cupsd.conf</i> file:
+<dl class="man">
+<dt>Allow all
+<dd style="margin-left: 5.0em"><dt>Allow none
+<dd style="margin-left: 5.0em"><dt>Allow host.domain.com
+<dd style="margin-left: 5.0em"><dt>Allow *.domain.com
+<dd style="margin-left: 5.0em"><dt>Allow ip-address
+<dd style="margin-left: 5.0em"><dt>Allow ip-address/netmask
+<dd style="margin-left: 5.0em"><dt>Allow ip-address/mm
+<dd style="margin-left: 5.0em"><dt>Allow @IF(name)
+<dd style="margin-left: 5.0em"><dt>Allow @LOCAL
+<dd style="margin-left: 5.0em">Allows access from the named hosts or addresses.
+<dt>AuthType None
+<dd style="margin-left: 5.0em"><dt>AuthType Basic
+<dd style="margin-left: 5.0em"><dt>AuthType Negotiate
+<dd style="margin-left: 5.0em">Specifies the authentication type (None, Basic, or Negotiate)
+<dt>Deny all
+<dd style="margin-left: 5.0em"><dt>Deny none
+<dd style="margin-left: 5.0em"><dt>Deny host.domain.com
+<dd style="margin-left: 5.0em"><dt>Deny *.domain.com
+<dd style="margin-left: 5.0em"><dt>Deny ip-address
+<dd style="margin-left: 5.0em"><dt>Deny ip-address/netmask
+<dd style="margin-left: 5.0em"><dt>Deny ip-address/mm
+<dd style="margin-left: 5.0em"><dt>Deny @IF(name)
+<dd style="margin-left: 5.0em"><dt>Deny @LOCAL
+<dd style="margin-left: 5.0em">Denies access to the named host or address.
+<dt>Encryption IfRequested
+<dd style="margin-left: 5.0em"><dt>Encryption Never
+<dd style="margin-left: 5.0em"><dt>Encryption Required
+<dd style="margin-left: 5.0em">Specifies the level of encryption that is required for a particular
+location.
+<dt>Order allow,deny
+<dd style="margin-left: 5.0em"><dt>Order deny,allow
+<dd style="margin-left: 5.0em">Specifies the order of HTTP access control (allow,deny or deny,allow)
+<dt>Require group group-name-list
+<dd style="margin-left: 5.0em"><dt>Require user user-name-list
+<dd style="margin-left: 5.0em"><dt>Require valid-user
+<dd style="margin-left: 5.0em">Specifies that user or group authentication is required.
+</dl>
+<h2 class="title"><a name="DIRECTIVES_VALID_WITHIN_POLICY_SECTIONS">Directives Valid Within Policy Sections</a></h2>
+The following directives may be placed inside Policy sections in the <i>cupsd.conf</i> file:
+<dl class="man">
+<dt>JobPrivateAccess all
+<dd style="margin-left: 5.0em"><dt>JobPrivateAccess default
+<dd style="margin-left: 5.0em"><dt>JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
+<dd style="margin-left: 5.0em">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.
+<dt>JobPrivateValues all
+<dd style="margin-left: 5.0em"><dt>JobPrivateValues default
+<dd style="margin-left: 5.0em"><dt>JobPrivateValues none
+<dd style="margin-left: 5.0em"><dt>JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
+<dd style="margin-left: 5.0em">Specifies the list of job values to make private. The "default" values are "job-name", "job-originating-host-name", and "job-originating-user-name".
<dt>SubscriptionPrivateAccess all
<dd style="margin-left: 5.0em"><dt>SubscriptionPrivateAccess default
<dd style="margin-left: 5.0em"><dt>SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
-<dd style="margin-left: 5.0em"><br>
-Specifies an access list for a subscription's private values. The "default"
+<dd style="margin-left: 5.0em">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.
<dt>SubscriptionPrivateValues all
<dd style="margin-left: 5.0em">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".
-<dt>Timeout seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the HTTP request timeout in seconds.
-<dt>WebInterface yes
-<dd style="margin-left: 5.0em"><dt>WebInterface no
-<dd style="margin-left: 5.0em">Specifies whether the web interface is enabled.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>classes.conf(5)</i>, <i>cups-files.conf(5)</i>, <i>cupsd(8)</i>,
-<i>mime.convs(5)</i>, <i>mime.types(5)</i>, <i>printers.conf(5)</i>,
-<i>subscriptions.conf(5)</i>,
-<br>
+<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a><a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a><a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a><a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a><a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a><a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a><a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
cupsd - cups scheduler
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsd</b>
-[ -c
+[
+<b>-c</b>
<i>config-file</i>
-] [ -f ] [ -F ] [ -h ] [ -l ] [ -t ]
+] [
+<b>-f</b>
+] [
+<b>-F</b>
+] [
+<b>-h</b>
+] [
+<b>-l</b>
+] [
+<b>-t</b>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<b>cupsd</b>
is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1. If no options are specified on the command-line then the default configuration file
will be used.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<dl class="man">
-<dt>-c config-file
+<dt><b>-c</b><i> config-file</i>
<dd style="margin-left: 5.0em">Uses the named configuration file.
-<dt>-f
+<dt><b>-f</b>
<dd style="margin-left: 5.0em">Run
<b>cupsd</b>
in the foreground; the default is to run in the background as a "daemon".
-<dt>-F
+<dt><b>-F</b>
<dd style="margin-left: 5.0em">Run
<b>cupsd</b>
in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
-<b>cupsd</b>from<b>init</b>(8).
-<dt>-h
+<b>cupsd</b>
+from
+<b>init</b>(8).
+<dt><b>-h</b>
<dd style="margin-left: 5.0em">Shows the program usage.
-<dt>-l
+<dt><b>-l</b>
<dd style="margin-left: 5.0em">This option is passed to
<b>cupsd</b>
when it is run from
-<b>launchd</b>(8).
-<dt>-t
+<b>launchd</b>(8)
+or
+<b>systemd</b>(8).
+<dt><b>-t</b>
<dd style="margin-left: 5.0em">Test the configuration file for syntax errors.
</dl>
-<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
+<h2 class="title"><a name="FILES">Files</a></h2>
+<pre class="man">
+<i>/etc/cups/classes.conf</i>
+<i>/etc/cups/cups-files.conf</i>
+<i>/etc/cups/cupsd.conf</i>
+<i>/usr/share/cups/mime/mime.convs</i>
+<i>/usr/share/cups/mime/mime.types</i>
+<i>/etc/cups/printers.conf</i>
+</pre>
+<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
+<b>cupsd</b>
+implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administrative operations.
+<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
+Run
+<b>cupsd</b>
+in the background with the default configuration file:
+<pre class="man">
+
+ cupsd
+
+</pre>
+Test a configuration file called
+<i>test.conf</i>:
+<pre class="man">
+
+ cupsd -t -c test.conf
+
+</pre>
+Run
<b>cupsd</b>
-implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administration operations.
+in the foreground with a test configuration file called
+<i>test.conf</i>:
+<pre class="man">
+
+ cupsd -f -c test.conf
+
+</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a><a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a><a href="man-cups-deviced.html?TOPIC=Man+Pages"><b>cups-deviced</b>(8),</a><a href="man-cups-driverd.html?TOPIC=Man+Pages"><b>cups-driverd</b>(8),</a><a href="man-cups-lpd.html?TOPIC=Man+Pages"><b>cups-lpd</b>(8),</a><a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a><a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a><b>launchd</b>(8),<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a><a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a><a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
+<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
+<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
+<b>cups-deviced</b>(8),
+<b>cups-driverd</b>(8),
+<a href="man-cups-lpd.html?TOPIC=Man+Pages"><b>cups-lpd</b>(8),</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
+<b>launchd</b>(8),
+<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
+<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
+<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+<b>systemd</b>(8),
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright © 2007-2014 by Apple Inc.
<h2 class="title"><a name="NAME">Name</a></h2>
printers.conf - printer configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>printers.conf</i> file defines the local printers that are
-available. It is normally located in the <i>/etc/cups</i> directory and
-is generated automatically by the <i>cupsd(8)</i> program when printers
-are added or deleted.
-<p>Each line in the file can be a configuration directive, a blank line,
-or a comment. Comment lines start with the # character.
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl class="man">
-<dt><Printer name> ... </Printer>
-<dd style="margin-left: 5.0em"><br>
-Defines a specific printer.
-<dt><DefaultPrinter name> ... </Printer>
-<dd style="margin-left: 5.0em"><br>
-Defines a default printer.
-<dt>Accepting Yes
-<dd style="margin-left: 5.0em"><dt>Accepting No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether the printer is accepting new jobs.
-<dt>AllowUser [ user @group ... ]
-<dd style="margin-left: 5.0em"><br>
-Allows specific users and groups to print to the printer.
-<dt>DenyUser [ user @group ... ]
-<dd style="margin-left: 5.0em"><br>
-Prevents specific users and groups from printing to the printer.
-<dt>DeviceURI uri
-<dd style="margin-left: 5.0em"><br>
-Specifies the device URI for a printer.
-<dt>ErrorPolicy abort-job
-<dd style="margin-left: 5.0em"><dt>ErrorPolicy retry-current-job
-<dd style="margin-left: 5.0em"><dt>ErrorPolicy retry-job
-<dd style="margin-left: 5.0em"><dt>ErrorPolicy stop-printer
-<dd style="margin-left: 5.0em"><br>
-Specifies the error policy for the printer.
-<dt>Info text
-<dd style="margin-left: 5.0em"><br>
-Specifies human-readable text describing the printer.
-<dt>JobSheets banner banner
-<dd style="margin-left: 5.0em"><br>
-Specifies the banner pages to use for the printer.
-<dt>KLimit number
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-k-limit value for the printer.
-<dt>Location text
-<dd style="margin-left: 5.0em"><br>
-Specifies human-readable text describing the location of the printer.
-<dt>OpPolicy name
-<dd style="margin-left: 5.0em"><br>
-Specifies the operation policy for the printer.
-<dt>PageLimit number
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-page-limit value for the printer.
-<dt>PortMonitor monitor
-<dd style="margin-left: 5.0em"><br>
-Specifies the port monitor for a printer.
-<dt>QuotaPeriod seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the job-quota-period value for the printer.
-<dt>Shared Yes
-<dd style="margin-left: 5.0em"><dt>Shared No
-<dd style="margin-left: 5.0em"><br>
-Specifies whether the printer is shared.
-<dt>State idle
-<dd style="margin-left: 5.0em"><dt>State stopped
-<dd style="margin-left: 5.0em"><br>
-Specifies the initial state of the printer (Idle or Stopped)
-<dt>StateMessage text
-<dd style="margin-left: 5.0em"><br>
-Specifies the message associated with the state.
-<dt>StateTime seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the date/time associated with the state.
-</dl>
+The <b>printers.conf</b> file defines the local printers that are available. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+program. This file is not intended to be edited or managed manually.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
-<i>mime.convs(5)</i>, <i>mime.types(5)</i>,
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
+<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
+<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">subscriptions.conf(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-subscriptions.conf - subscriptions file for cups
+subscriptions.conf - subscription configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>subscriptions.conf</i> file defines the local subscriptions
-that are active. It is normally located in the <i>/etc/cups</i>
-directory and is generated automatically by the <i>cupsd(8)</i>
-program when subscriptions are created, renewed, or cancelled.
-<p>Each line in the file can be a configuration directive, a blank line,
-or a comment. Comment lines start with the # character.
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl class="man">
-<dt><Subscription NNN> ... </Subscription>
-<dd style="margin-left: 5.0em"><br>
-Defines a subscription.
-<dt>Events name [ ... name ]
-<dd style="margin-left: 5.0em"><br>
-Specifies the events that are subscribed.
-<dt>ExpirationTime unix-time
-<dd style="margin-left: 5.0em"><br>
-Specifies the expiration time of a subscription as a UNIX time
-value in seconds since January 1st, 1970.
-<dt>Interval seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the preferred time interval for event notifications in
-seconds.
-<dt>JobId job-id
-<dd style="margin-left: 5.0em"><br>
-Specifies the job ID associated with the subscription.
-<dt>LeaseDuration seconds
-<dd style="margin-left: 5.0em"><br>
-Specifies the number of seconds that the subscription is valid
-for. If 0, the subscription does not expire.
-<dt>NextEventId number
-<dd style="margin-left: 5.0em"><br>
-Specifies the next notify-sequence-number to use for the
-subscription.
-<dt>NextSubscriptionId number
-<dd style="margin-left: 5.0em"><br>
-Specifies the next subscription-id to use.
-<dt>Owner username
-<dd style="margin-left: 5.0em"><br>
-Specifies the user that owns the subscription.
-<dt>PrinterName printername
-<dd style="margin-left: 5.0em"><br>
-Specifies the printer or class associated with the subscription.
-<dt>Recipient uri
-<dd style="margin-left: 5.0em"><br>
-Specifies the notify-recipient-uri value for push-type notifications.
-<dt>UserData hex-escaped-data
-<dd style="margin-left: 5.0em"><br>
-Specifies user data to be included in event notifications. This
-is typically the "from" address in mailto: notifications.
-</dl>
+The <b>subscriptions.conf</b> file defines the local event notification subscriptions that are active. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+program. This file is not intended to be edited or managed manually.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
-<i>mime.convs(5)</i>, <i>mime.types(5)</i>, printers.conf(5)
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
+<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
+<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
+<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
+++ /dev/null
-<HTML>
-<!-- SECTION: References -->
-<HEAD>
- <TITLE>cups-files.conf</TITLE>
- <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
-</HEAD>
-<BODY>
-
-<H1 CLASS="title">cups-files.conf</H1>
-
-<P>The <VAR>/etc/cups/cups-files.conf</VAR> file contains configuration <I>directives</I> that control the files, directories. users. and groups that are used by the CUPS scheduler, <CODE>cupsd(8)</CODE>. Each directive is listed on a line by itself followed by its value. Comments are introduced using the number sign ("#") character at the beginning of a line.</P>
-
-<H2 CLASS="title"><A NAME="AccessLog">AccessLog</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-AccessLog /var/log/cups/access_log
-AccessLog /var/log/cups/access_log-%s
-AccessLog syslog
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>AccessLog</CODE> directive sets the name of the
-access log file. If the filename is not absolute then it is
-assumed to be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-access log file is stored in "common log format" and can be used
-by any web access reporting tool to generate a report on CUPS
-server activity.</P>
-
-<P>The server name can be included in the filename by using
-<CODE>%s</CODE> in the name.</P>
-
-<P>The special name "syslog" can be used to send the access
-information to the system log instead of a plain file.</P>
-
-<P>The default access log file is
-<VAR>/var/log/access_log</VAR>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.1.15</SPAN><A NAME="ConfigFilePerm">ConfigFilePerm</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ConfigFilePerm 0644
-ConfigFilePerm 0640
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ConfigFilePerm</CODE> directive specifies the permissions to use when the scheduler writes configuration and cache files, typically in response to IPP or HTTP requests. The default is 644 on OS X and 640 on all other operating systems.</P>
-
-<BLOCKQUOTE><B>Note:</B>
-
-<P>The permissions for the <VAR>printers.conf</VAR> file are always masked to only allow access from the scheduler user (typically root). This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system. There is no way to disable this security feature.</P>
-
-</BLOCKQUOTE>
-
-
-<H2 CLASS="title"><A NAME="DataDir">DataDir</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-DataDir /usr/share/cups
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>DataDir</CODE> directive sets the directory to use
-for data files.</P>
-
-
-<H2 CLASS="title"><A NAME="DocumentRoot">DocumentRoot</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-DocumentRoot /usr/share/doc/cups
-DocumentRoot /foo/bar/doc/cups
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>DocumentRoot</CODE> directive specifies the location
-of web content for the HTTP server in CUPS. If an absolute path
-is not specified then it is assumed to be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-default directory is <VAR>/usr/share/doc/cups</VAR>.</P>
-
-<P>Documents are first looked up in a sub-directory for the
-primary language requested by the client (e.g.
-<VAR>/usr/share/doc/cups/fr/...</VAR>) and then directly under
-the <CODE>DocumentRoot</CODE> directory (e.g.
-<VAR>/usr/share/doc/cups/...</VAR>), so it is possible to
-localize the web content by providing subdirectories for each
-language needed.</P>
-
-
-<H2 CLASS="title"><A NAME="ErrorLog">ErrorLog</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ErrorLog /var/log/cups/error_log
-ErrorLog /var/log/cups/error_log-%s
-ErrorLog syslog
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ErrorLog</CODE> directive sets the name of the error
-log file. If the filename is not absolute then it is assumed to
-be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-default error log file is <VAR>/var/log/cups/error_log</VAR>.</P>
-
-<P>The server name can be included in the filename by using
-<CODE>%s</CODE> in the name.</P>
-
-<P>The special name "syslog" can be used to send the error
-information to the system log instead of a plain file.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4/OS X 10.6</SPAN><A NAME="FatalErrors">FatalErrors</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-FatalErrors none
-FatalErrors all
-FatalErrors browse
-FatalErrors config
-FatalErrors listen
-FatalErrors log
-FatalErrors permissions
-FatalErrors all -permissions
-FatalErrors config permissions log
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>FatalErrors</CODE> directive determines whether certain kinds of
-errors are fatal. The following kinds of errors are currently recognized:</P>
-
-<UL>
-
- <LI><CODE>none</CODE> - No errors are fatal</LI>
-
- <LI><CODE>all</CODE> - All of the errors below are fatal</LI>
-
- <LI><CODE>browse</CODE> - Browsing initialization errors are fatal,
- for example failed binding to the CUPS browse port or failed connections
- to LDAP servers</LI>
-
- <LI><CODE>config</CODE> - Configuration file syntax errors are
- fatal</LI>
-
- <LI><CODE>listen</CODE> - Listen or Port errors are fatal, except for
- IPv6 failures on the loopback or "any" addresses</LI>
-
- <LI><CODE>log</CODE> - Log file creation or write errors are fatal</LI>
-
- <LI><CODE>permissions</CODE> - Bad startup file permissions are
- fatal, for example shared SSL certificate and key files with world-
- read permissions</LI>
-
-</UL>
-
-<P>Multiple errors can be listed, and the form "-kind" can be used with
-<CODE>all</CODE> to remove specific kinds of errors. The default setting is
-<CODE>config</CODE>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.1.18</SPAN><A NAME="FileDevice">FileDevice</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-FileDevice Yes
-FileDevice No
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>FileDevice</CODE> directive determines whether the
-scheduler allows new printers to be added using device URIs of
-the form <CODE>file:/filename</CODE>. File devices are most often
-used to test new printer drivers and do not support raw file
-printing.</P>
-
-<P>The default setting is <CODE>No</CODE>.</P>
-
-<BLOCKQUOTE><B>Note:</B>
-
-<P>File devices are managed by the scheduler. Since the
-scheduler normally runs as the root user, file devices
-can be used to overwrite system files and potentially
-gain unauthorized access to the system. If you must
-create printers using file devices, we recommend that
-you set the <CODE>FileDevice</CODE> directive to
-<CODE>Yes</CODE> for only as long as you need to add the
-printers to the system, and then reset the directive to
-<CODE>No</CODE>.</P>
-
-</BLOCKQUOTE>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.1.3</SPAN><A NAME="FontPath">FontPath</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-FontPath /foo/bar/fonts
-FontPath /usr/share/cups/fonts:/foo/bar/fonts
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>FontPath</CODE> directive specifies the font path to
-use when searching for fonts. The default font path is
-<CODE>/usr/share/cups/fonts</CODE>.</P>
-
-
-<H2 CLASS="title"><A NAME="Group">Group</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-Group lp
-Group nobody
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>Group</CODE> directive specifies the UNIX group that
-filter and CGI programs run as. The default group is
-system-specific but is usually <CODE>lp</CODE> or
-<CODE>nobody</CODE>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.1.15</SPAN><A NAME="LogFilePerm">LogFilePerm</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-LogFilePerm 0644
-LogFilePerm 0600
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>LogFilePerm</CODE> directive specifies the
-permissions to use when writing log files. The default
-is 644.</P>
-
-
-<H2 CLASS="title"><A NAME="PageLog">PageLog</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-PageLog /var/log/cups/page_log
-PageLog /var/log/cups/page_log-%s
-PageLog syslog
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>PageLog</CODE> directive sets the name of the page
-log file. If the filename is not absolute then it is assumed to
-be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-default page log file is <VAR>/var/log/cups/page_log</VAR>.</P>
-
-<P>The server name can be included in the filename by using
-<CODE>%s</CODE> in the name.</P>
-
-<P>The special name "syslog" can be used to send the page
-information to the system log instead of a plain file.</P>
-
-
-<H2 CLASS="title"><A NAME="Printcap">Printcap</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-Printcap
-Printcap /etc/printcap
-Printcap /etc/printers.conf
-Printcap /Library/Preferences/org.cups.printers.plist
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>Printcap</CODE> directive controls whether or not a printcap file is automatically generated and updated with a list of available printers. If specified with no value, then no printcap file will be generated. The default is to generate a file named <VAR>/Library/Preferences.org.cups.printers.plist</VAR> on OS X and <VAR>/etc/printcap</VAR> on all other operating systems.</P>
-
-<P>When a filename is specified (e.g. <VAR>/etc/printcap</VAR>), the printcap file is written whenever a printer is added or removed. The printcap file can then be used by applications that are hardcoded to look at the printcap file for the available printers.</P>
-
-
-<H2 CLASS="title"><A NAME="PrintcapFormat">PrintcapFormat</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-PrintcapFormat BSD
-PrintcapFormat Solaris
-PrintcapFormat plist
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>PrintcapFormat</CODE> directive controls the output format of the
-printcap file. The default is to generate the plist format on OS X, the
-Solaris format on Solaris, and the BSD format on other operating systems.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.1.3</SPAN><A NAME="RemoteRoot">RemoteRoot</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-RemoteRoot remroot
-RemoteRoot root
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>RemoteRoot</CODE> directive sets the username for
-unauthenticated root requests from remote hosts. The default
-username is <VAR>remroot</VAR>. Setting <CODE>RemoteRoot</CODE>
-to <VAR>root</VAR> effectively disables this security
-mechanism.</P>
-
-
-<H2 CLASS="title"><A NAME="RequestRoot">RequestRoot</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-RequestRoot /var/spool/cups
-RequestRoot /foo/bar/spool/cups
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>RequestRoot</CODE> directive sets the directory for
-incoming IPP requests and HTML forms. If an absolute path is not
-provided then it is assumed to be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-default request directory is <VAR>/var/spool/cups</VAR>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 2.0</SPAN><A NAME="Sandboxing">Sandboxing</A> (OS X Only)</H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-Sandboxing off
-Sandboxing relaxed
-Sandboxing strict
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>Sandboxing</CODE> directive sets the default level of security sandboxing that is applied to print filters, backend, and other child processes. The default value is <CODE>strict</CODE>. Sandboxing is currently only supported on OS X.</P>
-
-
-<H2 CLASS="title"><A NAME="ServerBin">ServerBin</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ServerBin /usr/lib/cups
-ServerBin /foo/bar/lib/cups
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ServerBin</CODE> directive sets the directory for
-server-run executables. If an absolute path is not provided then
-it is assumed to be relative to the <A
-HREF="#ServerRoot"><CODE>ServerRoot</CODE></A> directory. The
-default executable directory is <VAR>/usr/lib/cups</VAR>,
-<VAR>/usr/lib32/cups</VAR>, or <VAR>/usr/libexec/cups</VAR>
-depending on the operating system.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 2.0</SPAN><A NAME="ServerKeychain">ServerKeychain</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ServerKeychain /etc/cups/ssl
-ServerKeychain /Library/Keychains/system.keychain
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ServerKeychain</CODE> directive specifies the location of TLS certificates and private keys used when negotiating encrypted connections.</P>
-
-<P>The default keychain is system-specific.</P>
-
-
-<H2 CLASS="title"><A NAME="ServerRoot">ServerRoot</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ServerRoot /etc/cups
-ServerRoot /foo/bar/cups
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ServerRoot</CODE> directive specifies the absolute
-path to the server configuration and state files. It is also used
-to resolve relative paths in the <VAR>cupsd.conf</VAR> file. The
-default server directory is <VAR>/etc/cups</VAR>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6.4</SPAN><A NAME="SyncOnClose">SyncOnClose</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-SyncOnClose No
-SyncOnClose Yes
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>SyncOnClose</CODE> directive determines whether the scheduler
-flushes changes to configuration and state files to disk. The default is
-<CODE>No</CODE> which relies on the operating system to schedule a suitable
-time to write changes to disk.</P>
-
-<BLOCKQUOTE><B>Note:</B>
-
-<P>Setting <CODE>SyncOnClose</CODE> to <CODE>Yes</CODE> makes the scheduler use the <CODE>fsync(2)</CODE> system call to write all changes to disk, however the drive or network file system server may still delay writing data to disk. Do not depend on this functionality to prevent data loss in the event of unexpected hardware failure.</P>
-
-<P>Enabling <CODE>SyncOnClose</CODE> may also cause the scheduler to periodically become unresponsive while it waits for changes to be written.</P>
-
-</BLOCKQUOTE>
-
-
-<H2 CLASS="title"><A NAME="SystemGroup">SystemGroup</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-SystemGroup lpadmin
-SystemGroup sys
-SystemGroup system
-SystemGroup root
-SystemGroup root lpadmin
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>SystemGroup</CODE> directive specifies the system administration group for <CODE>System</CODE> authentication. Multiple groups can be listed, separated with spaces. The default group list is <CODE>admin</CODE> on OS X and <CODE>lpadmin</CODE>, <CODE>root</CODE>, <CODE>sys</CODE>, and/or <CODE>system</CODE> on other operating systems.</P>
-
-
-<H2 CLASS="title"><A NAME="TempDir">TempDir</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-TempDir /var/tmp
-TempDir /foo/bar/tmp
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>TempDir</CODE> directive specifies an absolute path
-for the directory to use for temporary files. The default
-directory is <VAR>/var/spool/cups/tmp</VAR>.</P>
-
-<P>Temporary directories must be world-writable and should have
-the "sticky" permission bit enabled so that other users cannot
-delete filter temporary files. The following commands will create
-an appropriate temporary directory called
-<VAR>/foo/bar/tmp</VAR>:</P>
-
-<PRE CLASS="command">
-<KBD>mkdir /foo/bar/tmp</KBD>
-<KBD>chmod a+rwxt /foo/bar/tmp</KBD>
-</PRE>
-
-<BLOCKQUOTE><B>Note:</B>
-
-<P>The <CODE>TempDir</CODE> cannot be pointed at a standard system temporary directory such as <VAR>/tmp</VAR> or <VAR>/var/tmp</VAR> for security reasons.</P></BLOCKQUOTE>
-
-
-<H2 CLASS="title"><A NAME="User">User</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-User lp
-User guest
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>User</CODE> directive specifies the UNIX user that filter and CGI programs run as. The default user is <CODE>_lp</CODE>, <CODE>lp</CODE>, or <CODE>nobody</CODE> (whichever is found first).</P>
-
-<BLOCKQUOTE><B>Note:</B>
-
-<P>You may not use user <CODE>root</CODE>, as that would expose
-the system to unacceptable security risks. The scheduler will
-automatically choose user <CODE>nobody</CODE> if you specify a
-user whose ID is 0.</P>
-
-</BLOCKQUOTE>
-
-
-</BODY>
-</HTML>
.\"
.\" "$Id$"
.\"
-.\" cupsd.conf man page for CUPS.
+.\" cups-files.conf man page for CUPS.
.\"
.\" Copyright 2007-2014 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\" 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 cups-files.conf 5 "CUPS" "6 February 2014" "Apple Inc."
+.TH cups-files.conf 5 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
-cups-files.conf \- file and directory configuration file for cups
+cups\-files.conf \- file and directory configuration file for cups
.SH DESCRIPTION
-The \fIcups-files.conf\fR file configures the files and directories used by the
-CUPS scheduler, \fIcupsd(8)\fR. It is normally located in the
-\fI/etc/cups\fR directory.
+The \fBcups\-files.conf\fR file configures the files and directories used by the CUPS scheduler,
+.BR cupsd (8).
+It is normally located in the \fI/etc/cups\fR directory.
.LP
-Each line in the file can be a configuration directive, a blank line,
-or a comment. Comment lines start with the # character.
-.SH DIRECTIVES
-The following directives are understood by \fIcupsd(8)\fR. Consult the
-on-line help for detailed descriptions:
+Each line in the file can be a configuration directive, a blank line, or a comment.
+Comment lines start with the # character.
+.SS DIRECTIVES
+The following directives are understood by
+.BR cupsd (8):
.TP 5
-AccessLog filename
+\fBAccessLog \fIfilename\fR
.TP 5
-AccessLog syslog
-.br
+\fBAccessLog \fR[ \fIfilename\fR ]
+.TP 5
+\fBAccessLog syslog\fR
Defines the access log filename.
+The value "syslog" causes log entries to be sent to the system log daemon.
+Specifying a blank filename disables access log generation.
+The server name may be included in filenames using the string "%s", for example:
+.nf
+
+ AccessLog /var/log/cups/%s-access_log
+
+.fi
.TP 5
-ConfigFilePerm mode
-.br
-Specifies the permissions for all configuration files that the scheduler
-writes.
+\fBConfigFilePerm \fImode\fR
+Specifies the permissions for all configuration files that the scheduler writes.
+The default is 0644 on OS X and 0640 on all other operating systems.
+\fBNote:\fR The permissions for the printers.conf file are currently masked to only allow access from the scheduler user (typically root).
+This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system.
+There is no way to disable this security feature.
.TP 5
-DataDir path
-.br
-Specified the directory where data files can be found.
+\fBDataDir \fIpath\fR
+Specifies the directory where data files can be found. The default is usually \fI/usr/share/cups\fR.
.TP 5
-DocumentRoot directory
-.br
-Specifies the root directory for the internal web server documents.
+\fBDocumentRoot \fIdirectory\fR
+Specifies the root directory for the CUPS web interface content. The default is usually \fI/usr/share/doc/cups\fR.
.TP 5
-ErrorLog filename
+\fBErrorLog \fR[ \fIfilename\fR ]
.TP 5
-ErrorLog syslog
-.br
-Specifies the error log filename.
+\fBErrorLog syslog\fR
+Defines the error log filename.
+The value "syslog" causes log entries to be sent to the system log daemon.
+Specifying a blank filename disables error log generation.
+The server name may be included in filenames using the string "%s", for example:
+.nf
+
+ ErrorLog /var/log/cups/%s-error_log
+
+.fi
.TP 5
-FatalErrors none
+\fBFatalErrors none\fR
.TP 5
-FatalErrors all -kind [... -kind]
+\fBFatalErrors all \fI\-kind \fR[ \fI... \-kind \fR]
.TP 5
-FatalErrors kind [... kind]
-.br
-Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
-"browse", "config", "listen", "log", or "permissions".
+\fBFatalErrors \fIkind \fR[ \fI... kind \fR]
+Specifies which errors are fatal, causing the scheduler to exit.
+The default setting is "config".
+The \fIkind\fR strings are:
+.RS 5
.TP 5
-FileDevice Yes
+.B none
+No errors are fatal.
.TP 5
-FileDevice No
-.br
-Specifies whether the file pseudo-device can be used for new
-printer queues.
+.B all
+All of the errors below are fatal.
.TP 5
-FontPath directory[:directory:...]
-.br
-Specifies the search path for fonts.
+.B browse
+Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon.
+.TP 5
+.B config
+Configuration file syntax errors are fatal.
+.TP 5
+.B listen
+Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses.
+.TP 5
+.B log
+Log file creation or write errors are fatal.
.TP 5
-Group group-name-or-number
-.br
-Specifies the group name or ID that will be used when executing
-external programs.
+.B permissions
+Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions.
+.RE
+.TP 5
+\fBFileDevice Yes\fR
+.TP 5
+\fBFileDevice No\fR
+Specifies whether the file pseudo-device can be used for new printer queues.
+The URI "file:///dev/null" is always allowed.
+.TP 5
+\fBFontPath \fIdirectory\fR[:\fI...\fR:\fIdirectory\fR]
+Specifies the search path for fonts.
+\fBThis directive is deprecated and will no longer be supported in a future release of CUPS.\fR
.TP 5
-LogFilePerm mode
-.br
-Specifies the permissions for all log files that the scheduler writes.
+\fBGroup \fIgroup-name-or-number\fR
+Specifies the group name or ID that will be used when executing external programs.
+The default group is operating system specific but is usually \fIlp\fR or \fInobody\fR.
.TP 5
-PageLog filename
+\fBLogFilePerm \fImode\fR
+Specifies the permissions of all log files that the scheduler writes. The default is 0644.
.TP 5
-PageLog syslog
-.br
-Specifies the page log filename.
+\fBPageLog \fR[ \fIfilename\fR ]
.TP 5
-Printcap
+\fBPageLog syslog\fR
+Defines the page log filename.
+The value "syslog" causes log entries to be sent to the system log daemon.
+Specifying a blank filename disables page log generation.
+The server name may be included in filenames using the string "%s", for example:
+.nf
+
+ PageLog /var/log/cups/%s-page_log
+
+.fi
.TP 5
-Printcap filename
-.br
-Specifies the filename for a printcap file that is updated
-automatically with a list of available printers (needed for
-legacy applications); specifying Printcap with no filename
-disables printcap generation.
+\fBPrintcap \fR[ \fIfilename\fR ]
+Defines the printcap filename that the scheduler automatically updates with the current list of available printers, which is sometimes used by legacy applications.
+Specifying a blank filename disables printcap generation.
+\fBThis directive is deprecated and will no longer be supported in a future release of CUPS.\fR
.TP 5
-RemoteRoot user-name
-.br
-Specifies the username that is associated with unauthenticated root
-accesses.
+\fBRemoteRoot \fIusername\fR
+Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
.TP 5
-RequestRoot directory
-.br
-Specifies the directory to store print jobs and other HTTP request
-data.
+\fBRequestRoot \fIdirectory\fR
+Specifies the directory that contains print jobs and other HTTP request data.
.TP 5
-Sandboxing off
+\fBSandboxing off\fR
.TP 5
-Sandboxing relaxed
+\fBSandboxing relaxed\fR
.TP 5
-Sandboxing strict
-Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler. The default is "strict". (OS X only)
+\fBSandboxing strict\fR
+Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler.
+The default is "strict".
+This directive is currently only used on OS X.
.TP 5
-ServerBin directory
-.br
-Specifies the directory where backends, CGIs, daemons, and filters may
-be found.
+\fBServerBin \fIdirectory\fR
+Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
.TP 5
-ServerKeychain path
-.br
+\fBServerKeychain \fIpath\fR
Specifies the location of TLS certificates and private keys.
.TP 5
-ServerRoot directory
-.br
-Specifies the directory where the server configuration files can be found.
+\fBServerRoot \fIdirectory\fR
+Specifies the directory containing the server configuration files.
.TP 5
-SyncOnClose Yes
+\fBSyncOnClose Yes\fR
.TP 5
-SyncOnClose No
-Specifies whether the scheduler calls \fIfsync(2)\fR after writing configuration
-or state files. The default is No.
+\fBSyncOnClose No\fR
+Specifies whether the scheduler calls
+.BR fsync (2)
+after writing configuration or state files. The default is No.
.TP 5
-SystemGroup group-name [group-name ...]
-.br
-Specifies the group(s) to use for System class authentication.
+\fBSystemGroup \fIgroup-name \fR[ \fI... group-name\fR ]
+Specifies the group(s) to use for \fI@SYSTEM\fR group authentication.
.TP 5
-TempDir directory
-.br
+\fBTempDir \fIdirectory\fR
Specifies the directory where temporary files are stored.
.TP 5
-User user-name
-.br
+\fBUser \fIusername\fR
Specifies the user name or ID that is used when running external programs.
.SH SEE ALSO
-\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fImime.convs(5)\fR,
-\fImime.types(5)\fR, \fIprinters.conf(5)\fR,
-\fIsubscriptions.conf(5)\fR,
-.br
-http://localhost:631/help
+.BR classes.conf (5),
+.BR cups (1),
+.BR cupsd (8),
+.BR cupsd.conf (5),
+.BR mime.convs (5),
+.BR mime.types (5),
+.BR printers.conf (5),
+.BR subscriptions.conf (5),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2014 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
pre = 0, /* Preformatted */
font = 0, /* Current font */
linenum = 0; /* Current line number */
- const char *list = NULL; /* Current list, if any */
+ float list_indent = 0.0f, /* Current list indentation */
+ nested_indent = 0.0f; /* Nested list indentation, if any */
+ const char *list = NULL, /* Current list, if any */
+ *nested = NULL; /* Nested list, if any */
const char *post = NULL; /* Text to add after the current line */
if (list)
{
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
+ nested = list;
+ list = NULL;
+ nested_indent = list_indent;
+ list_indent = 0.0f;
}
- fprintf(outfile, "<div style=\"margin-left: %.1fem;\">\n", amount);
+ fprintf(outfile, "<div style=\"margin-left: %.1fem;\">\n", amount - nested_indent);
}
else if (!strcmp(line, ".RE"))
{
font = 0;
fputs("</div>\n", outfile);
+
+ if (nested)
+ {
+ list = nested;
+ nested = NULL;
+
+ list_indent = nested_indent;
+ nested_indent = 0.0f;
+ }
}
else if (!strcmp(line, ".HP") || !strncmp(line, ".HP ", 4))
{
if (!list)
{
fputs("<dl class=\"man\">\n", outfile);
- list = "dl";
+ list = "dl";
+ list_indent = amount;
}
fputs("<dt>", outfile);
fputs(end_fonts[font], outfile);
font = 0;
- if (list)
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
+// if (list)
+// {
+// fprintf(outfile, "</%s>\n", list);
+// list = NULL;
+// }
pre = 1;
fputs("<pre class=\"man\">\n", outfile);
projects / thirdparty / cups.git / commitdiff
