--- /dev/null
+---
+title: CUPS 2.3rc1
+layout: post
+permalink: /blog/:year-:month-:day-:title.html
+---
+
+CUPS 2.3rc1 is now available for download. This is the first release candidate for CUPS 2.3.0 which adopts the new CUPS license, adds support for IPP presets and finishing templates, and fixes a number of bugs and "polish" issues. This beta also includes the new ippeveprinter utility. A detailed list of changes can be found in the change log included in the download.
+
+Enjoy!
+
+<a class="btn btn-default" href="https://github.com/apple/cups/releases/tag/v2.3rc1">Download CUPS 2.3rc1</a>
<b>lpinfo</b>(8)
to query for available printers using the backend.
The one exception is the SNMP backend - see
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8)</a>
+<b>cups-snmp</b>(8)
for more information.
<h2 class="title"><a name="NOTES">Notes</a></h2>
CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
</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
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5).</a>
+<b>cupsd.conf</b>(5).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<b>cupsd.conf</b>(5),
<b>lp</b>(1),
<b>lpmove</b>(8),
<b>lpstat</b>(1),
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
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>
+<b>cupsd</b>(8)
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>
-<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>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>printers.conf</b>(5),
cups-files.conf - file and directory configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
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>
+<b>cupsd</b>(8).
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.
Configuration directives typically consist of a name and zero or more values separated by whitespace.
Comment lines start with the # character.
<h3><a name="DIRECTIVES">Directives</a></h3>
The following directives are understood by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt><a name="AccessLog"></a><b>AccessLog</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLog </b><i>filename</i>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>classes.conf</b>(5),
<b>cups</b>(1),
-<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>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>printers.conf</b>(5),
service using the corresponding control program.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cups</b>(1),
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</b>(8),
<b>inetconv</b>(1m),
<b>inetd</b>(8),
<b>launchd</b>(8),
file configures how the standard CUPS network backends (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using SNMPv1 and is normally located in the <i>/etc/cups</i> directory.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
<p>The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8).</a>
+<b>cups-snmp</b>(8).
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
The following directives are understood by the CUPS network backends:
<dl class="man">
Printers that do not support IPP can be supported using applications such as
<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8),</a>
+<b>cups-snmp</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-2019 by Apple Inc.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>backend</b>(7),
<b>cups-snmp.conf</b>(5),
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</b>(8),
<b>lpinfo</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>
<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cancel</b>(1),
-<a href="man-client.conf.html?TOPIC=Man+Pages"><b>client.conf</b>(7),</a>
+<b>client.conf</b>(7),
<b>cupsctl</b>(8),
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</b>(8),
<b>lp</b>(1),
<b>lpadmin</b>(8),
<b>lpinfo</b>(8),
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
+<b>lpoptions</b>(1),
<b>lpr</b>(1),
<b>lprm</b>(1),
<b>lpq</b>(1),
<h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
You cannot set the Listen or Port directives using <b>cupsctl</b>.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
<i>argvN</i>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>cupsd-helper</b> programs perform long-running operations on behalf of the scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<b>cupsd</b>(8).
The <b>cups-deviced</b> helper program runs each CUPS
<b>backend</b>(7)
with no arguments in order to discover the available printers.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>backend</b>(7),
<b>cups</b>(1),
-<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>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
<b>filter</b>(7),
<b>ppdcfile</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="NAME">Name</a></h2>
cupsd-logs - cupsd log files (access_log, error_log, and page_log)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
normally maintains three log files: <i>access_log</i> to track requests that are submitted to the scheduler, <i>error_log</i> to track progress and errors, and <i>page_log</i> to track pages that are printed.
Configuration directives in
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
and
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
control what information is logged and where it is stored.
<h3><a name="ACCESS_LOG_FILE_FORMAT">Access Log File Format</a></h3>
The <i>access_log</i> file lists each HTTP resource that is accessed by a web browser or client.
<p>The <i>ipp-status</i> field contains either "-" for non-IPP requests or the IPP status code name for POST requests containing an IPP response.
<h3><a name="ERROR_LOG_FILE_FORMAT">Error Log File Format</a></h3>
The <i>error_log</i> file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
file controls which messages are logged:
<pre class="man">
</pre>
The PageLogFormat directive in the
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
file can be used to change this information.
<p>The <i>printer</i> field contains the name of the printer that printed the page.
If you send a job to a printer class, this field will contain the name of the printer that was assigned the job.
<p>The <i>media</i> field contains a copy of the media or media-col/media-size attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
<p>The <i>sides</i> field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<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-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>cups-files.conf</b>(5),
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-2019 by Apple Inc.
The
<i>cupsd.conf</i>
file configures the CUPS scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<b>cupsd</b>(8).
It is normally located in the
<i>/etc/cups</i>
directory.
Comment lines start with the # character.
<h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3>
The following top-level directives are understood by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt><a name="AccessLogLevel"></a><b>AccessLogLevel config</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLogLevel actions</b>
<dd style="margin-left: 5.0em"><dt><b>HostNameLookups Double</b>
<dd style="margin-left: 5.0em">Specifies whether to do reverse lookups on connecting clients.
The "Double" setting causes
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
to verify that the hostname resolved from the address matches one of the addresses returned for that hostname.
Double lookups also prevent clients with unregistered addresses from connecting to your server.
The default is "Off" to avoid the potential server performance problems with hostname lookups.
<dd style="margin-left: 5.0em">Specifies the length of time to wait before shutting down due to inactivity.
The default is "60" seconds.
Note: Only applicable when
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
is run on-demand (e.g., with <b>-l</b>).
<dt><a name="JobKillDelay"></a><b>JobKillDelay </b><i>seconds</i>
<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.
</dl>
<h3><a name="HTTP_METHOD_NAMES">Http Method Names</a></h3>
The following HTTP methods are supported by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>GET
<dd style="margin-left: 5.0em">Used by a client to download icons and other printer resources and to access the CUPS web interface.
</dl>
<h3><a name="IPP_OPERATION_NAMES">Ipp Operation Names</a></h3>
The following IPP operations are supported by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>CUPS-Accept-Jobs
<dd style="margin-left: 5.0em">Allows a printer to accept new jobs.
</dl>
<h3><a name="LOCATION_PATHS">Location Paths</a></h3>
The following paths are commonly used when configuring
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>/
<dd style="margin-left: 5.0em">The path for all get operations (get-printers, get-jobs, etc.)
<dt><b>Require user {</b><i>user-name</i>|<b>@</b><i>group-name</i>} ...
<dd style="margin-left: 5.0em">Specifies that an authenticated user must match one of the named users or be a member of one of the named groups.
The group name "@SYSTEM" corresponds to the list of groups defined by the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
The group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job.
Note: The 'root' user is not special and must be granted privileges like any other user account.
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
<dt><b>JobPrivateValues all</b>
<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues default</b>
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
<dt><b>SubscriptionPrivateValues all</b>
<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues default</b>
</dl>
<h2 class="title"><a name="NOTES">Notes</a></h2>
File, directory, and user configuration directives that used to be allowed in the <b>cupsd.conf</b> file are now stored in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file instead in order to prevent certain types of privilege escalation attacks.
<p>The scheduler MUST be restarted manually after making changes to the <b>cupsd.conf</b> file.
On Linux this is typically done using the
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>classes.conf</b>(5),
-<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>
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>printers.conf</b>(5),
<b>backend</b>(7),
<b>classes.conf</b>(5),
<b>cups</b>(1),
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</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>
+<b>cups-files.conf</b>(5),
+<b>cups-lpd</b>(8),
+<b>cupsd.conf</b>(5),
<b>cupsd-helper</b>(8),
<b>cupsd-logs</b>(8),
<b>filter</b>(7),
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cups</b>(1),
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<b>cupsd.conf</b>(5),
<b>filter(7),</b>
<b>mime.convs</b>(7),
<b>mime.types</b>(7),
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>backend</b>(7),
<b>cups</b>(1),
-<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>
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
<b>cupsfilter</b>(8),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<b>-D</b>
<i>device-uri</i>
] [
+<b>-F</b>
+<i>output-type/subtype</i>
+] [
<b>-K</b>
<i>keypath</i>
] [
When specifying a directory,
<b>ippeveprinter</b>
will create an output file using the job ID and name.
+<dt><b>-F </b><i>output-type/subtype[,...]</i>
+<dd style="margin-left: 5.0em">Specifies the output MIME media type.
+The default is "application/postscript" when the <b>-P</b> option is specified.
<dt><b>-M </b><i>manufacturer</i>
<dd style="margin-left: 5.0em">Set the manufacturer of the printer.
The default is "Example".
<dd style="margin-left: 5.0em">Run the specified command for each document that is printed.
If "command" is not an absolute path ("/path/to/command"),
<b>ippeveprinter</b>
-looks for the command in the "ippeveprinter" subdirectory of the CUPS binary directory, typically /usr/lib/cups/ippeveprinter or /usr/libexec/cups/ippeveprinter.
+looks for the command in the "command" subdirectory of the CUPS binary directory, typically /usr/lib/cups/command or /usr/libexec/cups/command.
The
<b>cups-config</b>(1)
command can be used to discover the correct binary directory ("cups-config --serverbin").
<b>ippeveprinter</b>
adds environment variables starting with "IPP_" for all IPP Job attributes in the print request.
For example, when executing a command for an IPP Job containing the "media" Job Template attribute, the "IPP_MEDIA" environment variable will be set to the value of that attribute.
-<p>In addition, all IPP "xxx-default" Printer Description attributes are added to the environment.
+<p>In addition, all IPP "xxx-default" and "pwg-xxx" Printer Description attributes are added to the environment.
For example, the "IPP_MEDIA_DEFAULT" environment variable will be set to the default value for the "media" Job Template attribute.
<p>Enumerated values are converted to their keyword equivalents.
For example, a "print-quality" Job Template attribute with a enum value of 3 will become the "IPP_PRINT_QUALITY" environment variable with a value of "draft".
This string conversion only happens for standard Job Template attributes, currently "finishings", "orientation-requested", and "print-quality".
-<p>Finally, the "CONTENT_TYPE" environment variable contains the MIME media type of the document being printed, the "DEVICE_URI" environment variable contains the device URI as specified with the "-D" option, and the "PPD" environment variable contains the PPD filename as specified with the "-P" option.
+<p>Finally, the "CONTENT_TYPE" environment variable contains the MIME media type of the document being printed, the "DEVICE_URI" environment variable contains the device URI as specified with the "-D" option, the "OUTPUT_FORMAT" environment variable contains the output MIME media type, and the "PPD" environment variable contains the PPD filename as specified with the "-P" option.
<h2 class="title"><a name="COMMAND_OUTPUT">Command Output</a></h2>
Unless they communicate directly with a printer, print commands send printer-ready data to the standard output.
<p>Print commands can send messages back to
ippeveprinter -c /usr/bin/file "My Cool Printer"
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
+<b>ippevepcl</b>(7),
+<b>ippeveps</b>(7),
PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright © 2007-2019 by Apple Inc.
<dd style="margin-left: 5.0em">Inserts a single "$" character.
<dt><b>$ENV[</b><i>name</i><b>]</b>
<dd style="margin-left: 5.0em">Inserts the value of the named environment variable, or an empty string if the environment variable is not defined.
+<dt><b>$date-current</b>
+<dd style="margin-left: 5.0em">Inserts the current date and time using the ISO-8601 format ("yyyy-mm-ddThh:mm:ssZ").
+<dt><b>$date-start</b>
+<dd style="margin-left: 5.0em">Inserts the starting date and time using the ISO-8601 format ("yyyy-mm-ddThh:mm:ssZ").
<dt><b>$filename</b>
<dd style="margin-left: 5.0em">Inserts the filename provided to
<b>ipptool</b>(8)
<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
If neither are set, the current default set using the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command is used, followed by the default set using the
<b>lpadmin</b>(8)
command.
</dl>
<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
Aside from the printer-specific options reported by the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command, the following generic options are available:
<dl class="man">
<dt><b>-o job-sheets=</b><i>name</i>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cancel</b>(1),
<b>lpadmin</b>(8),
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
+<b>lpoptions</b>(1),
<b>lpq</b>(1),
<b>lpr</b>(1),
<b>lprm</b>(1),
or
<b>lpr</b>(1)
commands will use this destination unless the user specifies otherwise with the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command.
<p>The second form of the command (<i>-p</i>) configures the named printer or class. The additional options are described below.
<p>The third form of the command (<i>-x</i>) deletes the printer or class <i>destination</i>.
<dt><b>-o </b><i>name</i><b>=</b><i>value</i>
<dd style="margin-left: 5.0em">Sets a PPD option for the printer.
PPD options can be listed using the <i>-l</i> option with the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command.
<dt><b>-o </b><i>name</i><b>-default=</b><i>value</i>
<dd style="margin-left: 5.0em">Sets a default server-side option for the destination.
<b>cupsaccept</b>(8),
<b>cupsenable</b>(8),
<b>lpinfo</b>(8),
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
+<b>lpoptions</b>(1),
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-2019 by Apple Inc.
<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
If neither are set, the current default set using the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command is used, followed by the default set using the
<b>lpadmin</b>(8)
command.
</dl>
<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
Aside from the printer-specific options reported by the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command, the following generic options are available:
<dl class="man">
<dt><b>-o job-sheets=</b><i>name</i>
<b>cancel</b>(1),
<b>lp</b>(1),
<b>lpadmin</b>(8),
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
+<b>lpoptions</b>(1),
<b>lpq</b>(1),
<b>lprm</b>(1),
<b>lpstat</b>(1),
<dd style="margin-left: 5.0em">Specifies a prefix string for the subject line of an email notification.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</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-2019 by Apple Inc.
Printers that do not support IPP can be supported using applications such as
<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
<b>cupsfilter</b>(8),
<b>mime.types</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
string(4,PwgRaster<00>) priority(150)
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
<b>cupsfilter</b>(8),
<b>mime.convs</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
Notifiers inherit the environment and can use the logging mechanism documented in
<b>filter</b>(7).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</b>(8),
<b>filter</b>(7),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
printers.conf - printer configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
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>
+<b>cupsd</b>(8)
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>
<b>classes.conf</b>(5),
-<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-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>subscriptions.conf</b>(5),
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
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>
+<b>cupsd</b>(8)
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>
<b>classes.conf</b>(5),
-<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-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>printers.conf</b>(5),
layout: sub
---
+<h2 class="title"><a name="0203rc1">CUPS 2.3rc1</a> <em>(May 21, 2019)</em></h2>
+
+<ul>
+ <li>The <code>cups-config</code> script no longer adds extra libraries when linking against shared libraries (Issue #5261)</li>
+ <li>The supplied example print documents have been optimized for size (Issue #5529)</li>
+ <li>The <code>cupsctl</code> command now prevents setting "cups-files.conf" directives (Issue #5530)</li>
+ <li>The "forbidden" message in the web interface is now explained (Issue #5547)</li>
+ <li>The footer in the web interface covered some content on small displays (Issue #5574)</li>
+ <li>The libusb-based USB backend now enforces read limits, improving print speed in many cases (Issue #5583)</li>
+ <li>The <code>ippeveprinter</code> command now looks for print commands in the "command" subdirectory.</li>
+ <li>The <code>ipptool</code> command now supports <code>$date-current</code> and <code>$date-start</code> variables to insert the current and starting date and time values, as well as ISO-8601 relative time values such as "PT30S" for 30 seconds in the future.</li>
+</ul>
+
+
<h2 class="title"><a name="0203b8">CUPS 2.3b8</a> <em>(May 2, 2019)</em></h2>
<ul>
<li>Fixed a performance regression with large PPDs (rdar://47040759)</li>
<li>Fixed a memory reallocation bug in HTTP header value expansion (rdar://problem/50000749)</li>
<li>Timed out job submission now yields an error (Issue #5570)</li>
- <li>Restored minimal support for the `Emulators` keyword in PPD files to allow old Samsung printer drivers to continue to work (Issue #5562)</li>
+ <li>Restored minimal support for the <code>Emulators</code> keyword in PPD files to allow old Samsung printer drivers to continue to work (Issue #5562)</li>
<li>The scheduler did not encode octetString values like "job-password" correctly for the print filters (Issue #5558)</li>
- <li>The `cupsCheckDestSupported` function did not check octetString values correctly (Issue #5557)</li>
- <li>Added support for `UserAgentTokens` directive in "client.conf" (Issue #5555)</li>
+ <li>The <code>cupsCheckDestSupported</code> function did not check octetString values correctly (Issue #5557)</li>
+ <li>Added support for <code>UserAgentTokens</code> directive in "client.conf" (Issue #5555)</li>
<li>Updated the systemd service file for cupsd (Issue #5551)</li>
- <li>The `ippValidateAttribute` function did not catch all instances of invalid UTF-8 strings (Issue #5509)</li>
+ <li>The <code>ippValidateAttribute</code> function did not catch all instances of invalid UTF-8 strings (Issue #5509)</li>
<li>Fixed an issue with the self-signed certificates generated by GNU TLS (Issue #5506)</li>
<li>Fixed a potential memory leak when reading at the end of a file (Issue #5473)</li>
<li>Fixed potential unaligned accesses in the string pool (Issue #5474)</li>
<li>The scheduler's self-signed certificate did not include all of the alternate names for the server when using GNU TLS (Issue #5525)</li>
<li>Fixed compiler warnings with newer versions of GCC (Issue #5532, Issue #5533)</li>
<li>Fixed some PPD caching and IPP Everywhere PPD accounting/password bugs (Issue #5535)</li>
- <li>Fixed `PreserveJobHistory` bug with time values (Issue #5538)</li>
+ <li>Fixed <code>PreserveJobHistory</code> bug with time values (Issue #5538)</li>
<li>The scheduler no longer advertises the HTTP methods it supports (Issue #5540)</li>
<li>Localization updates (Issue #5461, Issues #5471, Issue #5481, Issue #5486, Issue #5489, Issue #5491, Issue #5492, Issue #5493, Issue #5494, Issue #5495, Issue #5497, Issue #5499, Issue #5500, Issue #5501, Issue #5504)</li>
<li>The scheduler did not always idle exit as quickly as it could.</li>
- <li>Added a new `ippeveprinter` command based on the old ippserver sample code.</li>
+ <li>Added a new <code>ippeveprinter</code> command based on the old ippserver sample code.</li>
</ul>
projects / thirdparty / cups.git / commitdiff
