help/license.html \
help/man-backend.html \
help/man-cancel.html \
+ help/man-client.conf.html \
help/man-cups.html \
help/man-cups-config.html \
help/man-cups-lpd.html \
help/man-cupsaccept.html \
help/man-cupsaddsmb.html \
help/man-cupsd.html \
+ help/man-cupsd-helper.html \
help/man-cupsenable.html \
help/man-cupstestdsc.html \
help/man-cupstestppd.html \
help/raster-driver.html \
help/ref-access_log.html \
help/ref-classes-conf.html \
- help/ref-client-conf.html \
help/ref-cupsd-conf.html \
help/ref-cups-files-conf.html \
help/ref-error_log.html \
cancel - cancel jobs
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cancel</b>
-[ -E ] [ -U
+[
+<i>-E</i>
+] [
+<i>-U</i>
<i>username</i>
-] [ -a ] [ -h
+] [
+<i>-a</i>
+] [
+<i>-h</i>
<i>hostname[:port]</i>
-] [ -u
+] [
+<i>-u</i>
<i>username</i>
-] [ -x ] [
+] [
+<i>-x</i>
+] [
<i>id</i>
] [
<i>destination</i>
<i>destination-id</i>
]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>cancel</i> cancels existing print jobs. The <i>-a</i> option will remove
-all jobs from the specified destination.
+The <b>cancel</b> command cancels print jobs. If no <i>destination</i> or <i>id</i> is specified, the currently printing job on the default destination is canceled.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by <i>cancel</i>:
+The following options are recognized by <b>cancel</b>:
<dl class="man">
-<dt>-E
-<dd style="margin-left: 5.0em"><br>
-Forces encryption when connecting to the server.
-<dt>-U username
-<dd style="margin-left: 5.0em"><br>
-Specifies the username to use when connecting to the server.
-<dt>-a
-<dd style="margin-left: 5.0em"><br>
-Cancel all jobs on the named destination, or all jobs on all
+<dt><b>-a</b>
+<dd style="margin-left: 5.0em">Cancel all jobs on the named destination, or all jobs on all
destinations if none is provided.
-<dt>-h hostname[:port]
-<dd style="margin-left: 5.0em"><br>
-Chooses an alternate server.
-<dt>-u username
-<dd style="margin-left: 5.0em"><br>
-Cancels jobs owned by <i>username</i>.
-<dt>-x
-<dd style="margin-left: 5.0em"><br>
-Deletes job data files in addition to canceling.
+<dt><b>-E</b>
+<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
+<dt><b>-h </b><i>hostname</i>[<i>:port</i>]
+<dd style="margin-left: 5.0em">Specifies an alternate server.
+<dt><b>-U </b><i>username</i>
+<dd style="margin-left: 5.0em">Specifies the username to use when connecting to the server.
+<dt><b>-u </b><i>username</i>
+<dd style="margin-left: 5.0em">Cancels jobs owned by <i>username</i>.
+<dt><b>-x</b>
+<dd style="margin-left: 5.0em">Deletes job data files in addition to canceling.
</dl>
-<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
-Unlike the System V printing system, CUPS allows printer names to
-contain any printable character except SPACE, TAB, "/", or "#".
-Also, printer and class names are <i>not</i> case-sensitive.
+<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
+Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". Also, printer and class names are <i>not</i> case-sensitive.
+<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
+Cancel the current print job:
+<pre class="man">
+
+ cancel
+
+</pre>
+Cancel job "myprinter-42":
+<pre class="man">
+
+ cancel myprinter-42
+
+</pre>
+Cancel all jobs:
+<pre class="man">
+
+ cancel -a
+</pre>
<h2 class="title"><a name="NOTES">Notes</a></h2>
-Administrators wishing to prevent unauthorized cancellation of
-jobs via the <i>-u</i> option should require authentication for
-Cancel-Jobs operations in <i>cupsd.conf(5)</i>.
+Administrators wishing to prevent unauthorized cancellation of jobs via the <i>-u</i> option should require authentication for Cancel-Jobs operations in
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5).</a>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>lp(1)</i>, <i>lpmove(8)</i>, <i>lpstat(1)</i>,
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
+<a href="man-lpmove.html?TOPIC=Man+Pages"><b>lpmove</b>(8),</a>
+<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</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>
+++ /dev/null
-<!DOCTYPE HTML>
-<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-deviced(8)</title>
-</head>
-<body>
-<h1 class="title">cups-deviced(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups-deviced - cups device daemon
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-deviced</b>
-<i>request-id</i><i>limit</i><i>user-id</i><i>options</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>cups-deviced</i> polls the backends in
-<i>/usr/lib/cups/backend</i> or <i>/usr/libexec/cups/backend</i> (OS X) for a
-list of available devices. It is run by <i>cupsd(8)</i> in response to a
-<i>CUPS-Get-Devices</i> request. The output format is an IPP
-response message. The <i>request-id</i> argument is the request ID
-from the original IPP request, typically 1. The <i>limit</i>
-argument is the limit value from the original IPP request - 0
-means no limit. The <i>user-id</i> argument is the
-requesting-user-name value from the original IPP request.
-Finally, the <i>options</i> argument is a space-delimited list of
-attributes ("name=value name=value ...") that were passed in
-with the request. Currently <i>cups-deviced</i> looks for the
-<i>requested-attributes</i> attribute and tailors the output
-accordingly.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-backend(7), cupsd(8), cupsd.conf(5),
-<br>
-<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.
-
-</body>
-</html>
+++ /dev/null
-<!DOCTYPE HTML>
-<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-driverd(8)</title>
-</head>
-<body>
-<h1 class="title">cups-driverd(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups-driverd - cups driver daemon
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-driverd</b>
-cat
-<i>ppd-name</i>
-<br>
-<b>cups-driverd</b>
-list
-<i>request_id</i><i>limit</i><i>options</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>cups-driverd</i> shows or lists PPD files. It is run in
-response to CUPS-Add-Modify-Printer or CUPS-Get-Devices requests.
-The first form ("cups-driverd cat ppd-name") writes the named PPD
-file to stdout. The output format is an uncompressed PPD file.
-<p>The second form lists the available manufacturers or PPD files to
-stdout as indicated by the <i>options</i> argument. The output
-format is an IPP response message. The <i>request_id</i> argument
-is the request ID from the original IPP request, typically 1. The
-<i>limit</i> argument is the limit value from the original IPP
-request - 0 means no limit. Finally, the <i>options</i> argument
-is a space-delimited list of attributes ("name=value name=value
-&...") that were passed in with the request. Currently
-<i>cups-driverd</i> looks for the <i>ppd-make</i> and
-<i>requested-attributes</i> attributes and tailors the output
-accordingly.
-<h2 class="title"><a name="DRIVERS">Drivers</a></h2>
-Drivers can be static PPD files under the
-<i>/usr/share/cups/model</i> directory or programs under the
-<i>/usr/lib/cups/driver</i> or <i>/usr/libexec/cups/driver</i> (OS X) directories.
-Static PPD files must conform to the Adobe PPD File Format Specification version
-4.3 and may be compressed using the <i>gzip(1)</i> program. Driver
-programs must implement the command-line interface shown in the
-next section.
-<h3><a name="DRIVER_PROGRAMS">Driver Programs</a></h3>
-Driver programs provide a interface to dynamically-generated PPD
-files. The following arguments are currently defined:
-<dl class="man">
-<dt>drivername list
-<dd style="margin-left: 5.0em"><br>
-Lists the supported PPD files to stdout.
-<dt>drivername cat ppdname
-<dd style="margin-left: 5.0em"><br>
-Writes the named PPD file to stdout.
-</dl>
-<p>Driver programs MUST NOT query hardware or make other long-term operations that
-would delay the return of a driver list. See the NOTES section below for
-specific recommendations.
-<h3><a name="LISTING_FILES__drivername_list_">Listing Files (drivername list)</a></h3>
-When run with the single argument "list", the program must list
-the available PPD files it can generate to stdout using the
-following format:
-<pre class="man">
- "drivername:ppdname" language "make" "make and model"
- "drivername:ppdname" language "make" "make and model" "1284 device id"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version" "type"
-</pre>
-<p><i>Drivername</i> is the name of the driver program. <i>Ppdname</i>
-is the name used to select the given driver. <i>Language</i> is
-the locale associated with the default language of the PPD file,
-typically "en". <i>Make</i> is the Manufacturer name from the PPD
-file. <i>Make and model</i> is the NickName name from the PPD
-file. <i>1284 device id</i> is the 1284DeviceId from the PPD file,
-if any. <i>(PPD product)</i> is the Product string as it would appear in the PPD
-file or from a PostScript query. <i>PostScript version</i> is the PSVersion
-string as it would appear in the PPD file or from a PostScript query. <i>Type</i>
-is "postscript" for PostScript printers, "pdf" for PDF printers, "raster" for
-raster printers, or "fax" for facsimile devices.
-<h3><a name="WRITING_FILES__drivername_cat_ppdname_">Writing Files (drivername cat ppdname)</a></h3>
-When the driver program is run with the "cat ppdname" arguments,
-it must write the named PPD file to stdout, uncompressed. If the
-named PPD file does not exist, the driver program must not write
-any output to stdout and report the error to stderr instead.
-<h3><a name="DRIVER_ERROR_MESSAGES">Driver Error Messages</a></h3>
-Error messages can be relayed back to <i>cupsd</i> by writing them
-to stderr. The following prefixes are recognized:
-<dl class="man">
-<dt>DEBUG: [drivername]
-<dd style="margin-left: 5.0em"><br>
-Debugging messages
-<dt>ERROR: [drivername]
-<dd style="margin-left: 5.0em"><br>
-Error messages
-<dt>INFO: [drivername]
-<dd style="margin-left: 5.0em"><br>
-Informational messages
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-Due to performance considerations, driver programs have been officially
-deprecated and should not be used for new development. Currently only the
-CUPS web interface and <i>lpinfo(8)</i> command will request lists from all
-driver programs.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-cupsd(8), cupsd.conf(5), cupstestppd(1), lpinfo(8),
-<br>
-<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.
-
-</body>
-</html>
<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,
-<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:
+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:
<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">Specifies the logging level for the AccessLog file.
+<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)
<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 [
-<dd style="margin-left: 5.0em"><i>All</i>
-] [
-<i>DNSSD</i>
-]
+<dt>BrowseLocalProtocols [All] [DNSSD]
+<dd style="margin-left: 5.0em"><br>
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">Specifies the type of encryption to use for authenticated requests.
+<dd style="margin-left: 5.0em"><br>
+Specifies the type of encryption to use for authenticated requests.
<dt>DefaultLanguage locale
-<dd style="margin-left: 5.0em">Specifies the default language to use for text and web content.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the default paper size for new print queues. "Auto" uses a locale-
+<dd style="margin-left: 5.0em"><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.
<dt>DefaultPolicy policy-name
-<dd style="margin-left: 5.0em">Specifies the default access policy to use.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether local printers are shared by default.
+<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.
<dt>DirtyCleanInterval seconds
-<dd style="margin-left: 5.0em">Specifies the delay for updating of configuration and state files. A value of 0
+<dd style="margin-left: 5.0em"><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.
+<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">Specifies the maximum cost of filters that are run concurrently.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum cost of filters that are run concurrently.
<dt>FilterNice nice-value
-<dd style="margin-left: 5.0em">Specifies the scheduling priority ("nice" value) of filters that
+<dd style="margin-left: 5.0em"><br>
+Specifies the scheduling priority ("nice" value) of filters that
are run to print a job.
<dt>GSSServiceName name
-<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication. The default
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether or not to do reverse lookups on client addresses.
+<dd style="margin-left: 5.0em"><br>
+Specifies whether or not to do reverse lookups on client addresses.
<dt>Include filename
-<dd style="margin-left: 5.0em">Includes the named file.
+<dd style="margin-left: 5.0em"><br>
+Includes the named file.
<dt>JobKillDelay seconds
-<dd style="margin-left: 5.0em">Specifies the number of seconds to wait before killing the filters and backend
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the interval between retries of jobs in seconds.
+<dd style="margin-left: 5.0em"><br>
+Specifies the interval between retries of jobs in seconds.
<dt>JobRetryLimit count
-<dd style="margin-left: 5.0em">Specifies the number of retries that are done for jobs.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether to support HTTP keep-alive connections.
+<dd style="margin-left: 5.0em"><br>
+Specifies whether to support HTTP keep-alive connections.
<dt>KeepAliveTimeout seconds
-<dd style="margin-left: 5.0em">Specifies the amount of time that connections are kept alive.
+<dd style="margin-left: 5.0em"><br>
+Specifies the amount of time that connections are kept alive.
<dt><Limit operations> ... </Limit>
-<dd style="margin-left: 5.0em">Specifies the IPP operations that are being limited inside a policy.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the HTTP methods that are being limited inside a location.
+<dd style="margin-left: 5.0em"><br>
+Specifies the HTTP methods that are being limited inside a location.
<dt>LimitRequestBody
-<dd style="margin-left: 5.0em">Specifies the maximum size of any print job request.
+<dd style="margin-left: 5.0em"><br>
+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">Listens to the specified address and port or domain socket path.
+<dd style="margin-left: 5.0em"><br>
+Listens to the specified address and port or domain socket path.
<dt><Location /path> ... </Location>
-<dd style="margin-left: 5.0em">Specifies access control for the named location.
+<dd style="margin-left: 5.0em"><br>
+Specifies access control for the named location.
<dt>LogDebugHistory #-messages
-<dd style="margin-left: 5.0em">Specifies the number of debugging messages that are logged when an error
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the logging level for the ErrorLog file.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the format of the date and time in the log files.
+<dd style="margin-left: 5.0em"><br>
+Specifies the format of the date and time in the log files.
<dt>MaxClients number
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients to support.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of simultaneous clients to support.
<dt>MaxClientsPerHost number
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients to support from a
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of simultaneous clients to support from a
single address.
<dt>MaxCopies number
-<dd style="margin-left: 5.0em">Specifies the maximum number of copies that a user can print of each job.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of copies that a user can print of each job.
<dt>MaxHoldTime seconds
-<dd style="margin-left: 5.0em">Specifies the maximum time a job may remain in the "indefinite" hold state
+<dd style="margin-left: 5.0em"><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.
<dt>MaxJobs number
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs to support.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of simultaneous jobs to support.
<dt>MaxJobsPerPrinter number
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs per printer to support.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of simultaneous jobs per printer to support.
<dt>MaxJobsPerUser number
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs per user to support.
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum number of simultaneous jobs per user to support.
<dt>MaxJobTime seconds
-<dd style="margin-left: 5.0em">Specifies the maximum time a job may take to print before it is canceled. The
+<dd style="margin-left: 5.0em"><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.
<dt>MaxLogSize number-bytes
-<dd style="margin-left: 5.0em">Specifies the maximum size of the log files before they are
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the maximum request/file size in bytes (0 for no limit)
+<dd style="margin-left: 5.0em"><br>
+Specifies the maximum request/file size in bytes (0 for no limit)
<dt>MultipleOperationTimeout seconds
-<dd style="margin-left: 5.0em">Specifies the maximum amount of time to allow between files in a multiple file
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the format of page log lines.
+<dd style="margin-left: 5.0em"><br>
+Specifies the format of page log lines.
<dt>PassEnv variable [... variable]
-<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
+<dd style="margin-left: 5.0em"><br>
+Passes the specified environment variable(s) to child processes.
<dt><Policy name> ... </Policy>
-<dd style="margin-left: 5.0em">Specifies access control for the named policy.
+<dd style="margin-left: 5.0em"><br>
+Specifies access control for the named policy.
<dt>Port number
-<dd style="margin-left: 5.0em">Specifies a port number to listen to for HTTP requests.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether or not to preserve job files after they are printed.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether or not to preserve the job history after they are
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the format of the printcap file.
+<dd style="margin-left: 5.0em"><br>
+Specifies the format of the printcap file.
<dt>ReloadTimeout seconds
-<dd style="margin-left: 5.0em">Specifies the amount of time to wait for job completion before
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the maximum amount of memory to use when converting images
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether all or any limits set for a Location must be
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the email address of the server administrator.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies an alternate name that the server is known by. The special name "*"
+<dd style="margin-left: 5.0em"><br>
+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">Specifies the fully-qualified hostname of the server.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies what information is included in the Server header of HTTP
+<dd style="margin-left: 5.0em"><br>
+Specifies what information is included in the Server header of HTTP
responses.
<dt>SetEnv variable value
-<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
+<dd style="margin-left: 5.0em"><br>
+Set the specified environment variable to be passed to child processes.
<dt>SSLListen
-<dd style="margin-left: 5.0em">Listens on the specified address and port for encrypted connections.
+<dd style="margin-left: 5.0em"><br>
+Listens on the specified address and port for encrypted connections.
<dt>SSLPort
-<dd style="margin-left: 5.0em">Listens on the specified port for encrypted connections.
+<dd style="margin-left: 5.0em"><br>
+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">Specifies whether the scheduler requires clients to strictly adhere to the IPP
+<dd style="margin-left: 5.0em"><br>
+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">Specifies an access list for a subscription's private values. The "default"
+<dd style="margin-left: 5.0em"><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.
<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>
-<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>
+<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="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2014 by Apple Inc.
+Copyright 2007-2013 by Apple Inc.
</body>
</html>
cupsd - cups scheduler
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsd</b>
-[
-<b>-c</b>
+[ -c
<i>config-file</i>
-] [
-<b>-f</b>
-] [
-<b>-F</b>
-] [
-<b>-h</b>
-] [
-<b>-l</b>
-] [
-<b>-t</b>
-]
+] [ -f ] [ -F ] [ -h ] [ -l ] [ -t ]
<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><b>-c</b><i> config-file</i>
+<dt>-c config-file
<dd style="margin-left: 5.0em">Uses the named configuration file.
-<dt><b>-f</b>
+<dt>-f
<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><b>-F</b>
+<dt>-F
<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><b>-h</b>
+<b>cupsd</b>from<b>init</b>(8).
+<dt>-h
<dd style="margin-left: 5.0em">Shows the program usage.
-<dt><b>-l</b>
+<dt>-l
<dd style="margin-left: 5.0em">This option is passed to
<b>cupsd</b>
when it is run from
-<b>launchd</b>(8)
-or
-<b>systemd</b>(8).
-<dt><b>-t</b>
+<b>launchd</b>(8).
+<dt>-t
<dd style="margin-left: 5.0em">Test the configuration file for syntax errors.
</dl>
-<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
+<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
<b>cupsd</b>
-in the foreground with a test configuration file called
-<i>test.conf</i>:
-<pre class="man">
-
- cupsd -f -c test.conf
-
-</pre>
+implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administration operations.
<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.html?TOPIC=Man+Pages"><b>cups</b>(1),</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>
-<b>systemd</b>(8),
-CUPS Online Help (<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-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>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright © 2007-2014 by Apple Inc.
+++ /dev/null
-<HTML>
-<!-- SECTION: References -->
-<HEAD>
- <TITLE>client.conf</TITLE>
- <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
-</HEAD>
-<BODY>
-
-<H1 CLASS="title">client.conf</H1>
-
-<P>The <VAR>/etc/cups/client.conf</VAR> and
-<VAR>~/.cups/client.conf</VAR> files contain up to two directives
-that determine how the client behaves. 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="Encryption">Encryption</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-Encryption Never
-Encryption IfRequested
-Encryption Required
-Encryption Always
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>Encryption</CODE> directive specifies the default
-encryption settings for the client.</P>
-
-<P>The default setting is <VAR>IfRequested</VAR>.</P>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="GSSServiceName">GSSServiceName</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-GSSServiceName http
-GSSServiceName ipp
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>GSSServiceName</CODE> directive sets the Kerberos service name to use. The default is <CODE>http</CODE> for compatibility with Microsoft Windows.</P>
-
-
-<H2 CLASS="title"><A NAME="ServerName">ServerName</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-ServerName foo.bar.com
-ServerName 11.22.33.44
-ServerName foo.bar.com:8631
-<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com/version=1.1
-<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com:8631/version=1.1
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>ServerName</CODE> directive specifies sets the remote server that is to be used for all client operations. That is, it redirects all client requests to the remote server.</P>
-
-<P>The default port number is 631 but can be overridden by adding a colon followed by the desired port number to the value.</P>
-
-<P>By default, CUPS 1.6 and later use IPP/2.0 to communicate with the server. Add "/version=1.1" to force IPP/1.1 which is required for CUPS 1.3.12 and earlier.</P>
-
-<P>The default is to use the local server ("<VAR>localhost</VAR>") or domain socket, if so configured.</P>
-
-<BLOCKQUOTE><B>Note:</B>
-<P>Only one <CODE>ServerName</CODE> directive may appear. If multiple names are
-present, only the last one is used. This directive is not supported on OS X 10.7 or later.</P>
-</BLOCKQUOTE>
-
-
-<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="User">User</A></H2>
-
-<H3>Examples</H3>
-
-<PRE CLASS="command">
-User joe
-User bob
-</PRE>
-
-<H3>Description</H3>
-
-<P>The <CODE>User</CODE> directive sets the user name to use. The default is the username associated with the current login.</P>
-
-
-</BODY>
-</HTML>
cupsaddsmb.$(MAN8EXT) \
cupsctl.$(MAN8EXT) \
cupsfilter.$(MAN8EXT) \
- cups-deviced.$(MAN8EXT) \
- cups-driverd.$(MAN8EXT) \
cups-lpd.$(MAN8EXT) \
cups-snmp.$(MAN8EXT) \
cupsd.$(MAN8EXT) \
+ cupsd-helper.$(MAN8EXT) \
cupsenable.$(MAN8EXT) \
lpadmin.$(MAN8EXT) \
lpinfo.$(MAN8EXT) \
.\"
.\" "$Id$"
.\"
-.\" cancel man page for CUPS.
+.\" cancel man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 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/".
+.\" 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 cancel 1 "CUPS" "21 January 2013" "Apple Inc."
+.TH cancel 1 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
-cancel - cancel jobs
+cancel \- cancel jobs
.SH SYNOPSIS
.B cancel
-[ -E ] [ -U
+[
+.I \-E
+] [
+.I \-U
.I username
-] [ -a ] [ -h
+] [
+.I \-a
+] [
+.I \-h
.I hostname[:port]
-] [ -u
+] [
+.I \-u
.I username
-] [ -x ] [
+] [
+.I \-x
+] [
.I id
] [
.I destination
] [
-.I destination-id
+.I destination\-id
]
.SH DESCRIPTION
-\fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
-all jobs from the specified destination.
+The \fBcancel\fR command cancels print jobs. If no \fIdestination\fR or \fIid\fR is specified, the currently printing job on the default destination is canceled.
.SH OPTIONS
-The following options are recognized by \fIcancel\fR:
-.TP 5
--E
-.br
-Forces encryption when connecting to the server.
-.TP 5
--U username
-.br
-Specifies the username to use when connecting to the server.
+The following options are recognized by \fBcancel\fR:
.TP 5
--a
-.br
+.B \-a
Cancel all jobs on the named destination, or all jobs on all
destinations if none is provided.
.TP 5
--h hostname[:port]
-.br
-Chooses an alternate server.
+.B \-E
+Forces encryption when connecting to the server.
+.TP 5
+\fB\-h \fIhostname\fR[\fI:port\fR]
+Specifies an alternate server.
+.TP 5
+\fB\-U \fIusername\fR
+Specifies the username to use when connecting to the server.
.TP 5
--u username
-.br
+\fB\-u \fIusername\fR
Cancels jobs owned by \fIusername\fR.
.TP 5
--x
-.br
+.B \-x
Deletes job data files in addition to canceling.
-.SH COMPATIBILITY
-Unlike the System V printing system, CUPS allows printer names to
-contain any printable character except SPACE, TAB, "/", or "#".
-Also, printer and class names are \fInot\fR case-sensitive.
+.SH CONFORMING TO
+Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". Also, printer and class names are \fInot\fR case-sensitive.
+.SH EXAMPLES
+Cancel the current print job:
+.nf
+
+ cancel
+
+.fi
+Cancel job "myprinter-42":
+.nf
+
+ cancel myprinter\-42
+
+.fi
+Cancel all jobs:
+.nf
+
+ cancel \-a
+.fi
.SH NOTES
-Administrators wishing to prevent unauthorized cancellation of
-jobs via the \fI-u\fR option should require authentication for
-Cancel-Jobs operations in \fIcupsd.conf(5)\fR.
+Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in
+.BR cupsd.conf (5).
.SH SEE ALSO
-\fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR,
-.br
-http://localhost:631/help
+.BR cupsd.conf (5),
+.BR lp (1),
+.BR lpmove (8),
+.BR lpstat (1),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
.\"
.\" "$Id$"
.\"
-.\" classes.conf man page for CUPS.
+.\" classes.conf man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 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/".
+.\" 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 classes.conf 5 "CUPS" "29 April 2009" "Apple Inc."
+.TH classes.conf 5 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
classes.conf \- class configuration file for cups
.SH DESCRIPTION
-The \fIclasses.conf\fR file defines the local printer classes that are
-available. It is normally located in the \fI/etc/cups\fR directory and
-is generated automatically by the \fIcupsd(8)\fR program when printer
-classes are added or deleted.
-.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
-.TP 5
-<Class name> ... </Class>
-.br
-Defines a specific printer class.
-.TP 5
-<DefaultClass name> ... </Class>
-.br
-Defines a default printer class.
-.TP 5
-Accepting Yes
-.TP 5
-Accepting No
-.br
-Specifies whether the printer is accepting new jobs.
-.TP 5
-AllowUser [ user @group ... ]
-.br
-Allows specific users and groups to print to the printer.
-.TP 5
-DenyUser [ user @group ... ]
-.br
-Prevents specific users and groups from printing to the printer.
-.TP 5
-Info text
-.br
-Specifies human-readable text describing the printer.
-.TP 5
-JobSheets banner banner
-.br
-Specifies the banner pages to use for the printer.
-.TP 5
-KLimit number
-.br
-Specifies the job-k-limit value for the printer.
-.TP 5
-Location text
-.br
-Specifies human-readable text describing the location of the printer.
-.TP 5
-OpPolicy name
-.br
-Specifies the operation policy for the printer.
-.TP 5
-PageLimit number
-.br
-Specifies the job-page-limit value for the printer.
-.TP 5
-Printer
-.br
-Specifies a printer that is a member of the printer class.
-.TP 5
-QuotaPeriod seconds
-.br
-Specifies the job-quota-period value for the printer.
-.TP 5
-Shared Yes
-.TP 5
-Shared No
-.br
-Specifies whether the printer is shared.
-.TP 5
-State idle
-.TP 5
-State stopped
-.br
-Specifies the initial state of the printer (Idle or Stopped)
-.TP 5
-StateMessage text
-.br
-Specifies the message associated with the state.
-.TP 5
-StateTime seconds
-.br
-Specifies the date/time associated with the state.
+The \fBclasses.conf\fR file defines the local printer classes that are available. It is normally located in the \fI/etc/cups\fR directory and is maintained by the
+.BR cupsd (8)
+program. This file is not intended to be edited or managed manually.
+.SH NOTES
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
-\fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fImime.convs(5)\fR,
-\fImime.types(5)\fR, \fIprinters.conf(5)\fR,
-.br
-http://localhost:631/help
+.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-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
.\"
.\" "$Id$"
.\"
-.\" client.conf man page for CUPS.
+.\" client.conf man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 2006 by Easy Software Products.
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 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/".
+.\" 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 client.conf 5 "CUPS" "8 July 2013" "Apple Inc."
+.TH client.conf 5 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
-client.conf \- client configuration file for cups
+client.conf \- client configuration file for cups (deprecated)
.SH DESCRIPTION
-The \fIclient.conf\fR file configures the CUPS client and is
-normally located in the \fI/etc/cups\fR or \fI~/.cups\fR
-directory. 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 the client. Consult the
-on-line help for detailed descriptions:
+The \fBclient.conf\fR file configures the CUPS client and is normally located in the \fI/etc/cups\fR and/or \fI~/.cups\fR directories.
+Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
+.LP
+\fBNote:\fR Starting with OS X 10.7, this file is only used by command-line and X11 applications.
+The \fBServerName\fR directive is not supported on OS X at all.
+.SS DIRECTIVES
+The following directives are understood by the client. Consult the online help for detailed descriptions:
.TP 5
-Encryption IfRequested
+\fBEncryption IfRequested\fR
.TP 5
-Encryption Never
+\fBEncryption Never\fR
.TP 5
-Encryption Required
-.br
-Specifies the level of encryption that is required for a particular
-location.
+\fBEncryption Required\fR
+Specifies the level of encryption that should be used.
.TP 5
-GSSServiceName name
-Specifies the Kerberos service name that is used for authentication, typically
-"host", "http", or "ipp". CUPS adds the remote hostname
-("name@server.example.com") for you. The default name is
-"http".
+\fBGSSServiceName \fIname\fR
+Specifies the Kerberos service name that is used for authentication, typically "host", "http", or "ipp".
+CUPS adds the remote hostname ("name@server.example.com") for you. The default name is "http".
.TP 5
-ServerName hostname-or-ip-address[:port]
+\fBServerName \fIhostname-or-ip-address\fR[\fI:port\fR]
.TP 5
-ServerName /domain/socket
-.br
-Specifies the address and optionally the port to use when connecting to the
-server. \fBNote: Not supported on OS X 10.7 or later.\fR
+\fBServerName \fI/domain/socket\fR
+Specifies the address and optionally the port to use when connecting to the server.
+\fBNote: This directive it not supported on OS X 10.7 or later.\fR
.TP 5
-ServerName hostname-or-ip-address[:port]/version=1.1
-.br
-Specifies the address and optionally the port to use when connecting to a
-server running CUPS 1.3.12 and earlier. \fBNote: Not supported on OS X 10.7 or
-later.\fR
+\fBServerName \fIhostname-or-ip-address\fR[\fI:port\fR]\fB/version=1.1\fR
+Specifies the address and optionally the port to use when connecting to a server running CUPS 1.3.12 and earlier.
.TP 5
-User name
-.br
+\fBUser \fIname\fR
Specifies the default user name to use for requests.
+.SH NOTES
+The \fBclient.conf\fR file is deprecated and will no longer be supported in a future version of CUPS.
.SH SEE ALSO
-http://localhost:631/help
+.BR cups (1),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
.\"
.\" "$Id$"
.\"
-.\" cups-config man page for CUPS.
+.\" cups-config man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 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/".
+.\" 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 cups-config 1 "CUPS" "23 October 2008" "Apple Inc."
+.TH cups-config 1 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
-cups-config \- get cups api, compiler, directory, and link information.
+cups\-config \- get cups api, compiler, directory, and link information.
.SH SYNOPSIS
-.B cups-config
---api-version
+.B cups\-config
+.I \-\-api\-version
.br
-.B cups-config
---build
+.B cups\-config
+.I \-\-build
.br
-.B cups-config
---cflags
+.B cups\-config
+.I \-\-cflags
.br
-.B cups-config
---datadir
+.B cups\-config
+.I \-\-datadir
.br
-.B cups-config
---help
+.B cups\-config
+.I \-\-help
.br
-.B cups-config
---ldflags
+.B cups\-config
+.I \-\-ldflags
.br
-.B cups-config
+.B cups\-config
[
-.I --image
+.I \-\-image
] [
-.I --static
-] --libs
+.I \-\-static
+]
+.I \-\-libs
.br
-.B cups-config
---serverbin
+.B cups\-config
+.I \-\-serverbin
.br
-.B cups-config
---serverroot
+.B cups\-config
+.I \-\-serverroot
.br
.B cups-config
---version
+.I \-\-version
.br
.SH DESCRIPTION
-\fBcups-config\fR 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 \fBcups-config\fR 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.
.SH OPTIONS
+The \fBcups-config\fR command accepts the following command-line options:
.TP 5
---api-version
-.br
-Displays the current API version (major.minor).
+.B \-\-api-version
+Reports the current API version (major.minor).
.TP 5
---build
-.br
-Displays a system-specific build number.
+.B \-\-build
+Reports a system-specific build number.
.TP 5
---cflags
-.br
-Displays the necessary compiler options.
+.B \-\-cflags
+Reports the necessary compiler options.
.TP 5
---datadir
-.br
-Displays the default CUPS data directory.
+.B \-\-datadir
+Reports the default CUPS data directory.
.TP 5
---help
-.br
-Displays the program usage message.
+.B \-\-help
+Reports the program usage message.
.TP 5
---image
-.br
-When used with \fI--libs\fR, adds the CUPS imaging library to the
-list of displayed libraries.
+.B \-\-image
+When used with \fI\-\-libs\fR, adds the CUPS imaging library to the
+list of libraries.
.TP 5
---ldflags
-.br
-Displays the necessary linker options.
+.B \-\-ldflags
+Reports the necessary linker options.
.TP 5
---libs
-.br
-Displays the necessary librarys to link to.
+.B \-\-libs
+Reports the necessary libraries to link to.
.TP 5
---serverbin
-.br
-Displays the default CUPS binary directory,
-where filters and backends are stored.
+.B \-\-serverbin
+Reports the default CUPS binary directory, where filters and backends are stored.
.TP 5
---serverroot
-.br
-Displays the default CUPS configuration file directory.
+.B \-\-serverroot
+Reports the default CUPS configuration file directory.
.TP 5
---static
-.br
-When used with \fI--libs\fR, shows the static libraries instead
-of the default (shared) libraries.
+.B \-\-static
+When used with \fI\-\-libs\fR, reports the static libraries instead of the default (shared) libraries.
.TP 5
---version
-.br
-Displays the full version number of the CUPS installation
-(major.minor.patch).
+.B \-\-version
+Reports the full version number of the CUPS installation (major.minor.patch).
+.SH EXAMPLES
+Show the currently installed version of CUPS:
+.nf
+
+ cups-config \-\-version
+
+.fi
+Compile a simple one-file CUPS filter:
+.nf
+
+ cc `cups\-config \-\-cflags \-\-ldflags` \-o filter filter.c \\
+ `cups\-config \-\-libs`
+.fi
.SH SEE ALSO
-http://localhost:631/help
+.BR cups (1),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
+++ /dev/null
-.\"
-.\" "$Id$"
-.\"
-.\" cups-deviced 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 cups-deviced 8 "CUPS" "8 July 2013" "Apple Inc."
-.SH NAME
-cups-deviced \- cups device daemon
-.SH SYNOPSIS
-.B cups-deviced
-.I request-id limit user-id options
-.SH DESCRIPTION
-\fIcups-deviced\fR polls the backends in
-\fI/usr/lib/cups/backend\fR or \fI/usr/libexec/cups/backend\fR (OS X) for a
-list of available devices. It is run by \fIcupsd(8)\fR in response to a
-\fICUPS-Get-Devices\fR request. The output format is an IPP
-response message. The \fIrequest-id\fR argument is the request ID
-from the original IPP request, typically 1. The \fIlimit\fR
-argument is the limit value from the original IPP request - 0
-means no limit. The \fIuser-id\fR argument is the
-requesting-user-name value from the original IPP request.
-Finally, the \fIoptions\fR argument is a space-delimited list of
-attributes ("name=value name=value \...") that were passed in
-with the request. Currently \fIcups-deviced\fR looks for the
-\fIrequested-attributes\fR attribute and tailors the output
-accordingly.
-.SH SEE ALSO
-backend(7), cupsd(8), cupsd.conf(5),
-.br
-http://localhost:631/help
-.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
-.\"
-.\" End of "$Id$".
-.\"
+++ /dev/null
-.\"
-.\" "$Id$"
-.\"
-.\" cups-driverd 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 cups-driverd 8 "CUPS" "8 July 2013" "Apple Inc."
-.SH NAME
-cups-driverd \- cups driver daemon
-.SH SYNOPSIS
-.B cups-driverd
-cat
-.I ppd-name
-.br
-.B cups-driverd
-list
-.I request_id limit options
-.SH DESCRIPTION
-\fIcups-driverd\fR shows or lists PPD files. It is run in
-response to CUPS-Add-Modify-Printer or CUPS-Get-Devices requests.
-The first form ("cups-driverd cat ppd-name") writes the named PPD
-file to stdout. The output format is an uncompressed PPD file.
-.LP
-The second form lists the available manufacturers or PPD files to
-stdout as indicated by the \fIoptions\fR argument. The output
-format is an IPP response message. The \fIrequest_id\fR argument
-is the request ID from the original IPP request, typically 1. The
-\fIlimit\fR argument is the limit value from the original IPP
-request - 0 means no limit. Finally, the \fIoptions\fR argument
-is a space-delimited list of attributes ("name=value name=value
-\&...") that were passed in with the request. Currently
-\fIcups-driverd\fR looks for the \fIppd-make\fR and
-\fIrequested-attributes\fR attributes and tailors the output
-accordingly.
-.SH DRIVERS
-Drivers can be static PPD files under the
-\fI/usr/share/cups/model\fR directory or programs under the
-\fI/usr/lib/cups/driver\fR or \fI/usr/libexec/cups/driver\fR (OS X) directories.
-Static PPD files must conform to the Adobe PPD File Format Specification version
-4.3 and may be compressed using the \fIgzip(1)\fR program. Driver
-programs must implement the command-line interface shown in the
-next section.
-.SS DRIVER PROGRAMS
-Driver programs provide a interface to dynamically-generated PPD
-files. The following arguments are currently defined:
-.TP 5
-drivername list
-.br
-Lists the supported PPD files to stdout.
-.TP 5
-drivername cat ppdname
-.br
-Writes the named PPD file to stdout.
-.PP
-Driver programs MUST NOT query hardware or make other long-term operations that
-would delay the return of a driver list. See the NOTES section below for
-specific recommendations.
-.SS LISTING FILES (drivername list)
-When run with the single argument "list", the program must list
-the available PPD files it can generate to stdout using the
-following format:
-.nf
- "drivername:ppdname" language "make" "make and model"
- "drivername:ppdname" language "make" "make and model" "1284 device id"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version"
- "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version" "type"
-.fi
-.LP
-\fIDrivername\fR is the name of the driver program. \fIPpdname\fR
-is the name used to select the given driver. \fILanguage\fR is
-the locale associated with the default language of the PPD file,
-typically "en". \fIMake\fR is the Manufacturer name from the PPD
-file. \fIMake and model\fR is the NickName name from the PPD
-file. \fI1284 device id\fR is the 1284DeviceId from the PPD file,
-if any. \fI(PPD product)\fR is the Product string as it would appear in the PPD
-file or from a PostScript query. \fIPostScript version\fR is the PSVersion
-string as it would appear in the PPD file or from a PostScript query. \fIType\fR
-is "postscript" for PostScript printers, "pdf" for PDF printers, "raster" for
-raster printers, or "fax" for facsimile devices.
-.SS WRITING FILES (drivername cat ppdname)
-When the driver program is run with the "cat ppdname" arguments,
-it must write the named PPD file to stdout, uncompressed. If the
-named PPD file does not exist, the driver program must not write
-any output to stdout and report the error to stderr instead.
-.SS DRIVER ERROR MESSAGES
-Error messages can be relayed back to \fIcupsd\fR by writing them
-to stderr. The following prefixes are recognized:
-.TP 5
-DEBUG: [drivername]
-.br
-Debugging messages
-.TP 5
-ERROR: [drivername]
-.br
-Error messages
-.TP 5
-INFO: [drivername]
-.br
-Informational messages
-.SH NOTES
-Due to performance considerations, driver programs have been officially
-deprecated and should not be used for new development. Currently only the
-CUPS web interface and \fIlpinfo(8)\fR command will request lists from all
-driver programs.
-.SH SEE ALSO
-cupsd(8), cupsd.conf(5), cupstestppd(1), lpinfo(8),
-.br
-http://localhost:631/help
-.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
-.\"
-.\" End of "$Id$".
-.\"
--- /dev/null
+.\"
+.\" "$Id$"
+.\"
+.\" cupsd-helper man page for CUPS.
+.\"
+.\" Copyright 2007-2014 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-helper 8 "CUPS" "15 April 2014" "Apple Inc."
+.SH NAME
+cupsd\-helper \- cupsd helper programs
+.SH SYNOPSIS
+.B cups\-deviced
+.I request-id
+.I limit
+.I user-id
+.I options
+.br
+.B cups\-driverd
+.B cat
+.I ppd-name
+.br
+.B cups\-driverd
+.B list
+.I request_id
+.I limit
+.I options
+.br
+.B cups\-exec
+.I sandbox-profile
+[
+.I \-g
+.I group-id
+] [
+.I \-n
+.I nice-value
+] [
+.I \-u
+.I user-id
+]
+.I /path/to/program
+.I argv0
+.I ...
+.I argvN
+.SH DESCRIPTION
+The \fBcupsd\-helper\fR programs perform long-running operations on behalf of the scheduler,
+.BR cupsd (8).
+The \fBcups-deviced\fR helper program runs each CUPS
+.BR backend (7)
+with no arguments in order to discover the available printers.
+.LP
+The \fBcups-driverd\fR helper program lists all available printer drivers, a subset of "matching" printer drivers, or a copy of a specific driver PPD file.
+.LP
+The \fBcups-exec\fR helper program runs backends, filters, and other programs. On OS X these programs are run in a secure sandbox.
+.SH FILES
+The \fBcups-driverd\fR program looks for PPD and driver information files in the following directories:
+.nf
+
+ \fI/Library/Printers\fR
+ \fI/opt/share/ppd\fR
+ \fI/System/Library/Printers\fR
+ \fI/usr/local/share/ppd\fR
+ \fI/usr/share/cups/drv\fR
+ \fI/usr/share/cups/model\fR
+ \fI/usr/share/ppd\fR
+.fi
+.LP
+PPD files can be compressed using the
+.BR gzip (1)
+program or placed in compressed
+.BR tar (1)
+archives to further reduce their size.
+.LP
+Driver information files must conform to the format defined in
+.BR ppdcfile (5).
+.SH SEE ALSO
+.BR backend (7),
+.BR cups (1),
+.BR cupsd (8),
+.BR cupsd.conf (5),
+.BR filter (7),
+.BR ppdcfile (5),
+CUPS Online Help (http://localhost:631/help)
+.SH COPYRIGHT
+Copyright \[co] 2007-2014 by Apple Inc.
+.\"
+.\" End of "$Id$".
+.\"
.\"
.\" "$Id$"
.\"
-.\" printers.conf man page for CUPS.
+.\" printers.conf man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 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/".
+.\" 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 printers.conf 5 "CUPS" "29 April 2009" "Apple Inc."
+.TH printers.conf 5 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
printers.conf \- printer configuration file for cups
.SH DESCRIPTION
-The \fIprinters.conf\fR file defines the local printers that are
-available. It is normally located in the \fI/etc/cups\fR directory and
-is generated automatically by the \fIcupsd(8)\fR program when printers
-are added or deleted.
-.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
-.TP 5
-<Printer name> ... </Printer>
-.br
-Defines a specific printer.
-.TP 5
-<DefaultPrinter name> ... </Printer>
-.br
-Defines a default printer.
-.TP 5
-Accepting Yes
-.TP 5
-Accepting No
-.br
-Specifies whether the printer is accepting new jobs.
-.TP 5
-AllowUser [ user @group ... ]
-.br
-Allows specific users and groups to print to the printer.
-.TP 5
-DenyUser [ user @group ... ]
-.br
-Prevents specific users and groups from printing to the printer.
-.TP 5
-DeviceURI uri
-.br
-Specifies the device URI for a printer.
-.TP 5
-ErrorPolicy abort-job
-.TP 5
-ErrorPolicy retry-current-job
-.TP 5
-ErrorPolicy retry-job
-.TP 5
-ErrorPolicy stop-printer
-.br
-Specifies the error policy for the printer.
-.TP 5
-Info text
-.br
-Specifies human-readable text describing the printer.
-.TP 5
-JobSheets banner banner
-.br
-Specifies the banner pages to use for the printer.
-.TP 5
-KLimit number
-.br
-Specifies the job-k-limit value for the printer.
-.TP 5
-Location text
-.br
-Specifies human-readable text describing the location of the printer.
-.TP 5
-OpPolicy name
-.br
-Specifies the operation policy for the printer.
-.TP 5
-PageLimit number
-.br
-Specifies the job-page-limit value for the printer.
-.TP 5
-PortMonitor monitor
-.br
-Specifies the port monitor for a printer.
-.TP 5
-QuotaPeriod seconds
-.br
-Specifies the job-quota-period value for the printer.
-.TP 5
-Shared Yes
-.TP 5
-Shared No
-.br
-Specifies whether the printer is shared.
-.TP 5
-State idle
-.TP 5
-State stopped
-.br
-Specifies the initial state of the printer (Idle or Stopped)
-.TP 5
-StateMessage text
-.br
-Specifies the message associated with the state.
-.TP 5
-StateTime seconds
-.br
-Specifies the date/time associated with the state.
+The \fBprinters.conf\fR file defines the local printers that are available. It is normally located in the \fI/etc/cups\fR directory and is maintained by the
+.BR cupsd (8)
+program. This file is not intended to be edited or managed manually.
+.SH NOTES
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
-\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
-\fImime.convs(5)\fR, \fImime.types(5)\fR,
-.br
-http://localhost:631/help
+.BR classes.conf (5),
+.BR cupsd (8),
+.BR cupsd.conf (5),
+.BR mime.convs (5),
+.BR mime.types (5),
+.BR subscriptions.conf (5),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
.\"
.\" "$Id$"
.\"
-.\" subscriptions.conf man page for CUPS.
+.\" subscriptions.conf man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 2006 by Easy Software Products.
+.\" Copyright 2007-2014 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/".
+.\" 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 subscriptions.conf 5 "CUPS" "30 April 2006" "Apple Inc."
+.TH subscriptions.conf 5 "CUPS" "15 April 2014" "Apple Inc."
.SH NAME
-subscriptions.conf \- subscriptions file for cups
+subscriptions.conf \- subscription configuration file for cups
.SH DESCRIPTION
-The \fIsubscriptions.conf\fR file defines the local subscriptions
-that are active. It is normally located in the \fI/etc/cups\fR
-directory and is generated automatically by the \fIcupsd(8)\fR
-program when subscriptions are created, renewed, or cancelled.
-.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
-.TP 5
-<Subscription NNN> ... </Subscription>
-.br
-Defines a subscription.
-.TP 5
-Events name [ ... name ]
-.br
-Specifies the events that are subscribed.
-.TP 5
-ExpirationTime unix-time
-.br
-Specifies the expiration time of a subscription as a UNIX time
-value in seconds since January 1st, 1970.
-.TP 5
-Interval seconds
-.br
-Specifies the preferred time interval for event notifications in
-seconds.
-.TP 5
-JobId job-id
-.br
-Specifies the job ID associated with the subscription.
-.TP 5
-LeaseDuration seconds
-.br
-Specifies the number of seconds that the subscription is valid
-for. If 0, the subscription does not expire.
-.TP 5
-NextEventId number
-.br
-Specifies the next notify-sequence-number to use for the
-subscription.
-.TP 5
-NextSubscriptionId number
-.br
-Specifies the next subscription-id to use.
-.TP 5
-Owner username
-.br
-Specifies the user that owns the subscription.
-.TP 5
-PrinterName printername
-.br
-Specifies the printer or class associated with the subscription.
-.TP 5
-Recipient uri
-.br
-Specifies the notify-recipient-uri value for push-type notifications.
-.TP 5
-UserData hex-escaped-data
-.br
-Specifies user data to be included in event notifications. This
-is typically the "from" address in mailto: notifications.
+The \fBsubscriptions.conf\fR file defines the local event notification subscriptions that are active. It is normally located in the \fI/etc/cups\fR directory and is maintained by the
+.BR cupsd (8)
+program. This file is not intended to be edited or managed manually.
+.SH NOTES
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
-\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
-\fImime.convs(5)\fR, \fImime.types(5)\fR, \fRprinters.conf(5)\fR
-.br
-http://localhost:631/help
+.BR classes.conf (5),
+.BR cupsd (8),
+.BR cupsd.conf (5),
+.BR mime.convs (5),
+.BR mime.types (5),
+.BR printers.conf (5),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
*
* Usage:
*
- * cups-exec /path/to/profile UID GID NICE /path/to/program argv0 argv1 ... argvN
+ * cups-exec /path/to/profile [-u UID] [-g GID] [-n NICE] /path/to/program argv0 argv1 ... argvN
*/
/*
projects / thirdparty / cups.git / commitdiff
