node = NULL;
offset = 0;
- cupsCopyString(section, "Other", sizeof(section));
+ if (strstr(filename, "/man-") != NULL)
+ cupsCopyString(section, "Man Pages", sizeof(section));
+ else
+ cupsCopyString(section, "Other", sizeof(section));
while (cupsFileGets(fp, line, sizeof(line)))
{
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>backend(7)</title>
-</head>
-<body>
-<h1 class="title">backend(7)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-backend - cups backend transmission interfaces
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>backend</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>backend(7)</title>
+ </head>
+ <body>
+ <h1 id="backend-7">backend(7)</h1>
+ <h2 id="backend-7.name">Name</h2>
+<p>backend - cups backend transmission interfaces
+</p>
+ <h2 id="backend-7.synopsis">Synopsis</h2>
+<p><strong>backend</strong>
<br>
-<b>backend</b>
-<i>job</i>
-<i>user</i>
-<i>title</i>
-<i>num-copies</i>
-<i>options</i>
+<strong>backend</strong>
+<em>job</em>
+<em>user</em>
+<em>title</em>
+<em>num-copies</em>
+<em>options</em>
[
-<i>filename</i>
+<em>filename</em>
]
-<pre class="man">
-<b>#include <cups/cups.h></b>
+</p>
+ <pre>
+<strong>#include <cups/cups.h></strong>
-<b>const char *cupsBackendDeviceURI</b>(<b>char **</b><i>argv</i>);
+<strong>const char *cupsBackendDeviceURI</strong>(<strong>char **</strong><em>argv</em>);
-<b>void cupsBackendReport</b>(<b>const char *</b><i>device_scheme</i>,
- <b>const char *</b><i>device_uri</i>,
- <b>const char *</b><i>device_make_and_model</i>,
- <b>const char *</b><i>device_info</i>,
- <b>const char *</b><i>device_id</i>,
- <b>const char *</b><i>device_location</i>);
+<strong>void cupsBackendReport</strong>(<strong>const char *</strong><em>device_scheme</em>,
+ <strong>const char *</strong><em>device_uri</em>,
+ <strong>const char *</strong><em>device_make_and_model</em>,
+ <strong>const char *</strong><em>device_info</em>,
+ <strong>const char *</strong><em>device_id</em>,
+ <strong>const char *</strong><em>device_location</em>);
-<b>ssize_t cupsBackChannelWrite</b>(<b>const char *</b><i>buffer</i>,
- <b>size_t </b><i>bytes</i>, <b>double </b><i>timeout</i>);
+<strong>ssize_t cupsBackChannelWrite</strong>(<strong>const char *</strong><em>buffer</em>,
+ <strong>size_t </strong><em>bytes</em>, <strong>double </strong><em>timeout</em>);
-<b>int cupsSideChannelRead</b>(<b>cups_sc_command_t *</b><i>command</i>,
- <b>cups_sc_status_t *</b><i>status</i>, <b>char *</b><i>data</i>,
- <b>int *</b><i>datalen</i>, <b>double </b><i>timeout</i>);
+<strong>int cupsSideChannelRead</strong>(<strong>cups_sc_command_t *</strong><em>command</em>,
+ <strong>cups_sc_status_t *</strong><em>status</em>, <strong>char *</strong><em>data</em>,
+ <strong>int *</strong><em>datalen</em>, <strong>double </strong><em>timeout</em>);
-<b>int cupsSideChannelWrite</b>(<b>cups_sc_command_t </b><i>command</i>,
- <b>cups_sc_status_t </b><i>status</i>, <b>const char *</b><i>data</i>,
- <b>int </b><i>datalen</i>, <b>double </b><i>timeout</i>);
+<strong>int cupsSideChannelWrite</strong>(<strong>cups_sc_command_t </strong><em>command</em>,
+ <strong>cups_sc_status_t </strong><em>status</em>, <strong>const char *</strong><em>data</em>,
+ <strong>int </strong><em>datalen</em>, <strong>double </strong><em>timeout</em>);
</pre>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-Backends are a special type of
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7)</a>
+ <h2 id="backend-7.description">Description</h2>
+<p>Backends are a special type of
+<strong>filter</strong>(7)
+
which is used to send print data to and discover different devices on the system.
-<p>Like filters, backends must be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the physical interface.
-<p>The command name (<i>argv[0]</i>) is set to the device URI of the destination printer.
+</p>
+ <p>Like filters, backends must be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the physical interface.
+</p>
+ <p>The command name (<em>argv[0]</em>) is set to the device URI of the destination printer.
Authentication information in
-<i>argv[0]</i>
+<em>argv[0]</em>
is removed, so backend developers are urged to use the
-<b>DEVICE_URI</b>
+<strong>DEVICE_URI</strong>
environment variable whenever authentication information is required. The
-<b>cupsBackendDeviceURI</b>()
+<strong>cupsBackendDeviceURI</strong>()
+
function may be used to retrieve the correct device URI.
-<p>Back-channel data from the device should be relayed to the job filters using the <i>cupsBackChannelWrite</i> function.
-<p>Backends are responsible for reading side-channel requests using the
-<b>cupsSideChannelRead</b>()
+</p>
+ <p>Back-channel data from the device should be relayed to the job filters using the <em>cupsBackChannelWrite</em> function.
+</p>
+ <p>Backends are responsible for reading side-channel requests using the
+<strong>cupsSideChannelRead</strong>()
+
function and responding with the
-<b>cupsSideChannelWrite</b>()
+<strong>cupsSideChannelWrite</strong>()
+
function. The
-<b>CUPS_SC_FD</b>
+<strong>CUPS_SC_FD</strong>
constant defines the file descriptor that should be monitored for incoming requests.
-<h3><a name="DEVICE_DISCOVERY">Device Discovery</a></h3>
-When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output.
+</p>
+ <h3 id="backend-7.description.device-discovery">Device Discovery</h3>
+<p>When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output.
The output consists of zero or more lines consisting of any of the following forms:
-<pre class="man">
- device-class scheme "Unknown" "device-info"
- device-class device-uri "device-make-and-model" "device-info"
- device-class device-uri "device-make-and-model" "device-info" "device-id"
- device-class device-uri "device-make-and-model" "device-info" "device-id" "device-location"
+</p>
+ <pre>
+ device-class scheme "Unknown" "device-info"
+ device-class device-uri "device-make-and-model" "device-info"
+ device-class device-uri "device-make-and-model" "device-info" "device-id"
+ device-class device-uri "device-make-and-model" "device-info" "device-id" "device-location"
</pre>
-<p>The
-<b>cupsBackendReport</b>()
+ <p>The
+<strong>cupsBackendReport</strong>()
+
function can be used to generate these lines and handle any necessary escaping of characters in the various strings.
-<p>The
-<i>device-class</i>
+</p>
+ <p>The
+<em>device-class</em>
field is one of the following values:
-<dl class="man">
-<dt><b>direct</b>
-<dd style="margin-left: 5.0em">The device-uri refers to a specific direct-access device with no options, such as a parallel, USB, or SCSI device.
-<dt><b>file</b>
-<dd style="margin-left: 5.0em">The device-uri refers to a file on disk.
-<dt><b>network</b>
-<dd style="margin-left: 5.0em">The device-uri refers to a networked device and conforms to the general form for
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>direct</strong><br>
+The device-uri refers to a specific direct-access device with no options, such as a parallel, USB, or SCSI device.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>file</strong><br>
+The device-uri refers to a file on disk.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>network</strong><br>
+The device-uri refers to a networked device and conforms to the general form for
network URIs.
-<dt><b>serial</b>
-<dd style="margin-left: 5.0em">The device-uri refers to a serial device with configurable baud rate and other options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>serial</strong><br>
+The device-uri refers to a serial device with configurable baud rate and other options.
If the device-uri contains a baud value, it represents the maximum baud rate supported by the device.
-</dl>
-<p>The
-<i>scheme</i>
+</p>
+<em>scheme</em>
field provides the URI scheme that is supported by the backend.
Backends should use this form only when the backend supports any URI using that scheme.
The
-<i>device-uri</i>
+<em>device-uri</em>
field specifies the full URI to use when communicating with the device.
-<p>The
-<i>device-make-and-model</i>
-field specifies the make and model of the device, e.g. "Example Foojet 2000".
-If the make and model is not known, you must report "Unknown".
-<p>The
-<i>device-info</i>
+</p>
+ <p>The
+<em>device-make-and-model</em>
+field specifies the make and model of the device, e.g. "Example Foojet 2000".
+If the make and model is not known, you must report "Unknown".
+</p>
+ <p>The
+<em>device-info</em>
field specifies additional information about the device.
-Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
-<p>The optional
-<i>device-id</i>
+Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
+</p>
+ <p>The optional
+<em>device-id</em>
field specifies the IEEE-1284 device ID string for the device, which is used to select a matching driver.
-<p>The optional
-<i>device-location</i>
+</p>
+ <p>The optional
+<em>device-location</em>
field specifies the physical location of the device, which is often used to pre-populate the printer-location attribute when adding a printer.
-<h3><a name="PERMISSIONS">Permissions</a></h3>
-Backends without world read and execute permissions are run as the root user.
-Otherwise, the backend is run using an unprivileged user account, typically "lp".
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-The following exit codes are defined for backends:
-<dl class="man">
-<dt><b>CUPS_BACKEND_OK</b>
-<dd style="margin-left: 5.0em">The print file was successfully transmitted to the device or remote server.
-<dt><b>CUPS_BACKEND_FAILED</b>
-<dd style="margin-left: 5.0em"><br>
+</p>
+ <h3 id="backend-7.description.permissions">Permissions</h3>
+<p>Backends without world read and execute permissions are run as the root user.
+Otherwise, the backend is run using an unprivileged user account, typically "lp".
+</p>
+ <h2 id="backend-7.exit-status">Exit Status</h2>
+<p>The following exit codes are defined for backends:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_OK</strong><br>
+The print file was successfully transmitted to the device or remote server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_FAILED</strong><br>
+<br>
The print file was not successfully transmitted to the device or remote server.
The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the
-<i>printer-error-policy</i>
+<em>printer-error-policy</em>
attribute.
-<dt><b>CUPS_BACKEND_AUTH_REQUIRED</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because valid authentication information is required.
-The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
-<dt><b>CUPS_BACKEND_HOLD</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_AUTH_REQUIRED</strong><br>
+The print file was not successfully transmitted because valid authentication information is required.
+The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_HOLD</strong><br>
+The print file was not successfully transmitted because it cannot be printed at this time.
The scheduler will respond to this by holding the job.
-<dt><b>CUPS_BACKEND_STOP</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_STOP</strong><br>
+The print file was not successfully transmitted because it cannot be printed at this time.
The scheduler will respond to this by stopping the queue.
-<dt><b>CUPS_BACKEND_CANCEL</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_CANCEL</strong><br>
+The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer.
The scheduler will respond to this by canceling the job.
-<dt><b>CUPS_BACKEND_RETRY</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_RETRY</strong><br>
+The print file was not successfully transmitted because of a temporary issue.
The scheduler will retry the job at a future time - other jobs may print before this one.
-<dt><b>CUPS_BACKEND_RETRY_CURRENT</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_BACKEND_RETRY_CURRENT</strong><br>
+The print file was not successfully transmitted because of a temporary issue.
The scheduler will retry the job immediately without allowing intervening jobs.
-</dl>
-<p>All other exit code values are reserved.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-In addition to the environment variables listed in
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+</p>
+ <p>All other exit code values are reserved.
+</p>
+ <h2 id="backend-7.environment">Environment</h2>
+<p>In addition to the environment variables listed in
+<strong>cups</strong>(1)
+
and
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
+<strong>filter</strong>(7),
+
CUPS backends can expect the following environment variable:
-<dl class="man">
-<dt><b>DEVICE_URI</b>
-<dd style="margin-left: 5.0em">The device URI associated with the printer.
-</dl>
-<h2 class="title"><a name="FILES">Files</a></h2>
-<i>/etc/cups/cups-files.conf</i>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS backends are not generally designed to be run directly by the user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEVICE_URI</strong><br>
+The device URI associated with the printer.
+</p>
+ <h2 id="backend-7.files">Files</h2>
+<p><em>/etc/cups/cups-files.conf</em>
+</p>
+ <h2 id="backend-7.notes">Notes</h2>
+<p>CUPS backends are not generally designed to be run directly by the user.
Aside from the device URI issue (
-<i>argv[0]</i>
+<em>argv[0]</em>
and
-<b>DEVICE_URI</b>
+<strong>DEVICE_URI</strong>
environment variable contain the device URI), CUPS backends also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
-Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
-<p>Unless you are a developer and know what you are doing, please do not run backends directly.
+Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
+</p>
+ <p>Unless you are a developer and know what you are doing, please do not run backends directly.
Instead, use the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+<strong>lp</strong>(1)
+
or
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<strong>lpr</strong>(1)
+
programs to send print jobs or
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<strong>lpinfo</strong>(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>
+<strong>cups-snmp</strong>(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.
+</p>
+ <h2 id="backend-7.notes">Notes</h2>
+<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>cups</i>(1),
-<i>cups-files.conf</i>(5),
-<i>cups-snmp</i>(8),
-<i>cupsd</i>(8),
-<i>filter</i>(7),
-<i>lp</i>(1),
-<i>lpinfo</i>(8),
-<i>lpr</i>(1),
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="backend-7.see-also">See Also</h2>
+<p><em>cups</em>(1),
+
+<em>cups-files.conf</em>(5),
+
+<em>cups-snmp</em>(8),
+
+<em>cupsd</em>(8),
+
+<em>filter</em>(7),
+
+<em>lp</em>(1),
+
+<em>lpinfo</em>(8),
+
+<em>lpr</em>(1),
+
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="backend-7.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cancel(1)</title>
-</head>
-<body>
-<h1 class="title">cancel(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cancel - cancel jobs
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cancel</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cancel(1)</title>
+ </head>
+ <body>
+ <h1 id="cancel-1">cancel(1)</h1>
+ <h2 id="cancel-1.name">Name</h2>
+<p>cancel - cancel jobs
+</p>
+ <h2 id="cancel-1.synopsis">Synopsis</h2>
+<p><strong>cancel</strong>
[
-<b>-h</b>
-<i>hostname[:port]</i>
+<strong>-h</strong>
+<em>hostname[:port]</em>
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-a</b>
+<strong>-a</strong>
] [
-<b>-u</b>
-<i>username</i>
+<strong>-u</strong>
+<em>username</em>
] [
-<b>-x</b>
+<strong>-x</strong>
] [
-<i>id</i>
+<em>id</em>
] [
-<i>destination</i>
+<em>destination</em>
] [
-<i>destination-id</i>
+<em>destination-id</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-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 <b>cancel</b>:
-<dl class="man">
-<dt><b>-a</b>
-<dd style="margin-left: 5.0em">Cancel all jobs on the named destination, or all jobs on all
+</p>
+ <h2 id="cancel-1.description">Description</h2>
+<p>The <strong>cancel</strong> command cancels print jobs.
+If no <em>destination</em> or <em>id</em> is specified, the currently printing job on the default destination is canceled.
+</p>
+ <h2 id="cancel-1.options">Options</h2>
+<p>The following options are recognized by <strong>cancel</strong>:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a</strong><br>
+Cancel all jobs on the named destination, or all jobs on all
destinations if none is provided.
-<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.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>hostname</em>[<em>:port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-<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="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">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies the username to use when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong><em>username</em><br>
+Cancels jobs owned by <em>username</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-x</strong><br>
+Deletes job data files in addition to canceling.
+</p>
+ <h2 id="cancel-1.conforming-to">Conforming To</h2>
+<p>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 <em>not</em> case-sensitive.
+</p>
+ <h2 id="cancel-1.examples">Examples</h2>
+<p>Cancel the current print job:
+</p>
+ <pre>
cancel
</pre>
-Cancel job "myprinter-42":
-<pre class="man">
+<p>Cancel job "myprinter-42":
+</p>
+ <pre>
cancel myprinter-42
</pre>
-Cancel all jobs:
-<pre class="man">
+<p>Cancel all jobs:
+</p>
+ <pre>
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
-<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>
-<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 © 2021-2023 by OpenPrinting.
+ <h2 id="cancel-1.notes">Notes</h2>
+<p>Administrators wishing to prevent unauthorized cancellation of jobs via the <em>-u</em> option should require authentication for Cancel-Jobs operations in
+<strong>cupsd.conf</strong>(5).
+
+</p>
+ <h2 id="cancel-1.see-also">See Also</h2>
+<p><strong>cupsd.conf</strong>(5),
+
+<strong>lp</strong>(1),
-</body>
+<strong>lpmove</strong>(8),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cancel-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>classes.conf(5)</title>
-</head>
-<body>
-<h1 class="title">classes.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-classes.conf - class configuration file for cups
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <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>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>classes.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="classes.conf-5">classes.conf(5)</h1>
+ <h2 id="classes.conf-5.name">Name</h2>
+<p>classes.conf - class configuration file for cups
+</p>
+ <h2 id="classes.conf-5.description">Description</h2>
+<p>The <strong>classes.conf</strong> file defines the local printer classes that are available.
+It is normally located in the <em>/etc/cups</em> directory and is maintained by the
+<strong>cupsd</strong>(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>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="classes.conf-5.notes">Notes</h2>
+<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
+</p>
+ <h2 id="classes.conf-5.see-also">See Also</h2>
+<p><strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>mime.convs</strong>(5),
-</body>
+<strong>mime.types</strong>(5),
+
+<strong>printers.conf</strong>(5),
+
+<strong>subscriptions.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="classes.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>client.conf(5)</title>
-</head>
-<body>
-<h1 class="title">client.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-client.conf - client configuration file for cups (deprecated on macos)
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>client.conf</b> file configures the CUPS client and is normally located in the <i>/etc/cups</i> and/or <i>~/.cups</i> directories.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>client.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="client.conf-5">client.conf(5)</h1>
+ <h2 id="client.conf-5.name">Name</h2>
+<p>client.conf - client configuration file for cups (deprecated on macos)
+</p>
+ <h2 id="client.conf-5.description">Description</h2>
+<p>The <strong>client.conf</strong> file configures the CUPS client and is normally located in the <em>/etc/cups</em> and/or <em>~/.cups</em> directories.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
-<p><b>Note:</b> Starting with macOS 10.7, this file is only used by command-line and X11 applications plus the IPP backend.
-The <b>ServerName</b> directive is not supported on macOS at all.
-Starting with macOS 10.12, all applications can access these settings in the <i>/Library/Preferences/org.cups.PrintingPrefs.plist</i> file instead.
+</p>
+ <p><strong>Note:</strong> Starting with macOS 10.7, this file is only used by command-line and X11 applications plus the IPP backend.
+The <strong>ServerName</strong> directive is not supported on macOS at all.
+Starting with macOS 10.12, all applications can access these settings in the <em>/Library/Preferences/org.cups.PrintingPrefs.plist</em> file instead.
See the NOTES section below for more information.
-<h3><a name="DIRECTIVES">Directives</a></h3>
-The following directives are understood by the client. Consult the online help for detailed descriptions:
-<dl class="man">
-<dt><a name="AllowAnyRoot"></a><b>AllowAnyRoot Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>AllowAnyRoot No</b>
-<dd style="margin-left: 5.0em">Specifies whether to allow TLS with certificates that have not been signed by a trusted Certificate Authority.
-The default is "Yes".
-<dt><a name="AllowExpiredCerts"></a><b>AllowExpiredCerts Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>AllowExpiredCerts No</b>
-<dd style="margin-left: 5.0em">Specifies whether to allow TLS with expired certificates.
-The default is "No".
-<dt><a name="DigestOptions"></a><b>DigestOptions DenyMD5</b>
-<dd style="margin-left: 5.0em"><dt><b>DigestOptions None</b>
-<dd style="margin-left: 5.0em">Specifies HTTP Digest authentication options.
-<b>DenyMD5</b> disables support for the original MD5 hash algorithm.
-<dt><a name="Encryption"></a><b>Encryption IfRequested</b>
-<dd style="margin-left: 5.0em"><dt><b>Encryption Never</b>
-<dd style="margin-left: 5.0em"><dt><b>Encryption Required</b>
-<dd style="margin-left: 5.0em">Specifies the level of encryption that should be used.
-<dt><a name="GSSServiceName"></a><b>GSSServiceName </b><i>name</i>
-<dd style="margin-left: 5.0em">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".
-<dt><a name="ServerName"></a><b>ServerName </b><i>hostname-or-ip-address</i>[<i>:port</i>]
-<dd style="margin-left: 5.0em"><dt><b>ServerName </b><i>/domain/socket</i>
-<dd style="margin-left: 5.0em">Specifies the address and optionally the port to use when connecting to the server.
-<b>Note: This directive is not supported on macOS 10.7 or later.</b>
-<dt><b>ServerName </b><i>hostname-or-ip-address</i>[<i>:port</i>]<b>/version=1.1</b>
-<dd style="margin-left: 5.0em">Specifies the address and optionally the port to use when connecting to a server running CUPS 1.3.12 and earlier.
-<dt><a name="SSLOptions"></a><b>SSLOptions </b>[<i>AllowDH</i>] [<i>AllowRC4</i>] [<i>AllowSSL3</i>] [<i>DenyCBC</i>] [<i>DenyTLS1.0</i>] [<i>MaxTLS1.0</i>] [<i>MaxTLS1.1</i>] [<i>MaxTLS1.2</i>] [<i>MaxTLS1.3</i>] [<i>MinTLS1.0</i>] [<i>MinTLS1.1</i>] [<i>MinTLS1.2</i>] [<i>MinTLS1.3</i>]
-<dd style="margin-left: 5.0em"><dt><b>SSLOptions None</b>
-<dd style="margin-left: 5.0em">Sets encryption options (only in /etc/cups/client.conf).
+</p>
+ <h3 id="client.conf-5.description.directives">Directives</h3>
+<p>The following directives are understood by the client. Consult the online help for detailed descriptions:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AllowAnyRoot Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AllowAnyRoot No</strong><br>
+Specifies whether to allow TLS with certificates that have not been signed by a trusted Certificate Authority.
+The default is "Yes".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AllowExpiredCerts Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AllowExpiredCerts No</strong><br>
+Specifies whether to allow TLS with expired certificates.
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DigestOptions DenyMD5</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DigestOptions None</strong><br>
+Specifies HTTP Digest authentication options.
+<strong>DenyMD5</strong> disables support for the original MD5 hash algorithm.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption IfRequested</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption Never</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption Required</strong><br>
+Specifies the level of encryption that should be used.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>GSSServiceName </strong><em>name</em><br>
+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".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerName </strong><em>hostname-or-ip-address</em>[<em>:port</em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerName </strong><em>/domain/socket</em><br>
+Specifies the address and optionally the port to use when connecting to the server.
+<strong>Note: This directive is not supported on macOS 10.7 or later.</strong>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerName </strong><em>hostname-or-ip-address</em>[<em>:port</em>]<strong>/version=1.1</strong><br>
+Specifies the address and optionally the port to use when connecting to a server running CUPS 1.3.12 and earlier.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLOptions </strong>[<em>AllowDH</em>] [<em>AllowRC4</em>] [<em>AllowSSL3</em>] [<em>DenyCBC</em>] [<em>DenyTLS1.0</em>] [<em>MaxTLS1.0</em>] [<em>MaxTLS1.1</em>] [<em>MaxTLS1.2</em>] [<em>MaxTLS1.3</em>] [<em>MinTLS1.0</em>] [<em>MinTLS1.1</em>] [<em>MinTLS1.2</em>] [<em>MinTLS1.3</em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLOptions None</strong><br>
+Sets encryption options (only in /etc/cups/client.conf).
By default, CUPS only supports encryption using TLS v1.0 or higher using known secure cipher suites.
-Security is reduced when <i>Allow</i> options are used.
-Security is enhanced when <i>Deny</i> options are used.
-The <i>AllowDH</i> option enables cipher suites using plain Diffie-Hellman key negotiation (not supported on systems using GNU TLS).
-The <i>AllowRC4</i> option enables the 128-bit RC4 cipher suites, which are required for some older clients.
-The <i>AllowSSL3</i> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0.
-The <i>DenyCBC</i> option disables all CBC cipher suites.
-The <i>DenyTLS1.0</i> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1.
-The <i>MinTLS</i> options set the minimum TLS version to support.
-The <i>MaxTLS</i> options set the maximum TLS version to support.
+Security is reduced when <em>Allow</em> options are used.
+Security is enhanced when <em>Deny</em> options are used.
+The <em>AllowDH</em> option enables cipher suites using plain Diffie-Hellman key negotiation (not supported on systems using GNU TLS).
+The <em>AllowRC4</em> option enables the 128-bit RC4 cipher suites, which are required for some older clients.
+The <em>AllowSSL3</em> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0.
+The <em>DenyCBC</em> option disables all CBC cipher suites.
+The <em>DenyTLS1.0</em> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1.
+The <em>MinTLS</em> options set the minimum TLS version to support.
+The <em>MaxTLS</em> options set the maximum TLS version to support.
Not all operating systems support TLS 1.3 at this time.
-<dt><a name="TrustOnFirstUse"></a><b>TrustOnFirstUse Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>TrustOnFirstUse No</b>
-<dd style="margin-left: 5.0em">Specifies whether to trust new TLS certificates by default.
-The default is "Yes".
-<dt><a name="User"></a><b>User </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the default user name to use for requests.
-<dt><a name="UserAgentTokens"></a><b>UserAgentTokens None</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens ProductOnly</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens Major</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens Minor</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens Minimal</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens OS</b>
-<dd style="margin-left: 5.0em"><dt><b>UserAgentTokens Full</b>
-<dd style="margin-left: 5.0em">Specifies what information is included in the User-Agent header of HTTP requests.
-"None" disables the User-Agent header.
-"ProductOnly" reports "CUPS".
-"Major" reports "CUPS/major IPP/2".
-"Minor" reports "CUPS/major.minor IPP/2.1".
-"Minimal" reports "CUPS/major.minor.patch IPP/2.1".
-"OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1".
-"Full" reports "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1".
-The default is "Minimal".
-<dt><a name="ValidateCerts"></a><b>ValidateCerts Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>ValidateCerts No</b>
-<dd style="margin-left: 5.0em">Specifies whether to only allow TLS with certificates whose common name matches the hostname.
-The default is "No".
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-The <b>client.conf</b> file is deprecated on macOS and will no longer be supported in a future version of CUPS.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TrustOnFirstUse Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TrustOnFirstUse No</strong><br>
+Specifies whether to trust new TLS certificates by default.
+The default is "Yes".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>User </strong><em>name</em><br>
+Specifies the default user name to use for requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens None</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens ProductOnly</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens Major</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens Minor</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens Minimal</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens OS</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UserAgentTokens Full</strong><br>
+Specifies what information is included in the User-Agent header of HTTP requests.
+"None" disables the User-Agent header.
+"ProductOnly" reports "CUPS".
+"Major" reports "CUPS/major IPP/2".
+"Minor" reports "CUPS/major.minor IPP/2.1".
+"Minimal" reports "CUPS/major.minor.patch IPP/2.1".
+"OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1".
+"Full" reports "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1".
+The default is "Minimal".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ValidateCerts Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ValidateCerts No</strong><br>
+Specifies whether to only allow TLS with certificates whose common name matches the hostname.
+The default is "No".
+</p>
+ <h2 id="client.conf-5.notes">Notes</h2>
+<p>The <strong>client.conf</strong> file is deprecated on macOS and will no longer be supported in a future version of CUPS.
Configuration settings can instead be viewed or changed using the
-<b>defaults</b>(1)
+<strong>defaults</strong>(1)
+
command:
-<pre class="man">
-defaults write /Library/Preferences/org.cups.PrintingPrefs.plist Encryption Required
+</p>
+ <pre>defaults write /Library/Preferences/org.cups.PrintingPrefs.plist Encryption Required
defaults write /Library/Preferences/org.cups.PrintingPrefs.plist TrustOnFirstUse -bool NO
defaults read /Library/Preferences/org.cups.PrintingPrefs.plist Encryption
</pre>
-On Linux and other systems using GNU TLS, the <i>/etc/cups/ssl/site.crl</i> file, if present, provides a list of revoked X.509 certificates and is used when validating certificates.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<b>default</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 © 2021-2023 by OpenPrinting.
+<p>On Linux and other systems using GNU TLS, the <em>/etc/cups/ssl/site.crl</em> file, if present, provides a list of revoked X.509 certificates and is used when validating certificates.
+</p>
+ <h2 id="client.conf-5.see-also">See Also</h2>
+<p><strong>cups</strong>(1),
-</body>
+<strong>default</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="client.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-config(1)</title>
-</head>
-<body>
-<h1 class="title">cups-config(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups-config - get cups api, compiler, directory, and link information (deprecated).
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-config</b>
-<i>--api-version</i>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cups-config(1)</title>
+ </head>
+ <body>
+ <h1 id="cups-config-1">cups-config(1)</h1>
+ <h2 id="cups-config-1.name">Name</h2>
+<p>cups-config - get cups api, compiler, directory, and link information (deprecated).
+</p>
+ <h2 id="cups-config-1.synopsis">Synopsis</h2>
+<p><strong>cups-config</strong>
+<em>--api-version</em>
<br>
-<b>cups-config</b>
-<i>--build</i>
+<strong>cups-config</strong>
+<em>--build</em>
<br>
-<b>cups-config</b>
-<i>--cflags</i>
+<strong>cups-config</strong>
+<em>--cflags</em>
<br>
-<b>cups-config</b>
-<i>--datadir</i>
+<strong>cups-config</strong>
+<em>--datadir</em>
<br>
-<b>cups-config</b>
-<i>--help</i>
+<strong>cups-config</strong>
+<em>--help</em>
<br>
-<b>cups-config</b>
-<i>--ldflags</i>
+<strong>cups-config</strong>
+<em>--ldflags</em>
<br>
-<b>cups-config</b>
+<strong>cups-config</strong>
[
-<i>--image</i>
+<em>--image</em>
] [
-<i>--static</i>
+<em>--static</em>
]
-<i>--libs</i>
+<em>--libs</em>
<br>
-<b>cups-config</b>
-<i>--serverbin</i>
+<strong>cups-config</strong>
+<em>--serverbin</em>
<br>
-<b>cups-config</b>
-<i>--serverroot</i>
+<strong>cups-config</strong>
+<em>--serverroot</em>
<br>
-<b>cups-config</b>
-<i>--version</i>
+<strong>cups-config</strong>
+<em>--version</em>
<br>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>cups-config</b> command allows application developers to determine the necessary command-line options for the compiler and linker, as well as the installation directories for filters, configuration files, and drivers.
+</p>
+ <h2 id="cups-config-1.description">Description</h2>
+<p>The <strong>cups-config</strong> 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.
-<b>Note:</b>
+<strong>Note:</strong>
This command is deprecated and will be removed in a future version of CUPS.
The
-<b>pkg-config</b>(1)
+<strong>pkg-config</strong>(1)
+
command should be used instead.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The <b>cups-config</b> command accepts the following command-line options:
-<dl class="man">
-<dt><b>--api-version</b>
-<dd style="margin-left: 5.0em">Reports the current API version (major.minor).
-<dt><b>--build</b>
-<dd style="margin-left: 5.0em">Reports a system-specific build number.
-<dt><b>--cflags</b>
-<dd style="margin-left: 5.0em">Reports the necessary compiler options.
-<dt><b>--datadir</b>
-<dd style="margin-left: 5.0em">Reports the default CUPS data directory.
-<dt><b>--help</b>
-<dd style="margin-left: 5.0em">Reports the program usage message.
-<dt><b>--ldflags</b>
-<dd style="margin-left: 5.0em">Reports the necessary linker options.
-<dt><b>--libs</b>
-<dd style="margin-left: 5.0em">Reports the necessary libraries to link to.
-<dt><b>--serverbin</b>
-<dd style="margin-left: 5.0em">Reports the default CUPS binary directory, where filters and backends are stored.
-<dt><b>--serverroot</b>
-<dd style="margin-left: 5.0em">Reports the default CUPS configuration file directory.
-<dt><b>--static</b>
-<dd style="margin-left: 5.0em">When used with <i>--libs</i>, reports the static libraries instead of the default (shared) libraries.
-<dt><b>--version</b>
-<dd style="margin-left: 5.0em">Reports the full version number of the CUPS installation (major.minor.patch).
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Show the currently installed version of CUPS:
-<pre class="man">
+</p>
+ <h2 id="cups-config-1.options">Options</h2>
+<p>The <strong>cups-config</strong> command accepts the following command-line options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--api-version</strong><br>
+Reports the current API version (major.minor).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--build</strong><br>
+Reports a system-specific build number.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--cflags</strong><br>
+Reports the necessary compiler options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--datadir</strong><br>
+Reports the default CUPS data directory.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Reports the program usage message.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--ldflags</strong><br>
+Reports the necessary linker options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--libs</strong><br>
+Reports the necessary libraries to link to.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--serverbin</strong><br>
+Reports the default CUPS binary directory, where filters and backends are stored.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--serverroot</strong><br>
+Reports the default CUPS configuration file directory.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--static</strong><br>
+When used with <em>--libs</em>, reports the static libraries instead of the default (shared) libraries.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Reports the full version number of the CUPS installation (major.minor.patch).
+</p>
+ <h2 id="cups-config-1.examples">Examples</h2>
+<p>Show the currently installed version of CUPS:
+</p>
+ <pre>
cups-config --version
</pre>
-Compile a simple one-file CUPS filter:
-<pre class="man">
+<p>Compile a simple one-file CUPS filter:
+</p>
+ <pre>
cc `cups-config --cflags --ldflags` -o filter filter.c \
`cups-config --libs`
</pre>
-<h2 class="title"><a name="DEPRECATED_OPTIONS">Deprecated Options</a></h2>
-The following options are deprecated but continue to work for backwards compatibility:
-<dl class="man">
-<dt><b>--image</b>
-<dd style="margin-left: 5.0em">Formerly used to add the CUPS imaging library to the list of libraries.
-</dl>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<b>pkg-config</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 © 2021-2023 by OpenPrinting.
+ <h2 id="cups-config-1.deprecated-options">Deprecated Options</h2>
+<p>The following options are deprecated but continue to work for backwards compatibility:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--image</strong><br>
+Formerly used to add the CUPS imaging library to the list of libraries.
+</p>
+ <h2 id="cups-config-1.see-also">See Also</h2>
+<p><strong>cups</strong>(1),
-</body>
+<strong>pkg-config</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cups-config-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-files.conf(5)</title>
-</head>
-<body>
-<h1 class="title">cups-files.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups-files.conf - file and directory configuration file for cups
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
-It is normally located in the <i>/etc/cups</i> directory.
-<p>Each line in the file can be a configuration directive, a blank line, or a comment.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cups-files.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="cups-files.conf-5">cups-files.conf(5)</h1>
+ <h2 id="cups-files.conf-5.name">Name</h2>
+<p>cups-files.conf - file and directory configuration file for cups
+</p>
+ <h2 id="cups-files.conf-5.description">Description</h2>
+<p>The <strong>cups-files.conf</strong> file configures the files and directories used by the CUPS scheduler,
+<strong>cupsd</strong>(8).
+
+It is normally located in the <em>/etc/cups</em> directory.
+</p>
+ <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.
The configuration directive name and values are case-insensitive.
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>
-<dl class="man">
-<dt><a name="AccessLog"></a><b>AccessLog</b>
-<dd style="margin-left: 5.0em"><dt><b>AccessLog </b><i>filename</i>
-<dd style="margin-left: 5.0em"><dt><b>AccessLog stderr</b>
-<dd style="margin-left: 5.0em"><dt><b>AccessLog syslog</b>
-<dd style="margin-left: 5.0em">Defines the access log filename.
+</p>
+ <h3 id="cups-files.conf-5.description.directives">Directives</h3>
+<p>The following directives are understood by
+<strong>cupsd</strong>(8):
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLog</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLog </strong><em>filename</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLog stderr</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLog syslog</strong><br>
+Defines the access log filename.
Specifying a blank filename disables access log generation.
-The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
-The value "syslog" causes log entries to be sent to the system log daemon.
-The server name may be included in filenames using the string "%s", for example:
-<pre class="man">
+The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
+The value "syslog" causes log entries to be sent to the system log daemon.
+The server name may be included in filenames using the string "%s", for example:
+</p>
+ <pre>
AccessLog /var/log/cups/%s-access_log
</pre>
-The default is "/var/log/cups/access_log".
-<dt><a name="CacheDir"></a><b>CacheDir </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory to use for long-lived temporary (cache) files.
-The default is "/var/spool/cups/cache" or "/var/cache/cups" depending on the platform.
-<dt><a name="ConfigFilePerm"></a><b>ConfigFilePerm </b><i>mode</i>
-<dd style="margin-left: 5.0em">Specifies the permissions for all configuration files that the scheduler writes.
-The default is "0644" on macOS and "0640" on all other operating systems.
-</dl>
-<p><b>Note:</b> The permissions for the <i>printers.conf</i> file are currently masked to only allow access from the scheduler user (typically root).
+<p>The default is "/var/log/cups/access_log".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CacheDir </strong><em>directory</em><br>
+Specifies the directory to use for long-lived temporary (cache) files.
+The default is "/var/spool/cups/cache" or "/var/cache/cups" depending on the platform.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ConfigFilePerm </strong><em>mode</em><br>
+Specifies the permissions for all configuration files that the scheduler writes.
+The default is "0644" on macOS and "0640" on all other operating systems.
+</p>
+ <p><strong>Note:</strong> The permissions for the <em>printers.conf</em> file are currently masked to only allow access from the scheduler user (typically root).
This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system.
There is no way to disable this security feature.
-<dl class="man">
-<dt><a name="CreateSelfSignedCerts"></a><b>CreateSelfSignedCerts yes</b>
-<dd style="margin-left: 5.0em"><dt><b>CreateSelfSignedCerts no</b>
-<dd style="margin-left: 5.0em">Specifies whether the scheduler automatically creates self-signed certificates for client connections using TLS.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CreateSelfSignedCerts yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CreateSelfSignedCerts no</strong><br>
+Specifies whether the scheduler automatically creates self-signed certificates for client connections using TLS.
The default is yes.
-<dt><a name="DataDir"></a><b>DataDir </b><i>path</i>
-<dd style="margin-left: 5.0em">Specifies the directory where data files can be found.
-The default is usually "/usr/share/cups".
-<dt><a name="DocumentRoot"></a><b>DocumentRoot </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the root directory for the CUPS web interface content.
-The default is usually "/usr/share/doc/cups".
-<dt><a name="ErrorLog"></a><b>ErrorLog</b>
-<dd style="margin-left: 5.0em"><dt><b>ErrorLog </b><i>filename</i>
-<dd style="margin-left: 5.0em"><dt><b>ErrorLog stderr</b>
-<dd style="margin-left: 5.0em"><dt><b>ErrorLog syslog</b>
-<dd style="margin-left: 5.0em">Defines the error log filename.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DataDir </strong><em>path</em><br>
+Specifies the directory where data files can be found.
+The default is usually "/usr/share/cups".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DocumentRoot </strong><em>directory</em><br>
+Specifies the root directory for the CUPS web interface content.
+The default is usually "/usr/share/doc/cups".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorLog</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorLog </strong><em>filename</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorLog stderr</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorLog syslog</strong><br>
+Defines the error log filename.
Specifying a blank filename disables error log generation.
-The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
-The value "syslog" causes log entries to be sent to the system log daemon.
-The server name may be included in filenames using the string "%s", for example:
-<pre class="man">
+The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
+The value "syslog" causes log entries to be sent to the system log daemon.
+The server name may be included in filenames using the string "%s", for example:
+</p>
+ <pre>
ErrorLog /var/log/cups/%s-error_log
</pre>
-The default is "/var/log/cups/error_log".
-<dt><a name="FatalErrors"></a><b>FatalErrors none</b>
-<dd style="margin-left: 5.0em"><dt><b>FatalErrors all </b><i>-kind </i>[ ... <i>-kind </i>]
-<dd style="margin-left: 5.0em"><dt><b>FatalErrors </b><i>kind </i>[ ... <i>kind </i>]
-<dd style="margin-left: 5.0em">Specifies which errors are fatal, causing the scheduler to exit.
-The default is "config".
-The <i>kind</i> strings are:
-<div style="margin-left: 0.0em;">
-<dl class="man">
-<dt><b>none</b>
-<dd style="margin-left: 5.0em">No errors are fatal.
-<dt><b>all</b>
-<dd style="margin-left: 5.0em">All of the errors below are fatal.
-<dt><b>browse</b>
-<dd style="margin-left: 5.0em">Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon.
-<dt><b>config</b>
-<dd style="margin-left: 5.0em">Configuration file syntax errors are fatal.
-<dt><b>listen</b>
-<dd style="margin-left: 5.0em">Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses.
-<dt><b>log</b>
-<dd style="margin-left: 5.0em">Log file creation or write errors are fatal.
-<dt><b>permissions</b>
-<dd style="margin-left: 5.0em">Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions.
-</div>
-<dt><a name="Group"></a><b>Group </b><i>group-name-or-number</i>
-<dd style="margin-left: 5.0em">Specifies the group name or ID that will be used when executing external programs.
-The default group is operating system specific but is usually "lp" or "nobody".
-</div>
-<dt><a name="LogFileGroup"></a><b>LogFileGroup </b><i>group-name-or-number</i>
-<dd style="margin-left: 5.0em">Specifies the group name or ID that will be used for log files.
-The default group is operating system specific but is usually "lp" or "nobody".
-<dt><a name="LogFilePerm"></a><b>LogFilePerm </b><i>mode</i>
-<dd style="margin-left: 5.0em">Specifies the permissions of all log files that the scheduler writes.
-The default is "0644".
-<dt><a name="PageLog"></a><b>PageLog </b>[ <i>filename</i> ]
-<dd style="margin-left: 5.0em"><dt><b>PageLog stderr</b>
-<dd style="margin-left: 5.0em"><dt><b>PageLog syslog</b>
-<dd style="margin-left: 5.0em">Defines the page log filename.
-The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
-The value "syslog" causes log entries to be sent to the system log daemon.
+<p>The default is "/var/log/cups/error_log".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FatalErrors none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FatalErrors all </strong><em>-kind </em>[ ... <em>-kind </em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FatalErrors </strong><em>kind </em>[ ... <em>kind </em>]<br>
+Specifies which errors are fatal, causing the scheduler to exit.
+The default is "config".
+The <em>kind</em> strings are:
+ <div style="margin-left: 2.5em;">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>none</strong><br>
+No errors are fatal.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>all</strong><br>
+All of the errors below are fatal.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>browse</strong><br>
+Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>config</strong><br>
+Configuration file syntax errors are fatal.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>listen</strong><br>
+Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>log</strong><br>
+Log file creation or write errors are fatal.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>permissions</strong><br>
+Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions.
+ </div>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Group </strong><em>group-name-or-number</em><br>
+Specifies the group name or ID that will be used when executing external programs.
+The default group is operating system specific but is usually "lp" or "nobody".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogFileGroup </strong><em>group-name-or-number</em><br>
+Specifies the group name or ID that will be used for log files.
+The default group is operating system specific but is usually "lp" or "nobody".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogFilePerm </strong><em>mode</em><br>
+Specifies the permissions of all log files that the scheduler writes.
+The default is "0644".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PageLog </strong>[ <em>filename</em> ]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PageLog stderr</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PageLog syslog</strong><br>
+Defines the page log filename.
+The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
+The value "syslog" causes log entries to be sent to the system log daemon.
Specifying a blank filename disables page log generation.
-The server name may be included in filenames using the string "%s", for example:
-<pre class="man">
+The server name may be included in filenames using the string "%s", for example:
+</p>
+ <pre>
PageLog /var/log/cups/%s-page_log
</pre>
-The default is "/var/log/cups/page_log".
-<dt><a name="PassEnv"></a><b>PassEnv </b><i>variable </i>[ ... <i>variable </i>]
-<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
+<p>The default is "/var/log/cups/page_log".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PassEnv </strong><em>variable </em>[ ... <em>variable </em>]<br>
+Passes the specified environment variable(s) to child processes.
Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
-<dt><a name="RemoteRoot"></a><b>RemoteRoot </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
-The default is "remroot".
-<dt><a name="RequestRoot"></a><b>RequestRoot </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory that contains print jobs and other HTTP request data.
-The default is "/var/spool/cups".
-<dt><a name="Sandboxing"></a><b>Sandboxing relaxed</b>
-<dd style="margin-left: 5.0em"><dt><b>Sandboxing strict</b>
-<dd style="margin-left: 5.0em">Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler.
-The default is "strict".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>RemoteRoot </strong><em>username</em><br>
+Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
+The default is "remroot".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>RequestRoot </strong><em>directory</em><br>
+Specifies the directory that contains print jobs and other HTTP request data.
+The default is "/var/spool/cups".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Sandboxing relaxed</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Sandboxing strict</strong><br>
+Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler.
+The default is "strict".
This directive is currently only used/supported on macOS.
-<dt><a name="ServerBin"></a><b>ServerBin </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
-The default is "/usr/lib/cups" or "/usr/libexec/cups" depending on the platform.
-<dt><a name="ServerKeychain"></a><b>ServerKeychain </b><i>path</i>
-<dd style="margin-left: 5.0em">Specifies the location of TLS certificates and private keys.
-The default is "/Library/Keychains/System.keychain" on macOS and "/etc/cups/ssl" on all other operating systems.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerBin </strong><em>directory</em><br>
+Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
+The default is "/usr/lib/cups" or "/usr/libexec/cups" depending on the platform.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerKeychain </strong><em>path</em><br>
+Specifies the location of TLS certificates and private keys.
+The default is "/Library/Keychains/System.keychain" on macOS and "/etc/cups/ssl" on all other operating systems.
macOS uses its keychain database to store certificates and keys while other platforms use separate files in the specified directory, *.crt for PEM-encoded certificates and *.key for PEM-encoded private keys.
-<dt><a name="ServerRoot"></a><b>ServerRoot </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory containing the server configuration files.
-The default is "/etc/cups".
-<dt><a name="SetEnv"></a><b>SetEnv </b><i>variable value</i>
-<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerRoot </strong><em>directory</em><br>
+Specifies the directory containing the server configuration files.
+The default is "/etc/cups".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SetEnv </strong><em>variable value</em><br>
+Set the specified environment variable to be passed to child processes.
Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
-<dt><a name="StateDir"></a><b>StateDir </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory to use for PID and local certificate files.
-The default is "/var/run/cups" or "/etc/cups" depending on the platform.
-<dt><a name="SyncOnClose"></a><b>SyncOnClose Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>SyncOnClose No</b>
-<dd style="margin-left: 5.0em">Specifies whether the scheduler calls
-<b>fsync</b>(2)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>StateDir </strong><em>directory</em><br>
+Specifies the directory to use for PID and local certificate files.
+The default is "/var/run/cups" or "/etc/cups" depending on the platform.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SyncOnClose Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SyncOnClose No</strong><br>
+Specifies whether the scheduler calls
+<strong>fsync</strong>(2)
+
after writing configuration or state files.
-<dt><a name="SystemGroup"></a><b>SystemGroup </b><i>group-name </i>[ ... <i>group-name</i> ]
-<dd style="margin-left: 5.0em">Specifies the group(s) to use for <i>@SYSTEM</i> group authentication.
-The default contains "admin", "lpadmin", "root", "sys", and/or "system".
-<dt><a name="TempDir"></a><b>TempDir </b><i>directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory where short-term temporary files are stored.
-The default is "/var/spool/cups/tmp".
-<dt><a name="User"></a><b>User </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies the user name or ID that is used when running external programs.
-The default is "lp".
-</dl>
-<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
-The following directives are deprecated and will be removed from a future version of CUPS:
-<dl class="man">
-<dt><a name="FileDevice"></a><b>FileDevice Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>FileDevice No</b>
-<dd style="margin-left: 5.0em">Specifies whether the file pseudo-device can be used for new printer queues.
-The URI "file:///dev/null" is always allowed.
-File devices cannot be used with "raw" print queues - a PPD file is required.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SystemGroup </strong><em>group-name </em>[ ... <em>group-name</em> ]<br>
+Specifies the group(s) to use for <em>@SYSTEM</em> group authentication.
+The default contains "admin", "lpadmin", "root", "sys", and/or "system".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TempDir </strong><em>directory</em><br>
+Specifies the directory where short-term temporary files are stored.
+The default is "/var/spool/cups/tmp".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>User </strong><em>username</em><br>
+Specifies the user name or ID that is used when running external programs.
+The default is "lp".
+</p>
+ <h3 id="cups-files.conf-5.description.deprecated-directives">Deprecated Directives</h3>
+<p>The following directives are deprecated and will be removed from a future version of CUPS:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FileDevice Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FileDevice No</strong><br>
+Specifies whether the file pseudo-device can be used for new printer queues.
+The URI "file:///dev/null" is always allowed.
+File devices cannot be used with "raw" print queues - a PPD file is required.
The specified file is overwritten for every print job.
Writing to directories is not supported.
-<dt><a name="Printcap"></a><b>Printcap </b><i>filename</i>
-<dd style="margin-left: 5.0em">Specifies a file that is filled with a list of local print queues.
-<dt><a name="PrintcapFormat"></a><b>PrintcapFormat bsd</b>
-<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat plist</b>
-<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat solaris</b>
-<dd style="margin-left: 5.0em">Specifies the format to use for the Printcap file.
-"bsd" is the historical LPD printcap file format.
-"plist" is the Apple plist file format.
-"solaris" is the historical Solaris LPD printcap file format.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-The scheduler MUST be restarted manually after making changes to the <b>cups-files.conf</b> file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Printcap </strong><em>filename</em><br>
+Specifies a file that is filled with a list of local print queues.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PrintcapFormat bsd</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PrintcapFormat plist</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PrintcapFormat solaris</strong><br>
+Specifies the format to use for the Printcap file.
+"bsd" is the historical LPD printcap file format.
+"plist" is the Apple plist file format.
+"solaris" is the historical Solaris LPD printcap file format.
+</p>
+ <h2 id="cups-files.conf-5.notes">Notes</h2>
+<p>The scheduler MUST be restarted manually after making changes to the <strong>cups-files.conf</strong> file.
On Linux this is typically done using the
-<b>systemctl</b>(8)
+<strong>systemctl</strong>(8)
+
command, while on macOS the
-<b>launchctl</b>(8)
+<strong>launchctl</strong>(8)
+
command is used instead.
-<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.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2020-2023 by OpenPrinting.
+</p>
+ <h2 id="cups-files.conf-5.see-also">See Also</h2>
+<p><strong>classes.conf</strong>(5),
+
+<strong>cups</strong>(1),
-</body>
+<strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>mime.convs</strong>(5),
+
+<strong>mime.types</strong>(5),
+
+<strong>printers.conf</strong>(5),
+
+<strong>subscriptions.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cups-files.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2020-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-lpd(8)</title>
-</head>
-<body>
-<h1 class="title">cups-lpd(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups-lpd - receive print jobs and report printer status to lpd clients (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-lpd</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cups-lpd(8)</title>
+ </head>
+ <body>
+ <h1 id="cups-lpd-8">cups-lpd(8)</h1>
+ <h2 id="cups-lpd-8.name">Name</h2>
+<p>cups-lpd - receive print jobs and report printer status to lpd clients (deprecated)
+</p>
+ <h2 id="cups-lpd-8.synopsis">Synopsis</h2>
+<p><strong>cups-lpd</strong>
[
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
-<b>-n</b>
+<strong>-n</strong>
] [
-<b>-o</b>
-<i>option=value</i>
+<strong>-o</strong>
+<em>option=value</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cups-lpd</b>
-is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
-<b>cups-lpd</b>
-does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
-<b>inetd</b>(8),
-<b>launchd</b>(8),
+</p>
+ <h2 id="cups-lpd-8.description">Description</h2>
+<p><strong>cups-lpd</strong>
+is the CUPS Line Printer Daemon ("LPD") mini-server that supports legacy client systems that use the LPD protocol.
+<strong>cups-lpd</strong>
+does not act as a standalone network daemon but instead operates using any of the Internet "super-servers" such as
+<strong>inetd</strong>(8),
+
+<strong>launchd</strong>(8),
+
and
-<b>systemd</b>(8).
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl class="man">
-<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Sets the CUPS server (and port) to use.
-<dt><b>-n</b>
-<dd style="margin-left: 5.0em">Disables reverse address lookups; normally
-<b>cups-lpd</b>
+<strong>systemd</strong>(8).
+
+</p>
+ <h2 id="cups-lpd-8.options">Options</h2>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]<br>
+Sets the CUPS server (and port) to use.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n</strong><br>
+Disables reverse address lookups; normally
+<strong>cups-lpd</strong>
will try to discover the hostname of the client via a reverse DNS lookup.
-<dt><b>-o </b><i>name=value</i>
-<dd style="margin-left: 5.0em">Inserts options for all print queues. Most often this is used to disable the "l" filter so that remote print jobs are filtered as needed for printing; the
-<b>inetd</b>(8)
-example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
-</dl>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-<b>cups-lpd</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name=value</em><br>
+Inserts options for all print queues. Most often this is used to disable the "l" filter so that remote print jobs are filtered as needed for printing; the
+<strong>inetd</strong>(8)
+
+example below sets the "document-format" option to "application/octet-stream" which forces autodetection of the print file format.
+</p>
+ <h2 id="cups-lpd-8.conforming-to">Conforming To</h2>
+<p><strong>cups-lpd</strong>
does not enforce the restricted source port number specified in RFC 1179, as using restricted ports does not prevent users from submitting print jobs.
While this behavior is different than standard Berkeley LPD implementations, it should not affect normal client operations.
-<p>The output of the status requests follows RFC 2569, Mapping between LPD and IPP Protocols. Since many LPD implementations stray from this definition, remote status reporting to LPD clients may be unreliable.
-<h2 class="title"><a name="ERRORS">Errors</a></h2>
-Errors are sent to the system log.
-<h2 class="title"><a name="FILES">Files</a></h2>
-<pre class="man">
-<i>/etc/inetd.conf</i>
-<i>/etc/xinetd.d/cups-lpd</i>
-<i>/System/Library/LaunchDaemons/org.cups.cups-lpd.plist</i>
+</p>
+ <p>The output of the status requests follows RFC 2569, Mapping between LPD and IPP Protocols. Since many LPD implementations stray from this definition, remote status reporting to LPD clients may be unreliable.
+</p>
+ <h2 id="cups-lpd-8.errors">Errors</h2>
+<p>Errors are sent to the system log.
+</p>
+ <h2 id="cups-lpd-8.files">Files</h2>
+ <pre><em>/etc/inetd.conf</em>
+<em>/etc/xinetd.d/cups-lpd</em>
+<em>/System/Library/LaunchDaemons/org.cups.cups-lpd.plist</em>
</pre>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-The
-<b>cups-lpd</b>
+ <h2 id="cups-lpd-8.notes">Notes</h2>
+<p>The
+<strong>cups-lpd</strong>
program is deprecated and will no longer be supported in a future feature release of CUPS.
-<h3><a name="PERFORMANCE">Performance</a></h3>
-<b>cups-lpd</b>
+</p>
+ <h3 id="cups-lpd-8.notes.performance">Performance</h3>
+<p><strong>cups-lpd</strong>
performs well with small numbers of clients and printers.
However, since a new process is created for each connection and since each process must query the printing system before each job submission, it does not scale to larger configurations.
We highly recommend that large configurations use the native IPP support provided by CUPS instead.
-<h3><a name="SECURITY">Security</a></h3>
-<b>cups-lpd</b>
-currently does not perform any access control based on the settings in <i>cupsd.conf(5)</i> or in the <i>hosts.allow(5)</i> or <i>hosts.deny(5)</i> files used by TCP wrappers.
+</p>
+ <h3 id="cups-lpd-8.notes.security">Security</h3>
+<p><strong>cups-lpd</strong>
+currently does not perform any access control based on the settings in <em>cupsd.conf(5)</em> or in the <em>hosts.allow(5)</em> or <em>hosts.deny(5)</em> files used by TCP wrappers.
Therefore, running
-<b>cups-lpd</b>
+<strong>cups-lpd</strong>
on your server will allow any computer on your network (and perhaps the entire
Internet) to print to your server.
-<p>While
-<b>xinetd</b>(8)
+</p>
+ <p>While
+<strong>xinetd</strong>(8)
+
has built-in access control support, you should use the TCP wrappers package with
-<b>inetd</b>(8)
+<strong>inetd</strong>(8)
+
to limit access to only those computers that should be able to print through your server.
-<p><b>cups-lpd</b>
+</p>
+ <p><strong>cups-lpd</strong>
is not enabled by the standard CUPS distribution.
Please consult with your operating system vendor to determine whether it is enabled by default on your system.
-<h2 class="title"><a name="EXAMPLE">Example</a></h2>
-If you are using
-<b>inetd</b>(8),
-add the following line to the <i>inetd.conf</i> file to enable the
-<b>cups-lpd</b>
+</p>
+ <h2 id="cups-lpd-8.example">Example</h2>
+<p>If you are using
+<strong>inetd</strong>(8),
+
+add the following line to the <em>inetd.conf</em> file to enable the
+<strong>cups-lpd</strong>
mini-server:
-<pre class="man">
+</p>
+ <pre>
printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
-o document-format=application/octet-stream
</pre>
-<p>CUPS includes configuration files for
-<b>launchd</b>(8),
-<b>systemd</b>(8),
+ <p>CUPS includes configuration files for
+<strong>launchd</strong>(8),
+
+<strong>systemd</strong>(8),
+
and
-<b>xinetd</b>(8).
+<strong>xinetd</strong>(8).
+
Simply enable the
-<b>cups-lpd</b>
+<strong>cups-lpd</strong>
service using the corresponding control program.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<b>inetd</b>(8),
-<b>launchd</b>(8),
-<b>xinetd</b>(8),
+</p>
+ <h2 id="cups-lpd-8.see-also">See Also</h2>
+<p><strong>cups</strong>(1),
+
+<strong>cupsd</strong>(8),
+
+<strong>inetd</strong>(8),
+
+<strong>launchd</strong>(8),
+
+<strong>xinetd</strong>(8),
+
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>),
RFC 2569
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2020-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="cups-lpd-8.copyright">Copyright</h2>
+<p>Copyright © 2020-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>snmp.conf(5)</title>
-</head>
-<body>
-<h1 class="title">snmp.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-snmp.conf - snmp configuration file for cups (deprecated)
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The
-<b>snmp.conf</b>
-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.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>snmp.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="snmp.conf-5">snmp.conf(5)</h1>
+ <h2 id="snmp.conf-5.name">Name</h2>
+<p>snmp.conf - snmp configuration file for cups (deprecated)
+</p>
+ <h2 id="snmp.conf-5.description">Description</h2>
+<p>The
+<strong>snmp.conf</strong>
+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 <em>/etc/cups</em> 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>
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-The following directives are understood by the CUPS network backends:
-<dl class="man">
-<dt><b>Address @IF(</b><i>name</i><b>)</b>
-<dd style="margin-left: 5.0em"><dt><b>Address @LOCAL</b>
-<dd style="margin-left: 5.0em"><dt><b>Address </b><i>address</i>
-<dd style="margin-left: 5.0em">Sends SNMP broadcast queries (for discovery) to the specified address(es).
+</p>
+ <p>The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
+<strong>cups-snmp</strong>(8).
+
+</p>
+ <h2 id="snmp.conf-5.directives">Directives</h2>
+<p>The following directives are understood by the CUPS network backends:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Address @IF(</strong><em>name</em><strong>)</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Address @LOCAL</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Address </strong><em>address</em><br>
+Sends SNMP broadcast queries (for discovery) to the specified address(es).
There is no default for the broadcast address.
-<dt><b>Community </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the community name to use.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Community </strong><em>name</em><br>
+Specifies the community name to use.
Only a single community name may be specified.
-The default community name is "public".
+The default community name is "public".
If no name is specified, all SNMP functions are disabled.
-<dt><b>DebugLevel </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the logging level from 0 (none) to 3 (everything).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DebugLevel </strong><em>number</em><br>
+Specifies the logging level from 0 (none) to 3 (everything).
Typically only used for debugging (thus the name).
The default debug level is 0.
-<dt><b>DeviceURI "</b><i>regular expression</i><b>" </b><i>device-uri </i>[... <i>device-uri</i>]
-<dd style="margin-left: 5.0em">Specifies one or more device URIs that should be used for a given make and model string.
-The regular expression is used to match the detected make and model, and the device URI strings must be of the form "scheme://%s[:port]/[path]", where "%s" represents the detected address or hostname.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DeviceURI "</strong><em>regular expression</em><strong>" </strong><em>device-uri </em>[... <em>device-uri</em>]<br>
+Specifies one or more device URIs that should be used for a given make and model string.
+The regular expression is used to match the detected make and model, and the device URI strings must be of the form "scheme://%s[:port]/[path]", where "%s" represents the detected address or hostname.
There are no default device URI matching rules.
-<dt><b>HostNameLookups on</b>
-<dd style="margin-left: 5.0em"><dt><b>HostNameLookups off</b>
-<dd style="margin-left: 5.0em">Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses.
-The default is "off".
-<dt><b>MaxRunTime </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of seconds that the SNMP backend will scan the
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups on</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups off</strong><br>
+Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses.
+The default is "off".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxRunTime </strong><em>seconds</em><br>
+Specifies the maximum number of seconds that the SNMP backend will scan the
network for printers.
The default is 120 seconds (2 minutes).
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <h2 id="snmp.conf-5.notes">Notes</h2>
+<p>CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<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>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
-</body>
+</p>
+ <h2 id="snmp.conf-5.see-also">See Also</h2>
+<p><strong>cups-snmp</strong>(8),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="snmp.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups-snmp(8)</title>
-</head>
-<body>
-<h1 class="title">cups-snmp(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-snmp - cups snmp backend (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>/usr/lib/cups/backend/snmp</b>
-<i>ip-address-or-hostname</i>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cups-snmp(8)</title>
+ </head>
+ <body>
+ <h1 id="cups-snmp-8">cups-snmp(8)</h1>
+ <h2 id="cups-snmp-8.name">Name</h2>
+<p>snmp - cups snmp backend (deprecated)
+</p>
+ <h2 id="cups-snmp-8.synopsis">Synopsis</h2>
+<p><strong>/usr/lib/cups/backend/snmp</strong>
+<em>ip-address-or-hostname</em>
<br>
-<b>/usr/libexec/cups/backend/snmp</b>
-<i>ip-address-or-hostname</i>
+<strong>/usr/libexec/cups/backend/snmp</strong>
+<em>ip-address-or-hostname</em>
<br>
-<b>lpinfo</b>
-<b>-v</b>
-<b>--include-schemes</b>
+<strong>lpinfo</strong>
+<strong>-v</strong>
+<strong>--include-schemes</strong>
snmp
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>DEPRECATED</b> CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1.
-When used for discovery through the scheduler, the backend will list all printers that respond to a broadcast SNMPv1 query with the "public" community name.
+</p>
+ <h2 id="cups-snmp-8.description">Description</h2>
+<p>The <strong>DEPRECATED</strong> CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1.
+When used for discovery through the scheduler, the backend will list all printers that respond to a broadcast SNMPv1 query with the "public" community name.
Additional queries are then sent to printers that respond in order to determine the correct device URI, make and model, and other information needed for printing.
-<p>In the first form, the SNMP backend is run directly by the user to look up the device URI and other information when you have an IP address or hostname.
+</p>
+ <p>In the first form, the SNMP backend is run directly by the user to look up the device URI and other information when you have an IP address or hostname.
This can be used for programs that need to configure print queues where the user has supplied an address but nothing else.
-<p>In the second form, the SNMP backend is run indirectly using the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+</p>
+ <p>In the second form, the SNMP backend is run indirectly using the
+<strong>lpinfo</strong>(8)
+
command.
The output provides all printers detected via SNMP on the configured
broadcast addresses.
-<i>Note: no broadcast addresses are configured by default.</i>
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment variable.
+<em>Note: no broadcast addresses are configured by default.</em>
+</p>
+ <h2 id="cups-snmp-8.environment">Environment</h2>
+<p>The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment variable.
The MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME environment variable.
-<h2 class="title"><a name="FILES">Files</a></h2>
-The SNMP backend reads the <i>/etc/cups/snmp.conf</i> configuration file, if
+</p>
+ <h2 id="cups-snmp-8.files">Files</h2>
+<p>The SNMP backend reads the <em>/etc/cups/snmp.conf</em> configuration file, if
present, to set the default broadcast address, community name, and logging
level.
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-The CUPS SNMP backend is deprecated and will no longer be supported in a future
+</p>
+ <h2 id="cups-snmp-8.notes">Notes</h2>
+<p>The CUPS SNMP backend is deprecated and will no longer be supported in a future
version of CUPS.
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer.
-<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-cups-snmp.conf.html?TOPIC=Man+Pages"><b>cups-snmp.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</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 © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="cups-snmp-8.conforming-to">Conforming To</h2>
+<p>The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer.
+</p>
+ <h2 id="cups-snmp-8.see-also">See Also</h2>
+<p><strong>backend</strong>(7),
+
+<strong>cups-snmp.conf</strong>(5),
-</body>
+<strong>cupsd</strong>(8),
+
+<strong>lpinfo</strong>(8),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cups-snmp-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cups(1)</title>
-</head>
-<body>
-<h1 class="title">cups(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cups - a standards-based, open source printing system
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>CUPS</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cups(1)</title>
+ </head>
+ <body>
+ <h1 id="cups-1">cups(1)</h1>
+ <h2 id="cups-1.name">Name</h2>
+<p>cups - a standards-based, open source printing system
+</p>
+ <h2 id="cups-1.description">Description</h2>
+<p><strong>CUPS</strong>
is the software you use to print from applications like word processors, email readers, photo editors, and web browsers. It converts the page descriptions produced by your application (put a paragraph here, draw a line there, and so forth) into something your printer can understand and then sends the information to the printer for printing.
-<p>Now, since every printer manufacturer does things differently, printing can be very complicated.
-<b>CUPS</b>
+</p>
+ <p>Now, since every printer manufacturer does things differently, printing can be very complicated.
+<strong>CUPS</strong>
does its best to hide this from you and your application so that you can concentrate on printing and less on how to print. Generally, the only time you need to know anything about your printer is when you use it for the first time, and even then
-<b>CUPS</b>
+<strong>CUPS</strong>
can often figure things out on its own.
-<h3><a name="HOW_DOES_IT_WORK_">How Does It Work?</a></h3>
-The first time you print to a printer,
-<b>CUPS</b>
+</p>
+ <h3 id="cups-1.description.how-does-it-work">How Does It Work?</h3>
+<p>The first time you print to a printer,
+<strong>CUPS</strong>
creates a queue to keep track of the current status of the printer (everything OK, out of paper, etc.) and any pages you have printed. Most of the time the queue points to a printer connected directly to your computer via a USB port, however it can also point to a printer on your network, a printer on the Internet, or multiple printers depending on the configuration. Regardless of where the queue points, it will look like any other printer to you and your applications.
-<p>Every time you print something,
-<b>CUPS</b>
+</p>
+ <p>Every time you print something,
+<strong>CUPS</strong>
creates a job which contains the queue you are sending the print to, the name of the document you are printing, and the page descriptions. Job are numbered (queue-1, queue-2, and so forth) so you can monitor the job as it is printed or cancel it if you see a mistake. When
-<b>CUPS</b>
+<strong>CUPS</strong>
gets a job for printing, it determines the best programs (filters, printer drivers, port monitors, and backends) to convert the pages into a printable format and then runs them to actually print the job.
-<p>When the print job is completely printed,
-<b>CUPS</b>
+</p>
+ <p>When the print job is completely printed,
+<strong>CUPS</strong>
removes the job from the queue and moves on to any other jobs you have submitted. You can also be notified when the job is finished, or if there are any errors during printing, in several different ways.
-<h3><a name="WHERE_DO_I_BEGIN_">Where Do I Begin?</a></h3>
-The easiest way to start is by using the web interface to configure your printer. Go to "<a href="http://localhost:631"">http://localhost:631"</a> and choose the Administration tab at the top of the page. Click/press on the Add Printer button and follow the prompts.
-<p>When you are asked for a username and password, enter your login username and password or the "root" username and password.
-<p>After the printer is added you will be asked to set the default printer options (paper size, output mode, etc.) for the printer. Make any changes as needed and then click/press on the Set Default Options button to save them. Some printers also support auto-configuration - click/press on the Query Printer for Default Options button to update the options automatically.
-<p>Once you have added the printer, you can print to it from any application. You can also choose Print Test Page from the maintenance menu to print a simple test page and verify that everything is working properly.
-<p>You can also use the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+</p>
+ <h3 id="cups-1.description.where-do-i-begin">Where Do I Begin?</h3>
+<p>The easiest way to start is by using the web interface to configure your printer. Go to "<a href="http://localhost:631"">http://localhost:631"</a> and choose the Administration tab at the top of the page. Click/press on the Add Printer button and follow the prompts.
+</p>
+ <p>When you are asked for a username and password, enter your login username and password or the "root" username and password.
+</p>
+ <p>After the printer is added you will be asked to set the default printer options (paper size, output mode, etc.) for the printer. Make any changes as needed and then click/press on the Set Default Options button to save them. Some printers also support auto-configuration - click/press on the Query Printer for Default Options button to update the options automatically.
+</p>
+ <p>Once you have added the printer, you can print to it from any application. You can also choose Print Test Page from the maintenance menu to print a simple test page and verify that everything is working properly.
+</p>
+ <p>You can also use the
+<strong>lpadmin</strong>(8)
+
and
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<strong>lpinfo</strong>(8)
+
commands to add printers to
-<b>CUPS</b>.
+<strong>CUPS</strong>.
+
Additionally, your operating system may include graphical user interfaces or automatically create printer queues when you connect a printer to your computer.
-<h3><a name="HOW_DO_I_GET_HELP_">How Do I Get Help?</a></h3>
-The
-<b>OpenPrinting</b><b>CUPS</b>
+</p>
+ <h3 id="cups-1.description.how-do-i-get-help">How Do I Get Help?</h3>
+<p>The
+<strong>OpenPrinting CUPS</strong>
website (<a href="https://openprinting.github.io/cups">https://openprinting.github.io/cups</a>) provides access to the
-<i>cups</i>
+<em>cups</em>
and
-<i>cups-devel</i>
+<em>cups-devel</em>
mailing lists, additional documentation and resources, and a bug report database. Most vendors also provide online discussion forums to ask printing questions for your operating system of choice.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-<b>CUPS</b>
+</p>
+ <h2 id="cups-1.environment">Environment</h2>
+<p><strong>CUPS</strong>
commands use the following environment variables to override the default locations of files and so forth. For security reasons, these environment variables are ignored for setuid programs:
-<dl class="man">
-<dt><b>CUPS_ANYROOT</b>
-<dd style="margin-left: 5.0em">Whether to allow any X.509 certificate root (Y or N).
-<dt><b>CUPS_CACHEDIR</b>
-<dd style="margin-left: 5.0em">The directory where semi-persistent cache files can be found.
-<dt><b>CUPS_DATADIR</b>
-<dd style="margin-left: 5.0em">The directory where data files can be found.
-<dt><b>CUPS_ENCRYPTION</b>
-<dd style="margin-left: 5.0em">The default level of encryption (Always, IfRequested, Never, Required).
-<dt><b>CUPS_EXPIREDCERTS</b>
-<dd style="margin-left: 5.0em">Whether to allow expired X.509 certificates (Y or N).
-<dt><b>CUPS_GSSSERVICENAME</b>
-<dd style="margin-left: 5.0em">The Kerberos service name used for authentication.
-<dt><b>CUPS_SERVER</b>
-<dd style="margin-left: 5.0em">The hostname/IP address and port number of the CUPS scheduler (hostname:port or ipaddress:port).
-<dt><b>CUPS_SERVERBIN</b>
-<dd style="margin-left: 5.0em">The directory where server helper programs, filters, backend, etc. can be found.
-<dt><b>CUPS_SERVERROOT</b>
-<dd style="margin-left: 5.0em">The root directory of the server.
-<dt><b>CUPS_STATEDIR</b>
-<dd style="margin-left: 5.0em">The directory where state files can be found.
-<dt><b>CUPS_USER</b>
-<dd style="margin-left: 5.0em">Specifies the name of the user for print requests.
-<dt><b>HOME</b>
-<dd style="margin-left: 5.0em">Specifies the home directory of the current user.
-<dt><b>IPP_PORT</b>
-<dd style="margin-left: 5.0em">Specifies the default port number for IPP requests.
-<dt><b>LOCALEDIR</b>
-<dd style="margin-left: 5.0em">Specifies the location of localization files.
-<dt><b>LPDEST</b>
-<dd style="margin-left: 5.0em">Specifies the default print queue (System V standard).
-<dt><b>PRINTER</b>
-<dd style="margin-left: 5.0em">Specifies the default print queue (Berkeley standard).
-<dt><b>TMPDIR</b>
-<dd style="margin-left: 5.0em">Specifies the location of temporary files.
-</dl>
-<h2 class="title"><a name="FILES">Files</a></h2>
-<pre class="man">
-<i>~/.cups/client.conf</i>
-<i>~/.cups/lpoptions</i>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_ANYROOT</strong><br>
+Whether to allow any X.509 certificate root (Y or N).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_CACHEDIR</strong><br>
+The directory where semi-persistent cache files can be found.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_DATADIR</strong><br>
+The directory where data files can be found.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_ENCRYPTION</strong><br>
+The default level of encryption (Always, IfRequested, Never, Required).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_EXPIREDCERTS</strong><br>
+Whether to allow expired X.509 certificates (Y or N).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_GSSSERVICENAME</strong><br>
+The Kerberos service name used for authentication.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_SERVER</strong><br>
+The hostname/IP address and port number of the CUPS scheduler (hostname:port or ipaddress:port).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_SERVERBIN</strong><br>
+The directory where server helper programs, filters, backend, etc. can be found.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_SERVERROOT</strong><br>
+The root directory of the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_STATEDIR</strong><br>
+The directory where state files can be found.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_USER</strong><br>
+Specifies the name of the user for print requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HOME</strong><br>
+Specifies the home directory of the current user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPP_PORT</strong><br>
+Specifies the default port number for IPP requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LOCALEDIR</strong><br>
+Specifies the location of localization files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
+Specifies the default print queue (System V standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+Specifies the default print queue (Berkeley standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TMPDIR</strong><br>
+Specifies the location of temporary files.
+</p>
+ <h2 id="cups-1.files">Files</h2>
+ <pre><em>~/.cups/client.conf</em>
+<em>~/.cups/lpoptions</em>
</pre>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-<b>CUPS</b>
+ <h2 id="cups-1.conforming-to">Conforming To</h2>
+<p><strong>CUPS</strong>
conforms to the Internet Printing Protocol version 2.1 and implements the Berkeley and System V UNIX print commands.
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <h2 id="cups-1.notes">Notes</h2>
+<p>CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-client.conf.html?TOPIC=Man+Pages"><b>client.conf</b>(5),</a>
-<a href="man-cupsctl.html?TOPIC=Man+Pages"><b>cupsctl</b>(8),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="cups-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>client.conf</strong>(5),
+
+<strong>cupsctl</strong>(8),
+
+<strong>cupsd</strong>(8),
+
+<strong>lp</strong>(1),
+
+<strong>lpadmin</strong>(8),
+
+<strong>lpinfo</strong>(8),
+
+<strong>lpoptions</strong>(1),
+
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
+<strong>lpq</strong>(1),
+
+<strong>lpstat</strong>(1),
+
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>),
OpenPrinting CUPS Web Site (<a href="https://openprinting.github.io/cups">https://openprinting.github.io/cups</a>),
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 © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="cups-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsaccept(8)</title>
-</head>
-<body>
-<h1 class="title">cupsaccept(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsaccept/cupsreject - accept/reject jobs sent to a destination
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsaccept</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsaccept(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsaccept-8">cupsaccept(8)</h1>
+ <h2 id="cupsaccept-8.name">Name</h2>
+<p>cupsaccept/cupsreject - accept/reject jobs sent to a destination
+</p>
+ <h2 id="cupsaccept-8.synopsis">Synopsis</h2>
+<p><strong>cupsaccept</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-h</b>
-<i>hostname[:port]</i>
+<strong>-h</strong>
+<em>hostname[:port]</em>
]
-<i>destination(s)</i>
+<em>destination(s)</em>
<br>
-<b>cupsreject</b>
+<strong>cupsreject</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-h</b>
-<i>hostname[:port]</i>
+<strong>-h</strong>
+<em>hostname[:port]</em>
] [
-<b>-r</b>
-<i>reason</i>
+<strong>-r</strong>
+<em>reason</em>
]
-<i>destination(s)</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The
-<b>cupsaccept</b>
-command instructs the printing system to accept print jobs to the specified destinations.
+<em>destination(s)</em>
+</p>
+ <h2 id="cupsaccept-8.description">Description</h2>
<p>The
-<b>cupsreject</b>
+<strong>cupsaccept</strong>
+command instructs the printing system to accept print jobs to the specified destinations.
+</p>
+ <p>The
+<strong>cupsreject</strong>
command instructs the printing system to reject print jobs to the
specified destinations.
-The <i>-r</i> option sets the reason for rejecting print jobs. If not specified, the reason defaults to "Reason Unknown".
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are supported by both
-<b>cupsaccept</b>
+The <em>-r</em> option sets the reason for rejecting print jobs. If not specified, the reason defaults to "Reason Unknown".
+</p>
+ <h2 id="cupsaccept-8.options">Options</h2>
+<p>The following options are supported by both
+<strong>cupsaccept</strong>
and
-<b>cupsreject</b>:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Sets the username that is sent when connecting to the server.
-<dt><b>-h </b><i>hostname[:port]</i>
-<dd style="margin-left: 5.0em">Chooses an alternate server.
-<dt><b>-r </b>"<i>reason</i>"
-<dd style="margin-left: 5.0em">Sets the reason string that is shown for a printer that is rejecting jobs.
-</dl>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The
-<b>cupsaccept</b>
+<strong>cupsreject</strong>:
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Sets the username that is sent when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>hostname[:port]</em><br>
+Chooses an alternate server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong>"<em>reason</em>"<br>
+Sets the reason string that is shown for a printer that is rejecting jobs.
+</p>
+ <h2 id="cupsaccept-8.conforming-to">Conforming To</h2>
+<p>The
+<strong>cupsaccept</strong>
and
-<b>cupsreject</b>
-commands correspond to the System V printing system commands "accept" and "reject", respectively.
-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.
-<p>Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<strong>cupsreject</strong>
+commands correspond to the System V printing system commands "accept" and "reject", respectively.
+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 <em>not</em> case-sensitive.
+</p>
+ <p>Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
+</p>
+ <h2 id="cupsaccept-8.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>cupsenable</strong>(8),
+
+<strong>lp</strong>(1),
+
+<strong>lpadmin</strong>(8),
+
+<strong>lpstat</strong>(1),
+
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="cupsaccept-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsctl(8)</title>
-</head>
-<body>
-<h1 class="title">cupsctl(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsctl - configure cupsd.conf options
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsctl</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsctl(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsctl-8">cupsctl(8)</h1>
+ <h2 id="cupsctl-8.name">Name</h2>
+<p>cupsctl - configure cupsd.conf options
+</p>
+ <h2 id="cupsctl-8.synopsis">Synopsis</h2>
+<p><strong>cupsctl</strong>
[
-<b>-h</b>
-<i>server</i>[<b>:</b><i>port</i>]
+<strong>-h</strong>
+<em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>--</b>[<b>no-</b>]<b>debug-logging</b>
+<strong>--</strong>[<strong>no-</strong>]<strong>debug-logging</strong>
] [
-<b>--</b>[<b>no-</b>]<b>remote-admin</b>
+<strong>--</strong>[<strong>no-</strong>]<strong>remote-admin</strong>
] [
-<b>--</b>[<b>no-</b>]<b>remote-any</b>
+<strong>--</strong>[<strong>no-</strong>]<strong>remote-any</strong>
] [
-<b>--</b>[<b>no-</b>]<b>share-printers</b>
+<strong>--</strong>[<strong>no-</strong>]<strong>share-printers</strong>
] [
-<b>--</b>[<b>no-</b>]<b>user-cancel-any</b>
+<strong>--</strong>[<strong>no-</strong>]<strong>user-cancel-any</strong>
] [
-<i>name=value</i>
+<em>name=value</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupsctl</b> updates or queries the <i>cupsd.conf</i> file for a server. When
+</p>
+ <h2 id="cupsctl-8.description">Description</h2>
+<p><strong>cupsctl</strong> updates or queries the <em>cupsd.conf</em> file for a server. When
no changes are requested, the current configuration values are written to the
-standard output in the format "name=value", one per line.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Enables encryption on the connection to the scheduler.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username to use when authenticating with the scheduler.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Specifies the server address.
+standard output in the format "name=value", one per line.
+</p>
+ <h2 id="cupsctl-8.options">Options</h2>
+<p>The following options are recognized:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Enables encryption on the connection to the scheduler.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username to use when authenticating with the scheduler.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Specifies the server address.
Note: This option must occur before all others.
-<dt><b>--</b>[<b>no-</b>]<b>debug-logging</b>
-<dd style="margin-left: 5.0em">Enables (disables) debug logging to the <i>error_log</i> file.
-<dt><b>--</b>[<b>no-</b>]<b>remote-admin</b>
-<dd style="margin-left: 5.0em">Enables (disables) remote administration.
-<dt><b>--</b>[<b>no-</b>]<b>remote-any</b>
-<dd style="margin-left: 5.0em">Enables (disables) printing from any address, e.g., the Internet.
-<dt><b>--</b>[<b>no-</b>]<b>share-printers</b>
-<dd style="margin-left: 5.0em">Enables (disables) sharing of local printers with other computers.
-<dt><b>--</b>[<b>no-</b>]<b>user-cancel-any</b>
-<dd style="margin-left: 5.0em">Allows (prevents) users to cancel jobs owned by others.
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Display the current settings:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>debug-logging</strong><br>
+Enables (disables) debug logging to the <em>error_log</em> file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>remote-admin</strong><br>
+Enables (disables) remote administration.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>remote-any</strong><br>
+Enables (disables) printing from any address, e.g., the Internet.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>share-printers</strong><br>
+Enables (disables) sharing of local printers with other computers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>user-cancel-any</strong><br>
+Allows (prevents) users to cancel jobs owned by others.
+</p>
+ <h2 id="cupsctl-8.examples">Examples</h2>
+<p>Display the current settings:
+</p>
+ <pre>
cupsctl
</pre>
-Enable debug logging:
-<pre class="man">
+<p>Enable debug logging:
+</p>
+ <pre>
cupsctl --debug-logging
</pre>
-Get the current debug logging state:
-<pre class="man">
+<p>Get the current debug logging state:
+</p>
+ <pre>
cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
</pre>
-Disable printer sharing:
-<pre class="man">
+<p>Disable printer sharing:
+</p>
+ <pre>
cupsctl --no-share-printers
</pre>
-<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>
+ <h2 id="cupsctl-8.known-issues">Known Issues</h2>
+<p>You cannot set the Listen or Port directives using <strong>cupsctl</strong>.
+</p>
+ <h2 id="cupsctl-8.see-also">See Also</h2>
+<p><strong>cupsd.conf</strong>(5),
+
+<strong>cupsd</strong>(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>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="cupsctl-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsd-helper(8)</title>
-</head>
-<body>
-<h1 class="title">cupsd-helper(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsd-helper - cupsd helper programs (deprecated)
-<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>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsd-helper(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsd-helper-8">cupsd-helper(8)</h1>
+ <h2 id="cupsd-helper-8.name">Name</h2>
+<p>cupsd-helper - cupsd helper programs (deprecated)
+</p>
+ <h2 id="cupsd-helper-8.synopsis">Synopsis</h2>
+<p><strong>cups-deviced</strong>
+<em>request-id</em>
+<em>limit</em>
+<em>user-id</em>
+<em>options</em>
<br>
-<b>cups-driverd</b>
-<b>cat</b>
-<i>ppd-name</i>
+<strong>cups-driverd</strong>
+<strong>cat</strong>
+<em>ppd-name</em>
<br>
-<b>cups-driverd</b>
-<b>list</b>
-<i>request_id</i>
-<i>limit</i>
-<i>options</i>
+<strong>cups-driverd</strong>
+<strong>list</strong>
+<em>request_id</em>
+<em>limit</em>
+<em>options</em>
<br>
-<b>cups-exec</b>
-<i>sandbox-profile</i>
+<strong>cups-exec</strong>
+<em>sandbox-profile</em>
[
-<i>-g</i>
-<i>group-id</i>
+<em>-g</em>
+<em>group-id</em>
] [
-<i>-n</i>
-<i>nice-value</i>
+<em>-n</em>
+<em>nice-value</em>
] [
-<i>-u</i>
-<i>user-id</i>
+<em>-u</em>
+<em>user-id</em>
]
-<i>/path/to/program</i>
-<i>argv0</i>
-<i>...</i>
-<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>
-The <b>cups-deviced</b> helper program runs each CUPS
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7)</a>
+<em>/path/to/program</em>
+<em>argv0</em>
+<em>...</em>
+<em>argvN</em>
+</p>
+ <h2 id="cupsd-helper-8.description">Description</h2>
+<p>The <strong>cupsd-helper</strong> programs perform long-running operations on behalf of the scheduler,
+<strong>cupsd</strong>(8).
+
+The <strong>cups-deviced</strong> helper program runs each CUPS
+<strong>backend</strong>(7)
+
with no arguments in order to discover the available printers.
-<p>The <b>cups-driverd</b> helper program lists all available printer drivers, a subset of "matching" printer drivers, or a copy of a specific driver PPD file.
-<p>The <b>cups-exec</b> helper program runs backends, filters, and other programs. On macOS these programs are run in a secure sandbox.
-<h2 class="title"><a name="FILES">Files</a></h2>
-The <b>cups-driverd</b> program looks for PPD and driver information files in the following directories:
-<pre class="man">
- <i>/Library/Printers</i>
- <i>/opt/share/ppd</i>
- <i>/System/Library/Printers</i>
- <i>/usr/local/share/ppd</i>
- <i>/usr/share/cups/drv</i>
- <i>/usr/share/cups/model</i>
- <i>/usr/share/ppd</i>
+</p>
+ <p>The <strong>cups-driverd</strong> helper program lists all available printer drivers, a subset of "matching" printer drivers, or a copy of a specific driver PPD file.
+</p>
+ <p>The <strong>cups-exec</strong> helper program runs backends, filters, and other programs. On macOS these programs are run in a secure sandbox.
+</p>
+ <h2 id="cupsd-helper-8.files">Files</h2>
+<p>The <strong>cups-driverd</strong> program looks for PPD and driver information files in the following directories:
+</p>
+ <pre>
+ <em>/Library/Printers</em>
+ <em>/opt/share/ppd</em>
+ <em>/System/Library/Printers</em>
+ <em>/usr/local/share/ppd</em>
+ <em>/usr/share/cups/drv</em>
+ <em>/usr/share/cups/model</em>
+ <em>/usr/share/ppd</em>
</pre>
-<p>PPD files can be compressed using the
-<b>gzip</b>(1)
+ <p>PPD files can be compressed using the
+<strong>gzip</strong>(1)
+
program or placed in compressed
-<b>tar</b>(1)
+<strong>tar</strong>(1)
+
archives to further reduce their size.
-<p>Driver information files must conform to the format defined in
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5).</a>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <p>Driver information files must conform to the format defined in
+<strong>ppdcfile</strong>(5).
+
+</p>
+ <h2 id="cupsd-helper-8.notes">Notes</h2>
+<p>CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<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-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="cupsd-helper-8.see-also">See Also</h2>
+<p><strong>backend</strong>(7),
-</body>
+<strong>cups</strong>(1),
+
+<strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>filter</strong>(7),
+
+<strong>ppdcfile</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsd-helper-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsd-logs(5)</title>
-</head>
-<body>
-<h1 class="title">cupsd-logs(5)</h1>
-<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>
-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.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsd-logs(5)</title>
+ </head>
+ <body>
+ <h1 id="cupsd-logs-5">cupsd-logs(5)</h1>
+ <h2 id="cupsd-logs-5.name">Name</h2>
+<p>cupsd-logs - cupsd log files (access_log, error_log, and page_log)
+</p>
+ <h2 id="cupsd-logs-5.description">Description</h2>
+<p><strong>cupsd</strong>(8)
+
+normally maintains three log files: <em>access_log</em> to track requests that are submitted to the scheduler, <em>error_log</em> to track progress and errors, and <em>page_log</em> to track pages that are printed.
Configuration directives in
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<strong>cupsd.conf</strong>(5)
+
and
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<strong>cups-files.conf</strong>(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.
-Each line is in an extended version of the so-called "Common Log Format" used by many web servers and web reporting tools:
-<pre class="man">
- <i>host group user date-time </i>"<i>method resource version</i>" <i>status bytes
- ipp-operation ipp-status</i>
+</p>
+ <h3 id="cupsd-logs-5.description.access-log-file-format">Access Log File Format</h3>
+<p>The <em>access_log</em> file lists each HTTP resource that is accessed by a web browser or client.
+Each line is in an extended version of the so-called "Common Log Format" used by many web servers and web reporting tools:
+</p>
+ <pre>
+ <em>host group user date-time </em>"<em>method resource version</em>" <em>status bytes
+ ipp-operation ipp-status</em>
</pre>
-For example:
-<pre class="man">
- 10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
+<p>For example:
+</p>
+ <pre>
+ 10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes
- localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
+ localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
200 0 - -
- localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
+ localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
200 157 CUPS-Get-Printers
successful-ok-ignored-or-substituted-attributes
- localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
+ localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
200 1411 CUPS-Get-Devices -
- localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
+ localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
200 6667 - -
</pre>
-The <i>host</i> field will normally only be an IP address unless you have enabled the HostNameLookups directive in the <i>cupsd.conf</i> file or if the IP address corresponds to your local machine.
-<p>The <i>group</i> field always contains "-".
-<p>The <i>user</i> field is the authenticated username of the requesting user.
-If no username and password is supplied for the request then this field contains "-".
-<p>The <i>date-time</i> field is the date and time of the request in local time and is in the format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]".
-<p>The <i>method</i> field is the HTTP method used: "GET", "HEAD", "OPTIONS", "POST", or "PUT".
-"GET" requests are used to get files from the server, both for the web interface and to get configuration and log files.
-"HEAD" requests are used to get information about a resource prior to a "GET".
-"OPTIONS" requests are used to upgrade connections to TLS encryption.
-"POST" requests are used for web interface forms and IPP requests.
-"PUT" requests are used to upload configuration files.
-<p>The <i>resource</i> field is the filename of the requested resource.
-<p>The <i>version</i> field is the HTTP specification version used by the client.
-For CUPS clients this will always be "HTTP/1.1".
-<p>The <i>status</i> field contains the HTTP result status of the request, as follows:
-<div style="margin-left: 5.0em;">
-<dl class="man">
-<dt>200
-<dd style="margin-left: 5.0em">Successful operation.
-<dt>201
-<dd style="margin-left: 5.0em">File created/modified successfully.
-<dt>304
-<dd style="margin-left: 5.0em">The requested file has not changed.
-<dt>400
-<dd style="margin-left: 5.0em">Bad HTTP request; typically this means that you have a malicious program trying to access your server.
-<dt>401
-<dd style="margin-left: 5.0em">Unauthorized, authentication (username + password) is required.
-<dt>403
-<dd style="margin-left: 5.0em">Access is forbidden; typically this means that a client tried to access a file or resource they do not have permission to access.
-<dt>404
-<dd style="margin-left: 5.0em">The file or resource does not exist.
-<dt>405
-<dd style="margin-left: 5.0em">URL access method is not allowed; typically this means you have a web browser using your server as a proxy.
-<dt>413
-<dd style="margin-left: 5.0em">Request too large; typically this means that a client tried to print a file larger than the MaxRequestSize allows.
-<dt>426
-<dd style="margin-left: 5.0em">Upgrading to TLS-encrypted connection.
-<dt>500
-<dd style="margin-left: 5.0em">Server error; typically this happens when the server is unable to open/create a file - consult the error_log file for details.
-<dt>501
-<dd style="margin-left: 5.0em">The client requested encryption but encryption support is not enabled/compiled in.
-<dt>505
-<dd style="margin-left: 5.0em">HTTP version number not supported; typically this means that you have a malicious program trying to access your server.
-</div>
-</dl>
-<p>The <i>bytes</i> field contains the number of bytes in the request.
+<p>The <em>host</em> field will normally only be an IP address unless you have enabled the HostNameLookups directive in the <em>cupsd.conf</em> file or if the IP address corresponds to your local machine.
+</p>
+ <p>The <em>group</em> field always contains "-".
+</p>
+ <p>The <em>user</em> field is the authenticated username of the requesting user.
+If no username and password is supplied for the request then this field contains "-".
+</p>
+ <p>The <em>date-time</em> field is the date and time of the request in local time and is in the format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]".
+</p>
+ <p>The <em>method</em> field is the HTTP method used: "GET", "HEAD", "OPTIONS", "POST", or "PUT".
+"GET" requests are used to get files from the server, both for the web interface and to get configuration and log files.
+"HEAD" requests are used to get information about a resource prior to a "GET".
+"OPTIONS" requests are used to upgrade connections to TLS encryption.
+"POST" requests are used for web interface forms and IPP requests.
+"PUT" requests are used to upload configuration files.
+</p>
+ <p>The <em>resource</em> field is the filename of the requested resource.
+</p>
+ <p>The <em>version</em> field is the HTTP specification version used by the client.
+For CUPS clients this will always be "HTTP/1.1".
+</p>
+ <p>The <em>status</em> field contains the HTTP result status of the request, as follows:
+ <div style="margin-left: 2.5em;">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">200<br>
+Successful operation.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">201<br>
+File created/modified successfully.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">304<br>
+The requested file has not changed.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">400<br>
+Bad HTTP request; typically this means that you have a malicious program trying to access your server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">401<br>
+Unauthorized, authentication (username + password) is required.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">403<br>
+Access is forbidden; typically this means that a client tried to access a file or resource they do not have permission to access.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">404<br>
+The file or resource does not exist.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">405<br>
+URL access method is not allowed; typically this means you have a web browser using your server as a proxy.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">413<br>
+Request too large; typically this means that a client tried to print a file larger than the MaxRequestSize allows.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">426<br>
+Upgrading to TLS-encrypted connection.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">500<br>
+Server error; typically this happens when the server is unable to open/create a file - consult the error_log file for details.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">501<br>
+The client requested encryption but encryption support is not enabled/compiled in.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">505<br>
+HTTP version number not supported; typically this means that you have a malicious program trying to access your server.
+ </div>
+</p>
+ <p>The <em>bytes</em> field contains the number of bytes in the request.
For POST requests the bytes field contains the number of bytes of non-IPP data that is received from the client.
-<p>The <i>ipp-operation</i> field contains either "-" for non-IPP requests or the IPP operation name for POST requests containing an IPP request.
-<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>
+</p>
+ <p>The <em>ipp-operation</em> field contains either "-" for non-IPP requests or the IPP operation name for POST requests containing an IPP request.
+</p>
+ <p>The <em>ipp-status</em> field contains either "-" for non-IPP requests or the IPP status code name for POST requests containing an IPP response.
+</p>
+ <h3 id="cupsd-logs-5.description.error-log-file-format">Error Log File Format</h3>
+<p>The <em>error_log</em> file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the
+<strong>cupsd.conf</strong>(5)
+
file controls which messages are logged:
-<pre class="man">
+</p>
+ <pre>
level date-time message
</pre>
-For example:
-<pre class="man">
+<p>For example:
+</p>
+ <pre>
I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'.
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
- na_letter_8.5x11in sides=one-sided"
- D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
- d000001-001"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
+ na_letter_8.5x11in sides=one-sided"
+ D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
+ d000001-001"
I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'.
I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'.
</pre>
-The <i>level</i> field contains the type of message:
-<dl class="man">
-<dt>A
-<dd style="margin-left: 5.0em">Alert message (LogLevel alert)
-<dt>C
-<dd style="margin-left: 5.0em">Critical error message (LogLevel crit)
-<dt>D
-<dd style="margin-left: 5.0em">Debugging message (LogLevel debug)
-<dt>d
-<dd style="margin-left: 5.0em">Detailed debugging message (LogLevel debug2)
-<dt>E
-<dd style="margin-left: 5.0em">Normal error message (LogLevel error)
-<dt>I
-<dd style="margin-left: 5.0em">Informational message (LogLevel info)
-<dt>N
-<dd style="margin-left: 5.0em">Notice message (LogLevel notice)
-<dt>W
-<dd style="margin-left: 5.0em">Warning message (LogLevel warn)
-<dt>X
-<dd style="margin-left: 5.0em">Emergency error message (LogLevel emerg)
-</dl>
-<p>The <i>date-time</i> field contains the date and time of when the page started printing. The format of this field is identical to the data-time field in the <i>access_log</i> file.
-<p>The <i>message</i> field contains a free-form textual message.
-Messages from job filters are prefixed with "[Job NNN]" where "NNN" is the job ID.
-<h3><a name="PAGE_LOG_FILE_FORMAT">Page Log File Format</a></h3>
-The <i>page_log</i> file lists the total number of pages (sheets) that are printed.
+<p>The <em>level</em> field contains the type of message:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">A<br>
+Alert message (LogLevel alert)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">C<br>
+Critical error message (LogLevel crit)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">D<br>
+Debugging message (LogLevel debug)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">d<br>
+Detailed debugging message (LogLevel debug2)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">E<br>
+Normal error message (LogLevel error)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">I<br>
+Informational message (LogLevel info)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">N<br>
+Notice message (LogLevel notice)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">W<br>
+Warning message (LogLevel warn)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">X<br>
+Emergency error message (LogLevel emerg)
+</p>
+ <p>The <em>date-time</em> field contains the date and time of when the page started printing. The format of this field is identical to the data-time field in the <em>access_log</em> file.
+</p>
+ <p>The <em>message</em> field contains a free-form textual message.
+Messages from job filters are prefixed with "[Job NNN]" where "NNN" is the job ID.
+</p>
+ <h3 id="cupsd-logs-5.description.page-log-file-format">Page Log File Format</h3>
+<p>The <em>page_log</em> file lists the total number of pages (sheets) that are printed.
By default, each line contains the following information:
-<pre class="man">
- <i>printer user job-id date-time </i><b>total </b><i>num-sheets job-billing
- job-originating-host-name job-name media sides</i>
+</p>
+ <pre>
+ <em>printer user job-id date-time </em><strong>total </strong><em>num-sheets job-billing
+ job-originating-host-name job-name media sides</em>
</pre>
-For example the entry for a two page job called "myjob" might look like:
-<pre class="man">
+<p>For example the entry for a two page job called "myjob" might look like:
+</p>
+ <pre>
DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
localhost myjob na_letter_8.5x11in one-sided
</pre>
-The PageLogFormat directive in the
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<p>The PageLogFormat directive in the
+<strong>cupsd.conf</strong>(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.
+</p>
+ <p>The <em>printer</em> 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>user</i> field contains the name of the user (the IPP requesting-user-name attribute) that submitted this file for printing.
-<p>The <i>job-id</i> field contains the job number of the page being printed.
-<p>The <i>date-time</i> field contains the date and time of when the page started printing.
-The format of this field is identical to the data-time field in the <i>access_log</i> file.
-<p>The <i>num-sheets</i> field provides the total number of pages (sheets) that have been printed on for the job.
-<p>The <i>job-billing</i> field contains a copy of the job-billing or job-account-id attributes provided with the IPP Create-Job or Print-Job requests or "-" if neither was provided.
-<p>The <i>job-originating-host-name</i> field contains the hostname or IP address of the client that printed the job.
-<p>The <i>job-name</i> field contains a copy of the job-name attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
-<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>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <p>The <em>user</em> field contains the name of the user (the IPP requesting-user-name attribute) that submitted this file for printing.
+</p>
+ <p>The <em>job-id</em> field contains the job number of the page being printed.
+</p>
+ <p>The <em>date-time</em> field contains the date and time of when the page started printing.
+The format of this field is identical to the data-time field in the <em>access_log</em> file.
+</p>
+ <p>The <em>num-sheets</em> field provides the total number of pages (sheets) that have been printed on for the job.
+</p>
+ <p>The <em>job-billing</em> field contains a copy of the job-billing or job-account-id attributes provided with the IPP Create-Job or Print-Job requests or "-" if neither was provided.
+</p>
+ <p>The <em>job-originating-host-name</em> field contains the hostname or IP address of the client that printed the job.
+</p>
+ <p>The <em>job-name</em> field contains a copy of the job-name attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
+</p>
+ <p>The <em>media</em> 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>
+ <p>The <em>sides</em> field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
+</p>
+ <h2 id="cupsd-logs-5.see-also">See Also</h2>
+<p><strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
-</body>
+<strong>cups-files.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsd-logs-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsd.conf(5)</title>
-</head>
-<body>
-<h1 class="title">cupsd.conf(5)</h1>
-<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>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsd.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="cupsd.conf-5">cupsd.conf(5)</h1>
+ <h2 id="cupsd.conf-5.name">Name</h2>
+<p>cupsd.conf - server configuration file for cups
+</p>
+ <h2 id="cupsd.conf-5.description">Description</h2>
+<p>The
+<em>cupsd.conf</em>
file configures the CUPS scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<strong>cupsd</strong>(8).
+
It is normally located in the
-<i>/etc/cups</i>
+<em>/etc/cups</em>
directory.
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.
The configuration directive name and values are case-insensitive.
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>
-<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>AccessLogLevel all</b>
-<dd style="margin-left: 5.0em">Specifies the logging level for the AccessLog file.
-The "config" level logs when printers and classes are added, deleted, or modified and when configuration files are accessed or updated.
-The "actions" level logs when print jobs are submitted, held, released, modified, or canceled, and any of the conditions for "config".
-The "all" level logs all requests.
-The default access log level is "actions".
-<dt><a name="AutoPurgeJobs"></a><b>AutoPurgeJobs Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>AutoPurgeJobs No</b>
-<dd style="margin-left: 5.0em"><br>
+</p>
+ <h3 id="cupsd.conf-5.description.top-level-directives">Top-Level Directives</h3>
+<p>The following top-level directives are understood by
+<strong>cupsd</strong>(8):
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLogLevel config</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLogLevel actions</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLogLevel all</strong><br>
+Specifies the logging level for the AccessLog file.
+The "config" level logs when printers and classes are added, deleted, or modified and when configuration files are accessed or updated.
+The "actions" level logs when print jobs are submitted, held, released, modified, or canceled, and any of the conditions for "config".
+The "all" level logs all requests.
+The default access log level is "actions".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AutoPurgeJobs Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AutoPurgeJobs No</strong><br>
+<br>
Specifies whether to purge job history data automatically when it is no longer required for quotas.
-The default is "No".
-<dt><a name="BrowseDNSSDSubTypes"></a><b>BrowseDNSSDSubTypes</b><i>_subtype[,...]</i>
-<dd style="margin-left: 5.0em">Specifies a list of Bonjour sub-types to advertise for each shared printer.
-For example, "BrowseDNSSDSubTypes _cups,_print" will tell network clients that both CUPS sharing and IPP Everywhere are supported.
-The default is "_cups" which is necessary for printer sharing to work between systems using CUPS.
-<dt><a name="BrowseLocalProtocols"></a><b>BrowseLocalProtocols all</b>
-<dd style="margin-left: 5.0em"><dt><b>BrowseLocalProtocols dnssd</b>
-<dd style="margin-left: 5.0em"><dt><b>BrowseLocalProtocols none</b>
-<dd style="margin-left: 5.0em">Specifies which protocols to use for local printer sharing.
-The default is "dnssd" on systems that support Bonjour and "none" otherwise.
-<dt><a name="BrowseWebIF"></a><b>BrowseWebIF Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>BrowseWebIF No</b>
-<dd style="margin-left: 5.0em"><br>
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseDNSSDSubTypes</strong><em>_subtype[,...]</em>
+<br>
+Specifies a list of Bonjour sub-types to advertise for each shared printer.
+For example, "BrowseDNSSDSubTypes _cups,_print" will tell network clients that both CUPS sharing and IPP Everywhere are supported.
+The default is "_cups" which is necessary for printer sharing to work between systems using CUPS.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseLocalProtocols all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseLocalProtocols dnssd</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseLocalProtocols none</strong><br>
+Specifies which protocols to use for local printer sharing.
+The default is "dnssd" on systems that support Bonjour and "none" otherwise.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseWebIF Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseWebIF No</strong><br>
+<br>
Specifies whether the CUPS web interface is advertised.
-The default is "No".
-<dt><a name="Browsing"></a><b>Browsing Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>Browsing No</b>
-<dd style="margin-left: 5.0em"><br>
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Browsing Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Browsing No</strong><br>
+<br>
Specifies whether shared printers are advertised.
-The default is "No".
-<dt><a name="DefaultAuthType"></a><b>DefaultAuthType Basic</b>
-<dd style="margin-left: 5.0em"><br>
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultAuthType Basic</strong><br>
+<br>
Specifies the default type of authentication to use.
-The default is "Basic".
-<dt><a name="DefaultEncryption"></a><b>DefaultEncryption Never</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultEncryption IfRequested</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultEncryption Required</b>
-<dd style="margin-left: 5.0em">Specifies whether encryption will be used for authenticated requests.
-The default is "Required".
-<dt><a name="DefaultLanguage"></a><b>DefaultLanguage </b><i>locale</i>
-<dd style="margin-left: 5.0em">Specifies the default language to use for text and web content.
-The default is "en".
-<dt><a name="DefaultPaperSize"></a><b>DefaultPaperSize Auto</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultPaperSize None</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultPaperSize </b><i>sizename</i>
-<dd style="margin-left: 5.0em">Specifies the default paper size for new print queues. "Auto" uses a locale-specific default, while "None" specifies there is no default paper size.
-Specific size names are typically "Letter" or "A4".
-The default is "Auto".
+The default is "Basic".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultEncryption Never</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultEncryption IfRequested</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultEncryption Required</strong><br>
+Specifies whether encryption will be used for authenticated requests.
+The default is "Required".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultLanguage </strong><em>locale</em><br>
+Specifies the default language to use for text and web content.
+The default is "en".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultPaperSize Auto</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultPaperSize None</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultPaperSize </strong><em>sizename</em><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.
+Specific size names are typically "Letter" or "A4".
+The default is "Auto".
Note: The default paper size must use a size name from the PPD file and not a PWG self-describing media size name.
-<dt><a name="DefaultPolicy"></a><b>DefaultPolicy </b><i>policy-name</i>
-<dd style="margin-left: 5.0em">Specifies the default access policy to use.
-The default access policy is "default".
-<dt><a name="DefaultShared"></a><b>DefaultShared Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultShared No</b>
-<dd style="margin-left: 5.0em">Specifies whether local printers are shared by default.
-The default is "Yes".
-<dt><a name="DirtyCleanInterval"></a><b>DirtyCleanInterval </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the delay for updating of configuration and state files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultPolicy </strong><em>policy-name</em><br>
+Specifies the default access policy to use.
+The default access policy is "default".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultShared Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultShared No</strong><br>
+Specifies whether local printers are shared by default.
+The default is "Yes".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DirtyCleanInterval </strong><em>seconds</em><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.
-The default value is "30".
-<dt><a name="DNSSDHostName"></a><b>DNSSDHostName</b><i>hostname.example.com</i>
-<dd style="margin-left: 5.0em">Specifies the fully-qualified domain name for the server that is used for Bonjour sharing.
-The default is typically the server's ".local" hostname.
-<dt><a name="ErrorPolicy"></a><b>ErrorPolicy abort-job</b>
-<dd style="margin-left: 5.0em">Specifies that a failed print job should be aborted (discarded) unless otherwise specified for the printer.
-<dt><b>ErrorPolicy retry-current-job</b>
-<dd style="margin-left: 5.0em">Specifies that a failed print job should be retried immediately unless otherwise specified for the printer.
-<dt><b>ErrorPolicy retry-job</b>
-<dd style="margin-left: 5.0em">Specifies that a failed print job should be retried at a later time unless otherwise specified for the printer.
-<dt><b>ErrorPolicy stop-printer</b>
-<dd style="margin-left: 5.0em">Specifies that a failed print job should stop the printer unless otherwise specified for the printer. The 'stop-printer' error policy is the default.
-<dt><a name="FilterLimit"></a><b>FilterLimit </b><i>limit</i>
-<dd style="margin-left: 5.0em">Specifies the maximum cost of filters that are run concurrently, which can be used to minimize disk, memory, and CPU resource problems.
+The default value is "30".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DNSSDHostName</strong><em>hostname.example.com</em>
+<br>
+Specifies the fully-qualified domain name for the server that is used for Bonjour sharing.
+The default is typically the server's ".local" hostname.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorPolicy abort-job</strong><br>
+Specifies that a failed print job should be aborted (discarded) unless otherwise specified for the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorPolicy retry-current-job</strong><br>
+Specifies that a failed print job should be retried immediately unless otherwise specified for the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorPolicy retry-job</strong><br>
+Specifies that a failed print job should be retried at a later time unless otherwise specified for the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ErrorPolicy stop-printer</strong><br>
+Specifies that a failed print job should stop the printer unless otherwise specified for the printer. The 'stop-printer' error policy is the default.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterLimit </strong><em>limit</em><br>
+Specifies the maximum cost of filters that are run concurrently, which can be used to minimize disk, memory, and CPU resource problems.
A limit of 0 disables filter limiting.
An average print to a non-PostScript printer needs a filter limit of about 200.
A PostScript printer needs about half that (100).
Setting the limit below these thresholds will effectively limit the scheduler to printing a single job at any time.
-The default limit is "0".
-<dt><a name="FilterNice"></a><b>FilterNice </b><i>nice-value</i>
-<dd style="margin-left: 5.0em">Specifies the scheduling priority (
-<b>nice</b>(8)
+The default limit is "0".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterNice </strong><em>nice-value</em><br>
+Specifies the scheduling priority (
+<strong>nice</strong>(8)
+
value) of filters that are run to print a job.
The nice value ranges from 0, the highest priority, to 19, the lowest priority.
The default is 0.
-<dt><b>HostNameLookups On</b>
-<dd style="margin-left: 5.0em"><dt><a name="HostNameLookups"></a><b>HostNameLookups Off</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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups On</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups Off</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups Double</strong><br>
+Specifies whether to do reverse lookups on connecting clients.
+The "Double" setting causes
+<strong>cupsd</strong>(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.
-Only set this option to "On" or "Double" if absolutely required.
-<dt><a name="IdleExitTimeout"></a><b>IdleExitTimeout </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the length of time to wait before shutting down due to inactivity.
-The default is "60" seconds.
+The default is "Off" to avoid the potential server performance problems with hostname lookups.
+Only set this option to "On" or "Double" if absolutely required.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IdleExitTimeout </strong><em>seconds</em><br>
+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>
-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.
-The default is "30".
-<dt><a name="JobRetryInterval"></a><b>JobRetryInterval </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the interval between retries of jobs in seconds.
-This is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job".
-The default is "30".
-<dt><a name="JobRetryLimit"></a><b>JobRetryLimit </b><i>count</i>
-<dd style="margin-left: 5.0em">Specifies the number of retries that are done for jobs.
-This is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job".
-The default is "5".
-<dt><a name="KeepAlive"></a><b>KeepAlive Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>KeepAlive No</b>
-<dd style="margin-left: 5.0em">Specifies whether to support HTTP keep-alive connections.
-The default is "Yes".
-<dt><a name="LimitIPP"></a><b><Limit </b><i>operation </i>...<b>> </b>... <b></Limit></b>
-<dd style="margin-left: 5.0em">Specifies the IPP operations that are being limited inside a Policy section. IPP operation names are listed below in the section "IPP OPERATION NAMES".
-<dt><a name="Limit"></a><b><Limit </b><i>method </i>...<b>> </b>... <b></Limit></b>
-<dd style="margin-left: 5.0em"><dt><a name="LimitExcept"></a><b><LimitExcept </b><i>method </i>...<b>> </b>... <b></LimitExcept></b>
-<dd style="margin-left: 5.0em">Specifies the HTTP methods that are being limited inside a Location section. HTTP method names are listed below in the section "HTTP METHOD NAMES".
-<dt><a name="LimitRequestBody"></a><b>LimitRequestBody </b><i>size</i>
-<dd style="margin-left: 5.0em">Specifies the maximum size of print files, IPP requests, and HTML form data.
-The default is "0" which disables the limit check.
-<dt><a name="Listen"></a><b>Listen </b><i>ipv4-address</i><b>:</b><i>port</i>
-<dd style="margin-left: 5.0em"><dt><b>Listen [</b><i>ipv6-address</i><b>]:</b><i>port</i>
-<dd style="margin-left: 5.0em"><dt><b>Listen *:</b><i>port</i>
-<dd style="margin-left: 5.0em"><dt><b>Listen </b><i>/path/to/domain/socket</i>
-<dd style="margin-left: 5.0em">Listens to the specified address and port or domain socket path for connections.
+<strong>cupsd</strong>(8)
+
+is run on-demand (e.g., with <strong>-l</strong>).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobKillDelay </strong><em>seconds</em><br>
+Specifies the number of seconds to wait before killing the filters and backend associated with a canceled or held job.
+The default is "30".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobRetryInterval </strong><em>seconds</em><br>
+Specifies the interval between retries of jobs in seconds.
+This is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job".
+The default is "30".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobRetryLimit </strong><em>count</em><br>
+Specifies the number of retries that are done for jobs.
+This is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job".
+The default is "5".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>KeepAlive Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>KeepAlive No</strong><br>
+Specifies whether to support HTTP keep-alive connections.
+The default is "Yes".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong><Limit </strong><em>operation </em>...<strong>> </strong>... <strong></Limit></strong><br>
+Specifies the IPP operations that are being limited inside a Policy section. IPP operation names are listed below in the section "IPP OPERATION NAMES".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong><Limit </strong><em>method </em>...<strong>> </strong>... <strong></Limit></strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong><LimitExcept </strong><em>method </em>...<strong>> </strong>... <strong></LimitExcept></strong><br>
+Specifies the HTTP methods that are being limited inside a Location section. HTTP method names are listed below in the section "HTTP METHOD NAMES".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LimitRequestBody </strong><em>size</em><br>
+Specifies the maximum size of print files, IPP requests, and HTML form data.
+The default is "0" which disables the limit check.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Listen </strong><em>ipv4-address</em><strong>:</strong><em>port</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Listen [</strong><em>ipv6-address</em><strong>]:</strong><em>port</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Listen *:</strong><em>port</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Listen </strong><em>/path/to/domain/socket</em><br>
+Listens to the specified address and port or domain socket path for connections.
Multiple Listen directives can be provided to listen on multiple addresses.
The Listen directive is similar to the Port directive but allows you to restrict access to specific interfaces or networks.
-Note: "Listen *:<i>port</i>" and "Port <i>port</i>" effectively listen on all IP addresses, so you cannot combine them with Listen directives for explicit IPv4 or IPv6 addresses on the same port.
-<dt><a name="Location"></a><b><Location </b><i>/path</i><b>> </b>... <b></Location></b>
-<dd style="margin-left: 5.0em">Specifies access control for the named location.
-Paths are documented below in the section "LOCATION PATHS".
-<dt><a name="LogDebugHistory"></a><b>LogDebugHistory </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the number of debugging messages that are retained for logging if an error occurs in a print job. Debug messages are logged regardless of the LogLevel setting.
-<dt><a name="LogLevel"></a><b>LogLevel </b>none
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>emerg
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>alert
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>crit
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>error
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>warn
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>notice
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>info
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>debug
-<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>debug2
-<dd style="margin-left: 5.0em">Specifies the level of logging for the ErrorLog file.
-The value "none" stops all logging while "debug2" logs everything.
-The default is "warn".
-<dt><a name="LogTimeFormat"></a><b>LogTimeFormat </b>standard
-<dd style="margin-left: 5.0em"><dt><b>LogTimeFormat </b>usecs
-<dd style="margin-left: 5.0em">Specifies the format of the date and time in the log files.
-The value "standard" is the default and logs whole seconds while "usecs" logs microseconds.
-<dt><a name="MaxClients"></a><b>MaxClients </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients that are allowed by the scheduler.
-The default is "100".
-<dt><a name="MaxClientPerHost"></a><b>MaxClientsPerHost </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients that are allowed from a
+Note: "Listen *:<em>port</em>" and "Port <em>port</em>" effectively listen on all IP addresses, so you cannot combine them with Listen directives for explicit IPv4 or IPv6 addresses on the same port.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong><Location </strong><em>/path</em><strong>> </strong>... <strong></Location></strong><br>
+Specifies access control for the named location.
+Paths are documented below in the section "LOCATION PATHS".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogDebugHistory </strong><em>number</em><br>
+Specifies the number of debugging messages that are retained for logging if an error occurs in a print job. Debug messages are logged regardless of the LogLevel setting.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>none<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>emerg<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>alert<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>crit<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>error<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>warn<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>notice<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>info<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>debug<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogLevel </strong>debug2<br>
+Specifies the level of logging for the ErrorLog file.
+The value "none" stops all logging while "debug2" logs everything.
+The default is "warn".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogTimeFormat </strong>standard<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LogTimeFormat </strong>usecs<br>
+Specifies the format of the date and time in the log files.
+The value "standard" is the default and logs whole seconds while "usecs" logs microseconds.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxClients </strong><em>number</em><br>
+Specifies the maximum number of simultaneous clients that are allowed by the scheduler.
+The default is "100".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxClientsPerHost </strong><em>number</em><br>
+Specifies the maximum number of simultaneous clients that are allowed from a
single address.
The default is the MaxClients value.
-<dt><a name="MaxCopies"></a><b>MaxCopies </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of copies that a user can print of each job.
-The default is "9999".
-<dt><a name="MaxHoldTime"></a><b>MaxHoldTime </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the maximum time a job may remain in the "indefinite" hold state before it is canceled.
-The default is "0" which disables cancellation of held jobs.
-<dt><a name="MaxJobs"></a><b>MaxJobs </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed.
-Set to "0" to allow an unlimited number of jobs.
-The default is "500".
-<dt><a name="MaxJobsPerPrinter"></a><b>MaxJobsPerPrinter </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed per printer.
-The default is "0" which allows up to MaxJobs jobs per printer.
-<dt><a name="MaxJobsPerUser"></a><b>MaxJobsPerUser </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed per user.
-The default is "0" which allows up to MaxJobs jobs per user.
-<dt><a name="MaxJobTime"></a><b>MaxJobTime </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the maximum time a job may take to print before it is canceled.
-Set to "0" to disable cancellation of "stuck" jobs.
-The default is "10800" (3 hours).
-<dt><a name="MaxLogSize"></a><b>MaxLogSize </b><i>size</i>
-<dd style="margin-left: 5.0em">Specifies the maximum size of the log files before they are rotated.
-The value "0" disables log rotation.
-The default is "1048576" (1MB).
-<dt><a name="MaxSubscriptions"></a><b>MaxSubscriptions </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous event subscriptions that are allowed.
-Set to "0" to allow an unlimited number of subscriptions.
-The default is "100".
-<dt><a name="MaxSubscriptionsPerJob"></a><b>MaxSubscriptionsPerJob </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous event subscriptions that are allowed per job.
-The default is "0" which allows up to MaxSubscriptions subscriptions per job.
-<dt><a name="MaxSubscriptionsPerPrinter"></a><b>MaxSubscriptionsPerPrinter </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous event subscriptions that are allowed per printer.
-The default is "0" which allows up to MaxSubscriptions subscriptions per printer.
-<dt><a name="MaxSubscriptionsPerUser"></a><b>MaxSubscriptionsPerUser </b><i>number</i>
-<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous event subscriptions that are allowed per user.
-The default is "0" which allows up to MaxSubscriptions subscriptions per user.
-<dt><a name="MultipleOperationTimeout"></a><b>MultipleOperationTimeout </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the maximum amount of time to allow between files in a multiple file print job.
-The default is "900" (15 minutes).
-<dt><a name="Policy"></a><b><Policy </b><i>name</i><b>> </b>... <b></Policy></b>
-<dd style="margin-left: 5.0em">Specifies access control for the named policy.
-<dt><a name="Port"></a><b>Port </b><i>number</i>
-<dd style="margin-left: 5.0em">Listens to the specified port number for connections.
-<dt><a name="PreserveJobFiles"></a><b>PreserveJobFiles Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>PreserveJobFiles No</b>
-<dd style="margin-left: 5.0em"><dt><b>PreserveJobFiles </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies whether job files (documents) are preserved after a job is printed.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxCopies </strong><em>number</em><br>
+Specifies the maximum number of copies that a user can print of each job.
+The default is "9999".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxHoldTime </strong><em>seconds</em><br>
+Specifies the maximum time a job may remain in the "indefinite" hold state before it is canceled.
+The default is "0" which disables cancellation of held jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxJobs </strong><em>number</em><br>
+Specifies the maximum number of simultaneous jobs that are allowed.
+Set to "0" to allow an unlimited number of jobs.
+The default is "500".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxJobsPerPrinter </strong><em>number</em><br>
+Specifies the maximum number of simultaneous jobs that are allowed per printer.
+The default is "0" which allows up to MaxJobs jobs per printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxJobsPerUser </strong><em>number</em><br>
+Specifies the maximum number of simultaneous jobs that are allowed per user.
+The default is "0" which allows up to MaxJobs jobs per user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxJobTime </strong><em>seconds</em><br>
+Specifies the maximum time a job may take to print before it is canceled.
+Set to "0" to disable cancellation of "stuck" jobs.
+The default is "10800" (3 hours).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxLogSize </strong><em>size</em><br>
+Specifies the maximum size of the log files before they are rotated.
+The value "0" disables log rotation.
+The default is "1048576" (1MB).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxSubscriptions </strong><em>number</em><br>
+Specifies the maximum number of simultaneous event subscriptions that are allowed.
+Set to "0" to allow an unlimited number of subscriptions.
+The default is "100".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxSubscriptionsPerJob </strong><em>number</em><br>
+Specifies the maximum number of simultaneous event subscriptions that are allowed per job.
+The default is "0" which allows up to MaxSubscriptions subscriptions per job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxSubscriptionsPerPrinter </strong><em>number</em><br>
+Specifies the maximum number of simultaneous event subscriptions that are allowed per printer.
+The default is "0" which allows up to MaxSubscriptions subscriptions per printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxSubscriptionsPerUser </strong><em>number</em><br>
+Specifies the maximum number of simultaneous event subscriptions that are allowed per user.
+The default is "0" which allows up to MaxSubscriptions subscriptions per user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MultipleOperationTimeout </strong><em>seconds</em><br>
+Specifies the maximum amount of time to allow between files in a multiple file print job.
+The default is "900" (15 minutes).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong><Policy </strong><em>name</em><strong>> </strong>... <strong></Policy></strong><br>
+Specifies access control for the named policy.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Port </strong><em>number</em><br>
+Listens to the specified port number for connections.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobFiles Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobFiles No</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobFiles </strong><em>seconds</em><br>
+Specifies whether job files (documents) are preserved after a job is printed.
If a numeric value is specified, job files are preserved for the indicated number of seconds after printing.
-The default is "86400" (preserve 1 day).
-<dt><a name="PreserveJobHistory"></a><b>PreserveJobHistory Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>PreserveJobHistory No</b>
-<dd style="margin-left: 5.0em"><dt><b>PreserveJobHistory </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies whether the job history is preserved after a job is printed.
+The default is "86400" (preserve 1 day).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobHistory Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobHistory No</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PreserveJobHistory </strong><em>seconds</em><br>
+Specifies whether the job history is preserved after a job is printed.
If a numeric value is specified, the job history is preserved for the indicated number of seconds after printing.
-If "Yes", the job history is preserved until the MaxJobs limit is reached.
-The default is "Yes".
-<dt><a name="ReadyPaperSizes"></a><b>ReadyPaperSizes </b><i>sizename[,...]</i>
-<dd style="margin-left: 5.0em">Specifies a list of potential paper sizes that are reported as "ready" (loaded).
+If "Yes", the job history is preserved until the MaxJobs limit is reached.
+The default is "Yes".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ReadyPaperSizes </strong><em>sizename[,...]</em><br>
+Specifies a list of potential paper sizes that are reported as "ready" (loaded).
The actual list will only contain sizes that each printer supports.
-The default is "Letter,Legal,Tabloid,4x6,Env10" when the default paper size is "Letter" and "A3,A4,A5,A6,EnvDL" otherwise.
+The default is "Letter,Legal,Tabloid,4x6,Env10" when the default paper size is "Letter" and "A3,A4,A5,A6,EnvDL" otherwise.
Note: Paper sizes must use the size names from the PPD file and not PWG self-describing media size names.
-<dt><a name="ReloadTimeout"></a><b>ReloadTimeout </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the amount of time to wait for job completion before restarting the scheduler.
-The default is "30".
-<dt><a name="ServerAdmin"></a><b>ServerAdmin </b><i>email-address</i>
-<dd style="margin-left: 5.0em">Specifies the email address of the server administrator.
-The default value is "root@ServerName".
-<dt><a name="ServerAlias"></a><b>ServerAlias </b><i>hostname </i>[ ... <i>hostname </i>]
-<dd style="margin-left: 5.0em"><dt><b>ServerAlias *</b>
-<dd style="margin-left: 5.0em">The ServerAlias directive is used for HTTP Host header validation when clients connect to the scheduler from external interfaces.
-Using the special name "*" can expose your system to known browser-based DNS rebinding attacks, even when accessing sites through a firewall.
-If the auto-discovery of alternate names does not work, we recommend listing each alternate name with a ServerAlias directive instead of using "*".
-<dt><a name="ServerName"></a><b>ServerName </b><i>hostname</i>
-<dd style="margin-left: 5.0em">Specifies the fully-qualified hostname of the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ReloadTimeout </strong><em>seconds</em><br>
+Specifies the amount of time to wait for job completion before restarting the scheduler.
+The default is "30".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerAdmin </strong><em>email-address</em><br>
+Specifies the email address of the server administrator.
+The default value is "root@ServerName".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerAlias </strong><em>hostname </em>[ ... <em>hostname </em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerAlias *</strong><br>
+The ServerAlias directive is used for HTTP Host header validation when clients connect to the scheduler from external interfaces.
+Using the special name "*" can expose your system to known browser-based DNS rebinding attacks, even when accessing sites through a firewall.
+If the auto-discovery of alternate names does not work, we recommend listing each alternate name with a ServerAlias directive instead of using "*".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerName </strong><em>hostname</em><br>
+Specifies the fully-qualified hostname of the server.
The default is the value reported by the
-<b>hostname</b>(1)
+<strong>hostname</strong>(1)
+
command.
-<dt><a name="ServerTokens"></a><b>ServerTokens None</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens ProductOnly</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens Major</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens Minor</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens Minimal</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens OS</b>
-<dd style="margin-left: 5.0em"><dt><b>ServerTokens Full</b>
-<dd style="margin-left: 5.0em">Specifies what information is included in the Server header of HTTP responses.
-"None" disables the Server header.
-"ProductOnly" reports "CUPS".
-"Major" reports "CUPS/major IPP/2".
-"Minor" reports "CUPS/major.minor IPP/2.1".
-"Minimal" reports "CUPS/major.minor.patch IPP/2.1".
-"OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1".
-"Full" reports "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1".
-The default is "Minimal".
-<dt><a name="SSLListen"></a><b>SSLListen </b><i>ipv4-address</i><b>:</b><i>port</i>
-<dd style="margin-left: 5.0em"><dt><b>SSLListen [</b><i>ipv6-address</i><b>]:</b><i>port</i>
-<dd style="margin-left: 5.0em"><dt><b>SSLListen *:</b><i>port</i>
-<dd style="margin-left: 5.0em">Listens on the specified address and port for encrypted connections.
-<dt><a name="SSLOptions"></a><dt><b>SSLOptions </b>[<i>AllowDH</i>] [<i>AllowRC4</i>] [<i>AllowSSL3</i>] [<i>DenyCBC</i>] [<i>DenyTLS1.0</i>] [<i>MaxTLS1.0</i>] [<i>MaxTLS1.1</i>] [<i>MaxTLS1.2</i>] [<i>MaxTLS1.3</i>] [<i>MinTLS1.0</i>] [<i>MinTLS1.1</i>] [<i>MinTLS1.2</i>] [<i>MinTLS1.3</i>]
-<dd style="margin-left: 5.0em"><dt><b>SSLOptions None</b>
-<dd style="margin-left: 5.0em">Sets encryption options (only in /etc/cups/client.conf).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens None</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens ProductOnly</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens Major</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens Minor</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens Minimal</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens OS</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerTokens Full</strong><br>
+Specifies what information is included in the Server header of HTTP responses.
+"None" disables the Server header.
+"ProductOnly" reports "CUPS".
+"Major" reports "CUPS/major IPP/2".
+"Minor" reports "CUPS/major.minor IPP/2.1".
+"Minimal" reports "CUPS/major.minor.patch IPP/2.1".
+"OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1".
+"Full" reports "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1".
+The default is "Minimal".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLListen </strong><em>ipv4-address</em><strong>:</strong><em>port</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLListen [</strong><em>ipv6-address</em><strong>]:</strong><em>port</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLListen *:</strong><em>port</em><br>
+Listens on the specified address and port for encrypted connections.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"></p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLOptions </strong>[<em>AllowDH</em>] [<em>AllowRC4</em>] [<em>AllowSSL3</em>] [<em>DenyCBC</em>] [<em>DenyTLS1.0</em>] [<em>MaxTLS1.0</em>] [<em>MaxTLS1.1</em>] [<em>MaxTLS1.2</em>] [<em>MaxTLS1.3</em>] [<em>MinTLS1.0</em>] [<em>MinTLS1.1</em>] [<em>MinTLS1.2</em>] [<em>MinTLS1.3</em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLOptions None</strong><br>
+Sets encryption options (only in /etc/cups/client.conf).
By default, CUPS only supports encryption using TLS v1.0 or higher using known secure cipher suites.
-Security is reduced when <i>Allow</i> options are used.
-Security is enhanced when <i>Deny</i> options are used.
-The <i>AllowDH</i> option enables cipher suites using plain Diffie-Hellman key negotiation (not supported on systems using GNU TLS).
-The <i>AllowRC4</i> option enables the 128-bit RC4 cipher suites, which are required for some older clients.
-The <i>AllowSSL3</i> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0.
-The <i>DenyCBC</i> option disables all CBC cipher suites.
-The <i>DenyTLS1.0</i> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1.
-The <i>MinTLS</i> options set the minimum TLS version to support.
-The <i>MaxTLS</i> options set the maximum TLS version to support.
+Security is reduced when <em>Allow</em> options are used.
+Security is enhanced when <em>Deny</em> options are used.
+The <em>AllowDH</em> option enables cipher suites using plain Diffie-Hellman key negotiation (not supported on systems using GNU TLS).
+The <em>AllowRC4</em> option enables the 128-bit RC4 cipher suites, which are required for some older clients.
+The <em>AllowSSL3</em> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0.
+The <em>DenyCBC</em> option disables all CBC cipher suites.
+The <em>DenyTLS1.0</em> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1.
+The <em>MinTLS</em> options set the minimum TLS version to support.
+The <em>MaxTLS</em> options set the maximum TLS version to support.
Not all operating systems support TLS 1.3 at this time.
-<dt><a name="SSLPort"></a><b>SSLPort </b><i>port</i>
-<dd style="margin-left: 5.0em">Listens on the specified port for encrypted connections.
-<dt><a name="StrictConformance"></a><b>StrictConformance Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>StrictConformance No</b>
-<dd style="margin-left: 5.0em">Specifies whether the scheduler requires clients to strictly adhere to the IPP specifications.
-The default is "No".
-<dt><a name="Timeout"></a><b>Timeout </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the HTTP request timeout.
-The default is "900" (15 minutes).
-<dt><a name="WebInterface"></a><b>WebInterface yes</b>
-<dd style="margin-left: 5.0em"><dt><b>WebInterface no</b>
-<dd style="margin-left: 5.0em">Specifies whether the web interface is enabled.
-The default is "No".
-</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>
-<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.
-<dt>HEAD
-<dd style="margin-left: 5.0em">Used by a client to get the type, size, and modification date of resources.
-<dt>OPTIONS
-<dd style="margin-left: 5.0em">Used by a client to establish a secure (SSL/TLS) connection.
-<dt>POST
-<dd style="margin-left: 5.0em">Used by a client to submit IPP requests and HTML forms from the CUPS web interface.
-<dt>PUT
-<dd style="margin-left: 5.0em">Used by a client to upload configuration files.
-</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>
-<dl class="man">
-<dt>CUPS-Accept-Jobs
-<dd style="margin-left: 5.0em">Allows a printer to accept new jobs.
-<dt>CUPS-Add-Modify-Class
-<dd style="margin-left: 5.0em">Adds or modifies a printer class.
-<dt>CUPS-Add-Modify-Printer
-<dd style="margin-left: 5.0em">Adds or modifies a printer.
-<dt>CUPS-Authenticate-Job
-<dd style="margin-left: 5.0em">Releases a job that is held for authentication.
-<dt>CUPS-Delete-Class
-<dd style="margin-left: 5.0em">Deletes a printer class.
-<dt>CUPS-Delete-Printer
-<dd style="margin-left: 5.0em">Deletes a printer.
-<dt>CUPS-Get-Classes
-<dd style="margin-left: 5.0em">Gets a list of printer classes.
-<dt>CUPS-Get-Default
-<dd style="margin-left: 5.0em">Gets the server default printer or printer class.
-<dt>CUPS-Get-Devices
-<dd style="margin-left: 5.0em">Gets a list of devices that are currently available.
-<dt>CUPS-Get-Document
-<dd style="margin-left: 5.0em">Gets a document file for a job.
-<dt>CUPS-Get-PPD
-<dd style="margin-left: 5.0em">Gets a PPD file.
-<dt>CUPS-Get-PPDs
-<dd style="margin-left: 5.0em">Gets a list of installed PPD files.
-<dt>CUPS-Get-Printers
-<dd style="margin-left: 5.0em">Gets a list of printers.
-<dt>CUPS-Move-Job
-<dd style="margin-left: 5.0em">Moves a job.
-<dt>CUPS-Reject-Jobs
-<dd style="margin-left: 5.0em">Prevents a printer from accepting new jobs.
-<dt>CUPS-Set-Default
-<dd style="margin-left: 5.0em">Sets the server default printer or printer class.
-<dt>Cancel-Job
-<dd style="margin-left: 5.0em">Cancels a job.
-<dt>Cancel-Jobs
-<dd style="margin-left: 5.0em">Cancels one or more jobs.
-<dt>Cancel-My-Jobs
-<dd style="margin-left: 5.0em">Cancels one or more jobs creates by a user.
-<dt>Cancel-Subscription
-<dd style="margin-left: 5.0em">Cancels a subscription.
-<dt>Close-Job
-<dd style="margin-left: 5.0em">Closes a job that is waiting for more documents.
-<dt>Create-Job
-<dd style="margin-left: 5.0em">Creates a new job with no documents.
-<dt>Create-Job-Subscriptions
-<dd style="margin-left: 5.0em">Creates a subscription for job events.
-<dt>Create-Printer-Subscriptions
-<dd style="margin-left: 5.0em">Creates a subscription for printer events.
-<dt>Get-Job-Attributes
-<dd style="margin-left: 5.0em">Gets information about a job.
-<dt>Get-Jobs
-<dd style="margin-left: 5.0em">Gets a list of jobs.
-<dt>Get-Notifications
-<dd style="margin-left: 5.0em">Gets a list of event notifications for a subscription.
-<dt>Get-Printer-Attributes
-<dd style="margin-left: 5.0em">Gets information about a printer or printer class.
-<dt>Get-Subscription-Attributes
-<dd style="margin-left: 5.0em">Gets information about a subscription.
-<dt>Get-Subscriptions
-<dd style="margin-left: 5.0em">Gets a list of subscriptions.
-<dt>Hold-Job
-<dd style="margin-left: 5.0em">Holds a job from printing.
-<dt>Hold-New-Jobs
-<dd style="margin-left: 5.0em">Holds all new jobs from printing.
-<dt>Pause-Printer
-<dd style="margin-left: 5.0em">Stops processing of jobs by a printer or printer class.
-<dt>Pause-Printer-After-Current-Job
-<dd style="margin-left: 5.0em">Stops processing of jobs by a printer or printer class after the current job is finished.
-<dt>Print-Job
-<dd style="margin-left: 5.0em">Creates a new job with a single document.
-<dt>Purge-Jobs
-<dd style="margin-left: 5.0em">Cancels one or more jobs and deletes the job history.
-<dt>Release-Held-New-Jobs
-<dd style="margin-left: 5.0em">Allows previously held jobs to print.
-<dt>Release-Job
-<dd style="margin-left: 5.0em">Allows a job to print.
-<dt>Renew-Subscription
-<dd style="margin-left: 5.0em">Renews a subscription.
-<dt>Restart-Job
-<dd style="margin-left: 5.0em">Reprints a job, if possible.
-<dt>Send-Document
-<dd style="margin-left: 5.0em">Adds a document to a job.
-<dt>Set-Job-Attributes
-<dd style="margin-left: 5.0em">Changes job information.
-<dt>Set-Printer-Attributes
-<dd style="margin-left: 5.0em">Changes printer or printer class information.
-<dt>Validate-Job
-<dd style="margin-left: 5.0em">Validates options for a new job.
-</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>
-<dl class="man">
-<dt>/
-<dd style="margin-left: 5.0em">The path for all get operations (get-printers, get-jobs, etc.)
-<dt>/admin
-<dd style="margin-left: 5.0em">The path for all administration operations (add-printer, delete-printer, start-printer, etc.)
-<dt>/admin/conf
-<dd style="margin-left: 5.0em">The path for access to the CUPS configuration files (cupsd.conf, client.conf, etc.)
-<dt>/admin/log
-<dd style="margin-left: 5.0em">The path for access to the CUPS log files (access_log, error_log, page_log)
-<dt>/classes
-<dd style="margin-left: 5.0em">The path for all printer classes
-<dt>/classes/name
-<dd style="margin-left: 5.0em">The resource for the named printer class
-<dt>/jobs
-<dd style="margin-left: 5.0em">The path for all jobs (hold-job, release-job, etc.)
-<dt>/jobs/id
-<dd style="margin-left: 5.0em">The path for the specified job
-<dt>/printers
-<dd style="margin-left: 5.0em">The path for all printers
-<dt>/printers/name
-<dd style="margin-left: 5.0em">The path for the named printer
-<dt>/printers/name.png
-<dd style="margin-left: 5.0em">The icon file path for the named printer
-<dt>/printers/name.ppd
-<dd style="margin-left: 5.0em">The PPD file path for the named printer
-</dl>
-<h3><a name="DIRECTIVES_VALID_WITHIN_LOCATION_AND_LIMIT_SECTIONS">Directives Valid Within Location And Limit Sections</a></h3>
-The following directives may be placed inside Location and Limit sections in the <b>cupsd.conf</b> file:
-<dl class="man">
-<dt><b>Allow all</b>
-<dd style="margin-left: 5.0em"><dt><b>Allow none</b>
-<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>host.domain.com</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow *.</b><i>domain.com</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i><b>/</b><i>netmask</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i><b>/</b><i>mm</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow [</b><i>ipv6-address</i><b>]</b>
-<dd style="margin-left: 5.0em"><dt><b>Allow [</b><i>ipv6-address</i><b>]/</b><i>mm</i>
-<dd style="margin-left: 5.0em"><dt><b>Allow @IF(</b><i>name</i><b>)</b>
-<dd style="margin-left: 5.0em"><dt><b>Allow @LOCAL</b>
-<dd style="margin-left: 5.0em">Allows access from the named hosts, domains, addresses, or interfaces.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SSLPort </strong><em>port</em><br>
+Listens on the specified port for encrypted connections.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>StrictConformance Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>StrictConformance No</strong><br>
+Specifies whether the scheduler requires clients to strictly adhere to the IPP specifications.
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Timeout </strong><em>seconds</em><br>
+Specifies the HTTP request timeout.
+The default is "900" (15 minutes).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WebInterface yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WebInterface no</strong><br>
+Specifies whether the web interface is enabled.
+The default is "No".
+</p>
+ <h3 id="cupsd.conf-5.description.http-method-names">Http Method Names</h3>
+<p>The following HTTP methods are supported by
+<strong>cupsd</strong>(8):
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">GET<br>
+Used by a client to download icons and other printer resources and to access the CUPS web interface.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">HEAD<br>
+Used by a client to get the type, size, and modification date of resources.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">OPTIONS<br>
+Used by a client to establish a secure (SSL/TLS) connection.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">POST<br>
+Used by a client to submit IPP requests and HTML forms from the CUPS web interface.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">PUT<br>
+Used by a client to upload configuration files.
+</p>
+ <h3 id="cupsd.conf-5.description.ipp-operation-names">Ipp Operation Names</h3>
+<p>The following IPP operations are supported by
+<strong>cupsd</strong>(8):
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Accept-Jobs<br>
+Allows a printer to accept new jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Add-Modify-Class<br>
+Adds or modifies a printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Add-Modify-Printer<br>
+Adds or modifies a printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Authenticate-Job<br>
+Releases a job that is held for authentication.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Delete-Class<br>
+Deletes a printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Delete-Printer<br>
+Deletes a printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-Classes<br>
+Gets a list of printer classes.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-Default<br>
+Gets the server default printer or printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-Devices<br>
+Gets a list of devices that are currently available.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-Document<br>
+Gets a document file for a job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-PPD<br>
+Gets a PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-PPDs<br>
+Gets a list of installed PPD files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Get-Printers<br>
+Gets a list of printers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Move-Job<br>
+Moves a job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Reject-Jobs<br>
+Prevents a printer from accepting new jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Set-Default<br>
+Sets the server default printer or printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Cancel-Job<br>
+Cancels a job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Cancel-Jobs<br>
+Cancels one or more jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Cancel-My-Jobs<br>
+Cancels one or more jobs creates by a user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Cancel-Subscription<br>
+Cancels a subscription.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Close-Job<br>
+Closes a job that is waiting for more documents.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Create-Job<br>
+Creates a new job with no documents.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Create-Job-Subscriptions<br>
+Creates a subscription for job events.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Create-Printer-Subscriptions<br>
+Creates a subscription for printer events.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Job-Attributes<br>
+Gets information about a job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Jobs<br>
+Gets a list of jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Notifications<br>
+Gets a list of event notifications for a subscription.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Printer-Attributes<br>
+Gets information about a printer or printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Subscription-Attributes<br>
+Gets information about a subscription.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Get-Subscriptions<br>
+Gets a list of subscriptions.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Hold-Job<br>
+Holds a job from printing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Hold-New-Jobs<br>
+Holds all new jobs from printing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Pause-Printer<br>
+Stops processing of jobs by a printer or printer class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Pause-Printer-After-Current-Job<br>
+Stops processing of jobs by a printer or printer class after the current job is finished.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Print-Job<br>
+Creates a new job with a single document.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Purge-Jobs<br>
+Cancels one or more jobs and deletes the job history.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Release-Held-New-Jobs<br>
+Allows previously held jobs to print.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Release-Job<br>
+Allows a job to print.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Renew-Subscription<br>
+Renews a subscription.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Restart-Job<br>
+Reprints a job, if possible.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Send-Document<br>
+Adds a document to a job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Set-Job-Attributes<br>
+Changes job information.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Set-Printer-Attributes<br>
+Changes printer or printer class information.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">Validate-Job<br>
+Validates options for a new job.
+</p>
+ <h3 id="cupsd.conf-5.description.location-paths">Location Paths</h3>
+<p>The following paths are commonly used when configuring
+<strong>cupsd</strong>(8):
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/<br>
+The path for all get operations (get-printers, get-jobs, etc.)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/admin<br>
+The path for all administration operations (add-printer, delete-printer, start-printer, etc.)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/admin/conf<br>
+The path for access to the CUPS configuration files (cupsd.conf, client.conf, etc.)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/admin/log<br>
+The path for access to the CUPS log files (access_log, error_log, page_log)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/classes<br>
+The path for all printer classes
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/classes/name<br>
+The resource for the named printer class
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/jobs<br>
+The path for all jobs (hold-job, release-job, etc.)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/jobs/id<br>
+The path for the specified job
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/printers<br>
+The path for all printers
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/printers/name<br>
+The path for the named printer
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/printers/name.png<br>
+The icon file path for the named printer
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">/printers/name.ppd<br>
+The PPD file path for the named printer
+</p>
+ <h3 id="cupsd.conf-5.description.directives-valid-within-location-and-limit-sections">Directives Valid Within Location And Limit Sections</h3>
+<p>The following directives may be placed inside Location and Limit sections in the <strong>cupsd.conf</strong> file:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow </strong><em>host.domain.com</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow *.</strong><em>domain.com</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow </strong><em>ipv4-address</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow </strong><em>ipv4-address</em><strong>/</strong><em>netmask</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow </strong><em>ipv4-address</em><strong>/</strong><em>mm</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow [</strong><em>ipv6-address</em><strong>]</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow [</strong><em>ipv6-address</em><strong>]/</strong><em>mm</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow @IF(</strong><em>name</em><strong>)</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Allow @LOCAL</strong><br>
+Allows access from the named hosts, domains, addresses, or interfaces.
The @IF(name) form uses the current subnets configured for the named interface.
The @LOCAL form uses the current subnets configured for all interfaces that are not point-to-point, for example Ethernet and Wi-Fi interfaces are used but DSL and VPN interfaces are not.
The Order directive controls whether Allow lines are evaluated before or after Deny lines.
-<dt><b>AuthType None</b>
-<dd style="margin-left: 5.0em"><dt><b>AuthType Basic</b>
-<dd style="margin-left: 5.0em"><dt><b>AuthType Default</b>
-<dd style="margin-left: 5.0em">Specifies the type of authentication required.
-The value "Default" corresponds to the DefaultAuthType value.
-<dt><b>Deny all</b>
-<dd style="margin-left: 5.0em"><dt><b>Deny none</b>
-<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>host.domain.com</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny *.</b><i>domain.com</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i><b>/</b><i>netmask</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i><b>/</b><i>mm</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny [</b><i>ipv6-address</i><b>]</b>
-<dd style="margin-left: 5.0em"><dt><b>Deny [</b><i>ipv6-address</i><b>]/</b><i>mm</i>
-<dd style="margin-left: 5.0em"><dt><b>Deny @IF(</b><i>name</i><b>)</b>
-<dd style="margin-left: 5.0em"><dt><b>Deny @LOCAL</b>
-<dd style="margin-left: 5.0em">Denies access from the named hosts, domains, addresses, or interfaces.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AuthType None</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AuthType Basic</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AuthType Default</strong><br>
+Specifies the type of authentication required.
+The value "Default" corresponds to the DefaultAuthType value.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny </strong><em>host.domain.com</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny *.</strong><em>domain.com</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny </strong><em>ipv4-address</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny </strong><em>ipv4-address</em><strong>/</strong><em>netmask</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny </strong><em>ipv4-address</em><strong>/</strong><em>mm</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny [</strong><em>ipv6-address</em><strong>]</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny [</strong><em>ipv6-address</em><strong>]/</strong><em>mm</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny @IF(</strong><em>name</em><strong>)</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Deny @LOCAL</strong><br>
+Denies access from the named hosts, domains, addresses, or interfaces.
The @IF(name) form uses the current subnets configured for the named interface.
The @LOCAL form uses the current subnets configured for all interfaces that are not point-to-point, for example Ethernet and Wi-Fi interfaces are used but DSL and VPN interfaces are not.
The Order directive controls whether Deny lines are evaluated before or after Allow lines.
-<dt><b>Encryption IfRequested</b>
-<dd style="margin-left: 5.0em"><dt><b>Encryption Never</b>
-<dd style="margin-left: 5.0em"><dt><b>Encryption Required</b>
-<dd style="margin-left: 5.0em">Specifies the level of encryption that is required for a particular location.
-The default value is "IfRequested".
-<dt><b>Order allow,deny</b>
-<dd style="margin-left: 5.0em">Specifies that access is denied by default. Allow lines are then processed followed by Deny lines to determine whether a client may access a particular resource.
-<dt><b>Order deny,allow</b>
-<dd style="margin-left: 5.0em">Specifies that access is allowed by default. Deny lines are then processed followed by Allow lines to determine whether a client may access a particular resource.
-<dt><b>Require group </b><i>group-name </i>[ <i>group-name </i>... ]
-<dd style="margin-left: 5.0em">Specifies that an authenticated user must be a member of one of the named groups.
-<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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption IfRequested</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption Never</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption Required</strong><br>
+Specifies the level of encryption that is required for a particular location.
+The default value is "IfRequested".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Order allow,deny</strong><br>
+Specifies that access is denied by default. Allow lines are then processed followed by Deny lines to determine whether a client may access a particular resource.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Order deny,allow</strong><br>
+Specifies that access is allowed by default. Deny lines are then processed followed by Allow lines to determine whether a client may access a particular resource.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Require group </strong><em>group-name </em>[ <em>group-name </em>... ]<br>
+Specifies that an authenticated user must be a member of one of the named groups.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Require user {</strong><em>user-name</em>|<strong>@</strong><em>group-name</em>} ...<br>
+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
+<strong>cups-files.conf</strong>(5)
+
file.
-The group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job.
+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.
-<dt><b>Require valid-user</b>
-<dd style="margin-left: 5.0em">Specifies that any authenticated user is acceptable.
-<dt><b>Satisfy all</b>
-<dd style="margin-left: 5.0em">Specifies that all Allow, AuthType, Deny, Order, and Require conditions must be satisfied to allow access.
-<dt><b>Satisfy any</b>
-<dd style="margin-left: 5.0em">Specifies that any a client may access a resource if either the authentication (AuthType/Require) or address (Allow/Deny/Order) conditions are satisfied.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Require valid-user</strong><br>
+Specifies that any authenticated user is acceptable.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Satisfy all</strong><br>
+Specifies that all Allow, AuthType, Deny, Order, and Require conditions must be satisfied to allow access.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Satisfy any</strong><br>
+Specifies that any a client may access a resource if either the authentication (AuthType/Require) or address (Allow/Deny/Order) conditions are satisfied.
For example, this can be used to require authentication only for remote accesses.
-</dl>
-<h3><a name="DIRECTIVES_VALID_WITHIN_POLICY_SECTIONS">Directives Valid Within Policy Sections</a></h3>
-The following directives may be placed inside Policy sections in the <b>cupsd.conf</b> file:
-<dl class="man">
-<dt><b>JobPrivateAccess all</b>
-<dd style="margin-left: 5.0em"><dt><b>JobPrivateAccess default</b>
-<dd style="margin-left: 5.0em"><dt><b>JobPrivateAccess </b>{<i>user</i>|<b>@</b><i>group</i>|<b>@ACL</b>|<b>@OWNER</b>|<b>@SYSTEM</b>} ...
-<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.
-"@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>
+</p>
+ <h3 id="cupsd.conf-5.description.directives-valid-within-policy-sections">Directives Valid Within Policy Sections</h3>
+<p>The following directives may be placed inside Policy sections in the <strong>cupsd.conf</strong> file:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateAccess all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateAccess default</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateAccess </strong>{<em>user</em>|<strong>@</strong><em>group</em>|<strong>@ACL</strong>|<strong>@OWNER</strong>|<strong>@SYSTEM</strong>} ...<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.
+"@OWNER" maps to the job's owner.
+"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
+<strong>cups-files.conf</strong>(5)
+
file.
-<dt><b>JobPrivateValues all</b>
-<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues default</b>
-<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues none</b>
-<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues </b><i>attribute-name </i>[ ... <i>attribute-name </i>]
-<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", "job-originating-user-name", and "phone".
-<dt><b>SubscriptionPrivateAccess all</b>
-<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateAccess default</b>
-<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateAccess </b>{<i>user</i>|<b>@</b><i>group</i>|<b>@ACL</b>|<b>@OWNER</b>|<b>@SYSTEM</b>} ...
-<dd style="margin-left: 5.0em">Specifies an access list for a subscription's private values.
-The "default" access list is "@OWNER @SYSTEM".
-"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
-"@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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateValues all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateValues default</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateValues none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>JobPrivateValues </strong><em>attribute-name </em>[ ... <em>attribute-name </em>]<br>
+Specifies the list of job values to make private.
+The "default" values are "job-name", "job-originating-host-name", "job-originating-user-name", and "phone".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateAccess all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateAccess default</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateAccess </strong>{<em>user</em>|<strong>@</strong><em>group</em>|<strong>@ACL</strong>|<strong>@OWNER</strong>|<strong>@SYSTEM</strong>} ...<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.
+"@OWNER" maps to the job's owner.
+"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
+<strong>cups-files.conf</strong>(5)
+
file.
-<dt><b>SubscriptionPrivateValues all</b>
-<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues default</b>
-<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues none</b>
-<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues </b><i>attribute-name </i>[ ... <i>attribute-name </i>]
-<dd style="margin-left: 5.0em">Specifies the list of subscription values to make private.
-The "default" values are "notify-events", "notify-pull-method", "notify-recipient-uri", "notify-subscriber-user-name", and "notify-user-data".
-</dl>
-<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
-The following directives are deprecated and will be removed in a future release of CUPS:
-<dl class="man">
-<dt><b>AuthType Negotiate</b>
-<dd style="margin-left: 5.0em">Specifies Kerberos authentication is required.
-<dt><a name="Classification"></a><b>Classification </b><i>banner</i>
-<dd style="margin-left: 5.0em"><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateValues all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateValues default</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateValues none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SubscriptionPrivateValues </strong><em>attribute-name </em>[ ... <em>attribute-name </em>]<br>
+Specifies the list of subscription values to make private.
+The "default" values are "notify-events", "notify-pull-method", "notify-recipient-uri", "notify-subscriber-user-name", and "notify-user-data".
+</p>
+ <h3 id="cupsd.conf-5.description.deprecated-directives">Deprecated Directives</h3>
+<p>The following directives are deprecated and will be removed in a future release of CUPS:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AuthType Negotiate</strong><br>
+Specifies Kerberos authentication is required.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Classification </strong><em>banner</em><br>
+<br>
Specifies the security classification of the server.
-Any valid banner name can be used, including "classified", "confidential", "secret", "topsecret", and "unclassified", or the banner can be omitted to disable secure printing functions.
+Any valid banner name can be used, including "classified", "confidential", "secret", "topsecret", and "unclassified", or the banner can be omitted to disable secure printing functions.
The default is no classification banner.
-<dt><a name="ClassifyOverride"></a><b>ClassifyOverride Yes</b>
-<dd style="margin-left: 5.0em"><dt><b>ClassifyOverride No</b>
-<dd style="margin-left: 5.0em"><br>
-Specifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option.
-The default is "No".
-<dt><b>DefaultAuthType Negotiate</b>
-<dd style="margin-left: 5.0em">Specifies that Kerberos authentication is required by default.
-<dt><a name="GSSServiceName"></a><b>GSSServiceName </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication.
-The default service name is "http."
-<dt><a name="PageLogFormat"></a><b>PageLogFormat </b><i>format-string</i>
-<dd style="margin-left: 5.0em">Specifies the format of PageLog lines.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ClassifyOverride Yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ClassifyOverride No</strong><br>
+<br>
+Specifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option.
+The default is "No".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DefaultAuthType Negotiate</strong><br>
+Specifies that Kerberos authentication is required by default.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>GSSServiceName </strong><em>name</em><br>
+Specifies the service name when using Kerberos authentication.
+The default service name is "http."
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PageLogFormat </strong><em>format-string</em><br>
+Specifies the format of PageLog lines.
Sequences beginning with percent (%) characters are replaced with the corresponding information, while all other characters are copied literally.
The following percent sequences are recognized:
-<pre class="man">
- "%%" inserts a single percent character.
- "%{name}" inserts the value of the specified IPP attribute.
- "%C" inserts the number of copies for the current page.
- "%P" inserts the current page number.
- "%T" inserts the current date and time in common log format.
- "%j" inserts the job ID.
- "%p" inserts the printer name.
- "%u" inserts the username.
+</p>
+ <pre>
+ "%%" inserts a single percent character.
+ "%{name}" inserts the value of the specified IPP attribute.
+ "%C" inserts the number of copies for the current page.
+ "%P" inserts the current page number.
+ "%T" inserts the current date and time in common log format.
+ "%j" inserts the job ID.
+ "%p" inserts the printer name.
+ "%u" inserts the username.
</pre>
-The default is the empty string, which disables page logging.
-The string "%p %u %j %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}" creates a page log with the standard items.
-Use "%{job-impressions-completed}" to insert the number of pages (sides) that were printed, or "%{job-media-sheets-completed}" to insert the number of sheets that were printed.
-</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>
+<p>The default is the empty string, which disables page logging.
+The string "%p %u %j %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}" creates a page log with the standard items.
+Use "%{job-impressions-completed}" to insert the number of pages (sides) that were printed, or "%{job-media-sheets-completed}" to insert the number of sheets that were printed.
+</p>
+ <h2 id="cupsd.conf-5.notes">Notes</h2>
+<p>File, directory, and user configuration directives that used to be allowed in the <strong>cupsd.conf</strong> file are now stored in the
+<strong>cups-files.conf</strong>(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.
+</p>
+ <p>The scheduler MUST be restarted manually after making changes to the <strong>cupsd.conf</strong> file.
On Linux this is typically done using the
-<b>systemctl</b>(8)
+<strong>systemctl</strong>(8)
+
command, while on macOS the
-<b>launchctl</b>(8)
+<strong>launchctl</strong>(8)
+
command is used instead.
-<p>The @LOCAL macro name can be confusing since the system running
-<b>cupsd</b>
+</p>
+ <p>The @LOCAL macro name can be confusing since the system running
+<strong>cupsd</strong>
often belongs to a different set of subnets from its clients.
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The <b>cupsd.conf</b> file format is based on the Apache HTTP Server configuration file format.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Log everything with a maximum log file size of 32 megabytes:
-<pre class="man">
+</p>
+ <h2 id="cupsd.conf-5.conforming-to">Conforming To</h2>
+<p>The <strong>cupsd.conf</strong> file format is based on the Apache HTTP Server configuration file format.
+</p>
+ <h2 id="cupsd.conf-5.examples">Examples</h2>
+<p>Log everything with a maximum log file size of 32 megabytes:
+</p>
+ <pre>
AccessLogLevel all
LogLevel debug2
MaxLogSize 32m
</pre>
-Require authentication for accesses from outside the 10. network:
-<pre class="man">
+<p>Require authentication for accesses from outside the 10. network:
+</p>
+ <pre>
<Location />
Order allow,deny
Allow from 10./8
Satisfy any
</Location>
</pre>
-<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>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2020-2023 by OpenPrinting.
+ <h2 id="cupsd.conf-5.see-also">See Also</h2>
+<p><strong>classes.conf</strong>(5),
+
+<strong>cups-files.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
-</body>
+<strong>mime.convs</strong>(5),
+
+<strong>mime.types</strong>(5),
+
+<strong>printers.conf</strong>(5),
+
+<strong>subscriptions.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsd.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2020-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsd(8)</title>
-</head>
-<body>
-<h1 class="title">cupsd(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsd - cups scheduler
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsd</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsd(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsd-8">cupsd(8)</h1>
+ <h2 id="cupsd-8.name">Name</h2>
+<p>cupsd - cups scheduler
+</p>
+ <h2 id="cupsd-8.synopsis">Synopsis</h2>
+<p><strong>cupsd</strong>
[
-<b>-c</b>
-<i>cupsd.conf</i>
+<strong>-c</strong>
+<em>cupsd.conf</em>
] [
-<b>-f</b>
+<strong>-f</strong>
] [
-<b>-F</b>
+<strong>-F</strong>
] [
-<b>-h</b>
+<strong>-h</strong>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>-s</b>
-<i>cups-files.conf</i>
+<strong>-s</strong>
+<em>cups-files.conf</em>
] [
-<b>-t</b>
+<strong>-t</strong>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupsd</b>
+</p>
+ <h2 id="cupsd-8.description">Description</h2>
+<p><strong>cupsd</strong>
is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1, and supports most of the requirements for IPP Everywhere. If no options are specified on the command-line then the default configuration file
-<i>/etc/cups/cupsd.conf</i>
+<em>/etc/cups/cupsd.conf</em>
will be used.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl class="man">
-<dt><b>-c</b><i> cupsd.conf</i>
-<dd style="margin-left: 5.0em">Uses the named cupsd.conf configuration file.
-<dt><b>-f</b>
-<dd style="margin-left: 5.0em">Run
-<b>cupsd</b>
-in the foreground; the default is to run in the background as a "daemon".
-<dt><b>-F</b>
-<dd style="margin-left: 5.0em">Run
-<b>cupsd</b>
+</p>
+ <h2 id="cupsd-8.options">Options</h2>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c</strong><em> cupsd.conf</em>
+<br>
+Uses the named cupsd.conf configuration file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-f</strong><br>
+Run
+<strong>cupsd</strong>
+in the foreground; the default is to run in the background as a "daemon".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-F</strong><br>
+Run
+<strong>cupsd</strong>
in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
-<b>cupsd</b>
+<strong>cupsd</strong>
from
-<b>init</b>(8).
-<dt><b>-h</b>
-<dd style="margin-left: 5.0em">Shows the program usage.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">This option is passed to
-<b>cupsd</b>
+<strong>init</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h</strong><br>
+Shows the program usage.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+This option is passed to
+<strong>cupsd</strong>
when it is run from
-<b>launchd</b>(8)
+<strong>launchd</strong>(8)
+
or
-<b>systemd</b>(8).
-<dt><b>-s</b><i> cups-files.conf</i>
-<dd style="margin-left: 5.0em">Uses the named cups-files.conf configuration file.
-<dt><b>-t</b>
-<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>
-<i>/etc/cups/subscriptions.conf</i>
+<strong>systemd</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s</strong><em> cups-files.conf</em>
+<br>
+Uses the named cups-files.conf configuration file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t</strong><br>
+Test the configuration file for syntax errors.
+</p>
+ <h2 id="cupsd-8.files">Files</h2>
+ <pre><em>/etc/cups/classes.conf</em>
+<em>/etc/cups/cups-files.conf</em>
+<em>/etc/cups/cupsd.conf</em>
+<em>/usr/share/cups/mime/mime.convs</em>
+<em>/usr/share/cups/mime/mime.types</em>
+<em>/etc/cups/printers.conf</em>
+<em>/etc/cups/subscriptions.conf</em>
</pre>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-<b>cupsd</b>
+ <h2 id="cupsd-8.conforming-to">Conforming To</h2>
+<p><strong>cupsd</strong>
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>
+</p>
+ <h2 id="cupsd-8.examples">Examples</h2>
+<p>Run
+<strong>cupsd</strong>
in the background with the default configuration file:
-<pre class="man">
+</p>
+ <pre>
cupsd
</pre>
-Test a configuration file called
-<i>test.conf</i>:
-<pre class="man">
+<p>Test a configuration file called
+<em>test.conf</em>:
+
+</p>
+ <pre>
cupsd -t -c test.conf
</pre>
-Run
-<b>cupsd</b>
+<p>Run
+<strong>cupsd</strong>
in the foreground with a test configuration file called
-<i>test.conf</i>:
-<pre class="man">
+<em>test.conf</em>:
+
+</p>
+ <pre>
cupsd -f -c test.conf
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<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>
-<a href="man-cupsd-helper.html?TOPIC=Man+Pages"><b>cupsd-helper</b>(8),</a>
-<b>cupsd-logs</b>(8),
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
-<b>launchd</b>(8),
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<b>systemd</b>(8),
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+ <h2 id="cupsd-8.see-also">See Also</h2>
+<p><strong>backend</strong>(7),
+
+<strong>classes.conf</strong>(5),
+
+<strong>cups</strong>(1),
-</body>
+<strong>cups-files.conf</strong>(5),
+
+<strong>cups-lpd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>cupsd-helper</strong>(8),
+
+<strong>cupsd-logs</strong>(8),
+
+<strong>filter</strong>(7),
+
+<strong>launchd</strong>(8),
+
+<strong>mime.convs</strong>(5),
+
+<strong>mime.types</strong>(5),
+
+<strong>printers.conf</strong>(5),
+
+<strong>systemd</strong>(8),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsd-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsenable(8)</title>
-</head>
-<body>
-<h1 class="title">cupsenable(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsdisable, cupsenable - stop/start printers and classes
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsdisable</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsenable(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsenable-8">cupsenable(8)</h1>
+ <h2 id="cupsenable-8.name">Name</h2>
+<p>cupsdisable, cupsenable - stop/start printers and classes
+</p>
+ <h2 id="cupsenable-8.synopsis">Synopsis</h2>
+<p><strong>cupsdisable</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-c</b>
+<strong>-c</strong>
] [
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-r</b>
-<i>reason</i>
+<strong>-r</strong>
+<em>reason</em>
] [
-<b>--hold</b>
+<strong>--hold</strong>
]
-<i>destination(s)</i>
+<em>destination(s)</em>
<br>
-<b>cupsenable</b>
+<strong>cupsenable</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-c</b>
+<strong>-c</strong>
] [
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>--release</b>
+<strong>--release</strong>
]
-<i>destination(s)</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupsenable</b>
+<em>destination(s)</em>
+</p>
+ <h2 id="cupsenable-8.description">Description</h2>
+<p><strong>cupsenable</strong>
starts the named printers or classes while
-<b>cupsdisable</b>
+<strong>cupsdisable</strong>
stops the named printers or classes.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options may be used:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption of the connection to the server.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Uses the specified username when connecting to the server.
-<dt><b>-c</b>
-<dd style="margin-left: 5.0em">Cancels all jobs on the named destination.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Uses the specified server and port.
-<dt><b>--hold</b>
-<dd style="margin-left: 5.0em">Holds remaining jobs on the named printer.
+</p>
+ <h2 id="cupsenable-8.options">Options</h2>
+<p>The following options may be used:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption of the connection to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Uses the specified username when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c</strong><br>
+Cancels all jobs on the named destination.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Uses the specified server and port.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--hold</strong><br>
+Holds remaining jobs on the named printer.
Useful for allowing the current job to complete before performing maintenance.
-<dt><b>-r "</b><i>reason</i><b>"</b>
-<dd style="margin-left: 5.0em">Sets the message associated with the stopped state.
-If no reason is specified then the message is set to "Reason Unknown".
-<dt><b>--release</b>
-<dd style="margin-left: 5.0em">Releases pending jobs for printing.
-Use after running <b>cupsdisable</b> with the <i>--hold</i> option to resume printing.
-</dl>
-<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.
-<p>The System V versions of these commands are <b>disable</b> and <b>enable</b>, respectively.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r "</strong><em>reason</em><strong>"</strong><br>
+Sets the message associated with the stopped state.
+If no reason is specified then the message is set to "Reason Unknown".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--release</strong><br>
+Releases pending jobs for printing.
+Use after running <strong>cupsdisable</strong> with the <em>--hold</em> option to resume printing.
+</p>
+ <h2 id="cupsenable-8.conforming-to">Conforming To</h2>
+<p>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 <em>not</em> case-sensitive.
+</p>
+ <p>The System V versions of these commands are <strong>disable</strong> and <strong>enable</strong>, respectively.
They have been renamed to avoid conflicts with the
-<b>bash</b>(1)
+<strong>bash</strong>(1)
+
built-in commands of the same names.
-<p>The CUPS versions of <b>disable</b> and <b>enable</b> may ask the user for an access password depending on the printing system configuration.
+</p>
+ <p>The CUPS versions of <strong>disable</strong> and <strong>enable</strong> may ask the user for an access password depending on the printing system configuration.
This differs from the System V versions which require the root user to execute these commands.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
-<b>cupsreject</b>(8),
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</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 © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="cupsenable-8.see-also">See Also</h2>
+<p><strong>cupsaccept</strong>(8),
+
+<strong>cupsreject</strong>(8),
+
+<strong>cancel</strong>(1),
-</body>
+<strong>lp</strong>(1),
+
+<strong>lpadmin</strong>(8),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsenable-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupsfilter(8)</title>
-</head>
-<body>
-<h1 class="title">cupsfilter(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupsfilter - convert a file to another format using cups filters (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsfilter</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupsfilter(8)</title>
+ </head>
+ <body>
+ <h1 id="cupsfilter-8">cupsfilter(8)</h1>
+ <h2 id="cupsfilter-8.name">Name</h2>
+<p>cupsfilter - convert a file to another format using cups filters (deprecated)
+</p>
+ <h2 id="cupsfilter-8.synopsis">Synopsis</h2>
+<p><strong>cupsfilter</strong>
[
-<b>--list-filters</b>
+<strong>--list-filters</strong>
] [
-<b>-D</b>
+<strong>-D</strong>
] [
-<b>-U</b>
-<i>user</i>
+<strong>-U</strong>
+<em>user</em>
] [
-<b>-c</b>
-<i>config-file</i>
+<strong>-c</strong>
+<em>config-file</em>
] [
-<b>-d</b>
-<i>printer</i>
+<strong>-d</strong>
+<em>printer</em>
] [
-<b>-e</b>
+<strong>-e</strong>
] [
-<b>-i</b>
-<i>mime/type</i>
+<strong>-i</strong>
+<em>mime/type</em>
] [
-<b>-j</b>
-<i>job-id[,N]</i>
+<strong>-j</strong>
+<em>job-id[,N]</em>
] [
-<b>-m</b>
-<i>mime/type</i>
+<strong>-m</strong>
+<em>mime/type</em>
] [
-<b>-n</b>
-<i>copies</i>
+<strong>-n</strong>
+<em>copies</em>
] [
-<b>-o</b>
-<i>name=value</i>
+<strong>-o</strong>
+<em>name=value</em>
] [
-<b>-p</b>
-<i>filename.ppd</i>
+<strong>-p</strong>
+<em>filename.ppd</em>
] [
-<b>-t</b>
-<i>title</i>
+<strong>-t</strong>
+<em>title</em>
] [
-<b>-u</b>
+<strong>-u</strong>
]
-<i>filename</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupsfilter</b>
+<em>filename</em>
+</p>
+ <h2 id="cupsfilter-8.description">Description</h2>
+<p><strong>cupsfilter</strong>
is a front-end to the CUPS filter subsystem which allows you to convert a file to a specific format, just as if you had printed the file through CUPS. By default,
-<b>cupsfilter</b>
+<strong>cupsfilter</strong>
generates a PDF file. The converted file is sent to the standard output.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl class="man">
-<dt><b>--list-filters</b>
-<dd style="margin-left: 5.0em">Do not actually run the filters, just print the filters used to stdout.
-<dt><b>-D</b>
-<dd style="margin-left: 5.0em">Delete the input file after conversion.
-<dt><b>-U </b><i>user</i>
-<dd style="margin-left: 5.0em">Specifies the username passed to the filters. The default is the name of the current user.
-<dt><b>-c </b><i>config-file</i>
-<dd style="margin-left: 5.0em">Uses the named cups-files.conf configuration file.
-<dt><b>-d </b><i>printer</i>
-<dd style="margin-left: 5.0em">Uses information from the named printer.
-<dt><b>-e</b>
-<dd style="margin-left: 5.0em">Use every filter from the PPD file.
-<dt><b>-i </b><i>mime/type</i>
-<dd style="margin-left: 5.0em">Specifies the source file type. The default file type is guessed using the filename and contents of the file.
-<dt><b>-j </b><i>job-id[,N]</i>
-<dd style="margin-left: 5.0em">Converts document N from the specified job. If N is omitted, document 1 is converted.
-<dt><b>-m </b><i>mime/type</i>
-<dd style="margin-left: 5.0em">Specifies the destination file type. The default file type is application/pdf. Use printer/foo to convert to the printer format defined by the filters in the PPD file.
-<dt><b>-n </b><i>copies</i>
-<dd style="margin-left: 5.0em">Specifies the number of copies to generate.
-<dt><b>-o </b><i>name=value</i>
-<dd style="margin-left: 5.0em">Specifies options to pass to the CUPS filters.
-<dt><b>-p </b><i>filename.ppd</i>
-<dd style="margin-left: 5.0em">Specifies the PPD file to use.
-<dt><b>-t </b><i>title</i>
-<dd style="margin-left: 5.0em">Specifies the document title.
-<dt><b>-u</b>
-<dd style="margin-left: 5.0em">Delete the PPD file after conversion.
-</dl>
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-<b>cupsfilter</b>
+</p>
+ <h2 id="cupsfilter-8.options">Options</h2>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--list-filters</strong><br>
+Do not actually run the filters, just print the filters used to stdout.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D</strong><br>
+Delete the input file after conversion.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>user</em><br>
+Specifies the username passed to the filters. The default is the name of the current user.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong><em>config-file</em><br>
+Uses the named cups-files.conf configuration file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>printer</em><br>
+Uses information from the named printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-e</strong><br>
+Use every filter from the PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i </strong><em>mime/type</em><br>
+Specifies the source file type. The default file type is guessed using the filename and contents of the file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-j </strong><em>job-id[,N]</em><br>
+Converts document N from the specified job. If N is omitted, document 1 is converted.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>mime/type</em><br>
+Specifies the destination file type. The default file type is application/pdf. Use printer/foo to convert to the printer format defined by the filters in the PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>copies</em><br>
+Specifies the number of copies to generate.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name=value</em><br>
+Specifies options to pass to the CUPS filters.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>filename.ppd</em><br>
+Specifies the PPD file to use.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t </strong><em>title</em><br>
+Specifies the document title.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u</strong><br>
+Delete the PPD file after conversion.
+</p>
+ <h2 id="cupsfilter-8.exit-status">Exit Status</h2>
+<p><strong>cupsfilter</strong>
returns a non-zero exit status on any error.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-All of the standard
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+</p>
+ <h2 id="cupsfilter-8.environment">Environment</h2>
+<p>All of the standard
+<strong>cups</strong>(1)
+
environment variables affect the operation of
-<b>cupsfilter</b>.
-<h2 class="title"><a name="FILES">Files</a></h2>
-<pre class="man">
-/etc/cups/cups-files.conf
+<strong>cupsfilter</strong>.
+
+</p>
+ <h2 id="cupsfilter-8.files">Files</h2>
+ <pre>/etc/cups/cups-files.conf
/etc/cups/*.convs
/etc/cups/*.types
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+</pre>
+ <h2 id="cupsfilter-8.notes">Notes</h2>
+<p>CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<p>Unlike when printing, filters run using the
-<b>cupsfilter</b>
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <p>Unlike when printing, filters run using the
+<strong>cupsfilter</strong>
command use the current user and security session. This may result in different output or unexpected behavior.
-<h2 class="title"><a name="EXAMPLE">Example</a></h2>
-The following command will generate a PDF preview of job 42 for a printer named "myprinter" and save it to a file named "preview.pdf":
-<pre class="man">
+</p>
+ <h2 id="cupsfilter-8.example">Example</h2>
+<p>The following command will generate a PDF preview of job 42 for a printer named "myprinter" and save it to a file named "preview.pdf":
+</p>
+ <pre>
cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<b>filter(7),</b>
-<b>mime.convs</b>(7),
-<b>mime.types</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>
-Copyright © 2021-2023 by OpenPrinting.
+ <h2 id="cupsfilter-8.see-also">See Also</h2>
+<p><strong>cups</strong>(1),
-</body>
+<strong>cupsd.conf</strong>(5),
+
+<strong>filter(7),</strong>
+
+<strong>mime.convs</strong>(7),
+
+<strong>mime.types</strong>(7),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="cupsfilter-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>cupstestppd(1)</title>
-</head>
-<body>
-<h1 class="title">cupstestppd(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupstestppd - test conformance of ppd files (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupstestppd</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>cupstestppd(1)</title>
+ </head>
+ <body>
+ <h1 id="cupstestppd-1">cupstestppd(1)</h1>
+ <h2 id="cupstestppd-1.name">Name</h2>
+<p>cupstestppd - test conformance of ppd files (deprecated)
+</p>
+ <h2 id="cupstestppd-1.synopsis">Synopsis</h2>
+<p><strong>cupstestppd</strong>
[
-<b>-I</b>
-<i>category</i>
+<strong>-I</strong>
+<em>category</em>
] [
-<b>-R</b>
-<i>rootdir</i>
+<strong>-R</strong>
+<em>rootdir</em>
] [
-<b>-W</b>
-<i>category</i>
+<strong>-W</strong>
+<em>category</em>
] [
-<b>-q</b>
+<strong>-q</strong>
] [
-<b>-r</b>
+<strong>-r</strong>
] [
-<b>-v</b>[<b>v</b>]
+<strong>-v</strong>[<strong>v</strong>]
]
-<i>filename.ppd[.gz]</i>
+<em>filename.ppd[.gz]</em>
[ ...
-<i>filename.ppd[.gz]</i>
+<em>filename.ppd[.gz]</em>
]
<br>
-<b>cupstestppd</b>
+<strong>cupstestppd</strong>
[
-<b>-R</b>
-<i>rootdir</i>
+<strong>-R</strong>
+<em>rootdir</em>
] [
-<b>-W</b>
-<i>category</i>
+<strong>-W</strong>
+<em>category</em>
] [
-<b>-q</b>
+<strong>-q</strong>
] [
-<b>-r</b>
+<strong>-r</strong>
] [
-<b>-v</b>[<b>v</b>]
+<strong>-v</strong>[<strong>v</strong>]
]
-<b>-</b>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupstestppd</b> tests the conformance of PPD files to the Adobe PostScript Printer Description file format specification version 4.3.
+<strong>-</strong>
+</p>
+ <h2 id="cupstestppd-1.description">Description</h2>
+<p><strong>cupstestppd</strong> tests the conformance of PPD files to the Adobe PostScript Printer Description file format specification version 4.3.
It can also be used to list the supported options and available fonts in a PPD file.
The results of testing and any other output are sent to the standard output.
-<p>The first form of <b>cupstestppd</b> tests one or more PPD files on the command-line.
+</p>
+ <p>The first form of <strong>cupstestppd</strong> tests one or more PPD files on the command-line.
The second form tests the PPD file provided on the standard input.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>cupstestppd</b> supports the following options:
-<dl class="man">
-<dt><b>-I filename</b>
-<dd style="margin-left: 5.0em">Ignores all PCFileName warnings.
-<dt><b>-I filters</b>
-<dd style="margin-left: 5.0em">Ignores all filter errors.
-<dt><b>-I profiles</b>
-<dd style="margin-left: 5.0em">Ignores all profile errors.
-<dt><b>-R </b><i>rootdir</i>
-<dd style="margin-left: 5.0em">Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
-<dt><b>-W constraints</b>
-<dd style="margin-left: 5.0em">Report all UIConstraint errors as warnings.
-<dt><b>-W defaults</b>
-<dd style="margin-left: 5.0em">Except for size-related options, report all default option errors as warnings.
-<dt><b>-W filters</b>
-<dd style="margin-left: 5.0em">Report all filter errors as warnings.
-<dt><b>-W profiles</b>
-<dd style="margin-left: 5.0em">Report all profile errors as warnings.
-<dt><b>-W sizes</b>
-<dd style="margin-left: 5.0em">Report all media size errors as warnings.
-<dt><b>-W translations</b>
-<dd style="margin-left: 5.0em">Report all translation errors as warnings.
-<dt><b>-W all</b>
-<dd style="margin-left: 5.0em">Report all of the previous errors as warnings.
-<dt><b>-W none</b>
-<dd style="margin-left: 5.0em">Report all of the previous errors as errors.
-<dt><b>-q</b>
-<dd style="margin-left: 5.0em">Specifies that no information should be displayed.
-<dt><b>-r</b>
-<dd style="margin-left: 5.0em">Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
-<dt><b>-v</b>
-<dd style="margin-left: 5.0em">Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
-<dt><b>-vv</b>
-<dd style="margin-left: 5.0em">Specifies that all information in the PPD file should be displayed in addition to the detailed conformance testing results.
-</dl>
-<p>The <i>-q</i>, <i>-v</i>, and <i>-vv</i> options are mutually exclusive.
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-<b>cupstestppd</b> returns zero on success and non-zero on error.
+</p>
+ <h2 id="cupstestppd-1.options">Options</h2>
+<p><strong>cupstestppd</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I filename</strong><br>
+Ignores all PCFileName warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I filters</strong><br>
+Ignores all filter errors.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I profiles</strong><br>
+Ignores all profile errors.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-R </strong><em>rootdir</em><br>
+Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W constraints</strong><br>
+Report all UIConstraint errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W defaults</strong><br>
+Except for size-related options, report all default option errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W filters</strong><br>
+Report all filter errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W profiles</strong><br>
+Report all profile errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W sizes</strong><br>
+Report all media size errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W translations</strong><br>
+Report all translation errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W all</strong><br>
+Report all of the previous errors as warnings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W none</strong><br>
+Report all of the previous errors as errors.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-q</strong><br>
+Specifies that no information should be displayed.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r</strong><br>
+Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v</strong><br>
+Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-vv</strong><br>
+Specifies that all information in the PPD file should be displayed in addition to the detailed conformance testing results.
+</p>
+ <p>The <em>-q</em>, <em>-v</em>, and <em>-vv</em> options are mutually exclusive.
+</p>
+ <h2 id="cupstestppd-1.exit-status">Exit Status</h2>
+<p><strong>cupstestppd</strong> returns zero on success and non-zero on error.
The error codes are as follows:
-<dl class="man">
-<dt>1
-<dd style="margin-left: 5.0em">Bad command-line arguments or missing PPD filename.
-<dt>2
-<dd style="margin-left: 5.0em">Unable to open or read PPD file.
-<dt>3
-<dd style="margin-left: 5.0em">The PPD file contains format errors that cannot be skipped.
-<dt>4
-<dd style="margin-left: 5.0em">The PPD file does not conform to the Adobe PPD specification.
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-The following command will test all PPD files under the current directory and print the names of each file that does not conform:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">1<br>
+Bad command-line arguments or missing PPD filename.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">2<br>
+Unable to open or read PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">3<br>
+The PPD file contains format errors that cannot be skipped.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">4<br>
+The PPD file does not conform to the Adobe PPD specification.
+</p>
+ <h2 id="cupstestppd-1.examples">Examples</h2>
+<p>The following command will test all PPD files under the current directory and print the names of each file that does not conform:
+</p>
+ <pre>
find . -name \*.ppd \! -exec cupstestppd -q '{}' \; -print
</pre>
-The next command tests all PPD files under the current directory and print detailed conformance testing results for the files that do not conform:
-<pre class="man">
+<p>The next command tests all PPD files under the current directory and print detailed conformance testing results for the files that do not conform:
+</p>
+ <pre>
find . -name \*.ppd \! -exec cupstestppd -q '{}' \; \
-exec cupstestppd -v '{}' \;
</pre>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+ <h2 id="cupstestppd-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="cupstestppd-1.see-also">See Also</h2>
+<p><strong>lpadmin</strong>(8),
+
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>),
Adobe PostScript Printer Description File Format Specification, Version 4.3.
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="cupstestppd-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>filter(7)</title>
-</head>
-<body>
-<h1 class="title">filter(7)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-filter - cups file conversion filter interface
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>filter</b>
-<i>job</i>
-<i>user</i>
-<i>title</i>
-<i>num-copies</i>
-<i>options</i>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>filter(7)</title>
+ </head>
+ <body>
+ <h1 id="filter-7">filter(7)</h1>
+ <h2 id="filter-7.name">Name</h2>
+<p>filter - cups file conversion filter interface
+</p>
+ <h2 id="filter-7.synopsis">Synopsis</h2>
+<p><strong>filter</strong>
+<em>job</em>
+<em>user</em>
+<em>title</em>
+<em>num-copies</em>
+<em>options</em>
[
-<i>filename</i>
+<em>filename</em>
]
-<pre class="man">
-<b>#include <cups/cups.h></b>
+</p>
+ <pre>
+<strong>#include <cups/cups.h></strong>
-<b>ssize_t cupsBackChannelRead</b>(<b>char *</b><i>buffer</i>, <b>size_t </b><i>bytes</i>,
- <b>double </b><i>timeout</i>);
+<strong>ssize_t cupsBackChannelRead</strong>(<strong>char *</strong><em>buffer</em>, <strong>size_t </strong><em>bytes</em>,
+ <strong>double </strong><em>timeout</em>);
-<b>cups_sc_status_t cupsSideChannelDoRequest</b>(<b>cups_sc_command_t </b><i>command</i>,
- <b>char *</b><i>data</i>, <b>int *</b><i>datalen</i>,
- <b>double </b><i>timeout</i>);
+<strong>cups_sc_status_t cupsSideChannelDoRequest</strong>(<strong>cups_sc_command_t </strong><em>command</em>,
+ <strong>char *</strong><em>data</em>, <strong>int *</strong><em>datalen</em>,
+ <strong>double </strong><em>timeout</em>);
-<b>#include <cups/ppd.h></b>
+<strong>#include <cups/ppd.h></strong>
-<b>const char *cupsGetOption</b>(<b>const char *</b><i>name</i>, <b>int </b><i>num_options</i>,
- <b>cups_option_t *</b><i>options</i>);
+<strong>const char *cupsGetOption</strong>(<strong>const char *</strong><em>name</em>, <strong>int </strong><em>num_options</em>,
+ <strong>cups_option_t *</strong><em>options</em>);
-<b>int cupsMarkOptions</b>(<b>ppd_file_t *</b><i>ppd</i>, <b>int </b><i>num_options</i>,
- <b>cups_option_t *</b><i>options</i>);
+<strong>int cupsMarkOptions</strong>(<strong>ppd_file_t *</strong><em>ppd</em>, <strong>int </strong><em>num_options</em>,
+ <strong>cups_option_t *</strong><em>options</em>);
-<b>int cupsParseOptions</b>(<b>const char *</b><i>arg</i>, <b>int </b><i>num_options</i>,
- <b>cups_option_t **</b><i>options</i>);
+<strong>int cupsParseOptions</strong>(<strong>const char *</strong><em>arg</em>, <strong>int </strong><em>num_options</em>,
+ <strong>cups_option_t **</strong><em>options</em>);
-<b>ppd_choice_t *ppdFindMarkedChoice</b>(<b>ppd_file_t *</b><i>ppd</i>, <b>const char *</b><i>keyword</i>);
+<strong>ppd_choice_t *ppdFindMarkedChoice</strong>(<strong>ppd_file_t *</strong><em>ppd</em>, <strong>const char *</strong><em>keyword</em>);
-<b>void ppdMarkDefaults</b>(<b>ppd_file_t *</b><i>ppd</i>);
+<strong>void ppdMarkDefaults</strong>(<strong>ppd_file_t *</strong><em>ppd</em>);
-<b>ppd_file_t *ppdOpenFile</b>(<b>const char *</b><i>filename</i>);
+<strong>ppd_file_t *ppdOpenFile</strong>(<strong>const char *</strong><em>filename</em>);
</pre>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The CUPS filter interface provides a standard method for adding support for new document types or printers to CUPS.
+ <h2 id="filter-7.description">Description</h2>
+<p>The CUPS filter interface provides a standard method for adding support for new document types or printers to CUPS.
Each filter is capable of converting from one or more input formats to another format that can either be printed directly or piped into another filter to get it to a printable format.
-<p>Filters <b>MUST</b> be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the file format.
-All output <b>MUST</b> be sent to the standard output.
-Filters <b>MUST NOT</b> attempt to communicate directly with the printer, other processes, or other services.
-<p>The command name (<i>argv[0]</i>) is set to the name of the destination printer but is also available in the <b>PRINTER</b><i> environment variable.
-</i><h2 class="title"><a name="OPTIONS">Options</a></h2>
-Options are passed in <i>argv[5]</i> and are encoded from the corresponding IPP attributes used when the job was submitted. Use the
-<b>cupsParseOptions</b>()
-function to load the options into a <b>cups_option_t</b> array and the
-<b>cupsGetOption</b>()
+</p>
+ <p>Filters <strong>MUST</strong> be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the file format.
+All output <strong>MUST</strong> be sent to the standard output.
+Filters <strong>MUST NOT</strong> attempt to communicate directly with the printer, other processes, or other services.
+</p>
+ <p>The command name (<em>argv[0]</em>) is set to the name of the destination printer but is also available in the <strong>PRINTER</strong><em> environment variable.
+</p>
+ <h2 id="filter-7.options">Options</h2>
+<p>Options are passed in argv[5]</em> and are encoded from the corresponding IPP attributes used when the job was submitted. Use the
+<strong>cupsParseOptions</strong>()
+
+function to load the options into a <strong>cups_option_t</strong> array and the
+<strong>cupsGetOption</strong>()
+
function to get the value of a specific attribute.
-Be careful to look for common aliases of IPP attributes such as "landscape" for the IPP "orientation-requested" attribute.
-<p>Options passed on the command-line typically do not include the default choices the printer's PPD file. Use the
-<b>ppdMarkDefaults</b>()
+Be careful to look for common aliases of IPP attributes such as "landscape" for the IPP "orientation-requested" attribute.
+</p>
+ <p>Options passed on the command-line typically do not include the default choices the printer's PPD file. Use the
+<strong>ppdMarkDefaults</strong>()
+
and
-<b>cupsMarkOptions</b>()
+<strong>cupsMarkOptions</strong>()
+
functions in the CUPS library to apply the options to the PPD defaults and map any IPP attributes to the corresponding PPD options.
Use
-<b>ppdFindMarkedChoice</b>()
-to get the user-selected choice for a PPD option. For example, a filter might use the following code to determine the current value of the <b>Duplex</b> PPD option:
-<pre class="man">
- ppd_file_t *ppd = ppdOpenFile(getenv("PPD"));
+<strong>ppdFindMarkedChoice</strong>()
+
+to get the user-selected choice for a PPD option. For example, a filter might use the following code to determine the current value of the <strong>Duplex</strong> PPD option:
+</p>
+ <pre>
+ ppd_file_t *ppd = ppdOpenFile(getenv("PPD"));
cups_option_t *options = NULL;
int num_options = cupsParseOptions(argv[5], 0, &options);
ppdMarkDefaults(ppd);
cupsMarkOptions(ppd, num_options, options);
- ppd_choice_t *choice = ppdFindMarkedChoice(ppd, "Duplex");
+ ppd_choice_t *choice = ppdFindMarkedChoice(ppd, "Duplex");
</pre>
-<p>Raster filters should use option choices set through the raster page header, as those reflect the options in effect for a given page.
+
<p>Raster filters should use option choices set through the raster page header, as those reflect the options in effect for a given page.
Options specified on the command-line determine the default values for the entire job, which can be overridden on a per-page basis.
-<h2 class="title"><a name="LOG_MESSAGES">Log Messages</a></h2>
-Messages sent to the standard error are generally stored in the printer's "printer-state-message" attribute and the current <b>ErrorLog</b> file.
+</p>
+ <h2 id="filter-7.log-messages">Log Messages</h2>
+<p>Messages sent to the standard error are generally stored in the printer's "printer-state-message" attribute and the current <strong>ErrorLog</strong> file.
Each line begins with a standard prefix:
-<dl class="man">
-<dt><b>ALERT: </b><i>message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "alert" log level.
-<dt><b>ATTR: </b><i>attribute=value </i>[ <i>... attribute=value</i>]
-<dd style="margin-left: 5.0em">Sets the named job or printer attribute(s). The following job attributes can be set: "job-media-progress". The following printer attributes can be set:
-"auth-info-required", "marker-colors", "marker-high-levels", "marker-levels",
-"marker-low-levels", "marker-message", "marker-names", "marker-types",
-"printer-alert", and "printer-alert-description".
-<dt><b>CRIT: </b><i>message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "critical" log level.
-<dt><b>DEBUG: </b><i>message</i>
-<dd style="margin-left: 5.0em">Adds the specified message to the current <b>ErrorLog</b> using the "debug" log level.
-<b>DEBUG</b> messages are never stored in the "printer-state-message" attribute.
-<dt><b>DEBUG2: </b><i>message</i>
-<dd style="margin-left: 5.0em"><br>
-Adds the specified message to the current <b>ErrorLog</b> using the "debug2" log level.
-<b>DEBUG2</b> messages are never stored in the "printer-state-message" attribute.
-<dt><b>EMERG: </b><i>message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "emergency" log level.
-<dt><b>ERROR:</b><i> message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "error" log level.
-<dt><b>INFO:</b><i> message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute. If the current <b>LogLevel</b> is set to "debug2", also adds the specified message to the current <b>ErrorLog</b> using the "info" log level.
-<dt><b>NOTICE:</b><i> message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "notice" log level.
-<dt><b>PAGE:</b><i> page-number #-copies</i>
-<dd style="margin-left: 5.0em"><dt><b>PAGE:</b><i> total #-pages</i>
-<dd style="margin-left: 5.0em">Adds an entry to the current <b>PageLog</b>. The first form adds <i>#-copies</i> to the "job-media-sheets-completed" attribute. The second form sets the "job-media-sheets-completed" attribute to <i>#-pages</i>.
-<dt><b>PPD:</b><i> Keyword=Value</i> [ <i>... KeywordN=Value</i> ]
-<dd style="margin-left: 5.0em">Sets the named keywords in the printer's PPD file. This is typically used to update default option keywords such as <b>DefaultPageSize</b> and the various installable options in the PPD file.
-<dt><b>STATE:</b><i> printer-state-reason </i>[ <i>... printer-state-reason</i> ]
-<dd style="margin-left: 5.0em"><dt><b>STATE: +</b><i> printer-state-reason </i>[ <i>... printer-state-reason</i> ]
-<dd style="margin-left: 5.0em"><dt><b>STATE: -</b><i> printer-state-reason </i>[ <i>... printer-state-reason</i> ]
-<dd style="margin-left: 5.0em">Sets, adds, or removes "printer-state-reason" keywords for the current queue. Typically this is used to indicate media, ink, and toner conditions on a printer.
-<dt><b>WARNING:</b><i> message</i>
-<dd style="margin-left: 5.0em">Sets the "printer-state-message" attribute and adds the specified message to the current <b>ErrorLog</b> using the "warning" log level.
-</dl>
-<h2 class="title"><a name="ENVIRONMENT_VARIABLES">Environment Variables</a></h2>
-The following environment variables are defined by the CUPS
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ALERT: </strong><em>message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "alert" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR: </strong><em>attribute=value </em>[ <em>... attribute=value</em>]<br>
+Sets the named job or printer attribute(s). The following job attributes can be set: "job-media-progress". The following printer attributes can be set:
+"auth-info-required", "marker-colors", "marker-high-levels", "marker-levels",
+"marker-low-levels", "marker-message", "marker-names", "marker-types",
+"printer-alert", and "printer-alert-description".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CRIT: </strong><em>message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "critical" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEBUG: </strong><em>message</em><br>
+Adds the specified message to the current <strong>ErrorLog</strong> using the "debug" log level.
+<strong>DEBUG</strong> messages are never stored in the "printer-state-message" attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEBUG2: </strong><em>message</em><br>
+<br>
+Adds the specified message to the current <strong>ErrorLog</strong> using the "debug2" log level.
+<strong>DEBUG2</strong> messages are never stored in the "printer-state-message" attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EMERG: </strong><em>message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "emergency" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ERROR:</strong><em> message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "error" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INFO:</strong><em> message</em><br>
+Sets the "printer-state-message" attribute. If the current <strong>LogLevel</strong> is set to "debug2", also adds the specified message to the current <strong>ErrorLog</strong> using the "info" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>NOTICE:</strong><em> message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "notice" log level.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PAGE:</strong><em> page-number #-copies</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PAGE:</strong><em> total #-pages</em><br>
+Adds an entry to the current <strong>PageLog</strong>. The first form adds <em>#-copies</em> to the "job-media-sheets-completed" attribute. The second form sets the "job-media-sheets-completed" attribute to <em>#-pages</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PPD:</strong><em> Keyword=Value</em> [ <em>... KeywordN=Value</em> ]<br>
+Sets the named keywords in the printer's PPD file. This is typically used to update default option keywords such as <strong>DefaultPageSize</strong> and the various installable options in the PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE:</strong><em> printer-state-reason </em>[ <em>... printer-state-reason</em> ]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: +</strong><em> printer-state-reason </em>[ <em>... printer-state-reason</em> ]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: -</strong><em> printer-state-reason </em>[ <em>... printer-state-reason</em> ]<br>
+Sets, adds, or removes "printer-state-reason" keywords for the current queue. Typically this is used to indicate media, ink, and toner conditions on a printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WARNING:</strong><em> message</em><br>
+Sets the "printer-state-message" attribute and adds the specified message to the current <strong>ErrorLog</strong> using the "warning" log level.
+</p>
+ <h2 id="filter-7.environment-variables">Environment Variables</h2>
+<p>The following environment variables are defined by the CUPS
server when executing the filter:
-<dl class="man">
-<dt><b>CHARSET</b>
-<dd style="margin-left: 5.0em">The default text character set, typically "utf-8".
-<dt><b>CLASS</b>
-<dd style="margin-left: 5.0em">When a job is submitted to a printer class, contains the name of the destination printer class. Otherwise this environment variable will not be set.
-<dt><b>CONTENT_TYPE</b>
-<dd style="margin-left: 5.0em">The MIME media type associated with the submitted job file, for example "application/postscript".
-<dt><b>CUPS_CACHEDIR</b>
-<dd style="margin-left: 5.0em">The directory where semi-persistent cache files can be found and stored.
-<dt><b>CUPS_DATADIR</b>
-<dd style="margin-left: 5.0em">The directory where data files can be found.
-<dt><b>CUPS_FILETYPE</b>
-<dd style="margin-left: 5.0em">The type of file being printed: "job-sheet" for a banner page and "document"
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CHARSET</strong><br>
+The default text character set, typically "utf-8".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CLASS</strong><br>
+When a job is submitted to a printer class, contains the name of the destination printer class. Otherwise this environment variable will not be set.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CONTENT_TYPE</strong><br>
+The MIME media type associated with the submitted job file, for example "application/postscript".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_CACHEDIR</strong><br>
+The directory where semi-persistent cache files can be found and stored.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_DATADIR</strong><br>
+The directory where data files can be found.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_FILETYPE</strong><br>
+The type of file being printed: "job-sheet" for a banner page and "document"
for a regular print file.
-<dt><b>CUPS_MAX_MESSAGE</b>
-<dd style="margin-left: 5.0em">The maximum size of a message sent to <i>stderr</i>, including any leading prefix and the trailing newline.
-<dt><b>CUPS_SERVERROOT</b>
-<dd style="margin-left: 5.0em">The root directory of the server.
-<dt><b>FINAL_CONTENT_TYPE</b>
-<dd style="margin-left: 5.0em">The MIME media type associated with the output destined for the printer, for example "application/vnd.cups-postscript".
-<dt><b>LANG</b>
-<dd style="margin-left: 5.0em">The default language locale (typically C or en).
-<dt><b>PATH</b>
-<dd style="margin-left: 5.0em">The standard execution path for external programs that may be run by the filter.
-<dt><b>PPD</b>
-<dd style="margin-left: 5.0em">The full pathname of the PostScript Printer Description (PPD) file for this printer.
-<dt><b>PRINTER</b>
-<dd style="margin-left: 5.0em">The name of the printer.
-<dt><b>RIP_CACHE</b>
-<dd style="margin-left: 5.0em">The recommended amount of memory to use for Raster Image Processors (RIPs).
-<dt><b>SOFTWARE</b>
-<dd style="margin-left: 5.0em">The name and version number of the server (typically CUPS/<i>major.minor</i>).
-<dt><b>TZ</b>
-<dd style="margin-left: 5.0em">The timezone of the server.
-<dt><b>USER</b>
-<dd style="margin-left: 5.0em">The user executing the filter, typically "lp" or "root"; consult the <i>cups-files.conf</i> file for the current setting.
-</dl>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-While the filter interface is compatible with System V interface scripts, CUPS does not support System V interface scripts.
-<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.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_MAX_MESSAGE</strong><br>
+The maximum size of a message sent to <em>stderr</em>, including any leading prefix and the trailing newline.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CUPS_SERVERROOT</strong><br>
+The root directory of the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FINAL_CONTENT_TYPE</strong><br>
+The MIME media type associated with the output destined for the printer, for example "application/vnd.cups-postscript".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LANG</strong><br>
+The default language locale (typically C or en).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PATH</strong><br>
+The standard execution path for external programs that may be run by the filter.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PPD</strong><br>
+The full pathname of the PostScript Printer Description (PPD) file for this printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+The name of the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>RIP_CACHE</strong><br>
+The recommended amount of memory to use for Raster Image Processors (RIPs).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SOFTWARE</strong><br>
+The name and version number of the server (typically CUPS/<em>major.minor</em>).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TZ</strong><br>
+The timezone of the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>USER</strong><br>
+The user executing the filter, typically "lp" or "root"; consult the <em>cups-files.conf</em> file for the current setting.
+</p>
+ <h2 id="filter-7.conforming-to">Conforming To</h2>
+<p>While the filter interface is compatible with System V interface scripts, CUPS does not support System V interface scripts.
+</p>
+ <h2 id="filter-7.notes">Notes</h2>
+<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<p>CUPS filters are not meant to be run directly by the user.
-Aside from the legacy System V interface issues (<i>argv[0]</i> is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <p>CUPS filters are not meant to be run directly by the user.
+Aside from the legacy System V interface issues (<em>argv[0]</em> is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
Unless you are a developer and know what you are doing, please do not run filters directly.
Instead, use the
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8)</a>
+<strong>cupsfilter</strong>(8)
+
program to use the appropriate filters to do the conversions you need.
-<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-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</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-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
+</p>
+ <h2 id="filter-7.see-also">See Also</h2>
+<p><strong>backend</strong>(7),
+
+<strong>cups</strong>(1),
+
+<strong>cups-files.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
+
+<strong>cupsfilter</strong>(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>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="filter-7.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ippevepcl/ps(7)</title>
-</head>
-<body>
-<h1 class="title">ippevepcl/ps(7)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ippevepcl/ps - pcl and postscript print commands for ippeveprinter
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ippevepcl</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ippevepcl/ps(7)</title>
+ </head>
+ <body>
+ <h1 id="ippevepclps-7">ippevepcl/ps(7)</h1>
+ <h2 id="ippevepclps-7.name">Name</h2>
+<p>ippevepcl/ps - pcl and postscript print commands for ippeveprinter
+</p>
+ <h2 id="ippevepclps-7.synopsis">Synopsis</h2>
+<p><strong>ippevepcl</strong>
[
-<i>filename</i>
+<em>filename</em>
]
<br>
-<b>ippeveps</b>
+<strong>ippeveps</strong>
[
-<i>filename</i>
+<em>filename</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ippevepcl</b>
+</p>
+ <h2 id="ippevepclps-7.description">Description</h2>
+<p><strong>ippevepcl</strong>
and
-<b>ippeveps</b>
+<strong>ippeveps</strong>
are print commands for
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
+<strong>ippeveprinter</strong>(1).
+
As with all print commands, these commands read either the filename specified on the command-line or from the standard input.
Output is sent to the standard output.
Status and progress messages are sent to the standard error.
-<p><b>ippevepcl</b>
+</p>
+ <p><strong>ippevepcl</strong>
prints to B&W HP PCL laser printers and supports printing of HP PCL (application/vnd.hp-pcl), PWG Raster (image/pwg-raster), and Apple Raster (image/urf) print files.
-<p><b>ippeveps</b>
+</p>
+ <p><strong>ippeveps</strong>
print to Adobe PostScript printers and supports printing of PDF (application/pdf), PostScript (application/postscript), JPEG (image/jpeg), PWG Raster (image/pwg-raster), and Apple Raster (image/urf) print files.
Printer-specific commands are read from a supplied PPD file.
If no PPD file is specified, generic commands suitable for any Level 2 or Level 3 PostScript printer are used instead to specify duplex printing and media size.
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-These programs return 1 on error and 0 on success.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-These program inherit the environment provided by the
-<b>ippeveprinter</b>
+</p>
+ <h2 id="ippevepclps-7.exit-status">Exit Status</h2>
+<p>These programs return 1 on error and 0 on success.
+</p>
+ <h2 id="ippevepclps-7.environment">Environment</h2>
+<p>These program inherit the environment provided by the
+<strong>ippeveprinter</strong>
program.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<b>ippeveprinter</b>(8)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="ippevepclps-7.see-also">See Also</h2>
+<p><strong>ippeveprinter</strong>(8)
-</body>
+</p>
+ <h2 id="ippevepclps-7.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ippeveprinter(1)</title>
-</head>
-<body>
-<h1 class="title">ippeveprinter(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ippeveprinter - an ipp everywhere printer application for cups
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ippeveprinter</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ippeveprinter(1)</title>
+ </head>
+ <body>
+ <h1 id="ippeveprinter-1">ippeveprinter(1)</h1>
+ <h2 id="ippeveprinter-1.name">Name</h2>
+<p>ippeveprinter - an ipp everywhere printer application for cups
+</p>
+ <h2 id="ippeveprinter-1.synopsis">Synopsis</h2>
+<p><strong>ippeveprinter</strong>
[
-<b>--help</b>
+<strong>--help</strong>
] [
-<b>--no-web-forms</b>
+<strong>--no-web-forms</strong>
] [
-<b>--pam-service</b>
-<i>service</i>
+<strong>--pam-service</strong>
+<em>service</em>
] [
-<b>--version</b>
+<strong>--version</strong>
] [
-<b>-2</b>
+<strong>-2</strong>
] [
-<b>-A</b>
+<strong>-A</strong>
] [
-<b>-D</b>
-<i>device-uri</i>
+<strong>-D</strong>
+<em>device-uri</em>
] [
-<b>-F</b>
-<i>output-type/subtype</i>
+<strong>-F</strong>
+<em>output-type/subtype</em>
] [
-<b>-K</b>
-<i>keypath</i>
+<strong>-K</strong>
+<em>keypath</em>
] [
-<b>-M</b>
-<i>manufacturer</i>
+<strong>-M</strong>
+<em>manufacturer</em>
] [
-<b>-P</b>
-<i>filename.ppd</i>
+<strong>-P</strong>
+<em>filename.ppd</em>
] [
-<b>-V</b>
-<i>ipp-version</i>
+<strong>-V</strong>
+<em>ipp-version</em>
] [
-<b>-a</b>
-<i>filename.conf</i>
+<strong>-a</strong>
+<em>filename.conf</em>
] [
-<b>-c</b>
-<i>command</i>
+<strong>-c</strong>
+<em>command</em>
] [
-<b>-d</b>
-<i>spool-directory</i>
+<strong>-d</strong>
+<em>spool-directory</em>
] [
-<b>-f</b>
-<i>type/subtype[,...]</i>
+<strong>-f</strong>
+<em>type/subtype[,...]</em>
] [
-<b>-i</b>
-<i>iconfile.png</i>
+<strong>-i</strong>
+<em>iconfile.png</em>
] [
-<b>-k</b>
+<strong>-k</strong>
] [
-<b>-l</b>
-<i>location</i>
+<strong>-l</strong>
+<em>location</em>
] [
-<b>-m</b>
-<i>model</i>
+<strong>-m</strong>
+<em>model</em>
] [
-<b>-n</b>
-<i>hostname</i>
+<strong>-n</strong>
+<em>hostname</em>
] [
-<b>-p</b>
-<i>port</i>
+<strong>-p</strong>
+<em>port</em>
] [
-<b>-r</b>
-<i>subtype[,subtype]</i>
+<strong>-r</strong>
+<em>subtype[,subtype]</em>
] [
-<b>-s</b>
-<i>speed[,color-speed]</i>
+<strong>-s</strong>
+<em>speed[,color-speed]</em>
] [
-<b>-v[vvv]</b>
+<strong>-v[vvv]</strong>
]
-<i>service-name</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ippeveprinter</b>
+<em>service-name</em>
+</p>
+ <h2 id="ippeveprinter-1.description">Description</h2>
+<p><strong>ippeveprinter</strong>
is a simple Internet Printing Protocol (IPP) server conforming to the IPP Everywhere (PWG 5100.14) specification. It can be used to test client software or act as a very basic print server that runs a command for every job that is printed.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by
-<b>ippeveprinter:</b>
-<dl class="man">
-<dt><b>--help</b>
-<dd style="margin-left: 5.0em">Show program usage.
-<dt><b>--no-web-forms</b>
-<dd style="margin-left: 5.0em">Disable the web interface forms used to update the media and supply levels.
-<dt><b>--pam-service </b><i>service</i>
-<dd style="margin-left: 5.0em">Set the PAM service name.
-The default service is "cups".
-<dt><b>--version</b>
-<dd style="margin-left: 5.0em">Show the CUPS version.
-<dt><b>-2</b>
-<dd style="margin-left: 5.0em">Report support for two-sided (duplex) printing.
-<dt><b>-A</b>
-<dd style="margin-left: 5.0em">Enable authentication for the created printer.
-<b>ippeveprinter</b>
+</p>
+ <h2 id="ippeveprinter-1.options">Options</h2>
+<p>The following options are recognized by
+<strong>ippeveprinter:</strong>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Show program usage.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--no-web-forms</strong><br>
+Disable the web interface forms used to update the media and supply levels.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--pam-service </strong><em>service</em><br>
+Set the PAM service name.
+The default service is "cups".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Show the CUPS version.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-2</strong><br>
+Report support for two-sided (duplex) printing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-A</strong><br>
+Enable authentication for the created printer.
+<strong>ippeveprinter</strong>
uses PAM to authenticate HTTP Basic credentials.
-<dt><b>-D </b><i>device-uri</i>
-<dd style="margin-left: 5.0em">Set the device URI for print output.
-The URI can be a filename, directory, or a network socket URI of the form "socket://ADDRESS[:PORT]" (where the default port number is 9100).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D </strong><em>device-uri</em><br>
+Set the device URI for print output.
+The URI can be a filename, directory, or a network socket URI of the form "socket://ADDRESS[:PORT]" (where the default port number is 9100).
When specifying a directory,
-<b>ippeveprinter</b>
+<strong>ippeveprinter</strong>
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 that is provided to the printer command.
-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".
-<dt><b>-K </b><i>keypath</i>
-<dd style="margin-left: 5.0em">Set location of server X.509 certificates and keys.
-<dt><b>-P </b><i>filename.ppd</i>
-<dd style="margin-left: 5.0em">Load printer attributes from the specified PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-F </strong><em>output-type/subtype[,...]</em><br>
+Specifies the output MIME media type that is provided to the printer command.
+The default is "application/postscript" when the <strong>-P</strong> option is specified.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-M </strong><em>manufacturer</em><br>
+Set the manufacturer of the printer.
+The default is "Example".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-K </strong><em>keypath</em><br>
+Set location of server X.509 certificates and keys.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>filename.ppd</em><br>
+Load printer attributes from the specified PPD file.
This option is typically used in conjunction with the
-<b>ippeveps</b>(7)
-printer command ("-c ippeveps").
-<dt><b>-V 1.1</b>
-<dd style="margin-left: 5.0em"><dt><b>-V 2.0</b>
-<dd style="margin-left: 5.0em">Specifies the maximum IPP version to report.
+<strong>ippeveps</strong>(7)
+
+printer command ("-c ippeveps").
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V 1.1</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V 2.0</strong><br>
+Specifies the maximum IPP version to report.
2.0 is the default.
-<dt><b>-a </b><i>filename.conf</i>
-<dd style="margin-left: 5.0em">Load printer attributes from "filename.conf".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong><em>filename.conf</em><br>
+Load printer attributes from "filename.conf".
Attribute files can be created using the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1)</a>
+<strong>ipptool</strong>(1)
+
command with the
-<i>--ippserver</i>
+<em>--ippserver</em>
option.
-<dt><b>-c </b><i>command</i>
-<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 "command" subdirectory of the CUPS binary directory, typically /usr/lib/cups/command or /usr/libexec/cups/command.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong><em>command</em><br>
+Run the specified command for each document that is printed.
+If "command" is not an absolute path ("/path/to/command"),
+<strong>ippeveprinter</strong>
+looks for the command in the "command" subdirectory of the CUPS binary directory, typically /usr/lib/cups/command or /usr/libexec/cups/command.
The
-<a href="man-cups-config.html?TOPIC=Man+Pages"><b>cups-config</b>(1)</a>
-command can be used to discover the correct binary directory ("cups-config --serverbin").
+<strong>cups-config</strong>(1)
+
+command can be used to discover the correct binary directory ("cups-config --serverbin").
In addition, the CUPS_SERVERBIN environment variable can be used to override the default location of this directory - see the
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+<strong>cups</strong>(1)
+
man page for more details.
-<dt><b>-d </b><i>spool-directory</i>
-<dd style="margin-left: 5.0em">Specifies the directory that will hold the print files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>spool-directory</em><br>
+Specifies the directory that will hold the print files.
The default is a directory under the user's current temporary directory.
-<dt><b>-f </b><i>type/subtype[,...]</i>
-<dd style="margin-left: 5.0em">Specifies a list of MIME media types that the server will accept.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-f </strong><em>type/subtype[,...]</em><br>
+Specifies a list of MIME media types that the server will accept.
The default depends on the type of printer created.
-<dt><b>-i </b><i>iconfile.png</i>
-<dd style="margin-left: 5.0em">Specifies the printer icon file for the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i </strong><em>iconfile.png</em><br>
+Specifies the printer icon file for the server.
The file must be a PNG format image.
The default is an internally-provided PNG image.
-<dt><b>-k</b>
-<dd style="margin-left: 5.0em">Keeps the print documents in the spool directory rather than deleting them.
-<dt><b>-l </b><i>location</i>
-<dd style="margin-left: 5.0em">Specifies the human-readable location string that is reported by the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-k</strong><br>
+Keeps the print documents in the spool directory rather than deleting them.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l </strong><em>location</em><br>
+Specifies the human-readable location string that is reported by the server.
The default is the empty string.
-<dt><b>-m </b><i>model</i>
-<dd style="margin-left: 5.0em">Specifies the model name of the printer.
-The default is "Printer".
-<dt><b>-n </b><i>hostname</i>
-<dd style="margin-left: 5.0em">Specifies the hostname that is reported by the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>model</em><br>
+Specifies the model name of the printer.
+The default is "Printer".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>hostname</em><br>
+Specifies the hostname that is reported by the server.
The default is the name returned by the
-<b>hostname</b>(1)
+<strong>hostname</strong>(1)
+
command.
-<dt><b>-p </b><i>port</i>
-<dd style="margin-left: 5.0em">Specifies the port number to listen on.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>port</em><br>
+Specifies the port number to listen on.
The default is a user-specific number from 8000 to 8999.
-<dt><b>-r</b><b>off</b>
-<dd style="margin-left: 5.0em">Turns off DNS-SD service advertisements entirely.
-<dt><b>-r </b><i>subtype[,subtype]</i>
-<dd style="margin-left: 5.0em">Specifies the DNS-SD subtype(s) to advertise.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r off</strong><br>
+Turns off DNS-SD service advertisements entirely.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>subtype[,subtype]</em><br>
+Specifies the DNS-SD subtype(s) to advertise.
Separate multiple subtypes with a comma.
-The default is "_print".
-<dt><b>-s </b><i>speed[,color-speed]</i>
-<dd style="margin-left: 5.0em">Specifies the printer speed in pages per minute.
+The default is "_print".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s </strong><em>speed[,color-speed]</em><br>
+Specifies the printer speed in pages per minute.
If two numbers are specified and the second number is greater than zero, the server will report support for color printing.
-The default is "10,0".
-<dt><b>-v[vvv]</b>
-<dd style="margin-left: 5.0em">Be (very) verbose when logging activity to standard error.
-</dl>
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-The
-<b>ippeveprinter</b>
+The default is "10,0".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v[vvv]</strong><br>
+Be (very) verbose when logging activity to standard error.
+</p>
+ <h2 id="ippeveprinter-1.exit-status">Exit Status</h2>
+<p>The
+<strong>ippeveprinter</strong>
program returns 1 if it is unable to process the command-line arguments or register the IPP service.
Otherwise
-<b>ippeveprinter</b>
+<strong>ippeveprinter</strong>
will run continuously until terminated.
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The
-<b>ippeveprinter</b>
+</p>
+ <h2 id="ippeveprinter-1.conforming-to">Conforming To</h2>
+<p>The
+<strong>ippeveprinter</strong>
program is unique to CUPS and conforms to the IPP Everywhere (PWG 5100.14) specification.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-<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" 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, 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
-<b>ippeveprinter</b>
+</p>
+ <h2 id="ippeveprinter-1.environment">Environment</h2>
+<p><strong>ippeveprinter</strong>
+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>
+ <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>
+ <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>
+ <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.
+</p>
+ <h2 id="ippeveprinter-1.command-output">Command Output</h2>
+<p>Unless they communicate directly with a printer, print commands send printer-ready data to the standard output.
+</p>
+ <p>Print commands can send messages back to
+<strong>ippeveprinter</strong>
on the standard error with one of the following prefixes:
-<dl class="man">
-<dt><b>ATTR: </b><i>attribute=value[ attribute=value]</i>
-<dd style="margin-left: 5.0em">Sets the named attribute(s) to the given values.
-Currently only the "job-impressions" and "job-impressions-completed" Job Status attributes and the "marker-xxx", "printer-alert", "printer-alert-description", "printer-supply", and "printer-supply-description" Printer Status attributes can be set.
-<dt><b>DEBUG: </b><i>Debugging message</i>
-<dd style="margin-left: 5.0em">Logs a debugging message if at least two -v's have been specified.
-<dt><b>ERROR: </b><i>Error message</i>
-<dd style="margin-left: 5.0em">Logs an error message and copies the message to the "job-state-message" attribute.
-<dt><b>INFO: </b><i>Informational message</i>
-<dd style="margin-left: 5.0em">Logs an informational/progress message if -v has been specified and copies the message to the "job-state-message" attribute unless an error has been reported.
-<dt><b>STATE: </b><i>keyword[,keyword,...]</i>
-<dd style="margin-left: 5.0em">Sets the printer's "printer-state-reasons" attribute to the listed keywords.
-<dt><b>STATE: -</b><i>keyword[,keyword,...]</i>
-<dd style="margin-left: 5.0em">Removes the listed keywords from the printer's "printer-state-reasons" attribute.
-<dt><b>STATE: +</b><i>keyword[,keyword,...]</i>
-<dd style="margin-left: 5.0em">Adds the listed keywords to the printer's "printer-state-reasons" attribute.
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Run
-<b>ippeveprinter</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR: </strong><em>attribute=value[ attribute=value]</em><br>
+Sets the named attribute(s) to the given values.
+Currently only the "job-impressions" and "job-impressions-completed" Job Status attributes and the "marker-xxx", "printer-alert", "printer-alert-description", "printer-supply", and "printer-supply-description" Printer Status attributes can be set.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEBUG: </strong><em>Debugging message</em><br>
+Logs a debugging message if at least two -v's have been specified.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ERROR: </strong><em>Error message</em><br>
+Logs an error message and copies the message to the "job-state-message" attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INFO: </strong><em>Informational message</em><br>
+Logs an informational/progress message if -v has been specified and copies the message to the "job-state-message" attribute unless an error has been reported.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: </strong><em>keyword[,keyword,...]</em><br>
+Sets the printer's "printer-state-reasons" attribute to the listed keywords.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: -</strong><em>keyword[,keyword,...]</em><br>
+Removes the listed keywords from the printer's "printer-state-reasons" attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: +</strong><em>keyword[,keyword,...]</em><br>
+Adds the listed keywords to the printer's "printer-state-reasons" attribute.
+</p>
+ <h2 id="ippeveprinter-1.examples">Examples</h2>
+<p>Run
+<strong>ippeveprinter</strong>
with a service name of My Cool Printer:
-<pre class="man">
- ippeveprinter "My Cool Printer"
+</p>
+ <pre>
+ ippeveprinter "My Cool Printer"
</pre>
-<p>Run the
-<b>file</b>(1)
+ <p>Run the
+<strong>file</strong>(1)
+
command whenever a job is sent to the server:
-<pre class="man">
- ippeveprinter -c /usr/bin/file "My Cool Printer"
+</p>
+ <pre>
+ ippeveprinter -c /usr/bin/file "My Cool Printer"
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ippevepcl.html?TOPIC=Man+Pages"><b>ippevepcl</b>(7),</a>
-<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 © 2021-2023 by OpenPrinting.
+ <h2 id="ippeveprinter-1.see-also">See Also</h2>
+<p><strong>ippevepcl</strong>(7),
-</body>
+<strong>ippeveps</strong>(7),
+
+PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>)
+</p>
+ <h2 id="ippeveprinter-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ippfind(1)</title>
-</head>
-<body>
-<h1 class="title">ippfind(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ippfind - find internet printing protocol printers
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ippfind</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ippfind(1)</title>
+ </head>
+ <body>
+ <h1 id="ippfind-1">ippfind(1)</h1>
+ <h2 id="ippfind-1.name">Name</h2>
+<p>ippfind - find internet printing protocol printers
+</p>
+ <h2 id="ippfind-1.synopsis">Synopsis</h2>
+<p><strong>ippfind</strong>
[
-<i>options</i>
-] <i>regtype</i>[<b>,</b><i>subtype</i>][<b>.</b><i>domain</i><b>.</b>] ... [
-<i>expression</i>
+<em>options</em>
+] <em>regtype</em>[<strong>,</strong><em>subtype</em>][<strong>.</strong><em>domain</em><strong>.</strong>] ... [
+<em>expression</em>
... ]
<br>
-<b>ippfind</b>
+<strong>ippfind</strong>
[
-<i>options</i>
-] <i>name</i>[<b>.</b><i>regtype</i>[<b>.</b><i>domain</i><b>.</b>]] ... [
-<i>expression</i>
+<em>options</em>
+] <em>name</em>[<strong>.</strong><em>regtype</em>[<strong>.</strong><em>domain</em><strong>.</strong>]] ... [
+<em>expression</em>
... ]
<br>
-<b>ippfind</b>
-<b>--help</b>
+<strong>ippfind</strong>
+<strong>--help</strong>
<br>
-<b>ippfind</b>
-<b>--version</b>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ippfind</b> finds services registered with a DNS server or available through local devices.
+<strong>ippfind</strong>
+<strong>--version</strong>
+</p>
+ <h2 id="ippfind-1.description">Description</h2>
+<p><strong>ippfind</strong> finds services registered with a DNS server or available through local devices.
Its primary purpose is to find IPP printers and show their URIs, show their current status, or run commands.
-<h3><a name="REGISTRATION_TYPES">Registration Types</a></h3>
-<b>ippfind</b> supports the following registration types:
-<dl class="man">
-<dt>_http._tcp
-<dd style="margin-left: 5.0em">HyperText Transport Protocol (HTTP, RFC 2616)
-<dt>_https._tcp
-<dd style="margin-left: 5.0em">Secure HyperText Transport Protocol (HTTPS, RFC 2818)
-<dt>_ipp._tcp
-<dd style="margin-left: 5.0em">Internet Printing Protocol (IPP, RFC 2911)
-<dt>_ipps._tcp
-<dd style="margin-left: 5.0em">Secure Internet Printing Protocol (IPPS, draft)
-<dt>_printer._tcp
-<dd style="margin-left: 5.0em">Line Printer Daemon (LPD, RFC 1179)
-</dl>
-<h3><a name="EXPRESSIONS">Expressions</a></h3>
-<b>ippfind</b> supports expressions much like the
-<b>find</b>(1)
+</p>
+ <h3 id="ippfind-1.description.registration-types">Registration Types</h3>
+<p><strong>ippfind</strong> supports the following registration types:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">_http._tcp<br>
+HyperText Transport Protocol (HTTP, RFC 2616)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">_https._tcp<br>
+Secure HyperText Transport Protocol (HTTPS, RFC 2818)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">_ipp._tcp<br>
+Internet Printing Protocol (IPP, RFC 2911)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">_ipps._tcp<br>
+Secure Internet Printing Protocol (IPPS, draft)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;">_printer._tcp<br>
+Line Printer Daemon (LPD, RFC 1179)
+</p>
+ <h3 id="ippfind-1.description.expressions">Expressions</h3>
+<p><strong>ippfind</strong> supports expressions much like the
+<strong>find</strong>(1)
+
utility.
However, unlike
-<b>find</b>(1),
-<b>ippfind</b> uses POSIX regular expressions instead of shell filename matching patterns.
-If <i>--exec</i>, <i>-l</i>, <i>--ls</i>, <i>-p</i>, <i>--print</i>, <i>--print-name</i>, <i>-q</i>, <i>--quiet</i>, <i>-s</i>, or <i>-x</i> is not specified, <b>ippfind</b> adds <i>--print</i> to print the service URI of anything it finds.
+<strong>find</strong>(1),
+
+<strong>ippfind</strong> uses POSIX regular expressions instead of shell filename matching patterns.
+If <em>--exec</em>, <em>-l</em>, <em>--ls</em>, <em>-p</em>, <em>--print</em>, <em>--print-name</em>, <em>-q</em>, <em>--quiet</em>, <em>-s</em>, or <em>-x</em> is not specified, <strong>ippfind</strong> adds <em>--print</em> to print the service URI of anything it finds.
The following expressions are supported:
-<dl class="man">
-<dt><b>-d </b><i>regex</i>
-<dd style="margin-left: 5.0em"><dt><b>--domain </b><i>regex</i>
-<dd style="margin-left: 5.0em">True if the domain matches the given regular expression.
-<dt><b>--false</b>
-<dd style="margin-left: 5.0em">Always false.
-<dt><b>-h </b><i>regex</i>
-<dd style="margin-left: 5.0em"><dt><b>--host </b><i>regex</i>
-<dd style="margin-left: 5.0em">True is the hostname matches the given regular expression.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em"><dt><b>--ls</b>
-<dd style="margin-left: 5.0em">Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <i>find</i> "-ls" output for HTTP URLs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>regex</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--domain </strong><em>regex</em><br>
+True if the domain matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--false</strong><br>
+Always false.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>regex</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--host </strong><em>regex</em><br>
+True is the hostname matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--ls</strong><br>
+Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <em>find</em> "-ls" output for HTTP URLs.
The result is true if the URI is accessible, false otherwise.
-<dt><b>--local</b>
-<dd style="margin-left: 5.0em">True if the service is local to this computer.
-<dt><b>-N </b><i>name</i>
-<dd style="margin-left: 5.0em"><dt><b>--literal-name </b><i>name</i>
-<dd style="margin-left: 5.0em">True if the service instance name matches the given name.
-<dt><b>-n </b><i>regex</i>
-<dd style="margin-left: 5.0em"><dt><b>--name </b><i>regex</i>
-<dd style="margin-left: 5.0em">True if the service instance name matches the given regular expression.
-<dt><b>--path </b><i>regex</i>
-<dd style="margin-left: 5.0em">True if the URI resource path matches the given regular expression.
-<dt><b>-P </b><i>number</i>[<b>-</b><i>number</i>]
-<dd style="margin-left: 5.0em"><dt><b>--port </b><i>number</i>[<b>-</b><i>number</i>]
-<dd style="margin-left: 5.0em">True if the port matches the given number or range.
-<dt><b>-p</b>
-<dd style="margin-left: 5.0em"><dt><b>--print</b>
-<dd style="margin-left: 5.0em">Prints the URI if the result of previous expressions is true.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--local</strong><br>
+True if the service is local to this computer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-N </strong><em>name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--literal-name </strong><em>name</em><br>
+True if the service instance name matches the given name.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>regex</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--name </strong><em>regex</em><br>
+True if the service instance name matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--path </strong><em>regex</em><br>
+True if the URI resource path matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>number</em>[<strong>-</strong><em>number</em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--port </strong><em>number</em>[<strong>-</strong><em>number</em>]<br>
+True if the port matches the given number or range.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--print</strong><br>
+Prints the URI if the result of previous expressions is true.
The result is always true.
-<dt><b>-q</b>
-<dd style="margin-left: 5.0em"><dt><b>--quiet</b>
-<dd style="margin-left: 5.0em">Quiet mode - just returns the exit codes below.
-<dt><b>-r</b>
-<dd style="margin-left: 5.0em"><dt><b>--remote</b>
-<dd style="margin-left: 5.0em">True if the service is not local to this computer.
-<dt><b>-s</b>
-<dd style="margin-left: 5.0em"><dt><b>--print-name</b>
-<dd style="margin-left: 5.0em">Prints the service instance name if the result of previous expressions is true.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-q</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--quiet</strong><br>
+Quiet mode - just returns the exit codes below.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--remote</strong><br>
+True if the service is not local to this computer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--print-name</strong><br>
+Prints the service instance name if the result of previous expressions is true.
The result is always true.
-<dt><b>--true</b>
-<dd style="margin-left: 5.0em">Always true.
-<dt><b>-t </b><i>key</i>
-<dd style="margin-left: 5.0em"><dt><b>--txt </b><i>key</i>
-<dd style="margin-left: 5.0em">True if the TXT record contains the named key.
-<dt><b>--txt-</b><i>key regex</i>
-<dd style="margin-left: 5.0em">True if the TXT record contains the named key and matches the given regular expression.
-<dt><b>-u </b><i>regex</i>
-<dd style="margin-left: 5.0em"><dt><b>--uri </b><i>regex</i>
-<dd style="margin-left: 5.0em">True if the URI matches the given regular expression.
-<dt><b>-x </b><i>utility </i>[ <i>argument </i>... ] <b>;</b>
-<dd style="margin-left: 5.0em"><dt><b>--exec </b><i>utility </i>[ <i>argument </i>... ] <b>;</b>
-<dd style="margin-left: 5.0em">Executes the specified program if the current result is true.
-"{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
-</dl>
-<p>Expressions may also contain modifiers:
-<dl class="man">
-<dt><b>( </b><i>expression </i><b>)</b>
-<dd style="margin-left: 5.0em">Group the result of expressions.
-<dt><b>! </b><i>expression</i>
-<dd style="margin-left: 5.0em"><dt><b>--not </b><i>expression</i>
-<dd style="margin-left: 5.0em">Unary NOT of the expression.
-<dt><i>expression expression</i>
-<dd style="margin-left: 5.0em"><dt><i>expression </i><b>--and </b><i>expression</i>
-<dd style="margin-left: 5.0em">Logical AND of expressions.
-<dt><i>expression </i><b>--or </b><i>expression</i>
-<dd style="margin-left: 5.0em">Logical OR of expressions.
-</dl>
-<h3><a name="SUBSTITUTIONS">Substitutions</a></h3>
-The substitutions for "{foo}" in <i>-e</i> and <i>--exec</i> are:
-<dl class="man">
-<dt><b>{service_domain}</b>
-<dd style="margin-left: 5.0em">Domain name, e.g., "example.com.", "local.", etc.
-<dt><b>{service_hostname}</b>
-<dd style="margin-left: 5.0em">Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
-<dt><b>{service_name}</b>
-<dd style="margin-left: 5.0em">Service instance name, e.g., "My Fine Printer".
-<dt><b>{service_port}</b>
-<dd style="margin-left: 5.0em">Port number for server, typically 631 for IPP and 80 for HTTP.
-<dt><b>{service_regtype}</b>
-<dd style="margin-left: 5.0em">DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
-<dt><b>{service_scheme}</b>
-<dd style="margin-left: 5.0em">URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
-<dt><b>{}</b>
-<dd style="margin-left: 5.0em"><dt><b>{service_uri}</b>
-<dd style="margin-left: 5.0em">URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./"">http://printer.local./"</a>, etc.
-<dt><b>{txt_</b><i>key</i><b>}</b>
-<dd style="margin-left: 5.0em">Value of TXT record <i>key</i> (lowercase).
-</dl>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ippfind</b> supports the following options:
-<dl class="man">
-<dt><b>--help</b>
-<dd style="margin-left: 5.0em">Show program help.
-<dt><b>--version</b>
-<dd style="margin-left: 5.0em">Show program version.
-<dt><b>-4</b>
-<dd style="margin-left: 5.0em">Use IPv4 when listing.
-<dt><b>-6</b>
-<dd style="margin-left: 5.0em">Use IPv6 when listing.
-<dt><b>-T </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specify find timeout in seconds.
-If 1 or less, <b>ippfind</b> stops as soon as it thinks it has found everything.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--true</strong><br>
+Always true.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t </strong><em>key</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--txt </strong><em>key</em><br>
+True if the TXT record contains the named key.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--txt-</strong><em>key regex</em><br>
+True if the TXT record contains the named key and matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong><em>regex</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--uri </strong><em>regex</em><br>
+True if the URI matches the given regular expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-x </strong><em>utility </em>[ <em>argument </em>... ] <strong>;</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--exec </strong><em>utility </em>[ <em>argument </em>... ] <strong>;</strong><br>
+Executes the specified program if the current result is true.
+"{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
+</p>
+ <p>Expressions may also contain modifiers:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>( </strong><em>expression </em><strong>)</strong><br>
+Group the result of expressions.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>! </strong><em>expression</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--not </strong><em>expression</em><br>
+Unary NOT of the expression.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><em>expression expression</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><em>expression </em><strong>--and </strong><em>expression</em><br>
+Logical AND of expressions.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><em>expression </em><strong>--or </strong><em>expression</em><br>
+Logical OR of expressions.
+</p>
+ <h3 id="ippfind-1.description.substitutions">Substitutions</h3>
+<p>The substitutions for "{foo}" in <em>-e</em> and <em>--exec</em> are:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_domain}</strong><br>
+Domain name, e.g., "example.com.", "local.", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_hostname}</strong><br>
+Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_name}</strong><br>
+Service instance name, e.g., "My Fine Printer".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_port}</strong><br>
+Port number for server, typically 631 for IPP and 80 for HTTP.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_regtype}</strong><br>
+DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_scheme}</strong><br>
+URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{}</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_uri}</strong><br>
+URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./"">http://printer.local./"</a>, etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{txt_</strong><em>key</em><strong>}</strong><br>
+Value of TXT record <em>key</em> (lowercase).
+</p>
+ <h2 id="ippfind-1.options">Options</h2>
+<p><strong>ippfind</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Show program help.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Show program version.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-4</strong><br>
+Use IPv4 when listing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-6</strong><br>
+Use IPv6 when listing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-T </strong><em>seconds</em><br>
+Specify find timeout in seconds.
+If 1 or less, <strong>ippfind</strong> stops as soon as it thinks it has found everything.
The default timeout is 1 second.
-<dt><b>-V </b><i>version</i>
-<dd style="margin-left: 5.0em">Specifies the IPP version when listing.
-Supported values are "1.1", "2.0", "2.1", and "2.2".
-</dl>
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-<b>ippfind</b> returns 0 if the result for all processed expressions is true, 1 if the result of any processed expression is false, 2 if browsing or any query or resolution failed, 3 if an undefined option or invalid expression was specified, and 4 if it ran out of memory.
-<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
-When executing a program, <b>ippfind</b> sets the following environment variables for the matching service registration:
-<dl class="man">
-<dt><b>IPPFIND_SERVICE_DOMAIN</b>
-<dd style="margin-left: 5.0em">Domain name, e.g., "example.com.", "local.", etc.
-<dt><b>IPPFIND_SERVICE_HOSTNAME</b>
-<dd style="margin-left: 5.0em">Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
-<dt><b>IPPFIND_SERVICE_NAME</b>
-<dd style="margin-left: 5.0em">Service instance name, e.g., "My Fine Printer".
-<dt><b>IPPFIND_SERVICE_PORT</b>
-<dd style="margin-left: 5.0em">Port number for server, typically 631 for IPP and 80 for HTTP.
-<dt><b>IPPFIND_SERVICE_REGTYPE</b>
-<dd style="margin-left: 5.0em">DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
-<dt><b>IPPFIND_SERVICE_SCHEME</b>
-<dd style="margin-left: 5.0em">URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
-<dt><b>IPPFIND_SERVICE_URI</b>
-<dd style="margin-left: 5.0em">URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./"">http://printer.local./"</a>, etc.
-<dt><b>IPPFIND_TXT_fIKEYfR</b>
-<dd style="margin-left: 5.0em">Values of TXT record <i>KEY</i> (uppercase).
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-To show the status of all registered IPP printers on your network, run:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V </strong><em>version</em><br>
+Specifies the IPP version when listing.
+Supported values are "1.1", "2.0", "2.1", and "2.2".
+</p>
+ <h2 id="ippfind-1.exit-status">Exit Status</h2>
+<p><strong>ippfind</strong> returns 0 if the result for all processed expressions is true, 1 if the result of any processed expression is false, 2 if browsing or any query or resolution failed, 3 if an undefined option or invalid expression was specified, and 4 if it ran out of memory.
+</p>
+ <h2 id="ippfind-1.environment">Environment</h2>
+<p>When executing a program, <strong>ippfind</strong> sets the following environment variables for the matching service registration:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_DOMAIN</strong><br>
+Domain name, e.g., "example.com.", "local.", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_HOSTNAME</strong><br>
+Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_NAME</strong><br>
+Service instance name, e.g., "My Fine Printer".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_PORT</strong><br>
+Port number for server, typically 631 for IPP and 80 for HTTP.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_REGTYPE</strong><br>
+DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_SCHEME</strong><br>
+URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_URI</strong><br>
+URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./"">http://printer.local./"</a>, etc.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_TXT_</strong><em>KEY</em><br>
+Values of TXT record <em>KEY</em> (uppercase).
+</p>
+ <h2 id="ippfind-1.examples">Examples</h2>
+<p>To show the status of all registered IPP printers on your network, run:
+</p>
+ <pre>
ippfind --ls
</pre>
-Similarly, to send a PostScript test page to every PostScript printer, run:
-<pre class="man">
+<p>Similarly, to send a PostScript test page to every PostScript printer, run:
+</p>
+ <pre>
ippfind --txt-pdl application/postscript --exec ipptool
-f onepage-letter.ps '{}' print-job.test \;
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1)</a>
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+ <h2 id="ippfind-1.see-also">See Also</h2>
+<p><strong>ipptool</strong>(1)
-</body>
+</p>
+ <h2 id="ippfind-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ipptool(1)</title>
-</head>
-<body>
-<h1 class="title">ipptool(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ipptool - perform internet printing protocol requests
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ipptool</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ipptool(1)</title>
+ </head>
+ <body>
+ <h1 id="ipptool-1">ipptool(1)</h1>
+ <h2 id="ipptool-1.name">Name</h2>
+<p>ipptool - perform internet printing protocol requests
+</p>
+ <h2 id="ipptool-1.synopsis">Synopsis</h2>
+<p><strong>ipptool</strong>
[
-<b>--help</b>
+<strong>--help</strong>
] [
-<b>--ippserver</b>
-<i>filename</i>
+<strong>--ippserver</strong>
+<em>filename</em>
] [
-<b>--stop-after-include-error</b>
+<strong>--stop-after-include-error</strong>
] [
-<b>--version</b>
+<strong>--version</strong>
] [
-<b>-4</b>
+<strong>-4</strong>
] [
-<b>-6</b>
+<strong>-6</strong>
] [
-<b>-C</b>
+<strong>-C</strong>
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-I</b>
+<strong>-I</strong>
] [
-<b>-L</b>
+<strong>-L</strong>
] [
-<b>-P</b>
-<i>filename.plist</i>
+<strong>-P</strong>
+<em>filename.plist</em>
] [
-<b>-S</b>
+<strong>-S</strong>
] [
-<b>-T</b>
-<i>seconds</i>
+<strong>-T</strong>
+<em>seconds</em>
] [
-<b>-V</b>
-<i>version</i>
+<strong>-V</strong>
+<em>version</em>
] [
-<b>-X</b>
+<strong>-X</strong>
] [
-<b>-c</b>
+<strong>-c</strong>
] [
-<b>-d</b>
-<i>name=value</i>
+<strong>-d</strong>
+<em>name=value</em>
] [
-<b>-f</b>
-<i>filename</i>
+<strong>-f</strong>
+<em>filename</em>
] [
-<b>-h</b>
+<strong>-h</strong>
] [
-<b>-i</b>
-<i>seconds</i>
+<strong>-i</strong>
+<em>seconds</em>
] [
-<b>-j</b>
+<strong>-j</strong>
] [
-<b>-n</b>
-<i>repeat-count</i>
+<strong>-n</strong>
+<em>repeat-count</em>
] [
-<b>-q</b>
+<strong>-q</strong>
] [
-<b>-t</b>
+<strong>-t</strong>
] [
-<b>-v</b><b>]</b>
-<i>printer-uri</i>
-<i>testfile</i>
+<strong>-v ]</strong>
+<em>printer-uri</em>
+<em>testfile</em>
[ ...
-<i>testfile</i>
+<em>testfile</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ipptool</b>
+</p>
+ <h2 id="ipptool-1.description">Description</h2>
+<p><strong>ipptool</strong>
sends IPP requests to the specified
-<i>printer-uri</i>
+<em>printer-uri</em>
and tests and/or displays the results.
Each named
-<i>testfile</i>
+<em>testfile</em>
defines one or more requests, including the expected response status, attributes, and values.
Output is either a plain text, formatted text, CSV, or XML report on the standard output, with a non-zero exit status indicating that one or more tests have failed.
The
-<i>testfile</i>
+<em>testfile</em>
format is described in
-<a href="man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile</b>(5).</a>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by
-<b>ipptool:</b>
-<dl class="man">
-<dt><b>--help</b>
-<dd style="margin-left: 5.0em">Shows program help.
-<dt><b>--ippserver </b><i>filename</i>
-<dd style="margin-left: 5.0em">Specifies that the test results should be written to the named
-<b>ippserver</b>
+<strong>ipptoolfile</strong>(5).
+
+</p>
+ <h2 id="ipptool-1.options">Options</h2>
+<p>The following options are recognized by
+<strong>ipptool:</strong>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Shows program help.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--ippserver </strong><em>filename</em><br>
+Specifies that the test results should be written to the named
+<strong>ippserver</strong>
attributes file.
-<dt><b>--stop-after-include-error</b>
-<dd style="margin-left: 5.0em">Tells
-<b>ipptool</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--stop-after-include-error</strong><br>
+Tells
+<strong>ipptool</strong>
to stop if an error occurs in an included file. Normally
-<b>ipptool</b>
+<strong>ipptool</strong>
will continue with subsequent tests after the INCLUDE directive.
-<dt><b>--version</b>
-<dd style="margin-left: 5.0em">Shows the version of
-<b>ipptool</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Shows the version of
+<strong>ipptool</strong>
being used.
-<dt><b>-4</b>
-<dd style="margin-left: 5.0em">Specifies that
-<b>ipptool</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-4</strong><br>
+Specifies that
+<strong>ipptool</strong>
must connect to the printer or server using IPv4.
-<dt><b>-6</b>
-<dd style="margin-left: 5.0em">Specifies that
-<b>ipptool</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-6</strong><br>
+Specifies that
+<strong>ipptool</strong>
must connect to the printer or server using IPv6.
-<dt><b>-C</b>
-<dd style="margin-left: 5.0em">Specifies that requests should be sent using the HTTP/1.1 "Transfer-Encoding: chunked" header, which is required for conformance by all versions of IPP.
-The default is to use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
-<dt><b>-I</b>
-<dd style="margin-left: 5.0em">Specifies that
-<b>ipptool</b>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-C</strong><br>
+Specifies that requests should be sent using the HTTP/1.1 "Transfer-Encoding: chunked" header, which is required for conformance by all versions of IPP.
+The default is to use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I</strong><br>
+Specifies that
+<strong>ipptool</strong>
will continue past errors.
-<dt><b>-L</b>
-<dd style="margin-left: 5.0em">Specifies that requests should be sent using the HTTP/1.0 "Content-Length:" header, which is required for conformance by all versions of IPP.
-The default is to use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
-<dt><b>-P</b><i> filename.plist</i>
-<dd style="margin-left: 5.0em">Specifies that the test results should be written to the named XML (Apple plist) file in addition to the regular test report (<b>-t</b>).
-This option is incompatible with the <b>-i</b> (interval) and <b>-n</b> (repeat-count) options.
-<dt><b>-S</b>
-<dd style="margin-left: 5.0em">Forces (dedicated) TLS encryption when connecting to the server.
-<dt><b>-T</b><i> seconds</i>
-<dd style="margin-left: 5.0em">Specifies a timeout for IPP requests in seconds.
-<dt><b>-V</b><i> version</i>
-<dd style="margin-left: 5.0em">Specifies the default IPP version to use: 1.0, 1.1, 2.0, 2.1, or 2.2. If not specified, version 1.1 is used.
-<dt><b>-X</b>
-<dd style="margin-left: 5.0em">Specifies that XML (Apple plist) output is desired instead of the plain text report.
-This option is incompatible with the <b>-i</b> (interval) and <b>-n</b> (repeat-count) options.
-<dt><b>-c</b>
-<dd style="margin-left: 5.0em">Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
-<dt><b>-d</b><i> name=value</i>
-<dd style="margin-left: 5.0em">Defines the named variable.
-<dt><b>-f</b><i> filename</i>
-<dd style="margin-left: 5.0em">Defines the default request filename for tests.
-<dt><b>-h</b>
-<dd style="margin-left: 5.0em">Validate HTTP response headers.
-<dt><b>-i</b><i> seconds</i>
-<dd style="margin-left: 5.0em">Specifies that the (last)
-<i>testfile</i>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-L</strong><br>
+Specifies that requests should be sent using the HTTP/1.0 "Content-Length:" header, which is required for conformance by all versions of IPP.
+The default is to use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P</strong><em> filename.plist</em>
+<br>
+Specifies that the test results should be written to the named XML (Apple plist) file in addition to the regular test report (<strong>-t</strong>).
+This option is incompatible with the <strong>-i</strong> (interval) and <strong>-n</strong> (repeat-count) options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-S</strong><br>
+Forces (dedicated) TLS encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-T</strong><em> seconds</em>
+<br>
+Specifies a timeout for IPP requests in seconds.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V</strong><em> version</em>
+<br>
+Specifies the default IPP version to use: 1.0, 1.1, 2.0, 2.1, or 2.2. If not specified, version 1.1 is used.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-X</strong><br>
+Specifies that XML (Apple plist) output is desired instead of the plain text report.
+This option is incompatible with the <strong>-i</strong> (interval) and <strong>-n</strong> (repeat-count) options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c</strong><br>
+Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d</strong><em> name=value</em>
+<br>
+Defines the named variable.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-f</strong><em> filename</em>
+<br>
+Defines the default request filename for tests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h</strong><br>
+Validate HTTP response headers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i</strong><em> seconds</em>
+<br>
+Specifies that the (last)
+<em>testfile</em>
should be repeated at the specified interval.
-This option is incompatible with the <b>-X</b> (XML plist output) option.
-<dt><b>-j</b>
-<dd style="margin-left: 5.0em">Specifies that
-<b>ipptool</b>
+This option is incompatible with the <strong>-X</strong> (XML plist output) option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-j</strong><br>
+Specifies that
+<strong>ipptool</strong>
will produce JSON output.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Specifies that plain text output is desired.
-<dt><b>-n</b><i> repeat-count</i>
-<dd style="margin-left: 5.0em">Specifies that the (last)
-<i>testfile</i>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Specifies that plain text output is desired.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n</strong><em> repeat-count</em>
+<br>
+Specifies that the (last)
+<em>testfile</em>
should be repeated the specified number of times.
-This option is incompatible with the <i>-X</i> (XML plist output) option.
-<dt><b>-q</b>
-<dd style="margin-left: 5.0em">Be quiet and produce no output.
-<dt><b>-t</b>
-<dd style="margin-left: 5.0em">Specifies that CUPS test report output is desired instead of the plain text output.
-<dt><b>-v</b>
-<dd style="margin-left: 5.0em">Specifies that all request and response attributes should be output in CUPS test mode (<b>-t</b>).
+This option is incompatible with the <em>-X</em> (XML plist output) option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-q</strong><br>
+Be quiet and produce no output.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t</strong><br>
+Specifies that CUPS test report output is desired instead of the plain text output.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v</strong><br>
+Specifies that all request and response attributes should be output in CUPS test mode (<strong>-t</strong>).
This is the default for XML output.
-</dl>
-<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
-The
-<b>ipptool</b>
+</p>
+ <h2 id="ipptool-1.exit-status">Exit Status</h2>
+<p>The
+<strong>ipptool</strong>
program returns 0 if all tests were successful and 1 otherwise.
-<h2 class="title"><a name="FILES">Files</a></h2>
-The following standard files are available:
-<pre class="man">
+</p>
+ <h2 id="ipptool-1.files">Files</h2>
+<p>The following standard files are available:
+</p>
+ <pre>
color.jpg
create-printer-subscription.test
document-a4.pdf
testfile.txt
validate-job.test
</pre>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The
-<b>ipptool</b>
+ <h2 id="ipptool-1.conforming-to">Conforming To</h2>
+<p>The
+<strong>ipptool</strong>
program is unique to CUPS and conforms to the Internet Printing Protocol up to version 2.2.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Get a list of completed jobs for "myprinter":
-<pre class="man">
+</p>
+ <h2 id="ipptool-1.examples">Examples</h2>
+<p>Get a list of completed jobs for "myprinter":
+</p>
+ <pre>
ipptool ipp://localhost/printers/myprinter get-completed-jobs.test
</pre>
-<p>Send email notifications to "user@example.com" when "myprinter" changes:
-<pre class="man">
+ <p>Send email notifications to "user@example.com" when "myprinter" changes:
+</p>
+ <pre>
ipptool -d recipient=mailto:user@example.com \
ipp://localhost/printers/myprinter create-printer-subscription.test
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile</b>(5),</a>
+ <h2 id="ipptool-1.see-also">See Also</h2>
+<p><strong>ipptoolfile</strong>(5),
+
IANA IPP Registry (<a href="https://www.iana.org/assignments/ipp-registrations">https://www.iana.org/assignments/ipp-registrations</a>),
PWG Internet Printing Protocol Workgroup (<a href="https://www.pwg.org/ipp">https://www.pwg.org/ipp</a>)
RFC 8011 (<a href="https://datatracker.ietf.org/doc/html/rfc8011">https://datatracker.ietf.org/doc/html/rfc8011</a>),
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="ipptool-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ipptoolfile(5)</title>
-</head>
-<body>
-<h1 class="title">ipptoolfile(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ipptoolfile - ipptool file format
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1)</a>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ipptoolfile(5)</title>
+ </head>
+ <body>
+ <h1 id="ipptoolfile-5">ipptoolfile(5)</h1>
+ <h2 id="ipptoolfile-5.name">Name</h2>
+<p>ipptoolfile - ipptool file format
+</p>
+ <h2 id="ipptoolfile-5.description">Description</h2>
+<p>The
+<strong>ipptool</strong>(1)
+
program accepts free-form plain text files that describe one or more IPP requests.
-Comments start with the "#" character and continue to the end of the line.
+Comments start with the "#" character and continue to the end of the line.
Each request is enclosed by curly braces, for example:
-<pre class="man">
+</p>
+ <pre>
# This is a comment
{
# The name of the test
- NAME "Print PDF File"
+ NAME "Print PDF File"
# The request to send
OPERATION Print-Job
GROUP job-attributes-tag
ATTR collection media-col {
- # US Letter plain paper from the "main" tray
+ # US Letter plain paper from the "main" tray
MEMBER collection media-size {
MEMBER integer x-dimension 21590
MEMBER integer y-dimension 27940
MEMBER integer media-bottom-margin 423
MEMBER integer media-left-margin 423
MEMBER integer media-right-margin 423
- MEMBER keyword media-source "main"
- MEMBER keyword media-type "stationery"
+ MEMBER keyword media-source "main"
+ MEMBER keyword media-type "stationery"
}
FILE testfile.pdf
}
{
# The name of the test
- NAME "Wait for Job to Complete"
+ NAME "Wait for Job to Complete"
# The request to send
OPERATION Get-Job-Attributes
EXPECT job-id OF-TYPE integer WITH-VALUE $job-id
EXPECT job-uri OF-TYPE uri
EXPECT job-state OF-TYPE enum WITH-VALUE >5 REPEAT-NO-MATCH
- EXPECT job-originating-user-name OF-TYPE name WITH-VALUE "$user"
+ EXPECT job-originating-user-name OF-TYPE name WITH-VALUE "$user"
# Show the job state until completed...
DISPLAY job-state
DISPLAY job-state-reasons
}
</pre>
-<h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3>
-The following directives can be used outside of a <i>test</i>:
-<dl class="man">
-<dt><b>{ </b><i>test </i><b>}</b>
-<dd style="margin-left: 5.0em">Defines a test.
-<dt><b>DEFINE </b><i>variable-name value</i>
-<dd style="margin-left: 5.0em">Defines the named variable to the given value. This is equivalent to specifying <i>-d variable-name=value</i> on the
-<b>ipptool</b>(8)
+ <h3 id="ipptoolfile-5.description.top-level-directives">Top-Level Directives</h3>
+<p>The following directives can be used outside of a <em>test</em>:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{ </strong><em>test </em><strong>}</strong><br>
+Defines a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE </strong><em>variable-name value</em><br>
+Defines the named variable to the given value. This is equivalent to specifying <em>-d variable-name=value</em> on the
+<strong>ipptool</strong>(8)
+
command-line.
-<dt><b>DEFINE-DEFAULT </b><i>variable-name value</i>
-<dd style="margin-left: 5.0em">Defines the named variable to the given value if it does not already have a value.
-<dt><b>FILE-ID "</b><i>identifier</i><b>"</b>
-<dd style="margin-left: 5.0em">Specifies an identifier string for the current file.
-<dt><b>IGNORE-ERRORS yes</b>
-<dd style="margin-left: 5.0em"><dt><b>IGNORE-ERRORS no</b>
-<dd style="margin-left: 5.0em">Specifies whether, by default,
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-DEFAULT </strong><em>variable-name value</em><br>
+Defines the named variable to the given value if it does not already have a value.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FILE-ID "</strong><em>identifier</em><strong>"</strong><br>
+Specifies an identifier string for the current file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IGNORE-ERRORS yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IGNORE-ERRORS no</strong><br>
+Specifies whether, by default,
+<strong>ipptool</strong>(8)
+
will ignore errors and continue with subsequent tests.
-<dt><b>INCLUDE "</b><i>filename</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>INCLUDE <</b><i>filename</i><b>></b>
-<dd style="margin-left: 5.0em">Includes another test file. The first form includes a file relative to the current test file, while the second form includes a file from the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE "</strong><em>filename</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE <</strong><em>filename</em><strong>></strong><br>
+Includes another test file. The first form includes a file relative to the current test file, while the second form includes a file from the
+<strong>ipptool</strong>(8)
+
include directory.
-<dt><b>INCLUDE-IF-DEFINED </b><i>name </i><b>"</b><i>filename</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>INCLUDE-IF-DEFINED </b><i>name </i><b><</b><i>filename</i><b>></b>
-<dd style="margin-left: 5.0em">Includes another test file if the named variable is defined. The first form includes a file relative to the current test file, while the second form includes a file from the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE-IF-DEFINED </strong><em>name </em><strong>"</strong><em>filename</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE-IF-DEFINED </strong><em>name </em><strong><</strong><em>filename</em><strong>></strong><br>
+Includes another test file if the named variable is defined. The first form includes a file relative to the current test file, while the second form includes a file from the
+<strong>ipptool</strong>(8)
+
include directory.
-<dt><b>INCLUDE-IF-NOT-DEFINED </b><i>name </i><b>"</b><i>filename</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>INCLUDE-IF-NOT-DEFINED </b><i>name </i><b><</b><i>filename</i><b>></b>
-<dd style="margin-left: 5.0em">Includes another test file if the named variable is not defined. The first form includes a file relative to the current test file, while the second form includes a file from the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE-IF-NOT-DEFINED </strong><em>name </em><strong>"</strong><em>filename</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INCLUDE-IF-NOT-DEFINED </strong><em>name </em><strong><</strong><em>filename</em><strong>></strong><br>
+Includes another test file if the named variable is not defined. The first form includes a file relative to the current test file, while the second form includes a file from the
+<strong>ipptool</strong>(8)
+
include directory.
-<dt><b>SKIP-IF-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em"><dt><b>SKIP-IF-NOT-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Specifies that the remainder of the test file should be skipped when the variable is or is not defined.
-<dt><b>STOP-AFTER-INCLUDE-ERROR no</b>
-<dd style="margin-left: 5.0em"><dt><b>STOP-AFTER-INCLUDE-ERROR yes</b>
-<dd style="margin-left: 5.0em">Specifies whether tests will be stopped after an error in an included file.
-<dt><b>TRANSFER auto</b>
-<dd style="margin-left: 5.0em">Specifies that tests will, by default, use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
-<dt><b>TRANSFER chunked</b>
-<dd style="margin-left: 5.0em">Specifies that tests will, by default, use the HTTP/1.1 "Transfer-Encoding: chunked" header. This is the default and is equivalent to specifying <i>-c</i> on the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-IF-DEFINED </strong><em>variable-name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-IF-NOT-DEFINED </strong><em>variable-name</em><br>
+Specifies that the remainder of the test file should be skipped when the variable is or is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STOP-AFTER-INCLUDE-ERROR no</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STOP-AFTER-INCLUDE-ERROR yes</strong><br>
+Specifies whether tests will be stopped after an error in an included file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER auto</strong><br>
+Specifies that tests will, by default, use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER chunked</strong><br>
+Specifies that tests will, by default, use the HTTP/1.1 "Transfer-Encoding: chunked" header. This is the default and is equivalent to specifying <em>-c</em> on the
+<strong>ipptool</strong>(8)
+
command-line. Support for chunked requests is required for conformance with all versions of IPP.
-<dt><b>TRANSFER length</b>
-<dd style="margin-left: 5.0em">Specifies that tests will, by default, use the HTTP/1.0 "Content-Length:" header. This is equivalent to specifying <i>-l</i> on the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER length</strong><br>
+Specifies that tests will, by default, use the HTTP/1.0 "Content-Length:" header. This is equivalent to specifying <em>-l</em> on the
+<strong>ipptool</strong>(8)
+
command-line. Support for content length requests is required for conformance with all versions of IPP.
-<dt><b>VERSION 1.0</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 1.1</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.0</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.1</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.2</b>
-<dd style="margin-left: 5.0em">Specifies the default IPP version number to use for the tests that follow.
-</dl>
-<h3><a name="TEST_DIRECTIVES">Test Directives</a></h3>
-The following directives are understood within a <i>test</i>:
-<dl class="man">
-<dt><b>ATTR </b><i>out-of-band-tag attribute-name</i>
-<dd style="margin-left: 5.0em"><dt><b>ATTR </b><i>tag attribute-name value(s)</i>
-<dd style="margin-left: 5.0em">Adds an attribute to the test request.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 1.0</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 1.1</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.0</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.1</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.2</strong><br>
+Specifies the default IPP version number to use for the tests that follow.
+</p>
+ <h3 id="ipptoolfile-5.description.test-directives">Test Directives</h3>
+<p>The following directives are understood within a <em>test</em>:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR </strong><em>out-of-band-tag attribute-name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR </strong><em>tag attribute-name value(s)</em><br>
+Adds an attribute to the test request.
Out-of-band tags (admin-define, delete-attribute, no-value, not-settable, unknown, unsupported) have no value.
-Values for other tags are delimited by the comma (",") character - escape commas using the "\" character.
+Values for other tags are delimited by the comma (",") character - escape commas using the "\" character.
Common attributes and values are listed in the IANA IPP registry - see references below.
-<dt><b>ATTR collection </b><i>attribute-name </i><b>{ MEMBER </b><i>tag member-name value(s) ... </i><b>}</b> [ <i>... </i><b>,{ </b><i>... </i><b>} </b>]
-<dd style="margin-left: 5.0em">Adds a collection attribute to the test request.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR collection </strong><em>attribute-name </em><strong>{ MEMBER </strong><em>tag member-name value(s) ... </em><strong>}</strong> [ <em>... </em><strong>,{ </strong><em>... </em><strong>} </strong>]<br>
+Adds a collection attribute to the test request.
Member attributes follow the same syntax as regular attributes and can themselves be nested collections.
Multiple collection values can be supplied as needed, separated by commas.
-<dt><b>COMPRESSION deflate</b>
-<dd style="margin-left: 5.0em"><dt><b>COMPRESSION gzip</b>
-<dd style="margin-left: 5.0em"><dt><b>COMPRESSION none</b>
-<dd style="margin-left: 5.0em">Uses the specified compression on the document data following the attributes in a Print-Job or Send-Document request.
-<dt><b>DELAY </b><i>seconds</i>[<i>,repeat-seconds</i>]
-<dd style="margin-left: 5.0em">Specifies a delay in seconds before this test will be run.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>COMPRESSION deflate</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>COMPRESSION gzip</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>COMPRESSION none</strong><br>
+Uses the specified compression on the document data following the attributes in a Print-Job or Send-Document request.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DELAY </strong><em>seconds</em>[<em>,repeat-seconds</em>]<br>
+Specifies a delay in seconds before this test will be run.
If two values are specified, the second value is used as the delay between repeated tests.
A default repeat interval of 5 seconds is used if this directive is not provided.
-<dt><b>DISPLAY </b><i>attribute-name</i>
-<dd style="margin-left: 5.0em">Specifies that value of the named attribute should be output as part of the
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DISPLAY </strong><em>attribute-name</em><br>
+Specifies that value of the named attribute should be output as part of the
test report.
-<dt><b>EXPECT </b><i>attribute-name </i>[ <i>predicate(s) </i>]
-<dd style="margin-left: 5.0em"><dt><b>EXPECT ?</b><i>attribute-name predicate(s)</i>
-<dd style="margin-left: 5.0em"><dt><b>EXPECT !</b><i>attribute-name</i>
-<dd style="margin-left: 5.0em">Specifies that the response must/may/must not include the named attribute. Additional requirements can be added as predicates - see the "EXPECT PREDICATES" section for more information on predicates. Attribute names can specify member attributes by separating the attribute and member names with the forward slash, for example "media-col/media-size/x-dimension".
-<dt><b>EXPECT-ALL </b><i>attribute-name </i>[ <i>predicate(s) </i>]
-<dd style="margin-left: 5.0em"><dt><b>EXPECT-ALL ?</b><i>attribute-name predicate(s)</i>
-<dd style="margin-left: 5.0em">Specifies that the response must/may include the named attribute and that all occurrences of that attribute must match the given predicates.
-<dt><b>FILE filename</b>
-<dd style="margin-left: 5.0em">Specifies a file to include at the end of the request. This is typically used when sending a test print file.
-<dt><b>GROUP tag</b>
-<dd style="margin-left: 5.0em">Specifies the group tag for subsequent attributes in the request.
-<dt><b>IGNORE-ERRORS yes</b>
-<dd style="margin-left: 5.0em"><dt><b>IGNORE-ERRORS no</b>
-<dd style="margin-left: 5.0em">Specifies whether
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EXPECT </strong><em>attribute-name </em>[ <em>predicate(s) </em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EXPECT ?</strong><em>attribute-name predicate(s)</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EXPECT !</strong><em>attribute-name</em><br>
+Specifies that the response must/may/must not include the named attribute. Additional requirements can be added as predicates - see the "EXPECT PREDICATES" section for more information on predicates. Attribute names can specify member attributes by separating the attribute and member names with the forward slash, for example "media-col/media-size/x-dimension".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EXPECT-ALL </strong><em>attribute-name </em>[ <em>predicate(s) </em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>EXPECT-ALL ?</strong><em>attribute-name predicate(s)</em><br>
+Specifies that the response must/may include the named attribute and that all occurrences of that attribute must match the given predicates.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FILE filename</strong><br>
+Specifies a file to include at the end of the request. This is typically used when sending a test print file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>GROUP tag</strong><br>
+Specifies the group tag for subsequent attributes in the request.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IGNORE-ERRORS yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IGNORE-ERRORS no</strong><br>
+Specifies whether
+<strong>ipptool</strong>(8)
+
will ignore errors and continue with subsequent tests.
-<dt><b>MONITOR-PRINTER-STATE </b>[ <i>printer-uri </i>] <b>{ EXPECT </b><i>attribute-name </i>[ <i>predicate(s) </i>] <b>}</b>
-<dd style="margin-left: 5.0em">Specifies printer state monitoring tests to run in parallel with the test operation.
-The monitoring tests will run until all of the <b>EXPECT</b> conditions are satisfied or the primary test operation has completed, whichever occurs first.
-<dt><b>NAME "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em">Specifies the human-readable name of the test.
-<dt><b>OPERATION </b><i>operation-code</i>
-<dd style="margin-left: 5.0em">Specifies the operation to be performed.
-<dt><b>PASS-IF-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em"><dt><b>PASS-IF-NOT-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Specifies that the current test should be passed automatically when the variable is or is not defined.
-<dt><b>PAUSE "</b><i>message</i><b>"</b>
-<dd style="margin-left: 5.0em">Displays the provided message and waits for the user to press a key to continue.
-<dt><b>REQUEST-ID </b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>REQUEST-ID random</b>
-<dd style="margin-left: 5.0em">Specifies the request-id value to use in the request, either an integer or the word "random" to use a randomly generated value (the default).
-<dt><b>RESOURCE </b><i>path</i>
-<dd style="margin-left: 5.0em">Specifies an alternate resource path that is used for the HTTP POST request. The default is the resource from the URI provided to the
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MONITOR-PRINTER-STATE </strong>[ <em>printer-uri </em>] <strong>{ EXPECT </strong><em>attribute-name </em>[ <em>predicate(s) </em>] <strong>}</strong><br>
+Specifies printer state monitoring tests to run in parallel with the test operation.
+The monitoring tests will run until all of the <strong>EXPECT</strong> conditions are satisfied or the primary test operation has completed, whichever occurs first.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>NAME "</strong><em>literal string</em><strong>"</strong><br>
+Specifies the human-readable name of the test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>OPERATION </strong><em>operation-code</em><br>
+Specifies the operation to be performed.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PASS-IF-DEFINED </strong><em>variable-name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PASS-IF-NOT-DEFINED </strong><em>variable-name</em><br>
+Specifies that the current test should be passed automatically when the variable is or is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PAUSE "</strong><em>message</em><strong>"</strong><br>
+Displays the provided message and waits for the user to press a key to continue.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REQUEST-ID </strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REQUEST-ID random</strong><br>
+Specifies the request-id value to use in the request, either an integer or the word "random" to use a randomly generated value (the default).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>RESOURCE </strong><em>path</em><br>
+Specifies an alternate resource path that is used for the HTTP POST request. The default is the resource from the URI provided to the
+<strong>ipptool</strong>(8)
+
program.
-<dt><b>SKIP-IF-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em"><dt><b>SKIP-IF-NOT-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Specifies that the current test should be skipped when the variable is or is not defined.
-<dt><b>SKIP-PREVIOUS-ERROR yes</b>
-<dd style="margin-left: 5.0em"><dt><b>SKIP-PREVIOUS-ERROR no</b>
-<dd style="margin-left: 5.0em">Specifies whether
-<b>ipptool</b>(8)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-IF-DEFINED </strong><em>variable-name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-IF-NOT-DEFINED </strong><em>variable-name</em><br>
+Specifies that the current test should be skipped when the variable is or is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-PREVIOUS-ERROR yes</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SKIP-PREVIOUS-ERROR no</strong><br>
+Specifies whether
+<strong>ipptool</strong>(8)
+
will skip the current test if the previous test resulted in an error/failure.
-<dt><b>STATUS </b><i>status-code </i>[ <i>predicate</i> ]
-<dd style="margin-left: 5.0em">Specifies an expected response status-code value. Additional requirements can be added as predicates - see the "STATUS PREDICATES" section for more information on predicates.
-<dt><b>TEST-ID "</b><i>identifier</i>"
-<dd style="margin-left: 5.0em">Specifies an identifier string for the current test.
-<dt><b>TRANSFER auto</b>
-<dd style="margin-left: 5.0em">Specifies that this test will use "Transfer-Encoding: chunked" if it has an attached file or "Content-Length:" otherwise.
-<dt><b>TRANSFER chunked</b>
-<dd style="margin-left: 5.0em">Specifies that this test will use the HTTP/1.1 "Transfer-Encoding: chunked" header.
-<dt><b>TRANSFER length</b>
-<dd style="margin-left: 5.0em">Specifies that this test will use the HTTP/1.0 "Content-Length:" header.
-<dt><b>VERSION 1.0</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 1.1</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.0</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.1</b>
-<dd style="margin-left: 5.0em"><dt><b>VERSION 2.2</b>
-<dd style="margin-left: 5.0em">Specifies the IPP version number to use for this test.
-</dl>
-<h3><a name="EXPECT_PREDICATES">Expect Predicates</a></h3>
-The following predicates are understood following the <b>EXPECT</b> test directive:
-<dl class="man">
-<dt><b>COUNT </b><i>number</i>
-<dd style="margin-left: 5.0em">Requires the <b>EXPECT</b> attribute to have the specified number of values.
-<dt><b>DEFINE-MATCH </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Defines the variable to "1" when the <b>EXPECT</b> condition matches.
-A side-effect of this predicate is that this <b>EXPECT</b> will never fail a test.
-<dt><b>DEFINE-NO-MATCH </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Defines the variable to "1" when the <b>EXPECT</b> condition does not match.
-A side-effect of this predicate is that this <b>EXPECT</b> will never fail a test.
-<dt><b>DEFINE-VALUE </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Defines the variable to the value of the attribute when the <b>EXPECT</b> condition matches.
-A side-effect of this predicate is that this <b>EXPECT</b> will never fail a test.
-<dt><b>DISPLAY-MATCH </b><i>"message"</i>
-<dd style="margin-left: 5.0em">Displays the specified message when the <b>EXPECT</b> condition matches.
-<dt><b>IF-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Makes the <b>EXPECT</b> conditions apply only if the specified variable is defined.
-<dt><b>IF-NOT-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Makes the <b>EXPECT</b> conditions apply only if the specified variable is not defined.
-<dt><b>IN-GROUP </b><i>tag</i>
-<dd style="margin-left: 5.0em">Requires the <b>EXPECT</b> attribute to be in the specified group tag.
-<dt><b>OF-TYPE </b><i>tag[(limits)|tag|...]</i>
-<dd style="margin-left: 5.0em">Requires the <b>EXPECT</b> attribute to use one of the specified value tag(s).
-Most value tags also support the specification of limits in parenthesis, for example "name(42)" would allow nameWith/WithoutLanguage strings up to 42 octets in length, "name(4:MAX)" would allow nameWith/WithoutLanguage strings between 4 and 255 octets in length, and "integer(-273:MAX)" would allow integers between -273 and 2147483647.
-<dt><b>REPEAT-LIMIT </b><i>number</i>
-<dd style="margin-left: 5.0em"><br>
-Specifies the maximum number of times to repeat if the <b>REPEAT-MATCH</b> or <b>REPEAT-NO-MATCH</b> predicate is specified. The default value is 1000.
-<dt><b>REPEAT-MATCH</b>
-<dd style="margin-left: 5.0em"><dt><b>REPEAT-NO-MATCH</b>
-<dd style="margin-left: 5.0em">Specifies that the current test should be repeated when the <b>EXPECT</b> condition matches or does not match.
-<dt><b>SAME-COUNT-AS </b><i>attribute-name</i>
-<dd style="margin-left: 5.0em">Requires the <b>EXPECT</b> attribute to have the same number of values as the specified parallel attribute.
-<dt><b>WITH-ALL-HOSTNAMES "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-HOSTNAMES "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that all URI values contain a matching hostname.
-<dt><b>WITH-ALL-RESOURCES "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-RESOURCES "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that all URI values contain a matching resource (including leading /).
-<dt><b>WITH-ALL-SCHEMES "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-SCHEMES "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that all URI values contain a matching scheme.
-<dt><b>WITH-ALL-VALUES "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em">Requires that all values of the <b>EXPECT</b> attribute match the literal string. Comparisons are case-sensitive.
-<dt><b>WITH-ALL-VALUES <</b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-VALUES =</b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-VALUES ></b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-VALUES </b><i>number</i>[<i>,...,number</i>]
-<dd style="margin-left: 5.0em">Requires that all values of the <b>EXPECT</b> attribute match the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
-<dt><b>WITH-ALL-VALUES "false"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-ALL-VALUES "true"</b>
-<dd style="margin-left: 5.0em">Requires that all values of the <b>EXPECT</b> attribute match the boolean value given.
-<dt><b>WITH-ALL-VALUES "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that all values of the <b>EXPECT</b> attribute match the regular expression, which must conform to the POSIX regular expression syntax.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATUS </strong><em>status-code </em>[ <em>predicate</em> ]<br>
+Specifies an expected response status-code value. Additional requirements can be added as predicates - see the "STATUS PREDICATES" section for more information on predicates.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TEST-ID "</strong><em>identifier</em>"<br>
+Specifies an identifier string for the current test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER auto</strong><br>
+Specifies that this test will use "Transfer-Encoding: chunked" if it has an attached file or "Content-Length:" otherwise.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER chunked</strong><br>
+Specifies that this test will use the HTTP/1.1 "Transfer-Encoding: chunked" header.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>TRANSFER length</strong><br>
+Specifies that this test will use the HTTP/1.0 "Content-Length:" header.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 1.0</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 1.1</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.0</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.1</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VERSION 2.2</strong><br>
+Specifies the IPP version number to use for this test.
+</p>
+ <h3 id="ipptoolfile-5.description.expect-predicates">Expect Predicates</h3>
+<p>The following predicates are understood following the <strong>EXPECT</strong> test directive:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>COUNT </strong><em>number</em><br>
+Requires the <strong>EXPECT</strong> attribute to have the specified number of values.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-MATCH </strong><em>variable-name</em><br>
+Defines the variable to "1" when the <strong>EXPECT</strong> condition matches.
+A side-effect of this predicate is that this <strong>EXPECT</strong> will never fail a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-NO-MATCH </strong><em>variable-name</em><br>
+Defines the variable to "1" when the <strong>EXPECT</strong> condition does not match.
+A side-effect of this predicate is that this <strong>EXPECT</strong> will never fail a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-VALUE </strong><em>variable-name</em><br>
+Defines the variable to the value of the attribute when the <strong>EXPECT</strong> condition matches.
+A side-effect of this predicate is that this <strong>EXPECT</strong> will never fail a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DISPLAY-MATCH </strong><em>"message"</em><br>
+Displays the specified message when the <strong>EXPECT</strong> condition matches.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IF-DEFINED </strong><em>variable-name</em><br>
+Makes the <strong>EXPECT</strong> conditions apply only if the specified variable is defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IF-NOT-DEFINED </strong><em>variable-name</em><br>
+Makes the <strong>EXPECT</strong> conditions apply only if the specified variable is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IN-GROUP </strong><em>tag</em><br>
+Requires the <strong>EXPECT</strong> attribute to be in the specified group tag.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>OF-TYPE </strong><em>tag[(limits)|tag|...]</em><br>
+Requires the <strong>EXPECT</strong> attribute to use one of the specified value tag(s).
+Most value tags also support the specification of limits in parenthesis, for example "name(42)" would allow nameWith/WithoutLanguage strings up to 42 octets in length, "name(4:MAX)" would allow nameWith/WithoutLanguage strings between 4 and 255 octets in length, and "integer(-273:MAX)" would allow integers between -273 and 2147483647.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-LIMIT </strong><em>number</em><br>
+<br>
+Specifies the maximum number of times to repeat if the <strong>REPEAT-MATCH</strong> or <strong>REPEAT-NO-MATCH</strong> predicate is specified. The default value is 1000.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-MATCH</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-NO-MATCH</strong><br>
+Specifies that the current test should be repeated when the <strong>EXPECT</strong> condition matches or does not match.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SAME-COUNT-AS </strong><em>attribute-name</em><br>
+Requires the <strong>EXPECT</strong> attribute to have the same number of values as the specified parallel attribute.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-HOSTNAMES "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-HOSTNAMES "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that all URI values contain a matching hostname.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-RESOURCES "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-RESOURCES "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that all URI values contain a matching resource (including leading /).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-SCHEMES "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-SCHEMES "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that all URI values contain a matching scheme.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES "</strong><em>literal string</em><strong>"</strong><br>
+Requires that all values of the <strong>EXPECT</strong> attribute match the literal string. Comparisons are case-sensitive.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES <</strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES =</strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES ></strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES </strong><em>number</em>[<em>,...,number</em>]<br>
+Requires that all values of the <strong>EXPECT</strong> attribute match the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES "false"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES "true"</strong><br>
+Requires that all values of the <strong>EXPECT</strong> attribute match the boolean value given.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-ALL-VALUES "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that all values of the <strong>EXPECT</strong> attribute match the regular expression, which must conform to the POSIX regular expression syntax.
Comparisons are case-sensitive.
-<dt><b>WITH-DISTINCT-VALUES</b>
-<dd style="margin-left: 5.0em">Requires that all values of the <b>EXPECT</b> attribute are unique.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-DISTINCT-VALUES</strong><br>
+Requires that all values of the <strong>EXPECT</strong> attribute are unique.
Comparisons are case-sensitive.
Only charset, collection, enum, integer, keyword, mimeMediaType, naturalLanguage, rangeOfInteger, resolution, uriScheme attributes support this predicate.
-<dt><b>WITH-HOSTNAME "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-HOSTNAME "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that at least one URI value contains a matching hostname.
-<dt><b>WITH-RESOURCE "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-RESOURCE "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that at least one URI value contains a matching resource (including leading /).
-<dt><b>WITH-SCHEME "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-SCHEME "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that at least one URI value contains a matching scheme.
-<dt><b>WITH-VALUE "</b><i>literal string</i><b>"</b>
-<dd style="margin-left: 5.0em">Requires that at least one value of the <b>EXPECT</b> attribute matches the literal string. Comparisons are case-sensitive.
-<dt><b>WITH-VALUE <</b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-VALUE =</b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-VALUE ></b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>WITH-VALUE </b><i>number</i>[<i>,...,number</i>]
-<dd style="margin-left: 5.0em">Requires that at least one value of the <b>EXPECT</b> attribute matches the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
-<dt><b>WITH-VALUE "false"</b>
-<dd style="margin-left: 5.0em"><dt><b>WITH-VALUE "true"</b>
-<dd style="margin-left: 5.0em">Requires that at least one value of the <b>EXPECT</b> attribute matches the boolean value given.
-<dt><b>WITH-VALUE "/</b><i>regular expression</i><b>/"</b>
-<dd style="margin-left: 5.0em">Requires that at least one value of the <b>EXPECT</b> attribute matches the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
-<dt><b>WITH-VALUE-FROM </b><i>attribute-name</i>
-<dd style="margin-left: 5.0em">Requires that the value(s) of the <b>EXPECT</b> attribute matches the value(s) in the specified attribute.
-For example, "EXPECT job-sheets WITH-VALUE-FROM job-sheets-supported" requires that the "job-sheets" value is listed as a value of the "job-sheets-supported" attribute.
-</dl>
-<h3><a name="STATUS_PREDICATES">Status Predicates</a></h3>
-The following predicates are understood following the <b>STATUS</b> test directive:
-<dl class="man">
-<dt><b>DEFINE-MATCH </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Defines the variable to "1" when the <b>STATUS</b> matches. A side-effect of this predicate is that this <b>STATUS</b> will never fail a test.
-<dt><b>DEFINE-NO-MATCH </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Defines the variable to "1" when the <b>STATUS</b> does not match. A side-effect of this predicate is that this <b>STATUS</b> will never fail a test.
-<dt><b>IF-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Makes the <b>STATUS</b> apply only if the specified variable is defined.
-<dt><b>IF-NOT-DEFINED </b><i>variable-name</i>
-<dd style="margin-left: 5.0em">Makes the <b>STATUS</b> apply only if the specified variable is not defined.
-<dt><b>REPEAT-LIMIT </b><i>number</i>
-<dd style="margin-left: 5.0em"><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-HOSTNAME "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-HOSTNAME "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that at least one URI value contains a matching hostname.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-RESOURCE "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-RESOURCE "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that at least one URI value contains a matching resource (including leading /).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-SCHEME "</strong><em>literal string</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-SCHEME "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that at least one URI value contains a matching scheme.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE "</strong><em>literal string</em><strong>"</strong><br>
+Requires that at least one value of the <strong>EXPECT</strong> attribute matches the literal string. Comparisons are case-sensitive.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE <</strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE =</strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE ></strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE </strong><em>number</em>[<em>,...,number</em>]<br>
+Requires that at least one value of the <strong>EXPECT</strong> attribute matches the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE "false"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE "true"</strong><br>
+Requires that at least one value of the <strong>EXPECT</strong> attribute matches the boolean value given.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE "/</strong><em>regular expression</em><strong>/"</strong><br>
+Requires that at least one value of the <strong>EXPECT</strong> attribute matches the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>WITH-VALUE-FROM </strong><em>attribute-name</em><br>
+Requires that the value(s) of the <strong>EXPECT</strong> attribute matches the value(s) in the specified attribute.
+For example, "EXPECT job-sheets WITH-VALUE-FROM job-sheets-supported" requires that the "job-sheets" value is listed as a value of the "job-sheets-supported" attribute.
+</p>
+ <h3 id="ipptoolfile-5.description.status-predicates">Status Predicates</h3>
+<p>The following predicates are understood following the <strong>STATUS</strong> test directive:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-MATCH </strong><em>variable-name</em><br>
+Defines the variable to "1" when the <strong>STATUS</strong> matches. A side-effect of this predicate is that this <strong>STATUS</strong> will never fail a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEFINE-NO-MATCH </strong><em>variable-name</em><br>
+Defines the variable to "1" when the <strong>STATUS</strong> does not match. A side-effect of this predicate is that this <strong>STATUS</strong> will never fail a test.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IF-DEFINED </strong><em>variable-name</em><br>
+Makes the <strong>STATUS</strong> apply only if the specified variable is defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IF-NOT-DEFINED </strong><em>variable-name</em><br>
+Makes the <strong>STATUS</strong> apply only if the specified variable is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-LIMIT </strong><em>number</em><br>
+<br>
Specifies the maximum number of times to repeat. The default value is 1000.
-<dt><b>REPEAT-MATCH</b>
-<dd style="margin-left: 5.0em"><dt><b>REPEAT-NO-MATCH</b>
-<dd style="margin-left: 5.0em">Specifies that the current test should be repeated when the response status-code matches or does not match the value specified by the STATUS directive.
-</dl>
-<h3><a name="OPERATION_CODES">Operation Codes</a></h3>
-Operation codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of names supported by
-<b>ipptool</b>(8):
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-MATCH</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>REPEAT-NO-MATCH</strong><br>
+Specifies that the current test should be repeated when the response status-code matches or does not match the value specified by the STATUS directive.
+</p>
+ <h3 id="ipptoolfile-5.description.operation-codes">Operation Codes</h3>
+<p>Operation codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of names supported by
+<strong>ipptool</strong>(8):
+
+</p>
+ <pre>
Acknowledge-Document
Acknowledge-Identify-Printer
Acknowledge-Job
Validate-Document
Validate-Job
</pre>
-<h3><a name="STATUS_CODES">Status Codes</a></h3>
-Status codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of the names supported by
-<b>ipptool</b>(8):
-<pre class="man">
+ <h3 id="ipptoolfile-5.description.status-codes">Status Codes</h3>
+<p>Status codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of the names supported by
+<strong>ipptool</strong>(8):
+
+</p>
+ <pre>
client-error-account-authorization-failed
client-error-account-closed
client-error-account-info-needed
successful-ok-ignored-subscriptions
successful-ok-too-many-events
</pre>
-<h3><a name="TAGS">Tags</a></h3>
-Value and group tags correspond to the names from RFC 8011 and other IPP extension specifications. Here are the group tags:
-<pre class="man">
+ <h3 id="ipptoolfile-5.description.tags">Tags</h3>
+<p>Value and group tags correspond to the names from RFC 8011 and other IPP extension specifications. Here are the group tags:
+</p>
+ <pre>
document-attributes-tag
event-notification-attributes-tag
job | job-attributes-tag
system-attributes-tag
unsupported-attributes-tag
</pre>
-<p>Here are the value tags:
-<pre class="man">
+ <p>Here are the value tags:
+</p>
+ <pre>
admin-define
boolean
charset
uri
uriScheme
</pre>
-<h3><a name="VARIABLES">Variables</a></h3>
-The
-<b>ipptool</b>(8)
-program maintains a list of variables that can be used in any literal string or attribute value by specifying "<i>$variable-name</i>". Aside from variables defined using the <i>-d</i> option or <b>DEFINE</b> directive, the following pre-defined variables are available:
-<dl class="man">
-<dt><b>$$</b>
-<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)
-with the <i>-f</i> option.
-<dt><b>$filetype</b>
-<dd style="margin-left: 5.0em">Inserts the MIME media type for the filename provided to
-<b>ipptool</b>(8)
-with the <i>-f</i> option.
-<dt><b>$hostname</b>
-<dd style="margin-left: 5.0em">Inserts the hostname from the URI provided to
-<b>ipptool</b>(8).
-<dt><b>$job-id</b>
-<dd style="margin-left: 5.0em">Inserts the last "job-id" attribute value returned in a test response or 0 if no "job-id" attribute has been seen.
-<dt><b>$job-uri</b>
-<dd style="margin-left: 5.0em">Inserts the last "job-uri" attribute value returned in a test response or an empty string if no "job-uri" attribute has been seen.
-<dt><b>$notify-subscription-id</b>
-<dd style="margin-left: 5.0em">Inserts the last "notify-subscription-id" attribute value returned in a test response or 0 if no "notify-subscription-id" attribute has been seen.
-<dt><b>$port</b>
-<dd style="margin-left: 5.0em">Inserts the port number from the URI provided to
-<b>ipptool</b>(8).
-<dt><b>$resource</b>
-<dd style="margin-left: 5.0em">Inserts the resource path from the URI provided to
-<b>ipptool</b>(8).
-<dt><b>$scheme</b>
-<dd style="margin-left: 5.0em">Inserts the scheme from the URI provided to
-<b>ipptool</b>(8).
-<dt><b>$uri</b>
-<dd style="margin-left: 5.0em">Inserts the URI provided to
-<b>ipptool</b>(8).
-<dt><b>$uriuser</b>
-<dd style="margin-left: 5.0em">Inserts the username from the URI provided to
-<b>ipptool</b>(8),
+ <h3 id="ipptoolfile-5.description.variables">Variables</h3>
+<p>The
+<strong>ipptool</strong>(8)
+
+program maintains a list of variables that can be used in any literal string or attribute value by specifying "<em>$variable-name</em>". Aside from variables defined using the <em>-d</em> option or <strong>DEFINE</strong> directive, the following pre-defined variables are available:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$$</strong><br>
+Inserts a single "$" character.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$ENV[</strong><em>name</em><strong>]</strong><br>
+Inserts the value of the named environment variable, or an empty string if the environment variable is not defined.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$date-current</strong><br>
+Inserts the current date and time using the ISO-8601 format ("yyyy-mm-ddThh:mm:ssZ").
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$date-start</strong><br>
+Inserts the starting date and time using the ISO-8601 format ("yyyy-mm-ddThh:mm:ssZ").
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$filename</strong><br>
+Inserts the filename provided to
+<strong>ipptool</strong>(8)
+
+with the <em>-f</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$filetype</strong><br>
+Inserts the MIME media type for the filename provided to
+<strong>ipptool</strong>(8)
+
+with the <em>-f</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$hostname</strong><br>
+Inserts the hostname from the URI provided to
+<strong>ipptool</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$job-id</strong><br>
+Inserts the last "job-id" attribute value returned in a test response or 0 if no "job-id" attribute has been seen.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$job-uri</strong><br>
+Inserts the last "job-uri" attribute value returned in a test response or an empty string if no "job-uri" attribute has been seen.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$notify-subscription-id</strong><br>
+Inserts the last "notify-subscription-id" attribute value returned in a test response or 0 if no "notify-subscription-id" attribute has been seen.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$port</strong><br>
+Inserts the port number from the URI provided to
+<strong>ipptool</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$resource</strong><br>
+Inserts the resource path from the URI provided to
+<strong>ipptool</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$scheme</strong><br>
+Inserts the scheme from the URI provided to
+<strong>ipptool</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$uri</strong><br>
+Inserts the URI provided to
+<strong>ipptool</strong>(8).
+
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$uriuser</strong><br>
+Inserts the username from the URI provided to
+<strong>ipptool</strong>(8),
+
if any.
-<dt><b>$user</b>
-<dd style="margin-left: 5.0em">Inserts the current user's login name.
-</dl>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1),</a>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>$user</strong><br>
+Inserts the current user's login name.
+</p>
+ <h2 id="ipptoolfile-5.see-also">See Also</h2>
+<p><strong>ipptool</strong>(1),
+
IANA IPP Registry (<a href="https://www.iana.org/assignments/ipp-registrations">https://www.iana.org/assignments/ipp-registrations</a>),
PWG Internet Printing Protocol Workgroup (<a href="https://www.pwg.org/ipp">https://www.pwg.org/ipp</a>),
RFC 8011 (<a href="https://datatracker.ietf.org/doc/html/rfc8011">https://datatracker.ietf.org/doc/html/rfc8011</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="ipptoolfile-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lp(1)</title>
-</head>
-<body>
-<h1 class="title">lp(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lp - print files
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lp</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lp(1)</title>
+ </head>
+ <body>
+ <h1 id="lp-1">lp(1)</h1>
+ <h2 id="lp-1.name">Name</h2>
+<p>lp - print files
+</p>
+ <h2 id="lp-1.synopsis">Synopsis</h2>
+<p><strong>lp</strong>
[
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-c</b>
+<strong>-c</strong>
] [
-<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-d </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
] [
-<b>-m</b>
+<strong>-m</strong>
] [
-<b>-n</b>
-<i>num-copies</i>
+<strong>-n</strong>
+<em>num-copies</em>
] [
-<b>-o </b><i>option</i>[<b>=</b><i>value</i>]
+<strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]
] [
-<b>-q</b>
-<i>priority</i>
+<strong>-q</strong>
+<em>priority</em>
] [
-<b>-s</b>
+<strong>-s</strong>
] [
-<b>-t</b>
-<i>title</i>
+<strong>-t</strong>
+<em>title</em>
] [
-<b>-H</b>
-<i>handling</i>
+<strong>-H</strong>
+<em>handling</em>
] [
-<b>-P</b>
-<i>page-list</i>
+<strong>-P</strong>
+<em>page-list</em>
] [
-<b>--</b>
+<strong>--</strong>
] [
-<i>file(s)</i>
+<em>file(s)</em>
]
<br>
-<b>lp</b>
+<strong>lp</strong>
[
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-c</b>
+<strong>-c</strong>
] [
-<b>-i</b>
-<i>job-id</i>
+<strong>-i</strong>
+<em>job-id</em>
] [
-<b>-n</b>
-<i>num-copies</i>
+<strong>-n</strong>
+<em>num-copies</em>
] [
-<b>-o </b><i>option</i>[<b>=</b><i>value</i>]
+<strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]
] [
-<b>-q</b>
-<i>priority</i>
+<strong>-q</strong>
+<em>priority</em>
] [
-<b>-t</b>
-<i>title</i>
+<strong>-t</strong>
+<em>title</em>
] [
-<b>-H</b>
-<i>handling</i>
+<strong>-H</strong>
+<em>handling</em>
] [
-<b>-P</b>
-<i>page-list</i>
+<strong>-P</strong>
+<em>page-list</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lp</b> submits files for printing or alters a pending job.
-Use a filename of "-" to force printing from the standard input.
-<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.
+</p>
+ <h2 id="lp-1.description">Description</h2>
+<p><strong>lp</strong> submits files for printing or alters a pending job.
+Use a filename of "-" to force printing from the standard input.
+</p>
+ <h3 id="lp-1.description.the-default-destination">The Default Destination</h3>
+<p>CUPS provides many ways to set the default destination. The <strong>LPDEST</strong> and <strong>PRINTER</strong> 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>
+<strong>lpoptions</strong>(1)
+
command is used, followed by the default set using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<strong>lpadmin</strong>(8)
+
command.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by <i>lp</i>:
-<dl class="man">
-<dt><b>--</b>
-<dd style="margin-left: 5.0em">Marks the end of options; use this to print a file whose name begins with a dash (-).
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the 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>-c</b>
-<dd style="margin-left: 5.0em">This option is provided for backwards-compatibility only. On systems that support it, this option forces the print file to be copied to the spool directory before printing.
+</p>
+ <h2 id="lp-1.options">Options</h2>
+<p>The following options are recognized by <em>lp</em>:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong><br>
+Marks the end of options; use this to print a file whose name begins with a dash (-).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies the username to use when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c</strong><br>
+This option is provided for backwards-compatibility only. On systems that support it, this option forces the print file to be copied to the spool directory before printing.
In CUPS, print files are always sent to the scheduler via IPP which has the same effect.
-<dt><b>-d </b><i>destination</i>
-<dd style="margin-left: 5.0em">Prints files to the named printer.
-<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Chooses an alternate server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>destination</em><br>
+Prints files to the named printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]<br>
+Chooses an alternate server.
Note: This option must occur before all others.
-<dt><b>-i </b><i>job-id</i>
-<dd style="margin-left: 5.0em">Specifies an existing job to modify.
-<dt><b>-m</b>
-<dd style="margin-left: 5.0em">Sends an email when the job is completed.
-<dt><b>-n </b><i>copies</i>
-<dd style="margin-left: 5.0em">Sets the number of copies to print.
-<dt><b>-o "</b><i>name</i><b>=</b><i>value </i>[ ... <i>name</i><b>=</b><i>value </i>]<b>"</b>
-<dd style="margin-left: 5.0em">Sets one or more job options.
-See "COMMON JOB OPTIONS" below.
-<dt><b>-q </b><i>priority</i>
-<dd style="margin-left: 5.0em">Sets the job priority from 1 (lowest) to 100 (highest).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i </strong><em>job-id</em><br>
+Specifies an existing job to modify.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m</strong><br>
+Sends an email when the job is completed.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>copies</em><br>
+Sets the number of copies to print.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o "</strong><em>name</em><strong>=</strong><em>value </em>[ ... <em>name</em><strong>=</strong><em>value </em>]<strong>"</strong><br>
+Sets one or more job options.
+See "COMMON JOB OPTIONS" below.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-q </strong><em>priority</em><br>
+Sets the job priority from 1 (lowest) to 100 (highest).
The default priority is 50.
-<dt><b>-s</b>
-<dd style="margin-left: 5.0em">Do not report the resulting job IDs (silent mode.)
-<dt><b>-t "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em">Sets the job name.
-<dt><b>-H </b><i>hh:mm</i>
-<dd style="margin-left: 5.0em"><dt><b>-H hold</b>
-<dd style="margin-left: 5.0em"><dt><b>-H immediate</b>
-<dd style="margin-left: 5.0em"><dt><b>-H restart</b>
-<dd style="margin-left: 5.0em"><dt><b>-H resume</b>
-<dd style="margin-left: 5.0em">Specifies when the job should be printed.
-A value of <i>immediate</i> will print the file immediately, a value of <i>hold</i> will hold the job indefinitely, and a UTC time value (HH:MM) will hold the job until the specified UTC (not local) time.
-Use a value of <i>resume</i> with the <i>-i</i> option to resume a held job.
-Use a value of <i>restart</i> with the <i>-i</i> option to restart a completed job.
-<dt><b>-P </b><i>page-list</i>
-<dd style="margin-left: 5.0em">Specifies which pages to print in the document.
-The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
-The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages.
-</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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s</strong><br>
+Do not report the resulting job IDs (silent mode.)
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t "</strong><em>name</em><strong>"</strong><br>
+Sets the job name.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H </strong><em>hh:mm</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H hold</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H immediate</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H restart</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H resume</strong><br>
+Specifies when the job should be printed.
+A value of <em>immediate</em> will print the file immediately, a value of <em>hold</em> will hold the job indefinitely, and a UTC time value (HH:MM) will hold the job until the specified UTC (not local) time.
+Use a value of <em>resume</em> with the <em>-i</em> option to resume a held job.
+Use a value of <em>restart</em> with the <em>-i</em> option to restart a completed job.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>page-list</em><br>
+Specifies which pages to print in the document.
+The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
+The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages.
+</p>
+ <h3 id="lp-1.options.common-job-options">Common Job Options</h3>
+<p>Aside from the printer-specific options reported by the
+<strong>lpoptions</strong>(1)
+
command, the following generic options are available:
-<dl class="man">
-<dt><b>-o job-sheets=</b><i>name</i>
-<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
-The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
-<dt><b>-o media=</b><i>size</i>
-<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal".
-<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
-<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
-<dt><b>-o orientation-requested=4</b>
-<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
-<dt><b>-o orientation-requested=5</b>
-<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
-<dt><b>-o orientation-requested=6</b>
-<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
-<dt><b>-o print-quality=3</b>
-<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
-<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
-<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
-<dt><b>-o sides=one-sided</b>
-<dd style="margin-left: 5.0em">Prints on one side of the paper.
-<dt><b>-o sides=two-sided-long-edge</b>
-<dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output.
-<dt><b>-o sides=two-sided-short-edge</b>
-<dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output.
-</dl>
-<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.
-<p>The <i>-q</i> option accepts a different range of values than the Solaris lp command, matching the IPP job priority values (1-100, 100 is highest priority) instead of the Solaris values (0-39, 0 is highest priority).
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Print two copies of a document to the default printer:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-sheets=</strong><em>name</em><br>
+Prints a cover page (banner) with the document.
+The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o media=</strong><em>size</em><br>
+Sets the page size to <em>size</em>. Most printers support at least the size names "a4", "letter", and "legal".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o number-up=</strong>{<em>2|4|6|9|16</em>}<br>
+Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=4</strong><br>
+Prints the job in landscape (rotated 90 degrees counter-clockwise).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=5</strong><br>
+Prints the job in landscape (rotated 90 degrees clockwise).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=6</strong><br>
+Prints the job in reverse portrait (rotated 180 degrees).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=3</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=4</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=5</strong><br>
+Specifies the output quality - draft (3), normal (4), or best (5).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=one-sided</strong><br>
+Prints on one side of the paper.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=two-sided-long-edge</strong><br>
+Prints on both sides of the paper for portrait output.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=two-sided-short-edge</strong><br>
+Prints on both sides of the paper for landscape output.
+</p>
+ <h2 id="lp-1.conforming-to">Conforming To</h2>
+<p>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 <em>not</em> case-sensitive.
+</p>
+ <p>The <em>-q</em> option accepts a different range of values than the Solaris lp command, matching the IPP job priority values (1-100, 100 is highest priority) instead of the Solaris values (0-39, 0 is highest priority).
+</p>
+ <h2 id="lp-1.examples">Examples</h2>
+<p>Print two copies of a document to the default printer:
+</p>
+ <pre>
lp -n 2 filename
</pre>
-Print a double-sided legal document to a printer called "foo":
-<pre class="man">
+<p>Print a double-sided legal document to a printer called "foo":
+</p>
+ <pre>
lp -d foo -o media=legal -o sides=two-sided-long-edge filename
</pre>
-Print a presentation document 2-up to a printer called "bar":
-<pre class="man">
+<p>Print a presentation document 2-up to a printer called "bar":
+</p>
+ <pre>
lp -d bar -o number-up=2 filename
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</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 © 2021-2023 by OpenPrinting.
+ <h2 id="lp-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lpadmin</strong>(8),
+
+<strong>lpoptions</strong>(1),
-</body>
+<strong>lpq</strong>(1),
+
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lp-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpadmin(8)</title>
-</head>
-<body>
-<h1 class="title">lpadmin(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpadmin - configure cups printers and classes
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpadmin</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpadmin(8)</title>
+ </head>
+ <body>
+ <h1 id="lpadmin-8">lpadmin(8)</h1>
+ <h2 id="lpadmin-8.name">Name</h2>
+<p>lpadmin - configure cups printers and classes
+</p>
+ <h2 id="lpadmin-8.synopsis">Synopsis</h2>
+<p><strong>lpadmin</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
]
-<b>-d</b>
-<i>destination</i>
+<strong>-d</strong>
+<em>destination</em>
<br>
-<b>lpadmin</b>
+<strong>lpadmin</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
]
-<b>-p</b>
-<i>destination</i>
+<strong>-p</strong>
+<em>destination</em>
[
-<b>-R</b>
-<i>name-default</i>
+<strong>-R</strong>
+<em>name-default</em>
]
-<i>option(s)</i>
+<em>option(s)</em>
<br>
-<b>lpadmin</b>
+<strong>lpadmin</strong>
[
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
]
-<b>-x</b>
-<i>destination</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpadmin</b> configures printer and class queues provided by CUPS.
+<strong>-x</strong>
+<em>destination</em>
+</p>
+ <h2 id="lpadmin-8.description">Description</h2>
+<p><strong>lpadmin</strong> configures printer and class queues provided by CUPS.
It can also be used to set the server default printer or class.
-<p>When specified before the <i>-d</i>, <i>-p</i>, or <i>-x</i> options, the <i>-E</i> option forces encryption when connecting to the server.
-<p>The first form of the command (<i>-d</i>) sets the default printer or class to <i>destination</i>.
+</p>
+ <p>When specified before the <em>-d</em>, <em>-p</em>, or <em>-x</em> options, the <em>-E</em> option forces encryption when connecting to the server.
+</p>
+ <p>The first form of the command (<em>-d</em>) sets the default printer or class to <em>destination</em>.
Subsequent print jobs submitted via the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+<strong>lp</strong>(1)
+
or
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<strong>lpr</strong>(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>
+<strong>lpoptions</strong>(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>.
+</p>
+ <p>The second form of the command (<em>-p</em>) configures the named printer or class. The additional options are described below.
+</p>
+ <p>The third form of the command (<em>-x</em>) deletes the printer or class <em>destination</em>.
Any jobs that are pending for the destination will be removed and any job that is currently printed will be aborted.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized when configuring a printer queue:
-<dl class="man">
-<dt><b>-c </b><i>class</i>
-<dd style="margin-left: 5.0em">Adds the named <i>printer</i> to <i>class</i>.
-If <i>class</i> does not exist it is created automatically.
-<dt><b>-m </b><i>model</i>
-<dd style="margin-left: 5.0em">Sets a standard PPD file for the printer from the <i>model</i> directory or using one of the driver interfaces.
-Use the <i>-m</i> option with the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+</p>
+ <h2 id="lpadmin-8.options">Options</h2>
+<p>The following options are recognized when configuring a printer queue:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong><em>class</em><br>
+Adds the named <em>printer</em> to <em>class</em>.
+If <em>class</em> does not exist it is created automatically.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>model</em><br>
+Sets a standard PPD file for the printer from the <em>model</em> directory or using one of the driver interfaces.
+Use the <em>-m</em> option with the
+<strong>lpinfo</strong>(8)
+
command to get a list of supported models.
-The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP <i>device-uri</i>.
-Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS.
-<dt><b>-o cupsIPPSupplies=true</b>
-<dd style="margin-left: 5.0em"><dt><b>-o cupsIPPSupplies=false</b>
-<dd style="margin-left: 5.0em">Specifies whether IPP supply level values should be reported.
-<dt><b>-o cupsSNMPSupplies=true</b>
-<dd style="margin-left: 5.0em"><dt><b>-o cupsSNMPSupplies=false</b>
-<dd style="margin-left: 5.0em">Specifies whether SNMP supply level (RFC 3805) values should be reported.
-<dt><b>-o job-k-limit=</b><i>value</i>
-<dd style="margin-left: 5.0em">Sets the kilobyte limit for per-user quotas.
+The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP <em>device-uri</em>.
+Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o cupsIPPSupplies=true</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o cupsIPPSupplies=false</strong><br>
+Specifies whether IPP supply level values should be reported.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o cupsSNMPSupplies=true</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o cupsSNMPSupplies=false</strong><br>
+Specifies whether SNMP supply level (RFC 3805) values should be reported.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-k-limit=</strong><em>value</em><br>
+Sets the kilobyte limit for per-user quotas.
The value is an integer number of kilobytes; one kilobyte is 1024 bytes.
-<dt><b>-o job-page-limit=</b><i>value</i>
-<dd style="margin-left: 5.0em">Sets the page limit for per-user quotas.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-page-limit=</strong><em>value</em><br>
+Sets the page limit for per-user quotas.
The value is the integer number of pages that can be printed; double-sided pages are counted as two pages.
-<dt><b>-o job-quota-period=</b><i>value</i>
-<dd style="margin-left: 5.0em">Sets the accounting period for per-user quotas.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-quota-period=</strong><em>value</em><br>
+Sets the accounting period for per-user quotas.
The value is an integer number of seconds; 86,400 seconds are in one day.
-<dt><b>-o job-sheets-default=</b><i>banner</i>
-<dd style="margin-left: 5.0em"><dt><b>-o job-sheets-default=</b><i>banner</i><b>,</b><i>banner</i>
-<dd style="margin-left: 5.0em">Sets the default banner page(s) to use for print jobs.
-<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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-sheets-default=</strong><em>banner</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-sheets-default=</strong><em>banner</em><strong>,</strong><em>banner</em><br>
+Sets the default banner page(s) to use for print jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name</em><strong>=</strong><em>value</em><br>
+Sets a PPD option for the printer.
+PPD options can be listed using the <em>-l</em> option with the
+<strong>lpoptions</strong>(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.
-Any print-time option can be defaulted, e.g., "-o number-up-default=2" to set the default "number-up" option value to 2.
-<dt><b>-o port-monitor=</b><i>name</i>
-<dd style="margin-left: 5.0em">Sets the binary communications program to use when printing, "none", "bcp", or "tbcp".
-The default program is "none".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name</em><strong>-default=</strong><em>value</em><br>
+Sets a default server-side option for the destination.
+Any print-time option can be defaulted, e.g., "-o number-up-default=2" to set the default "number-up" option value to 2.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o port-monitor=</strong><em>name</em><br>
+Sets the binary communications program to use when printing, "none", "bcp", or "tbcp".
+The default program is "none".
The specified port monitor must be listed in the printer's PPD file.
-<dt><b>-o printer-error-policy=</b><i>name</i>
-<dd style="margin-left: 5.0em">Sets the policy for errors such as printers that cannot be found or accessed, don't support the format being printed, fail during submission of the print data, or cause one or more filters to crash.
-The name must be one of "abort-job" (abort the job on error), "retry-job" (retry the job at a future time), "retry-current-job" (retry the current job immediately), or "stop-printer" (stop the printer on error).
-The default error policy is "stop-printer" for printers and "retry-current-job" for
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o printer-error-policy=</strong><em>name</em><br>
+Sets the policy for errors such as printers that cannot be found or accessed, don't support the format being printed, fail during submission of the print data, or cause one or more filters to crash.
+The name must be one of "abort-job" (abort the job on error), "retry-job" (retry the job at a future time), "retry-current-job" (retry the current job immediately), or "stop-printer" (stop the printer on error).
+The default error policy is "stop-printer" for printers and "retry-current-job" for
classes.
-<dt><b>-o printer-is-shared=true</b>
-<dd style="margin-left: 5.0em"><dt><b>-o printer-is-shared=false</b>
-<dd style="margin-left: 5.0em">Sets the destination to shared/published or unshared/unpublished.
-Shared/published destinations are publicly announced by the server on the LAN based on the browsing configuration in <i>cupsd.conf</i>, while unshared/unpublished destinations are not announced.
-The default value is "true".
-<dt><b>-o printer-op-policy=</b><i>name</i>
-<dd style="margin-left: 5.0em">Sets the IPP operation policy associated with the destination.
-The name must be defined in the <i>cupsd.conf</i> in a Policy section.
-The default operation policy is "default".
-<dt><b>-R </b><i>name</i><b>-default</b>
-<dd style="margin-left: 5.0em">Deletes the named option from <i>printer</i>.
-<dt><b>-r </b><i>class</i>
-<dd style="margin-left: 5.0em">Removes the named <i>printer</i> from <i>class</i>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o printer-is-shared=true</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o printer-is-shared=false</strong><br>
+Sets the destination to shared/published or unshared/unpublished.
+Shared/published destinations are publicly announced by the server on the LAN based on the browsing configuration in <em>cupsd.conf</em>, while unshared/unpublished destinations are not announced.
+The default value is "true".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o printer-op-policy=</strong><em>name</em><br>
+Sets the IPP operation policy associated with the destination.
+The name must be defined in the <em>cupsd.conf</em> in a Policy section.
+The default operation policy is "default".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-R </strong><em>name</em><strong>-default</strong><br>
+Deletes the named option from <em>printer</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>class</em><br>
+Removes the named <em>printer</em> from <em>class</em>.
If the resulting class becomes empty it is removed.
-<dt><b>-u allow:</b>{<i>user</i>|<b>@</b><i>group</i>}{<b>,</b><i>user</i>|<b>,@</b><i>group</i>}*
-<dd style="margin-left: 5.0em"><dt><b>-u deny:</b>{<i>user</i>|<b>@</b><i>group</i>}{<b>,</b><i>user</i>|<b>,@</b><i>group</i>}*
-<dd style="margin-left: 5.0em"><dt><b>-u allow:all</b>
-<dd style="margin-left: 5.0em"><dt><b>-u deny:none</b>
-<dd style="margin-left: 5.0em">Sets user-level access control on a destination.
-Names starting with "@" are interpreted as UNIX groups.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u allow:</strong>{<em>user</em>|<strong>@</strong><em>group</em>}{<strong>,</strong><em>user</em>|<strong>,@</strong><em>group</em>}*<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u deny:</strong>{<em>user</em>|<strong>@</strong><em>group</em>}{<strong>,</strong><em>user</em>|<strong>,@</strong><em>group</em>}*<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u allow:all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u deny:none</strong><br>
+Sets user-level access control on a destination.
+Names starting with "@" are interpreted as UNIX groups.
The latter two forms turn user-level access control off.
-Note: The user 'root' is not granted special access - using "-u allow:foo,bar" will allow users 'foo' and 'bar' to access the printer but NOT 'root'.
-<dt><b>-v "</b><i>device-uri</i><b>"</b>
-<dd style="margin-left: 5.0em">Sets the <i>device-uri</i> attribute of the printer queue.
-Use the <i>-v</i> option with the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+Note: The user 'root' is not granted special access - using "-u allow:foo,bar" will allow users 'foo' and 'bar' to access the printer but NOT 'root'.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v "</strong><em>device-uri</em><strong>"</strong><br>
+Sets the <em>device-uri</em> attribute of the printer queue.
+Use the <em>-v</em> option with the
+<strong>lpinfo</strong>(8)
+
command to get a list of supported device URIs and schemes.
-<dt><b>-D "</b><i>info</i><b>"</b>
-<dd style="margin-left: 5.0em">Provides a textual description of the destination.
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">When specified before the <b>-d</b>, <b>-p</b>, or <b>-x</b> options, forces the use of TLS encryption on the connection to the scheduler.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D "</strong><em>info</em><strong>"</strong><br>
+Provides a textual description of the destination.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+When specified before the <strong>-d</strong>, <strong>-p</strong>, or <strong>-x</strong> options, forces the use of TLS encryption on the connection to the scheduler.
Otherwise, enables the destination and accepts jobs; this is the same as running the
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8)</a>
+<strong>cupsaccept</strong>(8)
+
and
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8)</a>
+<strong>cupsenable</strong>(8)
+
programs on the destination.
-<dt><b>-L "</b><i>location</i><b>"</b>
-<dd style="margin-left: 5.0em">Provides a textual location of the destination.
-</dl>
-<h2 class="title"><a name="DEPRECATED_OPTIONS">Deprecated Options</a></h2>
-The following <b>lpadmin</b> options are deprecated:
-<dl class="man">
-<dt><b>-i </b><i>filename</i>
-<dd style="margin-left: 5.0em">This option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-L "</strong><em>location</em><strong>"</strong><br>
+Provides a textual location of the destination.
+</p>
+ <h2 id="lpadmin-8.deprecated-options">Deprecated Options</h2>
+<p>The following <strong>lpadmin</strong> options are deprecated:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i </strong><em>filename</em><br>
+This option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file.
Note: Interface scripts are not supported by CUPS.
PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS.
-<dt><b>-P </b><i>ppd-file</i>
-<dd style="margin-left: 5.0em">Specifies a PostScript Printer Description (PPD) file to use with the printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>ppd-file</em><br>
+Specifies a PostScript Printer Description (PPD) file to use with the printer.
Note: PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS.
-</dl>
-<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.
-<p>Finally, the CUPS version of <b>lpadmin</b> may ask the user for an access password depending on the printing system configuration.
+</p>
+ <h2 id="lpadmin-8.conforming-to">Conforming To</h2>
+<p>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 <em>not</em> case-sensitive.
+</p>
+ <p>Finally, the CUPS version of <strong>lpadmin</strong> may ask the user for an access password depending on the printing system configuration.
This differs from the System V version which requires the root user to execute this command.
-<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.
+</p>
+ <h2 id="lpadmin-8.notes">Notes</h2>
+<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<p>The CUPS version of <b>lpadmin</b> does not support all of the System V or Solaris printing system configuration options.
-<p>Interface scripts are not supported for security reasons.
-<p>The double meaning of the <b>-E</b> option is an unfortunate historical oddity.
-<p>The <b>lpadmin</b> command communicates with the scheduler (<b>cupsd</b>) to make changes to the printing system configuration.
-This configuration information is stored in several files including <i>printers.conf</i> and <i>classes.conf</i>.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <p>The CUPS version of <strong>lpadmin</strong> does not support all of the System V or Solaris printing system configuration options.
+</p>
+ <p>Interface scripts are not supported for security reasons.
+</p>
+ <p>The double meaning of the <strong>-E</strong> option is an unfortunate historical oddity.
+</p>
+ <p>The <strong>lpadmin</strong> command communicates with the scheduler (<strong>cupsd</strong>) to make changes to the printing system configuration.
+This configuration information is stored in several files including <em>printers.conf</em> and <em>classes.conf</em>.
These files should not be edited directly and are an implementation detail of CUPS that is subject to change at any time.
-<h2 class="title"><a name="EXAMPLE">Example</a></h2>
-Create an IPP Everywhere print queue:
-<pre class="man">
+</p>
+ <h2 id="lpadmin-8.example">Example</h2>
+<p>Create an IPP Everywhere print queue:
+</p>
+ <pre>
lpadmin -p myprinter -E -v ipp://myprinter.local/ipp/print -m everywhere
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</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 © 2021-2023 by OpenPrinting.
+ <h2 id="lpadmin-8.see-also">See Also</h2>
+<p><strong>cupsaccept</strong>(8),
+
+<strong>cupsenable</strong>(8),
-</body>
+<strong>lpinfo</strong>(8),
+
+<strong>lpoptions</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpadmin-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpc(8)</title>
-</head>
-<body>
-<h1 class="title">lpc(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpc - line printer control program (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpc</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpc(8)</title>
+ </head>
+ <body>
+ <h1 id="lpc-8">lpc(8)</h1>
+ <h2 id="lpc-8.name">Name</h2>
+<p>lpc - line printer control program (deprecated)
+</p>
+ <h2 id="lpc-8.synopsis">Synopsis</h2>
+<p><strong>lpc</strong>
[
-<i>command</i>
+<em>command</em>
[
-<i>parameter(s)</i>
+<em>parameter(s)</em>
] ]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpc</b> provides limited control over printer and class queues provided by CUPS. It can also be used to query the state of queues.
-<p>If no command is specified on the command-line, <b>lpc</b> displays a prompt and accepts commands from the standard input.
-<h3><a name="COMMANDS">Commands</a></h3>
-The <b>lpc</b> program accepts a subset of commands accepted by the Berkeley <b>lpc</b> program of the same name:
-<dl class="man">
-<dt><b>exit</b>
-<dd style="margin-left: 5.0em">Exits the command interpreter.
-<dt><b>help </b>[<i>command</i>]
-<dd style="margin-left: 5.0em"><dt><b>? </b>[<i>command</i>]
-<dd style="margin-left: 5.0em">Displays a short help message.
-<dt><b>quit</b>
-<dd style="margin-left: 5.0em">Exits the command interpreter.
-<dt><b>status </b>[<i>queue</i>]
-<dd style="margin-left: 5.0em">Displays the status of one or more printer or class queues.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-This program is deprecated and will be removed in a future feature release of CUPS.
-<p>Since <b>lpc</b> is geared towards the Berkeley printing system, it is impossible to use <b>lpc</b> to configure printer or class queues provided by CUPS.
+</p>
+ <h2 id="lpc-8.description">Description</h2>
+<p><strong>lpc</strong> provides limited control over printer and class queues provided by CUPS. It can also be used to query the state of queues.
+</p>
+ <p>If no command is specified on the command-line, <strong>lpc</strong> displays a prompt and accepts commands from the standard input.
+</p>
+ <h3 id="lpc-8.description.commands">Commands</h3>
+<p>The <strong>lpc</strong> program accepts a subset of commands accepted by the Berkeley <strong>lpc</strong> program of the same name:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>exit</strong><br>
+Exits the command interpreter.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>help </strong>[<em>command</em>]<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>? </strong>[<em>command</em>]<br>
+Displays a short help message.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>quit</strong><br>
+Exits the command interpreter.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>status </strong>[<em>queue</em>]<br>
+Displays the status of one or more printer or class queues.
+</p>
+ <h2 id="lpc-8.notes">Notes</h2>
+<p>This program is deprecated and will be removed in a future feature release of CUPS.
+</p>
+ <p>Since <strong>lpc</strong> is geared towards the Berkeley printing system, it is impossible to use <strong>lpc</strong> to configure printer or class queues provided by CUPS.
To configure printer or class queues you must use the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<strong>lpadmin</strong>(8)
+
command or another CUPS-compatible client with that functionality.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</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 © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="lpc-8.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>cupsaccept</strong>(8),
+
+<strong>cupsenable</strong>(8),
+
+<strong>lp</strong>(1),
-</body>
+<strong>lpadmin</strong>(8),
+
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpc-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpinfo(8)</title>
-</head>
-<body>
-<h1 class="title">lpinfo(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpinfo - show available devices or drivers (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpinfo</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpinfo(8)</title>
+ </head>
+ <body>
+ <h1 id="lpinfo-8">lpinfo(8)</h1>
+ <h2 id="lpinfo-8.name">Name</h2>
+<p>lpinfo - show available devices or drivers (deprecated)
+</p>
+ <h2 id="lpinfo-8.synopsis">Synopsis</h2>
+<p><strong>lpinfo</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>--device-id</b>
-<i>device-id-string</i>
+<strong>--device-id</strong>
+<em>device-id-string</em>
] [
-<b>--exclude-schemes</b>
-<i>scheme-list</i>
+<strong>--exclude-schemes</strong>
+<em>scheme-list</em>
] [
-<b>--include-schemes</b>
-<i>scheme-list</i>
+<strong>--include-schemes</strong>
+<em>scheme-list</em>
] [
-<b>--language</b>
-<i>locale</i>
+<strong>--language</strong>
+<em>locale</em>
] [
-<b>--make-and-model</b>
-<i>name</i>
+<strong>--make-and-model</strong>
+<em>name</em>
] [
-<b>--product</b>
-<i>name</i>
+<strong>--product</strong>
+<em>name</em>
]
-<b>-m</b>
+<strong>-m</strong>
<br>
-<b>lpinfo</b>
+<strong>lpinfo</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>--exclude-schemes</b>
-<i>scheme-list</i>
+<strong>--exclude-schemes</strong>
+<em>scheme-list</em>
] [
-<b>--include-schemes</b>
-<i>scheme-list</i>
+<strong>--include-schemes</strong>
+<em>scheme-list</em>
] [
-<b>--timeout</b>
-<i>seconds</i>
+<strong>--timeout</strong>
+<em>seconds</em>
]
-<b>-v</b>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpinfo</b> lists the available devices or drivers known to the CUPS server.
-The first form (<i>-m</i>) lists the available drivers, while the second form (<i>-v</i>) lists the available devices.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>lpinfo</b> accepts the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Selects an alternate server.
+<strong>-v</strong>
+</p>
+ <h2 id="lpinfo-8.description">Description</h2>
+<p><strong>lpinfo</strong> lists the available devices or drivers known to the CUPS server.
+The first form (<em>-m</em>) lists the available drivers, while the second form (<em>-v</em>) lists the available devices.
+</p>
+ <h2 id="lpinfo-8.options">Options</h2>
+<p><strong>lpinfo</strong> accepts the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Selects an alternate server.
Note: This option must occur before all others.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Shows a "long" listing of devices or drivers.
-<dt><b>--device-id </b><i>device-id-string</i>
-<dd style="margin-left: 5.0em">Specifies the IEEE-1284 device ID to match when listing drivers with the <i>-m</i> option.
-<dt><b>--exclude-schemes </b><i>scheme-list</i>
-<dd style="margin-left: 5.0em">Specifies a comma-delimited list of device or PPD schemes that should be excluded from the results.
-Static PPD files use the "file" scheme.
-<dt><b>--include-schemes </b><i>scheme-list</i>
-<dd style="margin-left: 5.0em">Specifies a comma-delimited list of device or PPD schemes that should be included in the results.
-Static PPD files use the "file" scheme.
-<dt><b>--language </b><i>locale</i>
-<dd style="margin-left: 5.0em">Specifies the language to match when listing drivers with the <i>-m</i> option.
-<dt><b>--make-and-model </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the make and model to match when listing drivers with the <i>-m</i> option.
-<dt><b>--product </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the product to match when listing drivers with the <i>-m</i> option.
-<dt><b>--timeout </b><i>seconds</i>
-<dd style="margin-left: 5.0em">Specifies the timeout when listing devices with the <i>-v</i> option.
-</dl>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The <i>lpinfo</i> command is unique to CUPS.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-List all devices:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Shows a "long" listing of devices or drivers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--device-id </strong><em>device-id-string</em><br>
+Specifies the IEEE-1284 device ID to match when listing drivers with the <em>-m</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--exclude-schemes </strong><em>scheme-list</em><br>
+Specifies a comma-delimited list of device or PPD schemes that should be excluded from the results.
+Static PPD files use the "file" scheme.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--include-schemes </strong><em>scheme-list</em><br>
+Specifies a comma-delimited list of device or PPD schemes that should be included in the results.
+Static PPD files use the "file" scheme.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--language </strong><em>locale</em><br>
+Specifies the language to match when listing drivers with the <em>-m</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--make-and-model </strong><em>name</em><br>
+Specifies the make and model to match when listing drivers with the <em>-m</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--product </strong><em>name</em><br>
+Specifies the product to match when listing drivers with the <em>-m</em> option.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--timeout </strong><em>seconds</em><br>
+Specifies the timeout when listing devices with the <em>-v</em> option.
+</p>
+ <h2 id="lpinfo-8.conforming-to">Conforming To</h2>
+<p>The <em>lpinfo</em> command is unique to CUPS.
+</p>
+ <h2 id="lpinfo-8.examples">Examples</h2>
+<p>List all devices:
+</p>
+ <pre>
lpinfo -v
</pre>
-List all drivers:
-<pre class="man">
+<p>List all drivers:
+</p>
+ <pre>
lpinfo -m
</pre>
-List drivers matching "HP LaserJet":
-<pre class="man">
- lpinfo --make-and-model "HP LaserJet" -m
+<p>List drivers matching "HP LaserJet":
+</p>
+ <pre>
+ lpinfo --make-and-model "HP LaserJet" -m
</pre>
-<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.
+ <h2 id="lpinfo-8.notes">Notes</h2>
+<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</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 © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="lpinfo-8.see-also">See Also</h2>
+<p><strong>lpadmin</strong>(8),
-</body>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpinfo-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpmove(8)</title>
-</head>
-<body>
-<h1 class="title">lpmove(8)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpmove - move a job or all jobs to a new destination
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpmove</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpmove(8)</title>
+ </head>
+ <body>
+ <h1 id="lpmove-8">lpmove(8)</h1>
+ <h2 id="lpmove-8.name">Name</h2>
+<p>lpmove - move a job or all jobs to a new destination
+</p>
+ <h2 id="lpmove-8.synopsis">Synopsis</h2>
+<p><strong>lpmove</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
]
-<i>job</i>
-<i>destination</i>
+<em>job</em>
+<em>destination</em>
<br>
-<b>lpmove</b>
+<strong>lpmove</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
]
-<i>source</i>
-<i>destination</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpmove</b> moves the specified <i>job</i> or all jobs from <i>source</i> to <i>destination</i>. <i>job</i> can be the job ID number or the old destination and job ID.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The <b>lpmove</b> command supports the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate server.
+<em>source</em>
+<em>destination</em>
+</p>
+ <h2 id="lpmove-8.description">Description</h2>
+<p><strong>lpmove</strong> moves the specified <em>job</em> or all jobs from <em>source</em> to <em>destination</em>. <em>job</em> can be the job ID number or the old destination and job ID.
+</p>
+ <h2 id="lpmove-8.options">Options</h2>
+<p>The <strong>lpmove</strong> command supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-</dl>
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Move job 123 from "oldprinter" to "newprinter":
-<pre class="man">
+</p>
+ <h2 id="lpmove-8.examples">Examples</h2>
+<p>Move job 123 from "oldprinter" to "newprinter":
+</p>
+ <pre>
lpmove 123 newprinter
- <i>or</i>
+ <em>or</em>
lpmove oldprinter-123 newprinter
</pre>
-Move all jobs from "oldprinter" to "newprinter":
-<pre class="man">
+<p>Move all jobs from "oldprinter" to "newprinter":
+</p>
+ <pre>
lpmove oldprinter newprinter
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
+ <h2 id="lpmove-8.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lp</strong>(1),
+
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
-
-</body>
+</p>
+ <h2 id="lpmove-8.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpoptions(1)</title>
-</head>
-<body>
-<h1 class="title">lpoptions(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpoptions - display or set printer options and defaults
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpoptions</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpoptions(1)</title>
+ </head>
+ <body>
+ <h1 id="lpoptions-1">lpoptions(1)</h1>
+ <h2 id="lpoptions-1.name">Name</h2>
+<p>lpoptions - display or set printer options and defaults
+</p>
+ <h2 id="lpoptions-1.synopsis">Synopsis</h2>
+<p><strong>lpoptions</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
]
-<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-d </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
[
-<b>-l</b>
+<strong>-l</strong>
]
<br>
-<b>lpoptions</b>
+<strong>lpoptions</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
]
-<b>-o </b><i>option</i>[<b>=</b><i>value</i>] ...
+<strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>] ...
<br>
-<b>lpoptions</b>
+<strong>lpoptions</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
]
-<b>-r</b>
-<i>option</i>
+<strong>-r</strong>
+<em>option</em>
<br>
-<b>lpoptions</b>
+<strong>lpoptions</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
]
-<b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpoptions</b> displays or sets printer options and defaults.
-If no printer is specified using the <i>-p</i> option, the default printer is used as described in
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1).</a>
-<p>If no <i>-l</i>, <i>-o</i>, or <i>-r</i> options are specified, the current options are reported on the standard output.
-<p>Options set with the <b>lpoptions</b> command are used by the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+<strong>-x </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
+</p>
+ <h2 id="lpoptions-1.description">Description</h2>
+<p><strong>lpoptions</strong> displays or sets printer options and defaults.
+If no printer is specified using the <em>-p</em> option, the default printer is used as described in
+<strong>lp</strong>(1).
+
+</p>
+ <p>If no <em>-l</em>, <em>-o</em>, or <em>-r</em> options are specified, the current options are reported on the standard output.
+</p>
+ <p>Options set with the <strong>lpoptions</strong> command are used by the
+<strong>lp</strong>(1)
+
and
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<strong>lpr</strong>(1)
+
commands when submitting jobs.
-<p>When run by the root user, <b>lpoptions</b> gets and sets default options and instances for all users in the <i>/etc/cups/lpoptions</i> file.
-Otherwise, the per-user defaults are managed in the <i>~/.cups/lpoptions</i> file.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>lpoptions</b> supports the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Enables encryption when communicating with the CUPS server.
-<dt><b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
-<dd style="margin-left: 5.0em">Sets the user default printer to <i>destination</i>.
-If <i>instance</i> is supplied then that particular instance is used.
+</p>
+ <p>When run by the root user, <strong>lpoptions</strong> gets and sets default options and instances for all users in the <em>/etc/cups/lpoptions</em> file.
+Otherwise, the per-user defaults are managed in the <em>~/.cups/lpoptions</em> file.
+</p>
+ <h2 id="lpoptions-1.options">Options</h2>
+<p><strong>lpoptions</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Enables encryption when communicating with the CUPS server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
+Sets the user default printer to <em>destination</em>.
+If <em>instance</em> is supplied then that particular instance is used.
This option overrides the system default printer for the current user.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Uses an alternate server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Uses an alternate server.
Note: This option must occur before all others.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Lists the printer specific options and their current settings.
-<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
-<dd style="margin-left: 5.0em">Specifies a new option for the named destination.
-<dt><b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
-<dd style="margin-left: 5.0em">Sets the destination and instance, if specified, for any options that follow.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Lists the printer specific options and their current settings.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]<br>
+Specifies a new option for the named destination.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
+Sets the destination and instance, if specified, for any options that follow.
If the named instance does not exist then it is created.
Destinations can only be created using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<strong>lpadmin</strong>(8)
+
program.
-<dt><b>-r </b><i>option</i>
-<dd style="margin-left: 5.0em">Removes the specified option from the named destination.
-<dt><b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
-<dd style="margin-left: 5.0em">Removes the options for the named destination and instance, if specified.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>option</em><br>
+Removes the specified option from the named destination.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-x </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
+Removes the options for the named destination and instance, if specified.
If the named instance does not exist then this does nothing.
Destinations can only be removed using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<strong>lpadmin</strong>(8)
+
command.
-</dl>
-<h2 class="title"><a name="FILES">Files</a></h2>
-<i>~/.cups/lpoptions</i> - user defaults and instances created by non-root users.
+</p>
+ <h2 id="lpoptions-1.files">Files</h2>
+<p><em>~/.cups/lpoptions</em> - user defaults and instances created by non-root users.
<br>
-<i>/etc/cups/lpoptions</i> - system-wide defaults and instances created by the root user.
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The <b>lpoptions</b> command is unique to CUPS.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</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 © 2021-2023 by OpenPrinting.
+<em>/etc/cups/lpoptions</em> - system-wide defaults and instances created by the root user.
+</p>
+ <h2 id="lpoptions-1.conforming-to">Conforming To</h2>
+<p>The <strong>lpoptions</strong> command is unique to CUPS.
+</p>
+ <h2 id="lpoptions-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
-</body>
+<strong>lp</strong>(1),
+
+<strong>lpadmin</strong>(8),
+
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpoptions-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpq(1)</title>
-</head>
-<body>
-<h1 class="title">lpq(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpq - show printer queue status
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpq</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpq(1)</title>
+ </head>
+ <body>
+ <h1 id="lpq-1">lpq(1)</h1>
+ <h2 id="lpq-1.name">Name</h2>
+<p>lpq - show printer queue status
+</p>
+ <h2 id="lpq-1.synopsis">Synopsis</h2>
+<p><strong>lpq</strong>
[
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-P </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-P </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
] [
-<b>-a</b>
+<strong>-a</strong>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>+</b><i>interval</i>
+<strong>+</strong><em>interval</em>
+
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpq</b> shows the current print queue status on the named printer.
+</p>
+ <h2 id="lpq-1.description">Description</h2>
+<p><strong>lpq</strong> shows the current print queue status on the named printer.
Jobs queued on the default destination will be shown if no printer or class is specified on the command-line.
-<p>The <i>+interval</i> option allows you to continuously report the jobs in the queue until the queue is empty; the list of jobs is shown once every <i>interval</i> seconds.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>lpq</b> supports the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-P </b><i>destination</i>[<b>/</b><i>instance</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate printer or class name.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username.
-<dt><b>-a</b>
-<dd style="margin-left: 5.0em">Reports jobs on all printers.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate server.
+</p>
+ <p>The <em>+interval</em> option allows you to continuously report the jobs in the queue until the queue is empty; the list of jobs is shown once every <em>interval</em> seconds.
+</p>
+ <h2 id="lpq-1.options">Options</h2>
+<p><strong>lpq</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
+Specifies an alternate printer or class name.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a</strong><br>
+Reports jobs on all printers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Requests a more verbose (long) reporting format.
-</dl>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</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 © 2021-2023 by OpenPrinting.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Requests a more verbose (long) reporting format.
+</p>
+ <h2 id="lpq-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lp</strong>(1),
+
+<strong>lpr</strong>(1),
-</body>
+<strong>lprm</strong>(1),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpq-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpr(1)</title>
-</head>
-<body>
-<h1 class="title">lpr(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpr - print files
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpr</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpr(1)</title>
+ </head>
+ <body>
+ <h1 id="lpr-1">lpr(1)</h1>
+ <h2 id="lpr-1.name">Name</h2>
+<p>lpr - print files
+</p>
+ <h2 id="lpr-1.synopsis">Synopsis</h2>
+<p><strong>lpr</strong>
[
-<b>-H </b><i>server</i>[<b>:</b><i>port</i>]
+<strong>-H </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-P </b><i>destination</i>[<b>/</b><i>instance</i>]
+<strong>-P </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
] [
-<b>-#</b>
-<i>num-copies</i>
+<strong>-#</strong>
+<em>num-copies</em>
[
-<b>-h</b>
+<strong>-h</strong>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>-m</b>
+<strong>-m</strong>
] [
-<b>-o </b><i>option</i>[<b>=</b><i>value</i>]
+<strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]
] [
-<b>-p</b>
+<strong>-p</strong>
] [
-<b>-q</b>
+<strong>-q</strong>
] [
-<b>-r</b>
+<strong>-r</strong>
] [
-<b>-C</b>
-<i>title</i>
+<strong>-C</strong>
+<em>title</em>
] [
-<b>-J</b>
-<i>title</i>
+<strong>-J</strong>
+<em>title</em>
] [
-<b>-T</b>
-<i>title</i>
+<strong>-T</strong>
+<em>title</em>
] [
-<i>file(s)</i>
+<em>file(s)</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpr</b> submits files for printing.
+</p>
+ <h2 id="lpr-1.description">Description</h2>
+<p><strong>lpr</strong> submits files for printing.
Files named on the command line are sent to the named printer or the default destination if no destination is specified.
-If no files are listed on the command-line, <b>lpr</b> reads the print file from the standard input.
-<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 no files are listed on the command-line, <strong>lpr</strong> reads the print file from the standard input.
+</p>
+ <h3 id="lpr-1.description.the-default-destination">The Default Destination</h3>
+<p>CUPS provides many ways to set the default destination. The <strong>LPDEST</strong> and <strong>PRINTER</strong> 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>
+<strong>lpoptions</strong>(1)
+
command is used, followed by the default set using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<strong>lpadmin</strong>(8)
+
command.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by <i>lpr</i>:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-H </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate server.
+</p>
+ <h2 id="lpr-1.options">Options</h2>
+<p>The following options are recognized by <em>lpr</em>:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-<dt><b>-C "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>-J "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>-T "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em">Sets the job name/title.
-<dt><b>-P </b><i>destination</i>[<b>/</b><i>instance</i>]
-<dd style="margin-left: 5.0em">Prints files to the named printer.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username.
-<dt><b>-# </b><i>copies</i>
-<dd style="margin-left: 5.0em">Sets the number of copies to print.
-<dt><b>-h</b>
-<dd style="margin-left: 5.0em">Disables banner printing. This option is equivalent to <i>-o job-sheets=none</i>.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Specifies that the print file is already formatted for the destination and should be sent without filtering.
-This option is equivalent to <i>-o raw</i>.
-<dt><b>-m</b>
-<dd style="margin-left: 5.0em">Send an email on job completion.
-<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
-<dd style="margin-left: 5.0em">Sets a job option.
-See "COMMON JOB OPTIONS" below.
-<dt><b>-p</b>
-<dd style="margin-left: 5.0em">Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number.
-This option is equivalent to <i>-o prettyprint</i> and is only useful when printing text files.
-<dt><b>-q</b>
-<dd style="margin-left: 5.0em">Hold job for printing.
-<dt><b>-r</b>
-<dd style="margin-left: 5.0em">Specifies that the named print files should be deleted after submitting them.
-</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>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-C "</strong><em>name</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-J "</strong><em>name</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-T "</strong><em>name</em><strong>"</strong><br>
+Sets the job name/title.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
+Prints files to the named printer.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-# </strong><em>copies</em><br>
+Sets the number of copies to print.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h</strong><br>
+Disables banner printing. This option is equivalent to <em>-o job-sheets=none</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Specifies that the print file is already formatted for the destination and should be sent without filtering.
+This option is equivalent to <em>-o raw</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m</strong><br>
+Send an email on job completion.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]<br>
+Sets a job option.
+See "COMMON JOB OPTIONS" below.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p</strong><br>
+Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number.
+This option is equivalent to <em>-o prettyprint</em> and is only useful when printing text files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-q</strong><br>
+Hold job for printing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r</strong><br>
+Specifies that the named print files should be deleted after submitting them.
+</p>
+ <h3 id="lpr-1.options.common-job-options">Common Job Options</h3>
+<p>Aside from the printer-specific options reported by the
+<strong>lpoptions</strong>(1)
+
command, the following generic options are available:
-<dl class="man">
-<dt><b>-o job-sheets=</b><i>name</i>
-<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
-The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
-<dt><b>-o media=</b><i>size</i>
-<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal".
-<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
-<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
-<dt><b>-o orientation-requested=4</b>
-<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
-<dt><b>-o orientation-requested=5</b>
-<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
-<dt><b>-o orientation-requested=6</b>
-<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
-<dt><b>-o print-quality=3</b>
-<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
-<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
-<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
-<dt><b>-o sides=one-sided</b>
-<dd style="margin-left: 5.0em">Prints on one side of the paper.
-<dt><b>-o sides=two-sided-long-edge</b>
-<dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output.
-<dt><b>-o sides=two-sided-short-edge</b>
-<dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-The <i>-c</i>, <i>-d</i>, <i>-f</i>, <i>-g</i>, <i>-i</i>, <i>-n</i>, <i>-t</i>, <i>-v</i>, and <i>-w</i> options are not supported by CUPS and produce a warning message if used.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Print two copies of a document to the default printer:
-<pre class="man">
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o job-sheets=</strong><em>name</em><br>
+Prints a cover page (banner) with the document.
+The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o media=</strong><em>size</em><br>
+Sets the page size to <em>size</em>. Most printers support at least the size names "a4", "letter", and "legal".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o number-up=</strong>{<em>2|4|6|9|16</em>}<br>
+Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=4</strong><br>
+Prints the job in landscape (rotated 90 degrees counter-clockwise).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=5</strong><br>
+Prints the job in landscape (rotated 90 degrees clockwise).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o orientation-requested=6</strong><br>
+Prints the job in reverse portrait (rotated 180 degrees).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=3</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=4</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o print-quality=5</strong><br>
+Specifies the output quality - draft (3), normal (4), or best (5).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=one-sided</strong><br>
+Prints on one side of the paper.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=two-sided-long-edge</strong><br>
+Prints on both sides of the paper for portrait output.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=two-sided-short-edge</strong><br>
+Prints on both sides of the paper for landscape output.
+</p>
+ <h2 id="lpr-1.notes">Notes</h2>
+<p>The <em>-c</em>, <em>-d</em>, <em>-f</em>, <em>-g</em>, <em>-i</em>, <em>-n</em>, <em>-t</em>, <em>-v</em>, and <em>-w</em> options are not supported by CUPS and produce a warning message if used.
+</p>
+ <h2 id="lpr-1.examples">Examples</h2>
+<p>Print two copies of a document to the default printer:
+</p>
+ <pre>
lpr -# 2 filename
</pre>
-Print a double-sided legal document to a printer called "foo":
-<pre class="man">
+<p>Print a double-sided legal document to a printer called "foo":
+</p>
+ <pre>
lpr -P foo -o media=legal -o sides=two-sided-long-edge filename
</pre>
-Print a presentation document 2-up to a printer called "foo":
-<pre class="man">
+<p>Print a presentation document 2-up to a printer called "foo":
+</p>
+ <pre>
lpr -P foo -o number-up=2 filename
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</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 © 2021-2023 by OpenPrinting.
+ <h2 id="lpr-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lp</strong>(1),
+
+<strong>lpadmin</strong>(8),
-</body>
+<strong>lpoptions</strong>(1),
+
+<strong>lpq</strong>(1),
+
+<strong>lprm</strong>(1),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpr-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lprm(1)</title>
-</head>
-<body>
-<h1 class="title">lprm(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lprm - cancel print jobs
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lprm</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lprm(1)</title>
+ </head>
+ <body>
+ <h1 id="lprm-1">lprm(1)</h1>
+ <h2 id="lprm-1.name">Name</h2>
+<p>lprm - cancel print jobs
+</p>
+ <h2 id="lprm-1.synopsis">Synopsis</h2>
+<p><strong>lprm</strong>
[
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-P</b>
-<i>destination</i>[<i>/instance</i>]
+<strong>-P</strong>
+<em>destination</em>[<em>/instance</em>]
+
] [
-<b>-</b>
+<strong>-</strong>
] [
-<i>job-id(s)</i>
+<em>job-id(s)</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lprm</b>
+</p>
+ <h2 id="lprm-1.description">Description</h2>
+<p><strong>lprm</strong>
cancels print jobs that have been queued for printing.
If no arguments are supplied, the current job on the default destination is canceled.
-You can specify one or more job ID numbers to cancel those jobs or use the <i>-</i> option to cancel all jobs.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The
-<b>lprm</b>
+You can specify one or more job ID numbers to cancel those jobs or use the <em>-</em> option to cancel all jobs.
+</p>
+ <h2 id="lprm-1.options">Options</h2>
+<p>The
+<strong>lprm</strong>
command supports the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-P </b><i>destination</i>[<i>/instance</i>]
-<dd style="margin-left: 5.0em">Specifies the destination printer or class.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username.
-<dt><b>-h </b><i>server</i>[<i>:port</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-P </strong><em>destination</em>[<em>/instance</em>]<br>
+Specifies the destination printer or class.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<em>:port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-</dl>
-<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
-The CUPS version of
-<b>lprm</b>
+</p>
+ <h2 id="lprm-1.conforming-to">Conforming To</h2>
+<p>The CUPS version of
+<strong>lprm</strong>
is compatible with the standard Berkeley command of the same name.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Cancel the current job on the default printer:
-<pre class="man">
+</p>
+ <h2 id="lprm-1.examples">Examples</h2>
+<p>Cancel the current job on the default printer:
+</p>
+ <pre>
lprm
</pre>
-Cancel job 1234:
-<pre class="man">
+<p>Cancel job 1234:
+</p>
+ <pre>
lprm 1234
</pre>
-Cancel all jobs:
-<pre class="man">
+<p>Cancel all jobs:
+</p>
+ <pre>
lprm -
</pre>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</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 © 2021-2023 by OpenPrinting.
+ <h2 id="lprm-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lp</strong>(1),
+
+<strong>lpq</strong>(1),
-</body>
+<strong>lpr</strong>(1),
+
+<strong>lpstat</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lprm-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>lpstat(1)</title>
-</head>
-<body>
-<h1 class="title">lpstat(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-lpstat - print cups status information
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpstat</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>lpstat(1)</title>
+ </head>
+ <body>
+ <h1 id="lpstat-1">lpstat(1)</h1>
+ <h2 id="lpstat-1.name">Name</h2>
+<p>lpstat - print cups status information
+</p>
+ <h2 id="lpstat-1.synopsis">Synopsis</h2>
+<p><strong>lpstat</strong>
[
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
+<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
-<b>-E</b>
+<strong>-E</strong>
] [
-<b>-H</b>
+<strong>-H</strong>
] [
-<b>-U</b>
-<i>username</i>
+<strong>-U</strong>
+<em>username</em>
] [
-<b>-l</b>
+<strong>-l</strong>
] [
-<b>-W</b>
-<i>which-jobs</i>
+<strong>-W</strong>
+<em>which-jobs</em>
] [
-<b>-a</b>
+<strong>-a</strong>
[
-<i>destination(s)</i>
+<em>destination(s)</em>
] ] [
-<b>-c</b>
+<strong>-c</strong>
[
-<i>class(es)</i>
+<em>class(es)</em>
] ] [
-<b>-d</b>
+<strong>-d</strong>
] [
-<b>-e</b>
+<strong>-e</strong>
] [
-<b>-o</b>
+<strong>-o</strong>
[
-<i>destination(s)</i>
+<em>destination(s)</em>
] ] [
-<b>-p</b>
+<strong>-p</strong>
[
-<i>printer(s)</i>
+<em>printer(s)</em>
] ] [
-<b>-r</b>
+<strong>-r</strong>
] [
-<b>-R</b>
+<strong>-R</strong>
] [
-<b>-s</b>
+<strong>-s</strong>
] [
-<b>-t</b>
+<strong>-t</strong>
] [
-<b>-u</b>
+<strong>-u</strong>
[
-<i>user(s)</i>
+<em>user(s)</em>
] ] [
-<b>-v</b>
+<strong>-v</strong>
[
-<i>printer(s)</i>
+<em>printer(s)</em>
] ]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>lpstat</b> displays status information about the current classes, jobs, and printers.
-When run with no arguments, <b>lpstat</b> will list active jobs queued by the current user.
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-The <b>lpstat</b> command supports the following options:
-<dl class="man">
-<dt><b>-E</b>
-<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
-<dt><b>-H</b>
-<dd style="margin-left: 5.0em">Shows the server hostname and port.
-<dt><b>-R</b>
-<dd style="margin-left: 5.0em">Shows the ranking of print jobs.
-<dt><b>-U </b><i>username</i>
-<dd style="margin-left: 5.0em">Specifies an alternate username.
-<dt><b>-W </b><i>which-jobs</i>
-<dd style="margin-left: 5.0em">Specifies which jobs to show, "completed" or "not-completed" (the default).
-This option <i>must</i> appear before the <i>-o</i> option and/or any printer names, otherwise the default ("not-completed") value will be used in the request to the scheduler.
-<dt><b>-a </b>[<i>printer(s)</i>]
-<dd style="margin-left: 5.0em">Shows the accepting state of printer queues.
+</p>
+ <h2 id="lpstat-1.description">Description</h2>
+<p><strong>lpstat</strong> displays status information about the current classes, jobs, and printers.
+When run with no arguments, <strong>lpstat</strong> will list active jobs queued by the current user.
+</p>
+ <h2 id="lpstat-1.options">Options</h2>
+<p>The <strong>lpstat</strong> command supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
+Forces encryption when connecting to the server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H</strong><br>
+Shows the server hostname and port.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-R</strong><br>
+Shows the ranking of print jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
+Specifies an alternate username.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W </strong><em>which-jobs</em><br>
+Specifies which jobs to show, "completed" or "not-completed" (the default).
+This option <em>must</em> appear before the <em>-o</em> option and/or any printer names, otherwise the default ("not-completed") value will be used in the request to the scheduler.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong>[<em>printer(s)</em>]<br>
+Shows the accepting state of printer queues.
If no printers are specified then all printers are listed.
-<dt><b>-c </b>[<i>class(es)</i>]
-<dd style="margin-left: 5.0em">Shows the printer classes and the printers that belong to them.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong>[<em>class(es)</em>]<br>
+Shows the printer classes and the printers that belong to them.
If no classes are specified then all classes are listed.
-<dt><b>-d</b>
-<dd style="margin-left: 5.0em">Shows the current default destination.
-<dt><b>-e</b>
-<dd style="margin-left: 5.0em">Shows all available destinations on the local network.
-<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
-<dd style="margin-left: 5.0em">Specifies an alternate server.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d</strong><br>
+Shows the current default destination.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-e</strong><br>
+Shows all available destinations on the local network.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
+Specifies an alternate server.
Note: This option must occur before all others.
-<dt><b>-l</b>
-<dd style="margin-left: 5.0em">Shows a long listing of printers, classes, or jobs.
-<dt><b>-o </b>[<i>destination(s)</i>]
-<dd style="margin-left: 5.0em">Shows the jobs queued on the specified destinations.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
+Shows a long listing of printers, classes, or jobs.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong>[<em>destination(s)</em>]<br>
+Shows the jobs queued on the specified destinations.
If no destinations are specified all jobs are shown.
-<dt><b>-p </b>[<i>printer(s)</i>]
-<dd style="margin-left: 5.0em">Shows the printers and whether they are enabled for printing.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong>[<em>printer(s)</em>]<br>
+Shows the printers and whether they are enabled for printing.
If no printers are specified then all printers are listed.
-<dt><b>-r</b>
-<dd style="margin-left: 5.0em">Shows whether the CUPS server is running.
-<dt><b>-s</b>
-<dd style="margin-left: 5.0em">Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices.
-This is equivalent to using the <i>-d</i>, <i>-c</i>, and <i>-v</i> options.
-<dt><b>-t</b>
-<dd style="margin-left: 5.0em">Shows all status information.
-This is equivalent to using the <i>-r</i>, <i>-d</i>, <i>-c</i>, <i>-v</i>, <i>-a</i>, <i>-p</i>, and <i>-o</i> options.
-<dt><b>-u </b>[<i>user(s)</i>]
-<dd style="margin-left: 5.0em">Shows a list of print jobs queued by the specified users.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r</strong><br>
+Shows whether the CUPS server is running.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s</strong><br>
+Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices.
+This is equivalent to using the <em>-d</em>, <em>-c</em>, and <em>-v</em> options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t</strong><br>
+Shows all status information.
+This is equivalent to using the <em>-r</em>, <em>-d</em>, <em>-c</em>, <em>-v</em>, <em>-a</em>, <em>-p</em>, and <em>-o</em> options.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong>[<em>user(s)</em>]<br>
+Shows a list of print jobs queued by the specified users.
If no users are specified, lists the jobs queued by the current user.
-<dt><b>-v </b>[<i>printer(s)</i>]
-<dd style="margin-left: 5.0em">Shows the printers and what device they are attached to.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v </strong>[<em>printer(s)</em>]<br>
+Shows the printers and what device they are attached to.
If no printers are specified then all printers are listed.
-</dl>
-<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, "/", and "#".
-Also, printer and class names are <i>not</i> case-sensitive.
-<p>The <i>-h</i>, <i>-e</i>, <i>-E</i>, <i>-U</i>, and <i>-W</i> options are unique to CUPS.
-<p>The Solaris <i>-f</i>, <i>-P</i>, and <i>-S</i> options are silently ignored.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</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 © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="lpstat-1.conforming-to">Conforming To</h2>
+<p>Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#".
+Also, printer and class names are <em>not</em> case-sensitive.
+</p>
+ <p>The <em>-h</em>, <em>-e</em>, <em>-E</em>, <em>-U</em>, and <em>-W</em> options are unique to CUPS.
+</p>
+ <p>The Solaris <em>-f</em>, <em>-P</em>, and <em>-S</em> options are silently ignored.
+</p>
+ <h2 id="lpstat-1.see-also">See Also</h2>
+<p><strong>cancel</strong>(1),
+
+<strong>lp</strong>(1),
+
+<strong>lpq</strong>(1),
-</body>
+<strong>lpr</strong>(1),
+
+<strong>lprm</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="lpstat-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>mailto.conf(5)</title>
-</head>
-<body>
-<h1 class="title">mailto.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-mailto.conf - configuration file for cups email notifier
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>mailto.conf</b> file defines the local mail server and email notification preferences for CUPS.
-<p>Each line in the file can be a configuration directive, a blank line, or a comment.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>mailto.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="mailto.conf-5">mailto.conf(5)</h1>
+ <h2 id="mailto.conf-5.name">Name</h2>
+<p>mailto.conf - configuration file for cups email notifier
+</p>
+ <h2 id="mailto.conf-5.description">Description</h2>
+<p>The <strong>mailto.conf</strong> file defines the local mail server and email notification preferences for CUPS.
+</p>
+ <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.
The configuration directive name and values are case-insensitive.
Comment lines start with the # character.
-<h3><a name="DIRECTIVES">Directives</a></h3>
-<dl class="man">
-<dt><b>Cc </b><i>cc-address@domain.com</i>
-<dd style="margin-left: 5.0em">Specifies an additional recipient for all email notifications.
-<dt><b>From </b><i>from-address@domain.com</i>
-<dd style="margin-left: 5.0em">Specifies the sender of email notifications.
-<dt><b>Sendmail </b><i>sendmail command and options</i>
-<dd style="margin-left: 5.0em">Specifies the sendmail command to use when sending email notifications.
-Only one <i>Sendmail</i> or <i>SMTPServer</i> line may be present in the <b>mailto.conf</b> file.
+</p>
+ <h3 id="mailto.conf-5.description.directives">Directives</h3>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Cc </strong><em>cc-address@domain.com</em><br>
+Specifies an additional recipient for all email notifications.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>From </strong><em>from-address@domain.com</em><br>
+Specifies the sender of email notifications.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Sendmail </strong><em>sendmail command and options</em><br>
+Specifies the sendmail command to use when sending email notifications.
+Only one <em>Sendmail</em> or <em>SMTPServer</em> line may be present in the <strong>mailto.conf</strong> file.
If multiple lines are present, only the last one is used.
-<dt><b>SMTPServer </b><i>servername</i>
-<dd style="margin-left: 5.0em">Specifies a SMTP server to send email notifications to.
-Only one <i>Sendmail</i> or <i>SMTPServer</i> line may be present in the <b>mailto.conf</b> file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SMTPServer </strong><em>servername</em><br>
+Specifies a SMTP server to send email notifications to.
+Only one <em>Sendmail</em> or <em>SMTPServer</em> line may be present in the <strong>mailto.conf</strong> file.
If multiple lines are present, only the last one is used.
-<dt><b>Subject </b><i>subject-prefix</i>
-<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>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Subject </strong><em>subject-prefix</em><br>
+Specifies a prefix string for the subject line of an email notification.
+</p>
+ <h2 id="mailto.conf-5.see-also">See Also</h2>
+<p><strong>cupsd</strong>(8),
-</body>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="mailto.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>mime.convs(5)</title>
-</head>
-<body>
-<h1 class="title">mime.convs(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-mime.convs - mime type conversion file for cups (deprecated)
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>mime.convs(5)</title>
+ </head>
+ <body>
+ <h1 id="mime.convs-5">mime.convs(5)</h1>
+ <h2 id="mime.convs-5.name">Name</h2>
+<p>mime.convs - mime type conversion file for cups (deprecated)
+</p>
+ <h2 id="mime.convs-5.description">Description</h2>
+<p>The <strong>mime.convs</strong> file defines the filters that are available for converting files from one format to another.
The standard filters support text, PDF, PostScript, and many types of image files.
-<p>Additional filters are specified in files with the extension <i>.convs</i> in the CUPS configuration directory.
-<p>Each line in the <b>mime.convs</b> file is a comment, blank, or filter
+</p>
+ <p>Additional filters are specified in files with the extension <em>.convs</em> in the CUPS configuration directory.
+</p>
+ <p>Each line in the <strong>mime.convs</strong> file is a comment, blank, or filter
line.
Comment lines start with the # character.
Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
-<pre class="man">
+</p>
+ <pre>
source/type destination/type cost filter
</pre>
-The <i>source/type</i> field specifies the source MIME media type that is consumed by the filter.
-<p>The <i>destination/type</i> field specifies the destination MIME media type that is produced by the filter.
-<p>The <i>cost</i> field specifies the relative cost for running the filter.
+<p>The <em>source/type</em> field specifies the source MIME media type that is consumed by the filter.
+</p>
+ <p>The <em>destination/type</em> field specifies the destination MIME media type that is produced by the filter.
+</p>
+ <p>The <em>cost</em> field specifies the relative cost for running the filter.
A value of 100 means that the filter uses a large amount of resources while a value of 0 means that the filter uses very few resources.
-<p>The <i>filter</i> field specifies the filter program filename.
+</p>
+ <p>The <em>filter</em> field specifies the filter program filename.
Filenames are relative to the CUPS filter directory.
-<h2 class="title"><a name="FILES">Files</a></h2>
-<i>/etc/cups</i> - Typical CUPS configuration directory.
+</p>
+ <h2 id="mime.convs-5.files">Files</h2>
+<p><em>/etc/cups</em> - Typical CUPS configuration directory.
<br>
-<i>/usr/lib/cups/filter</i> - Typical CUPS filter directory.
+<em>/usr/lib/cups/filter</em> - Typical CUPS filter directory.
<br>
-<i>/usr/libexec/cups/filter</i> - CUPS filter directory on macOS.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Define a filter that converts PostScript documents to CUPS Raster format:
-<pre class="man">
+<em>/usr/libexec/cups/filter</em> - CUPS filter directory on macOS.
+</p>
+ <h2 id="mime.convs-5.examples">Examples</h2>
+<p>Define a filter that converts PostScript documents to CUPS Raster format:
+</p>
+ <pre>
application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
</pre>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
+ <h2 id="mime.convs-5.notes">Notes</h2>
+<p>CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<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>
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="mime.convs-5.see-also">See Also</h2>
+<p><strong>cups-files.conf</strong>(5),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
-</body>
+<strong>cupsfilter</strong>(8),
+
+<strong>mime.types</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="mime.convs-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>mime.types(5)</title>
-</head>
-<body>
-<h1 class="title">mime.types(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-mime.types - mime type description file for cups
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>mime.types</b> file defines the recognized file types.
-<p>Additional file types are specified in files with the extension <i>.types</i> in the CUPS configuration directory.
-<p>Each line in the <b>mime.types</b> file is a comment, blank, or rule line.
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>mime.types(5)</title>
+ </head>
+ <body>
+ <h1 id="mime.types-5">mime.types(5)</h1>
+ <h2 id="mime.types-5.name">Name</h2>
+<p>mime.types - mime type description file for cups
+</p>
+ <h2 id="mime.types-5.description">Description</h2>
+<p>The <strong>mime.types</strong> file defines the recognized file types.
+</p>
+ <p>Additional file types are specified in files with the extension <em>.types</em> in the CUPS configuration directory.
+</p>
+ <p>Each line in the <strong>mime.types</strong> file is a comment, blank, or rule line.
Comment lines start with the # character.
Rule lines start with the MIME media type and are optionally followed by a series of file recognition rules:
-<pre class="man">
- <i>mime/type </i>[ <i>rule </i>... <i>rule </i>]
+</p>
+ <pre>
+ <em>mime/type </em>[ <em>rule </em>... <em>rule </em>]
</pre>
-Rules can be extended over multiple lines using the backslash character (\):
-<pre class="man">
- <i>mime/type </i>[ <i>really-really-really-long-rule </i>... <b>\
- </b><i>rule </i>]
+<p>Rules can be extended over multiple lines using the backslash character (\):
+</p>
+ <pre>
+ <em>mime/type </em>[ <em>really-really-really-long-rule </em>... <strong>\
+ </strong><em>rule </em>]
</pre>
-MIME media types specified by the <i>mime/type</i> field are case-insensitive and are sorted in ascending alphanumeric order for the purposes of matching.
-See the "TYPE MATCHING AND PRIORITY" section for more information.
-<p>The rules may be grouped using parenthesis, joined using "+" for a logical AND, joined using "," or whitespace for a logical OR, and negated using "!".
-<h3><a name="RULES">Rules</a></h3>
-Rules take two forms - a filename extension by itself and functions with test
+<p>MIME media types specified by the <em>mime/type</em> field are case-insensitive and are sorted in ascending alphanumeric order for the purposes of matching.
+See the "TYPE MATCHING AND PRIORITY" section for more information.
+</p>
+ <p>The rules may be grouped using parenthesis, joined using "+" for a logical AND, joined using "," or whitespace for a logical OR, and negated using "!".
+</p>
+ <h3 id="mime.types-5.description.rules">Rules</h3>
+<p>Rules take two forms - a filename extension by itself and functions with test
values inside parenthesis.
The following functions are available:
-<dl class="man">
-<dt><b>match("</b><i>pattern</i><b>")</b>
-<dd style="margin-left: 5.0em">True if the filename matches the given shell wildcard <i>pattern</i>.
-<dt><b>ascii(</b><i>offset</i><b>,</b><i>length</i><b>)</b>
-<dd style="margin-left: 5.0em">True if the <i>length</i> bytes starting at <i>offset</i> are valid printable ASCII (CR, NL, TAB, BS, 32-126).
-<dt><b>printable(</b><i>offset</i><b>,</b><i>length</i><b>)</b>
-<dd style="margin-left: 5.0em">True if the <i>length</i> bytes starting at <i>offset</i> are printable 8-bit chars (CR, NL, TAB, BS, 32-126, 128-254).
-<dt><b>priority(</b><i>number</i><b>)</b>
-<dd style="margin-left: 5.0em">Specifies the relative priority of this MIME media type.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>match("</strong><em>pattern</em><strong>")</strong><br>
+True if the filename matches the given shell wildcard <em>pattern</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ascii(</strong><em>offset</em><strong>,</strong><em>length</em><strong>)</strong><br>
+True if the <em>length</em> bytes starting at <em>offset</em> are valid printable ASCII (CR, NL, TAB, BS, 32-126).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>printable(</strong><em>offset</em><strong>,</strong><em>length</em><strong>)</strong><br>
+True if the <em>length</em> bytes starting at <em>offset</em> are printable 8-bit chars (CR, NL, TAB, BS, 32-126, 128-254).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>priority(</strong><em>number</em><strong>)</strong><br>
+Specifies the relative priority of this MIME media type.
The default priority is 100.
Larger values have higher priority while smaller values have lower priority.
-<dt><b>string(</b><i>offset</i><b>,"</b><i>string</i><b>")</b>
-<dd style="margin-left: 5.0em">True if the bytes starting at <i>offset</i> are identical to <i>string</i>.
-<dt><b>istring(</b><i>offset</i><b>,"</b><i>string</i><b>")</b>
-<dd style="margin-left: 5.0em">True if the bytes starting at <i>offset</i> match <i>string</i> without respect to case.
-<dt><b>char(</b><i>offset</i><b>,</b><i>value</i><b>)</b>
-<dd style="margin-left: 5.0em">True if the byte at <i>offset</i> is identical to <i>value</i>.
-<dt><b>short(</b><i>offset</i><b>,</b><i>value</i><b>)</b>
-<dd style="margin-left: 5.0em">True if the 16-bit big-endian integer at <i>offset</i> is identical to <i>value</i>.
-<dt><b>int(</b><i>offset</i><b>,</b><i>value</i><b>)</b>
-<dd style="margin-left: 5.0em">True if the 32-bit big-endian integer at <i>offset</i> is identical to <i>value</i>.
-<dt><b>locale("</b><i>string</i><b>")</b>
-<dd style="margin-left: 5.0em">True if current locale matches <i>string</i>.
-<dt><b>contains(</b><i>offset</i><b>,</b><i>range</i><b>,"</b><i>string</i><b>")</b>
-<dd style="margin-left: 5.0em">True if the bytes starting at <i>offset</i> for <i>range</i> bytes contains <i>string</i>.
-</dl>
-<h3><a name="STRING_CONSTANTS">String Constants</a></h3>
-String constants can be specified inside quotes ("") for strings containing whitespace and angle brackets (<>) for hexadecimal strings.
-<h3><a name="TYPE_MATCHING_AND_PRIORITY">Type Matching And Priority</a></h3>
-When CUPS needs to determine the MIME media type of a given file, it checks every MIME media type defined in the <i>.types</i> files.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>string(</strong><em>offset</em><strong>,"</strong><em>string</em><strong>")</strong><br>
+True if the bytes starting at <em>offset</em> are identical to <em>string</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>istring(</strong><em>offset</em><strong>,"</strong><em>string</em><strong>")</strong><br>
+True if the bytes starting at <em>offset</em> match <em>string</em> without respect to case.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>char(</strong><em>offset</em><strong>,</strong><em>value</em><strong>)</strong><br>
+True if the byte at <em>offset</em> is identical to <em>value</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>short(</strong><em>offset</em><strong>,</strong><em>value</em><strong>)</strong><br>
+True if the 16-bit big-endian integer at <em>offset</em> is identical to <em>value</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>int(</strong><em>offset</em><strong>,</strong><em>value</em><strong>)</strong><br>
+True if the 32-bit big-endian integer at <em>offset</em> is identical to <em>value</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>locale("</strong><em>string</em><strong>")</strong><br>
+True if current locale matches <em>string</em>.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>contains(</strong><em>offset</em><strong>,</strong><em>range</em><strong>,"</strong><em>string</em><strong>")</strong><br>
+True if the bytes starting at <em>offset</em> for <em>range</em> bytes contains <em>string</em>.
+</p>
+ <h3 id="mime.types-5.description.string-constants">String Constants</h3>
+<p>String constants can be specified inside quotes ("") for strings containing whitespace and angle brackets (<>) for hexadecimal strings.
+</p>
+ <h3 id="mime.types-5.description.type-matching-and-priority">Type Matching And Priority</h3>
+<p>When CUPS needs to determine the MIME media type of a given file, it checks every MIME media type defined in the <em>.types</em> files.
When two or more types match a given file, the type chosen will depend on the type name and priority, with higher-priority types being used over lower-priority ones.
If the types have the same priority, the type names are sorted alphanumerically in ascending order and the first type is chosen.
-<p>For example, if two types "text/bar" and "text/foo" are defined as matching the
-extension "doc", normally the type "text/bar" will be chosen since its name is
-alphanumerically smaller than "text/foo".
-However, if "text/foo" also defines a higher priority than "text/bar", "text/foo" will be chosen instead.
-<h2 class="title"><a name="FILES">Files</a></h2>
-<i>/etc/cups</i> - Typical CUPS configuration directory.
-<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
-Define two MIME media types for raster data, with one being a subset with higher priority:
-<pre class="man">
- application/vnd.cups-raster string(0,"RaSt") string(0,"tSaR") \
- string(0,"RaS2") string(0,"2SaR") \
- string(0,"RaS3") string(0,"3SaR")
+</p>
+ <p>For example, if two types "text/bar" and "text/foo" are defined as matching the
+extension "doc", normally the type "text/bar" will be chosen since its name is
+alphanumerically smaller than "text/foo".
+However, if "text/foo" also defines a higher priority than "text/bar", "text/foo" will be chosen instead.
+</p>
+ <h2 id="mime.types-5.files">Files</h2>
+<p><em>/etc/cups</em> - Typical CUPS configuration directory.
+</p>
+ <h2 id="mime.types-5.examples">Examples</h2>
+<p>Define two MIME media types for raster data, with one being a subset with higher priority:
+</p>
+ <pre>
+ application/vnd.cups-raster string(0,"RaSt") string(0,"tSaR") \
+ string(0,"RaS2") string(0,"2SaR") \
+ string(0,"RaS3") string(0,"3SaR")
- image/pwg-raster string(0,"RaS2") + \
+ image/pwg-raster string(0,"RaS2") + \
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>
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+ <h2 id="mime.types-5.see-also">See Also</h2>
+<p><strong>cups-files.conf</strong>(5),
+
+<strong>cupsd.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
-</body>
+<strong>cupsfilter</strong>(8),
+
+<strong>mime.convs</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="mime.types-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>notifier(7)</title>
-</head>
-<body>
-<h1 class="title">notifier(7)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-notifier - cups notification interface
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>notifier</b>
-<i>recipient</i>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>notifier(7)</title>
+ </head>
+ <body>
+ <h1 id="notifier-7">notifier(7)</h1>
+ <h2 id="notifier-7.name">Name</h2>
+<p>notifier - cups notification interface
+</p>
+ <h2 id="notifier-7.synopsis">Synopsis</h2>
+<p><strong>notifier</strong>
+<em>recipient</em>
[
-<i>user-data</i>
+<em>user-data</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The CUPS notifier interface provides a standard method for adding support for new event notification methods to CUPS.
+</p>
+ <h2 id="notifier-7.description">Description</h2>
+<p>The CUPS notifier interface provides a standard method for adding support for new event notification methods to CUPS.
Each notifier delivers one or more IPP events from the standard input to the specified recipient.
-<p>Notifiers <b>MUST</b> read IPP messages from the standard input using the
-<b>ippNew</b>()
+</p>
+ <p>Notifiers <strong>MUST</strong> read IPP messages from the standard input using the
+<strong>ippNew</strong>()
+
and
-<b>ippReadFile</b>()
+<strong>ippReadFile</strong>()
+
functions and exit on error.
Notifiers are encouraged to exit after a suitable period of inactivity, however they may exit after reading the first message or stay running until an error is seen.
Notifiers inherit the environment and can use the logging mechanism documented in
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7).</a>
-<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-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</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 © 2021-2023 by OpenPrinting.
+<strong>filter</strong>(7).
-</body>
+</p>
+ <h2 id="notifier-7.see-also">See Also</h2>
+<p><strong>cupsd</strong>(8),
+
+<strong>filter</strong>(7),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="notifier-7.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdc(1)</title>
-</head>
-<body>
-<h1 class="title">ppdc(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdc - cups ppd compiler (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdc</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdc(1)</title>
+ </head>
+ <body>
+ <h1 id="ppdc-1">ppdc(1)</h1>
+ <h2 id="ppdc-1.name">Name</h2>
+<p>ppdc - cups ppd compiler (deprecated)
+</p>
+ <h2 id="ppdc-1.synopsis">Synopsis</h2>
+<p><strong>ppdc</strong>
[
-<b>-D </b><i>name</i>[<b>=</b><i>value</i>]
+<strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]
] [
-<b>-I</b>
-<i>include-directory</i>
+<strong>-I</strong>
+<em>include-directory</em>
] [
-<b>-c</b>
-<i>message-catalog</i>
+<strong>-c</strong>
+<em>message-catalog</em>
] [
-<b>-d</b>
-<i>output-directory</i>
+<strong>-d</strong>
+<em>output-directory</em>
] [
-<b>-l</b>
-<i>language(s)</i>
+<strong>-l</strong>
+<em>language(s)</em>
] [
-<b>-m</b>
+<strong>-m</strong>
] [
-<b>-t</b>
+<strong>-t</strong>
] [
-<b>-v</b>
+<strong>-v</strong>
] [
-<b>-z</b>
+<strong>-z</strong>
] [
-<b>--cr</b>
+<strong>--cr</strong>
] [
-<b>--crlf</b>
+<strong>--crlf</strong>
] [
-<b>--lf</b>
+<strong>--lf</strong>
]
-<i>source-file</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ppdc</b> compiles PPDC source files into one or more PPD files.
-<b>This program is deprecated and will be removed in a future release of CUPS.</b>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ppdc</b> supports the following options:
-<dl class="man">
-<dt><b>-D </b><i>name</i>[<b>=</b><i>value</i>]
-<dd style="margin-left: 5.0em">Sets the named variable for use in the source file.
-It is equivalent to using the <i>#define</i> directive in the source file.
-<dt><b>-I </b><i>include-directory</i>
-<dd style="margin-left: 5.0em">Specifies an alternate include directory.
-Multiple <i>-I</i> options can be supplied to add additional directories.
-<dt><b>-c </b><i>message-catalog</i>
-<dd style="margin-left: 5.0em">Specifies a single message catalog file in GNU gettext (filename.po) or Apple strings (filename.strings) format to be used for localization.
-<dt><b>-d </b><i>output-directory</i>
-<dd style="margin-left: 5.0em">Specifies the output directory for PPD files.
-The default output directory is "ppd".
-<dt><b>-l </b><i>language(s)</i>
-<dd style="margin-left: 5.0em">Specifies one or more languages to use when localizing the PPD file(s).
-The default language is "en" (English).
-Separate multiple languages with commas, for example "de_DE,en_UK,es_ES,es_MX,es_US,fr_CA,fr_FR,it_IT" will create PPD files with German, UK English, Spanish (Spain, Mexico, and US), French (France and Canada), and Italian languages in each file.
-<dt><b>-m</b>
-<dd style="margin-left: 5.0em">Specifies that the output filename should be based on the ModelName value instead of FileName or PCFileName.
-<dt><b>-t</b>
-<dd style="margin-left: 5.0em">Specifies that PPD files should be tested instead of generated.
-<dt><b>-v</b>
-<dd style="margin-left: 5.0em">Specifies verbose output, basically a running status of which files are being loaded or written.
-<b>-z</b>
+<em>source-file</em>
+</p>
+ <h2 id="ppdc-1.description">Description</h2>
+<p><strong>ppdc</strong> compiles PPDC source files into one or more PPD files.
+<strong>This program is deprecated and will be removed in a future release of CUPS.</strong>
+</p>
+ <h2 id="ppdc-1.options">Options</h2>
+<p><strong>ppdc</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]<br>
+Sets the named variable for use in the source file.
+It is equivalent to using the <em>#define</em> directive in the source file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I </strong><em>include-directory</em><br>
+Specifies an alternate include directory.
+Multiple <em>-I</em> options can be supplied to add additional directories.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong><em>message-catalog</em><br>
+Specifies a single message catalog file in GNU gettext (filename.po) or Apple strings (filename.strings) format to be used for localization.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>output-directory</em><br>
+Specifies the output directory for PPD files.
+The default output directory is "ppd".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l </strong><em>language(s)</em><br>
+Specifies one or more languages to use when localizing the PPD file(s).
+The default language is "en" (English).
+Separate multiple languages with commas, for example "de_DE,en_UK,es_ES,es_MX,es_US,fr_CA,fr_FR,it_IT" will create PPD files with German, UK English, Spanish (Spain, Mexico, and US), French (France and Canada), and Italian languages in each file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m</strong><br>
+Specifies that the output filename should be based on the ModelName value instead of FileName or PCFileName.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t</strong><br>
+Specifies that PPD files should be tested instead of generated.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v</strong><br>
+Specifies verbose output, basically a running status of which files are being loaded or written.
+<strong>-z</strong>
Generates compressed PPD files (filename.ppd.gz).
The default is to generate uncompressed PPD files.
-<dt><b>--cr</b>
-<dd style="margin-left: 5.0em"><dt><b>--crlf</b>
-<dd style="margin-left: 5.0em"><dt><b>--lf</b>
-<dd style="margin-left: 5.0em">Specifies the line ending to use - carriage return, carriage return and line feed, or line feed alone.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--cr</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--crlf</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--lf</strong><br>
+Specifies the line ending to use - carriage return, carriage return and line feed, or line feed alone.
The default is to use the line feed character alone.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <h2 id="ppdc-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="ppdc-1.see-also">See Also</h2>
+<p><strong>ppdhtml</strong>(1),
+
+<strong>ppdi</strong>(1),
+
+<strong>ppdmerge</strong>(1),
-</body>
+<strong>ppdpo</strong>(1),
+
+<strong>ppdcfile</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdc-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdcfile(5)</title>
-</head>
-<body>
-<h1 class="title">ppdcfile(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdcfile - cups ppd compiler source file format (deprecated)
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1).</a>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdcfile(5)</title>
+ </head>
+ <body>
+ <h1 id="ppdcfile-5">ppdcfile(5)</h1>
+ <h2 id="ppdcfile-5.name">Name</h2>
+<p>ppdcfile - cups ppd compiler source file format (deprecated)
+</p>
+ <h2 id="ppdcfile-5.description">Description</h2>
+<p>The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
+<strong>ppdc</strong>(1).
+
This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS.
-<p>The source file format is plain ASCII text that can be edited using your favorite text editor. Comments are supported using the C (/* ... */) and C++ (// ...) comment mechanisms.
-<p>Printer driver information can be grouped and shared using curly braces ({ ... }); PPD files are written when a close brace or end-of-file is seen and a PCFileName directive has been defined.
-<p>Directives may be placed anywhere on a line and are followed by one or more values. The following is a list of the available directives and the values they accept:
-<dl class="man">
-<dt><b>#define </b><i>name value</i>
-<dd style="margin-left: 5.0em"><dt><b>#elif </b>{<i>name </i>| <i>value</i>}
-<dd style="margin-left: 5.0em"><dt><b>#else</b>
-<dd style="margin-left: 5.0em"><dt><b>#endif</b>
-<dd style="margin-left: 5.0em"><dt><b>#font </b><i>name encoding "version" charset status</i>
-<dd style="margin-left: 5.0em"><dt><b>#if </b>{<i>name </i>| <i>value</i>}
-<dd style="margin-left: 5.0em"><dt><b>#include <</b><i>filename</i><b>></b>
-<dd style="margin-left: 5.0em"><dt><b>#include "</b><i>filename</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>#media </b><i>name width length</i>
-<dd style="margin-left: 5.0em"><dt><b>#media "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>width length</i>
-<dd style="margin-left: 5.0em"><dt><b>#po </b><i>locale </i><b>"</b><i>filename</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name </i><b>"" </b><i>value</i>
-<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name keyword value</i>
-<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name </i><b>"</b><i>keyword</i><b>/</b><i>text</i><b>" </b><i>value</i>
-<dd style="margin-left: 5.0em"><dt><b>Choice </b><i>name </i><b>"</b><i>code</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Choice "</b><i>name</i><b>/</b><i>text</i><b>" "</b><i>code</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>ColorDevice </b><i>boolean-value</i>
-<dd style="margin-left: 5.0em"><dt><b>ColorModel </b><i>name colorspace colororder compression</i>
-<dd style="margin-left: 5.0em"><dt><b>ColorModel "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>colorspace colororder compression</i>
-<dd style="margin-left: 5.0em"><dt><b>ColorProfile </b><i>resolution</i><b>/</b><i>mediatype gamma density matrix</i>
-<dd style="margin-left: 5.0em"><dt><b>Copyright "</b><i>text</i>"
-<dd style="margin-left: 5.0em"><dt><b>CustomMedia </b><i>name width length left bottom right top </i><b>"</b><i>size-code</i><b>" "</b><i>region-code</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>CustomMedia "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>width length left bottom right top </i><b>"</b><i>size-code</i><b>" "</b><i>region-code</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Cutter </b><i>boolean-value</i>
-<dd style="margin-left: 5.0em"><dt><b>Darkness </b><i>temperature name</i>
-<dd style="margin-left: 5.0em"><dt><b>Darkness </b><i>temperature </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>DriverType </b><i>type</i>
-<dd style="margin-left: 5.0em"><dt><b>Duplex </b><i>type</i>
-<dd style="margin-left: 5.0em"><dt><b>Filter </b><i>mime-type cost program</i>
-<dd style="margin-left: 5.0em"><dt><b>Finishing </b><i>name</i>
-<dd style="margin-left: 5.0em"><dt><b>Finishing "</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Font *</b>
-<dd style="margin-left: 5.0em"><dt><b>Font </b><i>name encoding </i><b>"</b><i>version</i><b>" </b><i>charset status</i>
-<dd style="margin-left: 5.0em"><dt><b>Group </b><i>name</i>
-<dd style="margin-left: 5.0em"><dt><b>Group "</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>HWMargins </b><i>left bottom right top</i>
-<dd style="margin-left: 5.0em"><dt><b>InputSlot </b><i>position name</i>
-<dd style="margin-left: 5.0em"><dt><b>InputSlot </b><i>position </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Installable </b><i>name</i>
-<dd style="margin-left: 5.0em"><dt><b>Installable "</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>LocAttribute </b><i>name </i><b>"</b><i>keyword</i><b>/</b><i>text</i><b>" </b><i>value</i>
-<dd style="margin-left: 5.0em"><dt><b>ManualCopies </b><i>boolean-value</i>
-<dd style="margin-left: 5.0em"><dt><b>Manufacturer "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>MaxSize </b><i>width length</i>
-<dd style="margin-left: 5.0em"><dt><b>MediaSize </b><i>name</i>
-<dd style="margin-left: 5.0em"><dt><b>MediaType </b><i>type name</i>
-<dd style="margin-left: 5.0em"><dt><b>MediaType </b><i>type </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>MinSize </b><i>width length</i>
-<dd style="margin-left: 5.0em"><dt><b>ModelName "</b><i>name</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>ModelNumber </b><i>number</i>
-<dd style="margin-left: 5.0em"><dt><b>Option </b><i>name type section order</i>
-<dd style="margin-left: 5.0em"><dt><b>Option "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>type section order</i>
-<dd style="margin-left: 5.0em"><dt><b>PCFileName "</b><i>filename.ppd</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>Resolution </b><i>colorspace bits-per-color row-count row-feed row-step name</i>
-<dd style="margin-left: 5.0em"><dt><b>Resolution </b><i>colorspace bits-per-color row-count row-feed row-step </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>SimpleColorProfile </b><i>resolution</i><b>/</b><i>mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust</i>
-<dd style="margin-left: 5.0em"><dt><b>Throughput </b><i>pages-per-minute</i>
-<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2 Choice2</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2 Choice2</i><b>"</b>
-<dd style="margin-left: 5.0em"><dt><b>VariablePaperSize </b><i>boolean-value</i>
-<dd style="margin-left: 5.0em"><dt><b>Version </b><i>number</i>
-<dd style="margin-left: 5.0em"></dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <p>The source file format is plain ASCII text that can be edited using your favorite text editor. Comments are supported using the C (/* ... */) and C++ (// ...) comment mechanisms.
+</p>
+ <p>Printer driver information can be grouped and shared using curly braces ({ ... }); PPD files are written when a close brace or end-of-file is seen and a PCFileName directive has been defined.
+</p>
+ <p>Directives may be placed anywhere on a line and are followed by one or more values. The following is a list of the available directives and the values they accept:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#define </strong><em>name value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#elif </strong>{<em>name </em>| <em>value</em>}<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#else</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#endif</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#font </strong><em>name encoding "version" charset status</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#if </strong>{<em>name </em>| <em>value</em>}<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#include <</strong><em>filename</em><strong>></strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#include "</strong><em>filename</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#media </strong><em>name width length</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#media "</strong><em>name</em><strong>/</strong><em>text</em><strong>" </strong><em>width length</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>#po </strong><em>locale </em><strong>"</strong><em>filename</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Attribute </strong><em>name </em><strong>"" </strong><em>value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Attribute </strong><em>name keyword value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Attribute </strong><em>name </em><strong>"</strong><em>keyword</em><strong>/</strong><em>text</em><strong>" </strong><em>value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Choice </strong><em>name </em><strong>"</strong><em>code</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Choice "</strong><em>name</em><strong>/</strong><em>text</em><strong>" "</strong><em>code</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ColorDevice </strong><em>boolean-value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ColorModel </strong><em>name colorspace colororder compression</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ColorModel "</strong><em>name</em><strong>/</strong><em>text</em><strong>" </strong><em>colorspace colororder compression</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ColorProfile </strong><em>resolution</em><strong>/</strong><em>mediatype gamma density matrix</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Copyright "</strong><em>text</em>"<br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CustomMedia </strong><em>name width length left bottom right top </em><strong>"</strong><em>size-code</em><strong>" "</strong><em>region-code</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>CustomMedia "</strong><em>name</em><strong>/</strong><em>text</em><strong>" </strong><em>width length left bottom right top </em><strong>"</strong><em>size-code</em><strong>" "</strong><em>region-code</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Cutter </strong><em>boolean-value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Darkness </strong><em>temperature name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Darkness </strong><em>temperature </em><strong>"</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DriverType </strong><em>type</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Duplex </strong><em>type</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Filter </strong><em>mime-type cost program</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Finishing </strong><em>name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Finishing "</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Font *</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Font </strong><em>name encoding </em><strong>"</strong><em>version</em><strong>" </strong><em>charset status</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Group </strong><em>name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Group "</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HWMargins </strong><em>left bottom right top</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>InputSlot </strong><em>position name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>InputSlot </strong><em>position </em><strong>"</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Installable </strong><em>name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Installable "</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LocAttribute </strong><em>name </em><strong>"</strong><em>keyword</em><strong>/</strong><em>text</em><strong>" </strong><em>value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ManualCopies </strong><em>boolean-value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Manufacturer "</strong><em>name</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MaxSize </strong><em>width length</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MediaSize </strong><em>name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MediaType </strong><em>type name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MediaType </strong><em>type </em><strong>"</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>MinSize </strong><em>width length</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ModelName "</strong><em>name</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ModelNumber </strong><em>number</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Option </strong><em>name type section order</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Option "</strong><em>name</em><strong>/</strong><em>text</em><strong>" </strong><em>type section order</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PCFileName "</strong><em>filename.ppd</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Resolution </strong><em>colorspace bits-per-color row-count row-feed row-step name</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Resolution </strong><em>colorspace bits-per-color row-count row-feed row-step </em><strong>"</strong><em>name</em><strong>/</strong><em>text</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>SimpleColorProfile </strong><em>resolution</em><strong>/</strong><em>mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Throughput </strong><em>pages-per-minute</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UIConstraints "</strong><em>*Option1 *Option2</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UIConstraints "</strong><em>*Option1 Choice1 *Option2</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UIConstraints "</strong><em>*Option1 *Option2 Choice2</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>UIConstraints "</strong><em>*Option1 Choice1 *Option2 Choice2</em><strong>"</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>VariablePaperSize </strong><em>boolean-value</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Version </strong><em>number</em><br>
+</p>
+ <h2 id="ppdcfile-5.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</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 © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="ppdcfile-5.see-also">See Also</h2>
+<p><strong>ppdc</strong>(1),
+
+<strong>ppdhtml</strong>(1),
-</body>
+<strong>ppdi</strong>(1),
+
+<strong>ppdmerge</strong>(1),
+
+<strong>ppdpo</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdcfile-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdhtml(1)</title>
-</head>
-<body>
-<h1 class="title">ppdhtml(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdhtml - cups html summary generator (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdhtml</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdhtml(1)</title>
+ </head>
+ <body>
+ <h1 id="ppdhtml-1">ppdhtml(1)</h1>
+ <h2 id="ppdhtml-1.name">Name</h2>
+<p>ppdhtml - cups html summary generator (deprecated)
+</p>
+ <h2 id="ppdhtml-1.synopsis">Synopsis</h2>
+<p><strong>ppdhtml</strong>
[
-<b>-D </b><i>name</i>[<b>=</b><i>value</i>]
+<strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]
] [
-<b>-I</b>
-<i>include-directory</i>
+<strong>-I</strong>
+<em>include-directory</em>
]
-<i>source-file</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ppdhtml</b> reads a driver information file and produces a HTML summary page that lists all of the drivers in a file and the supported options.
-<b>This program is deprecated and will be removed in a future release of CUPS.</b>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ppdhtml</b> supports the following options:
-<dl class="man">
-<dt><b>-D </b><i>name</i>[<b>=</b><i>value</i>]
-<dd style="margin-left: 5.0em">Sets the named variable for use in the source file.
-It is equivalent to using the <i>#define</i> directive in the source file.
-<dt><b>-I </b><i>include-directory</i>
-<dd style="margin-left: 5.0em">Specifies an alternate include directory.
-Multiple <i>-I</i> options can be supplied to add additional directories.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+<em>source-file</em>
+</p>
+ <h2 id="ppdhtml-1.description">Description</h2>
+<p><strong>ppdhtml</strong> reads a driver information file and produces a HTML summary page that lists all of the drivers in a file and the supported options.
+<strong>This program is deprecated and will be removed in a future release of CUPS.</strong>
+</p>
+ <h2 id="ppdhtml-1.options">Options</h2>
+<p><strong>ppdhtml</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]<br>
+Sets the named variable for use in the source file.
+It is equivalent to using the <em>#define</em> directive in the source file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I </strong><em>include-directory</em><br>
+Specifies an alternate include directory.
+Multiple <em>-I</em> options can be supplied to add additional directories.
+</p>
+ <h2 id="ppdhtml-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</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 © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="ppdhtml-1.see-also">See Also</h2>
+<p><strong>ppdc</strong>(1),
+
+<strong>ppdcfile</strong>(5),
+
+<strong>ppdi</strong>(1),
-</body>
+<strong>ppdmerge</strong>(1),
+
+<strong>ppdpo</strong>(1),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdhtml-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdi(1)</title>
-</head>
-<body>
-<h1 class="title">ppdi(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdi - import ppd files (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdi</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdi(1)</title>
+ </head>
+ <body>
+ <h1 id="ppdi-1">ppdi(1)</h1>
+ <h2 id="ppdi-1.name">Name</h2>
+<p>ppdi - import ppd files (deprecated)
+</p>
+ <h2 id="ppdi-1.synopsis">Synopsis</h2>
+<p><strong>ppdi</strong>
[
-<b>-I</b>
-<i>include-directory</i>
+<strong>-I</strong>
+<em>include-directory</em>
] [
-<b>-o</b>
-<i>source-file</i>
+<strong>-o</strong>
+<em>source-file</em>
]
-<i>ppd-file</i>
+<em>ppd-file</em>
[ ...
-<i>ppd-file</i>
+<em>ppd-file</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ppdi</b> imports one or more PPD files into a PPD compiler source file.
+</p>
+ <h2 id="ppdi-1.description">Description</h2>
+<p><strong>ppdi</strong> imports one or more PPD files into a PPD compiler source file.
Multiple languages of the same PPD file are merged into a single printer definition to facilitate accurate changes for all localizations.
-<b>This program is deprecated and will be removed in a future release of CUPS.</b>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ppdi</b> supports the following options:
-<dl class="man">
-<dt><b>-I </b><i>include-directory</i>
-<dd style="margin-left: 5.0em">Specifies an alternate include directory.
-Multiple <i>-I</i> options can be supplied to add additional directories.
-<dt><b>-o </b><i>source-file</i>
-<dd style="margin-left: 5.0em">Specifies the PPD source file to update.
+<strong>This program is deprecated and will be removed in a future release of CUPS.</strong>
+</p>
+ <h2 id="ppdi-1.options">Options</h2>
+<p><strong>ppdi</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I </strong><em>include-directory</em><br>
+Specifies an alternate include directory.
+Multiple <em>-I</em> options can be supplied to add additional directories.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>source-file</em><br>
+Specifies the PPD source file to update.
If the source file does not exist, a new source file is created.
Otherwise the existing file is merged with the new PPD file(s) on the command-line.
-If no source file is specified, the filename <i>ppdi.drv</i> is used.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+If no source file is specified, the filename <em>ppdi.drv</em> is used.
+</p>
+ <h2 id="ppdi-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="ppdi-1.see-also">See Also</h2>
+<p><strong>ppdc</strong>(1),
+
+<strong>ppdhtml</strong>(1),
+
+<strong>ppdmerge</strong>(1),
-</body>
+<strong>ppdpo</strong>(1),
+
+<strong>ppdcfile</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdi-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdmerge(1)</title>
-</head>
-<body>
-<h1 class="title">ppdmerge(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdmerge - merge ppd files (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdmerge</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdmerge(1)</title>
+ </head>
+ <body>
+ <h1 id="ppdmerge-1">ppdmerge(1)</h1>
+ <h2 id="ppdmerge-1.name">Name</h2>
+<p>ppdmerge - merge ppd files (deprecated)
+</p>
+ <h2 id="ppdmerge-1.synopsis">Synopsis</h2>
+<p><strong>ppdmerge</strong>
[
-<b>-o</b>
-<i>output-ppd-file</i>
+<strong>-o</strong>
+<em>output-ppd-file</em>
]
-<i>ppd-file</i>
-<i>ppd-file</i>
+<em>ppd-file</em>
+<em>ppd-file</em>
[ ...
-<i>ppd-file</i>
+<em>ppd-file</em>
]
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ppdmerge</b> merges two or more PPD files into a single, multi-language
+</p>
+ <h2 id="ppdmerge-1.description">Description</h2>
+<p><strong>ppdmerge</strong> merges two or more PPD files into a single, multi-language
PPD file.
-<b>This program is deprecated and will be removed in a future release of CUPS.</b>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ppdmerge</b> supports the following options:
-<dl class="man">
-<dt><b>-o </b><i>output-ppd-file</i>
-<dd style="margin-left: 3.0em">Specifies the PPD file to create.
+<strong>This program is deprecated and will be removed in a future release of CUPS.</strong>
+</p>
+ <h2 id="ppdmerge-1.options">Options</h2>
+<p><strong>ppdmerge</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>output-ppd-file</em><br>
+Specifies the PPD file to create.
If not specified, the merged PPD file is written to the standard output.
If the output file already exists, it is silently overwritten.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+</p>
+ <h2 id="ppdmerge-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<p><b>ppdmerge</b> does not check whether the merged PPD files are for the same device.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <p><strong>ppdmerge</strong> does not check whether the merged PPD files are for the same device.
Merging of different device PPDs will yield unpredictable results.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="ppdmerge-1.see-also">See Also</h2>
+<p><strong>ppdc</strong>(1),
+
+<strong>ppdhtml</strong>(1),
+
+<strong>ppdi</strong>(1),
-</body>
+<strong>ppdpo</strong>(1),
+
+<strong>ppdcfile</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdmerge-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>ppdpo(1)</title>
-</head>
-<body>
-<h1 class="title">ppdpo(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-ppdpo - ppd message catalog generator (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdpo</b>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>ppdpo(1)</title>
+ </head>
+ <body>
+ <h1 id="ppdpo-1">ppdpo(1)</h1>
+ <h2 id="ppdpo-1.name">Name</h2>
+<p>ppdpo - ppd message catalog generator (deprecated)
+</p>
+ <h2 id="ppdpo-1.synopsis">Synopsis</h2>
+<p><strong>ppdpo</strong>
[
-<b>-D </b><i>name</i>[<b>=</b><i>value</i>]
+<strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]
] [
-<b>-I</b>
-<i>include-directory</i>
+<strong>-I</strong>
+<em>include-directory</em>
] [
-<b>-o</b>
-<i>output-file</i>
+<strong>-o</strong>
+<em>output-file</em>
]
-<i>source-file</i>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>ppdpo</b> extracts UI strings from PPDC source files and updates either a GNU gettext or macOS strings format message catalog source file for translation.
-<b>This program is deprecated and will be removed in a future release of CUPS.</b>
-<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<b>ppdpo</b> supports the following options:
-<dl class="man">
-<dt><b>-D </b><i>name</i>[<b>=</b><i>value</i>]
-<dd style="margin-left: 5.0em">Sets the named variable for use in the source file.
-It is equivalent to using the <i>#define</i> directive in the source file.
-<dt><b>-I </b><i>include-directory</i>
-<dd style="margin-left: 5.0em">Specifies an alternate include directory.
-Multiple <i>-I</i> options can be supplied to add additional directories.
-<dt><b>-o </b><i>output-file</i>
-<dd style="margin-left: 5.0em">Specifies the output file.
-The supported extensions are <i>.po</i> or <i>.po.gz</i> for GNU gettext format message catalogs and <i>.strings</i> for macOS strings files.
-</dl>
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+<em>source-file</em>
+</p>
+ <h2 id="ppdpo-1.description">Description</h2>
+<p><strong>ppdpo</strong> extracts UI strings from PPDC source files and updates either a GNU gettext or macOS strings format message catalog source file for translation.
+<strong>This program is deprecated and will be removed in a future release of CUPS.</strong>
+</p>
+ <h2 id="ppdpo-1.options">Options</h2>
+<p><strong>ppdpo</strong> supports the following options:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D </strong><em>name</em>[<strong>=</strong><em>value</em>]<br>
+Sets the named variable for use in the source file.
+It is equivalent to using the <em>#define</em> directive in the source file.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-I </strong><em>include-directory</em><br>
+Specifies an alternate include directory.
+Multiple <em>-I</em> options can be supplied to add additional directories.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>output-file</em><br>
+Specifies the output file.
+The supported extensions are <em>.po</em> or <em>.po.gz</em> for GNU gettext format message catalogs and <em>.strings</em> for macOS strings files.
+</p>
+ <h2 id="ppdpo-1.notes">Notes</h2>
+<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<b>ppdcfile(5),</b>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+<strong>ippeveprinter</strong>(1).
+
+</p>
+ <h2 id="ppdpo-1.see-also">See Also</h2>
+<p><strong>ppdc</strong>(1),
+
+<strong>ppdhtml</strong>(1),
+
+<strong>ppdi</strong>(1),
-</body>
+<strong>ppdmerge</strong>(1),
+
+<strong>ppdcfile(5),</strong>
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="ppdpo-1.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>printers.conf(5)</title>
-</head>
-<body>
-<h1 class="title">printers.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-printers.conf - printer configuration file for cups
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <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>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>printers.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="printers.conf-5">printers.conf(5)</h1>
+ <h2 id="printers.conf-5.name">Name</h2>
+<p>printers.conf - printer configuration file for cups
+</p>
+ <h2 id="printers.conf-5.description">Description</h2>
+<p>The <strong>printers.conf</strong> file defines the local printers that are available. It is normally located in the <em>/etc/cups</em> directory and is maintained by the
+<strong>cupsd</strong>(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-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-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="printers.conf-5.notes">Notes</h2>
+<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
+</p>
+ <h2 id="printers.conf-5.see-also">See Also</h2>
+<p><strong>classes.conf</strong>(5),
+
+<strong>cups-files.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
-</body>
+<strong>mime.convs</strong>(5),
+
+<strong>mime.types</strong>(5),
+
+<strong>subscriptions.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="printers.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
-<!DOCTYPE HTML>
+<!DOCTYPE html>
<html>
-<!-- SECTION: Man Pages -->
-<head>
- <link rel="stylesheet" type="text/css" href="../cups-printable.css">
- <title>subscriptions.conf(5)</title>
-</head>
-<body>
-<h1 class="title">subscriptions.conf(5)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-subscriptions.conf - subscription configuration file for cups
-<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>
+ <head>
+ <meta name="creator" content="mantohtml v2.0.1">
+ <title>subscriptions.conf(5)</title>
+ </head>
+ <body>
+ <h1 id="subscriptions.conf-5">subscriptions.conf(5)</h1>
+ <h2 id="subscriptions.conf-5.name">Name</h2>
+<p>subscriptions.conf - subscription configuration file for cups
+</p>
+ <h2 id="subscriptions.conf-5.description">Description</h2>
+<p>The <strong>subscriptions.conf</strong> file defines the local event notification subscriptions that are active.
+It is normally located in the <em>/etc/cups</em> directory and is maintained by the
+<strong>cupsd</strong>(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-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-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2021-2023 by OpenPrinting.
+</p>
+ <h2 id="subscriptions.conf-5.notes">Notes</h2>
+<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
+</p>
+ <h2 id="subscriptions.conf-5.see-also">See Also</h2>
+<p><strong>classes.conf</strong>(5),
+
+<strong>cups-files.conf</strong>(5),
+
+<strong>cupsd</strong>(8),
+
+<strong>cupsd.conf</strong>(5),
-</body>
+<strong>mime.convs</strong>(5),
+
+<strong>mime.types</strong>(5),
+
+<strong>printers.conf</strong>(5),
+
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
+</p>
+ <h2 id="subscriptions.conf-5.copyright">Copyright</h2>
+<p>Copyright © 2021-2023 by OpenPrinting.
+ </body>
</html>
#
# Man page makefile for CUPS.
#
+# The "html" target depends on "mantohtml" from https://www.msweet.org/mantohtml
+#
+# Copyright © 2023 by OpenPrinting.
# Copyright © 2007-2019 by Apple Inc.
# Copyright © 1993-2006 by Easy Software Products.
#
# Make html versions of man pages...
#
-html: $(MAN1) $(MAN5) $(MAN7) $(MAN8) mantohtml
+html: $(MAN1) $(MAN5) $(MAN7) $(MAN8)
echo Converting man pages to HTML...
for file in $(MAN1); do \
echo " $$file..."; \
- ./mantohtml $$file >../doc/help/man-`basename $$file .1`.html; \
+ mantohtml $$file >../doc/help/man-`basename $$file .1`.html; \
done
for file in $(MAN5); do \
echo " $$file..."; \
- ./mantohtml $$file >../doc/help/man-`basename $$file .5`.html; \
+ mantohtml $$file >../doc/help/man-`basename $$file .5`.html; \
done
for file in $(MAN7); do \
echo " $$file..."; \
- ./mantohtml $$file >../doc/help/man-`basename $$file .7`.html; \
+ mantohtml $$file >../doc/help/man-`basename $$file .7`.html; \
done
for file in $(MAN8); do \
echo " $$file..."; \
- ./mantohtml $$file >../doc/help/man-`basename $$file .8`.html; \
+ mantohtml $$file >../doc/help/man-`basename $$file .8`.html; \
done
-
-mantohtml: mantohtml.o ../cups/$(LIBCUPSSTATIC)
- $(LD_CC) $(ARCHFLAGS) $(ALL_LDFLAGS) -o $@ mantohtml.o $(LINKCUPSSTATIC)
- $(CODE_SIGN) -s "$(CODE_SIGN_IDENTITY)" $@
\fBGroup \fIgroup-name-or-number\fR
Specifies the group name or ID that will be used when executing external programs.
The default group is operating system specific but is usually "lp" or "nobody".
-.RE
.\"#LogFileGroup
.TP 5
\fBLogFileGroup \fIgroup-name-or-number\fR
+++ /dev/null
-/*
- * Man page to HTML conversion program.
- *
- * Copyright 2007-2017 by Apple Inc.
- * Copyright 2004-2006 by Easy Software Products.
- *
- * Licensed under Apache License v2.0. See the file "LICENSE" for more information.
- */
-
-/*
- * Include necessary headers.
- */
-
-#include <cups/string-private.h>
-#include <cups/array.h>
-#include <unistd.h>
-
-
-/*
- * Local globals...
- */
-
-static const char /* Start/end tags for fonts */
- * const start_fonts[] = { "", "<b>", "<i>" },
- * const end_fonts[] = { "", "</b>", "</i>" };
-
-
-/*
- * Local functions...
- */
-
-static void html_alternate(const char *s, const char *first, const char *second, FILE *fp);
-static void html_fputs(const char *s, int *font, FILE *fp);
-static void html_putc(int ch, FILE *fp);
-static void strmove(char *d, const char *s);
-
-
-/*
- * 'main()' - Convert a man page to HTML.
- */
-
-int /* O - Exit status */
-main(int argc, /* I - Number of command-line args */
- char *argv[]) /* I - Command-line arguments */
-{
- FILE *infile, /* Input file */
- *outfile; /* Output file */
- char line[1024], /* Line from file */
- *lineptr, /* Pointer into line */
- anchor[1024], /* Anchor */
- name[1024], /* Man page name */
- ddpost[256]; /* Tagged list post markup */
- int section = -1, /* Man page section */
- pre = 0, /* Preformatted */
- font = 0, /* Current font */
- linenum = 0; /* Current line number */
- float list_indent = 0.0f, /* Current list indentation */
- nested_indent = 0.0f; /* Nested list indentation, if any */
- const char *list = NULL, /* Current list, if any */
- *nested = NULL; /* Nested list, if any */
- const char *post = NULL; /* Text to add after the current line */
-
-
- /*
- * Check arguments...
- */
-
- if (argc > 3)
- {
- fputs("Usage: mantohtml [filename.man [filename.html]]\n", stderr);
- return (1);
- }
-
- /*
- * Open files as needed...
- */
-
- if (argc > 1)
- {
- if ((infile = fopen(argv[1], "r")) == NULL)
- {
- perror(argv[1]);
- return (1);
- }
- }
- else
- infile = stdin;
-
- if (argc > 2)
- {
- if ((outfile = fopen(argv[2], "w")) == NULL)
- {
- perror(argv[2]);
- fclose(infile);
- return (1);
- }
- }
- else
- outfile = stdout;
-
- /*
- * Read from input and write the output...
- */
-
- fputs("<!DOCTYPE HTML>\n"
- "<html>\n"
- "<!-- SECTION: Man Pages -->\n"
- "<head>\n"
- "\t<link rel=\"stylesheet\" type=\"text/css\" "
- "href=\"../cups-printable.css\">\n", outfile);
-
- anchor[0] = '\0';
-
- while (fgets(line, sizeof(line), infile))
- {
- size_t linelen = strlen(line); /* Length of line */
-
- if (linelen > 0 && line[linelen - 1] == '\n')
- line[linelen - 1] = '\0';
-
- linenum ++;
-
- if (line[0] == '.')
- {
- /*
- * Strip leading whitespace...
- */
-
- while (line[1] == ' ' || line[1] == '\t')
- strmove(line + 1, line + 2);
-
- /*
- * Process man page commands...
- */
-
- if (!strncmp(line, ".TH ", 4) && section < 0)
- {
- /*
- * Grab man page title...
- */
-
- sscanf(line + 4, "%s%d", name, §ion);
-
- fprintf(outfile,
- "\t<title>%s(%d)</title>\n"
- "</head>\n"
- "<body>\n"
- "<h1 class=\"title\">%s(%d)</h1>\n"
- "%s",
- name, section, name, section, start_fonts[font]);
- }
- else if (section < 0)
- continue;
- else if (!strncmp(line, ".SH ", 4) || !strncmp(line, ".SS ", 4))
- {
- /*
- * Grab heading...
- */
-
- int first = 1;
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (list)
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- if (line[2] == 'H')
- fputs("<h2 class=\"title\"><a name=\"", outfile);
- else
- fputs("<h3><a name=\"", outfile);
-
- if (anchor[0])
- {
- fputs(anchor, outfile);
- anchor[0] = '\0';
- }
- else
- {
- for (lineptr = line + 4; *lineptr; lineptr ++)
- if (*lineptr == '\"')
- continue;
- else if (isalnum(*lineptr & 255))
- html_putc(*lineptr, outfile);
- else
- html_putc('_', outfile);
- }
-
- fputs("\">", outfile);
-
- for (lineptr = line + 4; *lineptr; lineptr ++)
- {
- if (*lineptr == '\"')
- continue;
- else if (*lineptr == ' ')
- {
- html_putc(' ', outfile);
-
- first = 1;
- }
- else
- {
- if (first)
- html_putc(*lineptr, outfile);
- else
- html_putc(tolower(*lineptr & 255), outfile);
-
- first = 0;
- }
- }
-
- if (line[2] == 'H')
- fputs("</a></h2>\n", outfile);
- else
- fputs("</a></h3>\n", outfile);
- }
- else if (!strncmp(line, ".B ", 3))
- {
- /*
- * Grab bold text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 3, "b", "b", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".I ", 3))
- {
- /*
- * Grab italic text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 3, "i", "i", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".BI ", 4))
- {
- /*
- * Alternating bold and italic text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "b", "i", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".BR ", 4))
- {
- /*
- * Alternating bold and roman (plain) text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "b", NULL, outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".IB ", 4))
- {
- /*
- * Alternating italic and bold text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "i", "b", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".IR ", 4))
- {
- /*
- * Alternating italic and roman (plain) text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "i", NULL, outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".RB ", 4))
- {
- /*
- * Alternating roman (plain) and bold text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, NULL, "b", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".RI ", 4))
- {
- /*
- * Alternating roman (plain) and italic text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, NULL, "i", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".SB ", 4))
- {
- /*
- * Alternating small and bold text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "small", "b", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strncmp(line, ".SM ", 4))
- {
- /*
- * Small text...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (anchor[0])
- fprintf(outfile, "<a name=\"%s\">", anchor);
-
- html_alternate(line + 4, "small", "small", outfile);
-
- if (anchor[0])
- {
- fputs("</a>", outfile);
- anchor[0] = '\0';
- }
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- else if (!strcmp(line, ".LP") || !strcmp(line, ".PP") || !strcmp(line, ".P"))
- {
- /*
- * New paragraph...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (list)
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- fputs("<p>", outfile);
-
- if (anchor[0])
- {
- fprintf(outfile, "<a name=\"%s\"></a>", anchor);
- anchor[0] = '\0';
- }
- }
- else if (!strcmp(line, ".RS") || !strncmp(line, ".RS ", 4))
- {
- /*
- * Indent...
- */
-
- float amount = 3.0f; /* Indentation */
-
- if (line[3])
- amount = (float)atof(line + 4);
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (list)
- {
- nested = list;
- list = NULL;
- nested_indent = list_indent;
- list_indent = 0.0f;
- }
-
- fprintf(outfile, "<div style=\"margin-left: %.1fem;\">\n", amount - nested_indent);
- }
- else if (!strcmp(line, ".RE"))
- {
- /*
- * Unindent...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- fputs("</div>\n", outfile);
-
- if (nested)
- {
- list = nested;
- nested = NULL;
-
- list_indent = nested_indent;
- nested_indent = 0.0f;
- }
- }
- else if (!strcmp(line, ".HP") || !strncmp(line, ".HP ", 4))
- {
- /*
- * Hanging paragraph...
- *
- * .HP i
- */
-
- float amount = 3.0f; /* Indentation */
-
- if (line[3])
- amount = (float)atof(line + 4);
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (list)
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- fprintf(outfile, "<p style=\"margin-left: %.1fem; text-indent: %.1fem\">", amount, -amount);
-
- if (anchor[0])
- {
- fprintf(outfile, "<a name=\"%s\"></a>", anchor);
- anchor[0] = '\0';
- }
-
- if (line[1] == 'T')
- post = "<br>\n";
- }
- else if (!strcmp(line, ".TP") || !strncmp(line, ".TP ", 4))
- {
- /*
- * Tagged list...
- *
- * .TP i
- */
-
- float amount = 3.0f; /* Indentation */
-
- if (line[3])
- amount = (float)atof(line + 4);
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (list && strcmp(list, "dl"))
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- if (!list)
- {
- fputs("<dl class=\"man\">\n", outfile);
- list = "dl";
- list_indent = amount;
- }
-
- fputs("<dt>", outfile);
- snprintf(ddpost, sizeof(ddpost), "<dd style=\"margin-left: %.1fem\">", amount);
- post = ddpost;
-
- if (anchor[0])
- {
- fprintf(outfile, "<a name=\"%s\"></a>", anchor);
- anchor[0] = '\0';
- }
- }
- else if (!strncmp(line, ".IP ", 4))
- {
- /*
- * Indented paragraph...
- *
- * .IP x i
- */
-
- float amount = 3.0f; /* Indentation */
- const char *newlist = NULL; /* New list style */
- const char *newtype = NULL; /* New list numbering type */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- lineptr = line + 4;
- while (isspace(*lineptr & 255))
- lineptr ++;
-
- if (!strncmp(lineptr, "\\(bu", 4) || !strncmp(lineptr, "\\(em", 4))
- {
- /*
- * Bullet list...
- */
-
- newlist = "ul";
- }
- else if (isdigit(*lineptr & 255))
- {
- /*
- * Numbered list...
- */
-
- newlist = "ol";
- }
- else if (islower(*lineptr & 255))
- {
- /*
- * Lowercase alpha list...
- */
-
- newlist = "ol";
- newtype = "a";
- }
- else if (isupper(*lineptr & 255))
- {
- /*
- * Lowercase alpha list...
- */
-
- newlist = "ol";
- newtype = "A";
- }
-
- while (!isspace(*lineptr & 255))
- lineptr ++;
- while (isspace(*lineptr & 255))
- lineptr ++;
-
- if (isdigit(*lineptr & 255))
- amount = (float)atof(lineptr);
-
- if (newlist && list && strcmp(newlist, list))
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- if (newlist && !list)
- {
- if (newtype)
- fprintf(outfile, "<%s type=\"%s\">\n", newlist, newtype);
- else
- fprintf(outfile, "<%s>\n", newlist);
-
- list = newlist;
- }
-
- if (list)
- fprintf(outfile, "<li style=\"margin-left: %.1fem;\">", amount);
- else
- fprintf(outfile, "<p style=\"margin-left: %.1fem;\">", amount);
-
- if (anchor[0])
- {
- fprintf(outfile, "<a name=\"%s\"></a>", anchor);
- anchor[0] = '\0';
- }
- }
- else if (!strncmp(line, ".br", 3))
- {
- /*
- * Grab line break...
- */
-
- fputs("<br>\n", outfile);
- }
- else if (!strncmp(line, ".de ", 4))
- {
- /*
- * Define macro - ignore...
- */
-
- while (fgets(line, sizeof(line), infile))
- {
- linenum ++;
-
- if (!strncmp(line, "..", 2))
- break;
- }
- }
- else if (!strncmp(line, ".ds ", 4) || !strncmp(line, ".rm ", 4) ||
- !strncmp(line, ".tr ", 4) || !strncmp(line, ".hy ", 4) ||
- !strncmp(line, ".IX ", 4) || !strncmp(line, ".PD", 3) ||
- !strncmp(line, ".Sp", 3))
- {
- /*
- * Ignore unused commands...
- */
- }
- else if (!strncmp(line, ".Vb", 3) || !strncmp(line, ".nf", 3) || !strncmp(line, ".EX", 3))
- {
- /*
- * Start preformatted...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
-// if (list)
-// {
-// fprintf(outfile, "</%s>\n", list);
-// list = NULL;
-// }
-
- pre = 1;
- fputs("<pre class=\"man\">\n", outfile);
- }
- else if (!strncmp(line, ".Ve", 3) || !strncmp(line, ".fi", 3) || !strncmp(line, ".EE", 3))
- {
- /*
- * End preformatted...
- */
-
- fputs(end_fonts[font], outfile);
- font = 0;
-
- if (pre)
- {
- pre = 0;
- fputs("</pre>\n", outfile);
- }
- }
- else if (!strncmp(line, ".\\}", 3))
- {
- /*
- * Ignore close block...
- */
- }
- else if (!strncmp(line, ".ie", 3) || !strncmp(line, ".if", 3) ||
- !strncmp(line, ".el", 3))
- {
- /*
- * If/else - ignore...
- */
-
- if (strchr(line, '{') != NULL)
- {
- /*
- * Skip whole block...
- */
-
- while (fgets(line, sizeof(line), infile))
- {
- linenum ++;
-
- if (strchr(line, '}') != NULL)
- break;
- }
- }
- }
-#if 0
- else if (!strncmp(line, ". ", 4))
- {
- /*
- * Grab ...
- */
- }
-#endif /* 0 */
- else if (!strncmp(line, ".\\\"#", 4))
- {
- /*
- * Anchor for HTML output...
- */
-
- cupsCopyString(anchor, line + 4, sizeof(anchor));
- }
- else if (strncmp(line, ".\\\"", 3))
- {
- /*
- * Unknown...
- */
-
- if ((lineptr = strchr(line, ' ')) != NULL)
- *lineptr = '\0';
- else if ((lineptr = strchr(line, '\n')) != NULL)
- *lineptr = '\0';
-
- fprintf(stderr, "mantohtml: Unknown man page command \'%s\' on line %d.\n", line, linenum);
- }
-
- /*
- * Skip continuation lines...
- */
-
- lineptr = line + strlen(line) - 1;
- if (lineptr >= line && *lineptr == '\\')
- {
- while (fgets(line, sizeof(line), infile))
- {
- linenum ++;
- lineptr = line + strlen(line) - 2;
-
- if (lineptr < line || *lineptr != '\\')
- break;
- }
- }
- }
- else
- {
- /*
- * Process man page text...
- */
-
- if (pre == 1)
- {
- pre ++;
- if (!line[0])
- continue; // Skip initial blank line
- }
-
- html_fputs(line, &font, outfile);
- putc('\n', outfile);
-
- if (post)
- {
- fputs(post, outfile);
- post = NULL;
- }
- }
- }
-
- fprintf(outfile, "%s\n", end_fonts[font]);
- font = 0;
-
- if (list)
- {
- fprintf(outfile, "</%s>\n", list);
- list = NULL;
- }
-
- fputs("</body>\n"
- "</html>\n", outfile);
-
- /*
- * Close files...
- */
-
- if (infile != stdin)
- fclose(infile);
-
- if (outfile != stdout)
- fclose(outfile);
-
- /*
- * Return with no errors...
- */
-
- return (0);
-}
-
-
-/*
- * 'html_alternate()' - Alternate words between two styles of text.
- */
-
-static void
-html_alternate(const char *s, /* I - String */
- const char *first, /* I - First style or NULL */
- const char *second, /* I - Second style of NULL */
- FILE *fp) /* I - File */
-{
- int i = 0; /* Which style */
- int quote = 0; /* Saw quote? */
- int dolinks, /* Do hyperlinks to other man pages? */
- link = 0; /* Doing a link now? */
-
-
- /*
- * Skip leading whitespace...
- */
-
- while (isspace(*s & 255))
- s ++;
-
- dolinks = first && !strcmp(first, "b") && !second;
-
- while (*s)
- {
- if (!i && dolinks)
- {
- /*
- * See if we need to make a link to a man page...
- */
-
- const char *end; /* End of current word */
- const char *next; /* Start of next word */
-
- for (end = s; *end && !isspace(*end & 255); end ++);
- for (next = end; isspace(*next & 255); next ++);
-
- if (isalnum(*s & 255) && *next == '(')
- {
- // "name (section)" - see if the man file is available locally...
- char name[1024], // Name
- manfile[1024], // Man page filename
- manurl[1024]; // Man page URL
-
- cupsCopyString(name, s, sizeof(name));
- if ((size_t)(end - s) < sizeof(name))
- name[end - s] = '\0';
-
- snprintf(manurl, sizeof(manurl), "man-%s.html?TOPIC=Man+Pages", name);
- snprintf(manfile, sizeof(manfile), "%s.%d", name, atoi(next + 1));
- if (!access(manfile, 0))
- {
- // Local man page, do a link...
- fprintf(fp, "<a href=\"%s\">", manurl);
- link = 1;
- }
- }
- }
-
- if (!i && first)
- fprintf(fp, "<%s>", first);
- else if (i && second)
- fprintf(fp, "<%s>", second);
-
- while ((!isspace(*s & 255) || quote) && *s)
- {
- if (*s == '\"')
- quote = !quote;
-
- if (*s == '\\' && s[1])
- {
- s ++;
- html_putc(*s++, fp);
- }
- else
- html_putc(*s++, fp);
- }
-
- if (!i && first)
- fprintf(fp, "</%s>", first);
- else if (i && second)
- fprintf(fp, "</%s>", second);
-
- if (i && link)
- {
- fputs("</a>", fp);
- link = 0;
- }
-
- i ^= 1;
-
- /*
- * Skip trailing whitespace...
- */
-
- while (isspace(*s & 255))
- s ++;
- }
-
- putc('\n', fp);
-}
-
-/*
- * 'html_fputs()' - Output a string, quoting as needed HTML entities.
- */
-
-static void
-html_fputs(const char *s, /* I - String */
- int *font, /* IO - Font */
- FILE *fp) /* I - File */
-{
- while (*s)
- {
- if (*s == '\\')
- {
- s ++;
- if (!*s)
- break;
-
- if (*s == 'f')
- {
- int newfont; /* New font */
-
- s ++;
- if (!*s)
- break;
-
- if (!font)
- {
- s ++;
- continue;
- }
-
- switch (*s++)
- {
- case 'R' :
- case 'P' :
- newfont = 0;
- break;
-
- case 'b' :
- case 'B' :
- newfont = 1;
- break;
-
- case 'i' :
- case 'I' :
- newfont = 2;
- break;
-
- default :
- fprintf(stderr, "mantohtml: Unknown font \"\\f%c\" ignored.\n", s[-1]);
- newfont = *font;
- break;
- }
-
- if (newfont != *font)
- {
- fputs(end_fonts[*font], fp);
- *font = newfont;
- fputs(start_fonts[*font], fp);
- }
- }
- else if (*s == '*')
- {
- /*
- * Substitute macro...
- */
-
- s ++;
- if (!*s)
- break;
-
- switch (*s++)
- {
- case 'R' :
- fputs("®", fp);
- break;
-
- case '(' :
- if (!strncmp(s, "lq", 2))
- fputs("“", fp);
- else if (!strncmp(s, "rq", 2))
- fputs("”", fp);
- else if (!strncmp(s, "Tm", 2))
- fputs("<sup>TM</sup>", fp);
- else
- fprintf(stderr, "mantohtml: Unknown macro \"\\*(%2s\" ignored.\n", s);
-
- if (*s)
- s ++;
- if (*s)
- s ++;
- break;
-
- default :
- fprintf(stderr, "mantohtml: Unknown macro \"\\*%c\" ignored.\n", s[-1]);
- break;
- }
- }
- else if (*s == '(')
- {
- if (!strncmp(s, "(em", 3))
- {
- fputs("—", fp);
- s += 3;
- }
- else if (!strncmp(s, "(en", 3))
- {
- fputs("–", fp);
- s += 3;
- }
- else
- {
- putc(*s, fp);
- s ++;
- }
- }
- else if (*s == '[')
- {
- /*
- * Substitute escaped character...
- */
-
- s ++;
- if (!strncmp(s, "co]", 3))
- fputs("©", fp);
- else if (!strncmp(s, "de]", 3))
- fputs("°", fp);
- else if (!strncmp(s, "rg]", 3))
- fputs("®", fp);
- else if (!strncmp(s, "tm]", 3))
- fputs("<sup>TM</sup>", fp);
-
- if (*s)
- s ++;
- if (*s)
- s ++;
- if (*s)
- s ++;
- }
- else if (isdigit(s[0]) && isdigit(s[1]) &&
- isdigit(s[2]))
- {
- fprintf(fp, "&#%d;", ((s[0] - '0') * 8 + s[1] - '0') * 8 + s[2] - '0');
- s += 3;
- }
- else
- {
- if (*s != '\\' && *s != '\"' && *s != '\'' && *s != '-')
- {
- fprintf(stderr, "mantohtml: Unrecognized escape \"\\%c\" ignored.\n", *s);
- html_putc('\\', fp);
- }
-
- html_putc(*s++, fp);
- }
- }
- else if (!strncmp(s, "http://", 7) || !strncmp(s, "https://", 8) || !strncmp(s, "ftp://", 6))
- {
- /*
- * Embed URL...
- */
-
- char temp[1024], // Temporary string
- *tempptr; // Pointer into temporary string
-
- for (tempptr = temp; *s && !isspace(*s & 255) && tempptr < (temp + sizeof(temp) - 1); s ++)
- {
- if (strchr(",.)", *s) && strchr(",. \n\r\t", s[1]))
- {
- // End of URL
- break;
- }
- else if (*s == '\\' && s[1])
- {
- // Escaped character
- s ++;
- *tempptr++ = *s;
- }
- else
- {
- // Regular character...
- *tempptr++ = *s;
- }
- }
-
- *tempptr = '\0';
- fprintf(fp, "<a href=\"%s\">%s</a>", temp, temp);
- }
- else
- html_putc(*s++ & 255, fp);
- }
-}
-
-
-/*
- * 'html_putc()' - Put a single character, using entities as needed.
- */
-
-static void
-html_putc(int ch, /* I - Character */
- FILE *fp) /* I - File */
-{
- if (ch == '&')
- fputs("&", fp);
- else if (ch == '<')
- fputs("<", fp);
- else
- putc(ch, fp);
-}
-
-
-/*
- * 'strmove()' - Move characters within a string.
- */
-
-static void
-strmove(char *d, /* I - Destination */
- const char *s) /* I - Source */
-{
- while (*s)
- *d++ = *s++;
-
- *d = '\0';
-}
projects / thirdparty / cups.git / commitdiff
