-CHANGES.txt - 2.0b1 - 2014-02-20
+CHANGES.txt - 2.0b1 - 2014-03-04
--------------------------------
CHANGES IN CUPS V2.0b1
of the CUPS 1.4 sleep support to do a cleaner sleep
(<rdar://problem/14323704>)
- Dropped support for AIX, HP-UX, and OSF/1 (aka Digital UNIX)
+ - Adopted Linux man page conventions and updated all man pages
+ (STR #4372)
- Added support for re-sending a job as a raster file if a higher-level
format such as PDF fails (<rdar://problem/15583721>)
- Added support for regular expression matching in the MIME type rules
font-style: italic;
margin-left: 36pt;
}
-
+
PRE.example {
background: #eeeeee;
border: dotted thin #999999;
}
A:link, A:visited {
- font-weight: normal;
+ font-weight: inherit;
text-decoration: none;
}
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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><br>
-<b>backend
-</b>job user title num-copies options [
-<i>filename
-</i>]
+<b>backend</b>
+<br>
+<b>backend</b>
+job user title num-copies options [
+<i>filename</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-Backends are a special type of <a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a> which is used to send print data
+Backends are a special type of <i>filter(7)</i> 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
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. Instead, use the <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> or <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> programs to send
-a print job or <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a> program to query for available printers using the
+backends directly. Instead, use the <i>lp(1)</i> or <i>lpr(1)</i> programs to send
+a print job or <i>lpinfo(8)</i> program to query for available printers using the
backend. The one exception is the SNMP backend - see <i>snmpbackend(8)</i> for
more information.
<h2 class="title"><a name="DEVICE_DISCOVERY">Device Discovery</a></h2>
device-class device-uri "device-make-and-model" "device-info" "device-id" "device-location"
</pre>
<p>The <i>device-class</i> field is one of the following values:
-<dl>
-<dt>direct
-</dt>
-<dd></dd>
-<dd>The device-uri refers to a specific direct-access device with no options, such
+<p style="margin-left: 5.0em; text-indent: -5.0em">direct
+<br>
+<br>
+The device-uri refers to a specific direct-access device with no options, such
as a parallel, USB, or SCSI device.
-</dd>
-<dt>file
-</dt>
-<dd></dd>
-<dd>The device-uri refers to a file on disk.
-</dd>
-<dt>network
-</dt>
-<dd></dd>
-<dd>The device-uri refers to a networked device and conforms to the general form for
+<p style="margin-left: 5.0em; text-indent: -5.0em">file
+<br>
+<br>
+The device-uri refers to a file on disk.
+<p style="margin-left: 5.0em; text-indent: -5.0em">network
+<br>
+<br>
+The device-uri refers to a networked device and conforms to the general form for
network URIs.
-</dd>
-<dt>serial
-</dt>
-<dd></dd>
-<dd>The device-uri refers to a serial device with configurable baud rate and other
+<p style="margin-left: 5.0em; text-indent: -5.0em">serial
+<br>
+<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.
-</dd>
-</dl>
<p>The <i>scheme</i> 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> field specifies the full URI to use when
<h2 class="title"><a name="EXIT_CODES">Exit Codes</a></h2>
The following exit codes are defined for backends; C API constants defined in
the <cups/backend.h> header file are defined in parenthesis:
-<dl>
-<dt>0 (CUPS_BACKEND_OK)
-</dt>
-<dd></dd>
-<dd>The print file was successfully transmitted to the device or remote server.
-</dd>
-<dt>1 (CUPS_BACKEND_FAILED)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted to the device or remote server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">0 (CUPS_BACKEND_OK)
+<br>
+<br>
+The print file was successfully transmitted to the device or remote server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">1 (CUPS_BACKEND_FAILED)
+<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 error-policy attribute.
-</dd>
-<dt>2 (CUPS_BACKEND_AUTH_REQUIRED)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because valid authentication
+<p style="margin-left: 5.0em; text-indent: -5.0em">2 (CUPS_BACKEND_AUTH_REQUIRED)
+<br>
+<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"
attribute.
-</dd>
-<dt>3 (CUPS_BACKEND_HOLD)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because it cannot be printed at
+<p style="margin-left: 5.0em; text-indent: -5.0em">3 (CUPS_BACKEND_HOLD)
+<br>
+<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.
-</dd>
-<dt>4 (CUPS_BACKEND_STOP)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because it cannot be printed at
+<p style="margin-left: 5.0em; text-indent: -5.0em">4 (CUPS_BACKEND_STOP)
+<br>
+<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.
-</dd>
-<dt>5 (CUPS_BACKEND_CANCEL)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because one or more attributes
+<p style="margin-left: 5.0em; text-indent: -5.0em">5 (CUPS_BACKEND_CANCEL)
+<br>
+<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.
-</dd>
-<dt>6 (CUPS_BACKEND_RETRY)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because of a temporary issue.
+<p style="margin-left: 5.0em; text-indent: -5.0em">6 (CUPS_BACKEND_RETRY)
+<br>
+<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.
-</dd>
-<dt>7 (CUPS_BACKEND_RETRY_CURRENT)
-</dt>
-<dd></dd>
-<dd>The print file was not successfully transmitted because of a temporary issue.
+<p style="margin-left: 5.0em; text-indent: -5.0em">7 (CUPS_BACKEND_RETRY_CURRENT)
+<br>
+<br>
+The print file was not successfully transmitted because of a temporary issue.
The scheduler will retry the job immediately without allowing intervening jobs.
-</dd>
-</dl>
<p>All other exit code values are reserved.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cups-snmp.html?TOPIC=Man+Pages'>cups-snmp(8)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a>,
-<a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a>,
+<i>cups-snmp(8)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>, <i>filter(7)</i>,
+<i>lpinfo(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cancel - cancel jobs
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cancel
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -a ] [ -h
-<i>hostname[:port]
-</i>] [ -u
-<i>username
-</i>] [ -x ] [
-<i>id
-</i>] [
-<i>destination
-</i>] [
-<i>destination-id
-</i>]
+<b>cancel</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -a ] [ -h
+<i>hostname[:port]</i>
+] [ -u
+<i>username</i>
+] [ -x ] [
+<i>id</i>
+] [
+<i>destination</i>
+] [
+<i>destination-id</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cancel</i> cancels existing print jobs. The <i>-a</i> option will remove
all jobs from the specified destination.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>cancel</i>:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies the username to use when connecting to the server.
-</dd>
-<dt>-a
-</dt>
-<dd></dd>
-<dd>Cancel all jobs on the named destination, or all jobs on all
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies the username to use when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-a
+<br>
+<br>
+Cancel all jobs on the named destination, or all jobs on all
destinations if none is provided.
-</dd>
-<dt>-h hostname[:port]
-</dt>
-<dd></dd>
-<dd>Chooses an alternate server.
-</dd>
-<dt>-u username
-</dt>
-<dd></dd>
-<dd>Cancels jobs owned by <i>username</i>.
-</dd>
-<dt>-x
-</dt>
-<dd></dd>
-<dd>Deletes job data files in addition to canceling.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h hostname[:port]
+<br>
+<br>
+Chooses an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u username
+<br>
+<br>
+Cancels jobs owned by <i>username</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-x
+<br>
+<br>
+Deletes job data files in addition to canceling.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".
<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'>cupsd.conf(5)</a>.
+Cancel-Jobs operations in <i>cupsd.conf(5)</i>.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpmove.html?TOPIC=Man+Pages'>lpmove(8)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>lp(1)</i>, <i>lpmove(8)</i>, <i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <i>classes.conf</i> file defines the local printer classes that are
available. It is normally located in the <i>/etc/cups</i> directory and
-is generated automatically by the <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a> program when printer
+is generated automatically by the <i>cupsd(8)</i> program when printer
classes are added or deleted.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl>
-<dt><Class name> ... </Class>
-</dt>
-<dd></dd>
-<dd>Defines a specific printer class.
-</dd>
-<dt><DefaultClass name> ... </Class>
-</dt>
-<dd></dd>
-<dd>Defines a default printer class.
-</dd>
-<dt>Accepting Yes
-</dt>
-<dd></dd>
-<dt>Accepting No
-</dt>
-<dd></dd>
-<dd>Specifies whether the printer is accepting new jobs.
-</dd>
-<dt>AllowUser [ user @group ... ]
-</dt>
-<dd></dd>
-<dd>Allows specific users and groups to print to the printer.
-</dd>
-<dt>DenyUser [ user @group ... ]
-</dt>
-<dd></dd>
-<dd>Prevents specific users and groups from printing to the printer.
-</dd>
-<dt>Info text
-</dt>
-<dd></dd>
-<dd>Specifies human-readable text describing the printer.
-</dd>
-<dt>JobSheets banner banner
-</dt>
-<dd></dd>
-<dd>Specifies the banner pages to use for the printer.
-</dd>
-<dt>KLimit number
-</dt>
-<dd></dd>
-<dd>Specifies the job-k-limit value for the printer.
-</dd>
-<dt>Location text
-</dt>
-<dd></dd>
-<dd>Specifies human-readable text describing the location of the printer.
-</dd>
-<dt>OpPolicy name
-</dt>
-<dd></dd>
-<dd>Specifies the operation policy for the printer.
-</dd>
-<dt>PageLimit number
-</dt>
-<dd></dd>
-<dd>Specifies the job-page-limit value for the printer.
-</dd>
-<dt>Printer
-</dt>
-<dd></dd>
-<dd>Specifies a printer that is a member of the printer class.
-</dd>
-<dt>QuotaPeriod seconds
-</dt>
-<dd></dd>
-<dd>Specifies the job-quota-period value for the printer.
-</dd>
-<dt>Shared Yes
-</dt>
-<dd></dd>
-<dt>Shared No
-</dt>
-<dd></dd>
-<dd>Specifies whether the printer is shared.
-</dd>
-<dt>State idle
-</dt>
-<dd></dd>
-<dt>State stopped
-</dt>
-<dd></dd>
-<dd>Specifies the initial state of the printer (Idle or Stopped)
-</dd>
-<dt>StateMessage text
-</dt>
-<dd></dd>
-<dd>Specifies the message associated with the state.
-</dd>
-<dt>StateTime seconds
-</dt>
-<dd></dd>
-<dd>Specifies the date/time associated with the state.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Class name> ... </Class>
+<br>
+<br>
+Defines a specific printer class.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><DefaultClass name> ... </Class>
+<br>
+<br>
+Defines a default printer class.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting No
+<br>
+<br>
+Specifies whether the printer is accepting new jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">AllowUser [ user @group ... ]
+<br>
+<br>
+Allows specific users and groups to print to the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DenyUser [ user @group ... ]
+<br>
+<br>
+Prevents specific users and groups from printing to the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Info text
+<br>
+<br>
+Specifies human-readable text describing the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobSheets banner banner
+<br>
+<br>
+Specifies the banner pages to use for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">KLimit number
+<br>
+<br>
+Specifies the job-k-limit value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Location text
+<br>
+<br>
+Specifies human-readable text describing the location of the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">OpPolicy name
+<br>
+<br>
+Specifies the operation policy for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PageLimit number
+<br>
+<br>
+Specifies the job-page-limit value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Printer
+<br>
+<br>
+Specifies a printer that is a member of the printer class.
+<p style="margin-left: 5.0em; text-indent: -5.0em">QuotaPeriod seconds
+<br>
+<br>
+Specifies the job-quota-period value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Shared Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Shared No
+<br>
+<br>
+Specifies whether the printer is shared.
+<p style="margin-left: 5.0em; text-indent: -5.0em">State idle
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">State stopped
+<br>
+<br>
+Specifies the initial state of the printer (Idle or Stopped)
+<p style="margin-left: 5.0em; text-indent: -5.0em">StateMessage text
+<br>
+<br>
+Specifies the message associated with the state.
+<p style="margin-left: 5.0em; text-indent: -5.0em">StateTime seconds
+<br>
+<br>
+Specifies the date/time associated with the state.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>,
-<a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
+<i>cupsd(8)</i>, <i>cupsd.conf(5)</i>, <i>mime.convs(5)</i>,
+<i>mime.types(5)</i>, <i>printers.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
The following directives are understood by the client. Consult the
on-line help for detailed descriptions:
-<dl>
-<dt>Encryption IfRequested
-</dt>
-<dd></dd>
-<dt>Encryption Never
-</dt>
-<dd></dd>
-<dt>Encryption Required
-</dt>
-<dd></dd>
-<dd>Specifies the level of encryption that is required for a particular
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption IfRequested
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption Never
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption Required
+<br>
+<br>
+Specifies the level of encryption that is required for a particular
location.
-</dd>
-<dt>GSSServiceName name
-</dt>
-<dd>Specifies the Kerberos service name that is used for authentication, typically
+<p style="margin-left: 5.0em; text-indent: -5.0em">GSSServiceName name
+<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".
-</dd>
-<dt>ServerName hostname-or-ip-address[:port]
-</dt>
-<dd></dd>
-<dt>ServerName /domain/socket
-</dt>
-<dd></dd>
-<dd>Specifies the address and optionally the port to use when connecting to the
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerName hostname-or-ip-address[:port]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerName /domain/socket
+<br>
+<br>
+Specifies the address and optionally the port to use when connecting to the
server. <b>Note: Not supported on OS X 10.7 or later.</b>
-</dd>
-<dt>ServerName hostname-or-ip-address[:port]/version=1.1
-</dt>
-<dd></dd>
-<dd>Specifies the address and optionally the port to use when connecting to a
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerName hostname-or-ip-address[:port]/version=1.1
+<br>
+<br>
+Specifies the address and optionally the port to use when connecting to a
server running CUPS 1.3.12 and earlier. <b>Note: Not supported on OS X 10.7 or
later.</b>
-</dd>
-<dt>User name
-</dt>
-<dd></dd>
-<dd>Specifies the default user name to use for requests.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">User name
+<br>
+<br>
+Specifies the default user name to use for requests.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-config - get cups api, compiler, directory, and link information.
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-config
-</b>--api-version
+<b>cups-config</b>
+--api-version
<br>
-<b>cups-config
-</b>--build
+<b>cups-config</b>
+--build
<br>
-<b>cups-config
-</b>--cflags
+<b>cups-config</b>
+--cflags
<br>
-<b>cups-config
-</b>--datadir
+<b>cups-config</b>
+--datadir
<br>
-<b>cups-config
-</b>--help
+<b>cups-config</b>
+--help
<br>
-<b>cups-config
-</b>--ldflags
+<b>cups-config</b>
+--ldflags
<br>
-<b>cups-config
-</b>[
-<i>--image
-</i>] [
-<i>--static
-</i>] --libs
+<b>cups-config</b>
+[
+<i>--image</i>
+] [
+<i>--static</i>
+] --libs
<br>
-<b>cups-config
-</b>--serverbin
+<b>cups-config</b>
+--serverbin
<br>
-<b>cups-config
-</b>--serverroot
+<b>cups-config</b>
+--serverroot
<br>
-<b>cups-config
-</b>--version
+<b>cups-config</b>
+--version
<br>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<b>cups-config</b> is the CUPS program configuration utility. It should be
options for the compiler and linker, as well as determining installation
directories for filters, configuration files, and drivers.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl>
-<dt>--api-version
-</dt>
-<dd></dd>
-<dd>Displays the current API version (major.minor).
-</dd>
-<dt>--build
-</dt>
-<dd></dd>
-<dd>Displays a system-specific build number.
-</dd>
-<dt>--cflags
-</dt>
-<dd></dd>
-<dd>Displays the necessary compiler options.
-</dd>
-<dt>--datadir
-</dt>
-<dd></dd>
-<dd>Displays the default CUPS data directory.
-</dd>
-<dt>--help
-</dt>
-<dd></dd>
-<dd>Displays the program usage message.
-</dd>
-<dt>--image
-</dt>
-<dd></dd>
-<dd>When used with <i>--libs</i>, adds the CUPS imaging library to the
+<p style="margin-left: 5.0em; text-indent: -5.0em">--api-version
+<br>
+<br>
+Displays the current API version (major.minor).
+<p style="margin-left: 5.0em; text-indent: -5.0em">--build
+<br>
+<br>
+Displays a system-specific build number.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--cflags
+<br>
+<br>
+Displays the necessary compiler options.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--datadir
+<br>
+<br>
+Displays the default CUPS data directory.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--help
+<br>
+<br>
+Displays the program usage message.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--image
+<br>
+<br>
+When used with <i>--libs</i>, adds the CUPS imaging library to the
list of displayed libraries.
-</dd>
-<dt>--ldflags
-</dt>
-<dd></dd>
-<dd>Displays the necessary linker options.
-</dd>
-<dt>--libs
-</dt>
-<dd></dd>
-<dd>Displays the necessary librarys to link to.
-</dd>
-<dt>--serverbin
-</dt>
-<dd></dd>
-<dd>Displays the default CUPS binary directory,
+<p style="margin-left: 5.0em; text-indent: -5.0em">--ldflags
+<br>
+<br>
+Displays the necessary linker options.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--libs
+<br>
+<br>
+Displays the necessary librarys to link to.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--serverbin
+<br>
+<br>
+Displays the default CUPS binary directory,
where filters and backends are stored.
-</dd>
-<dt>--serverroot
-</dt>
-<dd></dd>
-<dd>Displays the default CUPS configuration file directory.
-</dd>
-<dt>--static
-</dt>
-<dd></dd>
-<dd>When used with <i>--libs</i>, shows the static libraries instead
+<p style="margin-left: 5.0em; text-indent: -5.0em">--serverroot
+<br>
+<br>
+Displays the default CUPS configuration file directory.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--static
+<br>
+<br>
+When used with <i>--libs</i>, shows the static libraries instead
of the default (shared) libraries.
-</dd>
-<dt>--version
-</dt>
-<dd></dd>
-<dd>Displays the full version number of the CUPS installation
+<p style="margin-left: 5.0em; text-indent: -5.0em">--version
+<br>
+<br>
+Displays the full version number of the CUPS installation
(major.minor.patch).
-</dd>
-</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-deviced - cups device daemon
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-deviced
-</b><i>request-id limit user-id options
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>cups-deviced</b>
+<i>request-id</i> <i>limit</i> <i>user-id</i> <i>options</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cups-deviced</i> polls the backends in
<i>/usr/lib/cups/backend</i> or <i>/usr/libexec/cups/backend</i> (OS X) for a
-list of available devices. It is run by <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a> in response to a
+list of available devices. It is run by <i>cupsd(8)</i> in response to a
<i>CUPS-Get-Devices</i> request. The output format is an IPP
response message. The <i>request-id</i> argument is the request ID
from the original IPP request, typically 1. The <i>limit</i>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
backend(7), cupsd(8), cupsd.conf(5),
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-driverd - cups driver daemon
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-driverd
-</b>cat
-<i>ppd-name
-</i><br>
-<b>cups-driverd
-</b>list
-<i>request_id limit options
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>cups-driverd</b>
+cat
+<i>ppd-name</i>
+<br>
+<b>cups-driverd</b>
+list
+<i>request_id</i> <i>limit</i> <i>options</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cups-driverd</i> shows or lists PPD files. It is run in
response to CUPS-Add-Modify-Printer or CUPS-Get-Devices requests.
The first form ("cups-driverd cat ppd-name") writes the named PPD
<i>limit</i> argument is the limit value from the original IPP
request - 0 means no limit. Finally, the <i>options</i> argument
is a space-delimited list of attributes ("name=value name=value
-...") that were passed in with the request. Currently
+&...") that were passed in with the request. Currently
<i>cups-driverd</i> looks for the <i>ppd-make</i> and
<i>requested-attributes</i> attributes and tailors the output
accordingly.
<h3><a name="DRIVER_PROGRAMS">Driver Programs</a></h3>
Driver programs provide a interface to dynamically-generated PPD
files. The following arguments are currently defined:
-<dl>
-<dt>drivername list
-</dt>
-<dd></dd>
-<dd>Lists the supported PPD files to stdout.
-</dd>
-<dt>drivername cat ppdname
-</dt>
-<dd></dd>
-<dd>Writes the named PPD file to stdout.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">drivername list
+<br>
+<br>
+Lists the supported PPD files to stdout.
+<p style="margin-left: 5.0em; text-indent: -5.0em">drivername cat ppdname
+<br>
+<br>
+Writes the named PPD file to stdout.
<p>Driver programs MUST NOT query hardware or make other long-term operations that
would delay the return of a driver list. See the NOTES section below for
specific recommendations.
-<h3><a name="LISTING_FILES_(drivername_list)">Listing Files (drivername list)</a></h3>
+<h3><a name="LISTING_FILES__drivername_list_">Listing Files (drivername list)</a></h3>
When run with the single argument "list", the program must list
the available PPD files it can generate to stdout using the
following format:
string as it would appear in the PPD file or from a PostScript query. <i>Type</i>
is "postscript" for PostScript printers, "pdf" for PDF printers, "raster" for
raster printers, or "fax" for facsimile devices.
-<h3><a name="WRITING_FILES_(drivername_cat_ppdname)">Writing Files (drivername cat ppdname)</a></h3>
+<h3><a name="WRITING_FILES__drivername_cat_ppdname_">Writing Files (drivername cat ppdname)</a></h3>
When the driver program is run with the "cat ppdname" arguments,
it must write the named PPD file to stdout, uncompressed. If the
named PPD file does not exist, the driver program must not write
<h3><a name="DRIVER_ERROR_MESSAGES">Driver Error Messages</a></h3>
Error messages can be relayed back to <i>cupsd</i> by writing them
to stderr. The following prefixes are recognized:
-<dl>
-<dt>DEBUG: [drivername]
-</dt>
-<dd></dd>
-<dd>Debugging messages
-</dd>
-<dt>ERROR: [drivername]
-</dt>
-<dd></dd>
-<dd>Error messages
-</dd>
-<dt>INFO: [drivername]
-</dt>
-<dd></dd>
-<dd>Informational messages
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEBUG: [drivername]
+<br>
+<br>
+Debugging messages
+<p style="margin-left: 5.0em; text-indent: -5.0em">ERROR: [drivername]
+<br>
+<br>
+Error messages
+<p style="margin-left: 5.0em; text-indent: -5.0em">INFO: [drivername]
+<br>
+<br>
+Informational messages
<h2 class="title"><a name="NOTES">Notes</a></h2>
Due to performance considerations, driver programs have been officially
deprecated and should not be used for new development. Currently only the
-CUPS web interface and <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a> command will request lists from all
+CUPS web interface and <i>lpinfo(8)</i> command will request lists from all
driver programs.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
cupsd(8), cupsd.conf(5), cupstestppd(1), lpinfo(8),
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
cups-files.conf - file and directory configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <i>cups-files.conf</i> file configures the files and directories used by the
-CUPS scheduler, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>. It is normally located in the
+CUPS scheduler, <i>cupsd(8)</i>. It is normally located in the
<i>/etc/cups</i> directory.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-The following directives are understood by <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>. Consult the
+The following directives are understood by <i>cupsd(8)</i>. Consult the
on-line help for detailed descriptions:
-<dl>
-<dt>AccessLog filename
-</dt>
-<dd></dd>
-<dt>AccessLog syslog
-</dt>
-<dd></dd>
-<dd>Defines the access log filename.
-</dd>
-<dt>ConfigFilePerm mode
-</dt>
-<dd></dd>
-<dd>Specifies the permissions for all configuration files that the scheduler
+<p style="margin-left: 5.0em; text-indent: -5.0em">AccessLog filename
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AccessLog syslog
+<br>
+<br>
+Defines the access log filename.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ConfigFilePerm mode
+<br>
+<br>
+Specifies the permissions for all configuration files that the scheduler
writes.
-</dd>
-<dt>DataDir path
-</dt>
-<dd></dd>
-<dd>Specified the directory where data files can be found.
-</dd>
-<dt>DocumentRoot directory
-</dt>
-<dd></dd>
-<dd>Specifies the root directory for the internal web server documents.
-</dd>
-<dt>ErrorLog filename
-</dt>
-<dd></dd>
-<dt>ErrorLog syslog
-</dt>
-<dd></dd>
-<dd>Specifies the error log filename.
-</dd>
-<dt>FatalErrors none
-</dt>
-<dd></dd>
-<dt>FatalErrors all -kind [... -kind]
-</dt>
-<dd></dd>
-<dt>FatalErrors kind [... kind]
-</dt>
-<dd></dd>
-<dd>Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
+<p style="margin-left: 5.0em; text-indent: -5.0em">DataDir path
+<br>
+<br>
+Specified the directory where data files can be found.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DocumentRoot directory
+<br>
+<br>
+Specifies the root directory for the internal web server documents.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorLog filename
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorLog syslog
+<br>
+<br>
+Specifies the error log filename.
+<p style="margin-left: 5.0em; text-indent: -5.0em">FatalErrors none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">FatalErrors all -kind [... -kind]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">FatalErrors kind [... kind]
+<br>
+<br>
+Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
"browse", "config", "listen", "log", or "permissions".
-</dd>
-<dt>FileDevice Yes
-</dt>
-<dd></dd>
-<dt>FileDevice No
-</dt>
-<dd></dd>
-<dd>Specifies whether the file pseudo-device can be used for new
+<p style="margin-left: 5.0em; text-indent: -5.0em">FileDevice Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">FileDevice No
+<br>
+<br>
+Specifies whether the file pseudo-device can be used for new
printer queues.
-</dd>
-<dt>FontPath directory[:directory:...]
-</dt>
-<dd></dd>
-<dd>Specifies the search path for fonts.
-</dd>
-<dt>Group group-name-or-number
-</dt>
-<dd></dd>
-<dd>Specifies the group name or ID that will be used when executing
+<p style="margin-left: 5.0em; text-indent: -5.0em">FontPath directory[:directory:...]
+<br>
+<br>
+Specifies the search path for fonts.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Group group-name-or-number
+<br>
+<br>
+Specifies the group name or ID that will be used when executing
external programs.
-</dd>
-<dt>LogFilePerm mode
-</dt>
-<dd></dd>
-<dd>Specifies the permissions for all log files that the scheduler writes.
-</dd>
-<dt>PageLog filename
-</dt>
-<dd></dd>
-<dt>PageLog syslog
-</dt>
-<dd></dd>
-<dd>Specifies the page log filename.
-</dd>
-<dt>Printcap
-</dt>
-<dd></dd>
-<dt>Printcap filename
-</dt>
-<dd></dd>
-<dd>Specifies the filename for a printcap file that is updated
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogFilePerm mode
+<br>
+<br>
+Specifies the permissions for all log files that the scheduler writes.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PageLog filename
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PageLog syslog
+<br>
+<br>
+Specifies the page log filename.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Printcap
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Printcap filename
+<br>
+<br>
+Specifies the filename for a printcap file that is updated
automatically with a list of available printers (needed for
legacy applications); specifying Printcap with no filename
disables printcap generation.
-</dd>
-<dt>RemoteRoot user-name
-</dt>
-<dd></dd>
-<dd>Specifies the username that is associated with unauthenticated root
+<p style="margin-left: 5.0em; text-indent: -5.0em">RemoteRoot user-name
+<br>
+<br>
+Specifies the username that is associated with unauthenticated root
accesses.
-</dd>
-<dt>RequestRoot directory
-</dt>
-<dd></dd>
-<dd>Specifies the directory to store print jobs and other HTTP request
+<p style="margin-left: 5.0em; text-indent: -5.0em">RequestRoot directory
+<br>
+<br>
+Specifies the directory to store print jobs and other HTTP request
data.
-</dd>
-<dt>Sandboxing off
-</dt>
-<dd></dd>
-<dt>Sandboxing relaxed
-</dt>
-<dd></dd>
-<dt>Sandboxing strict
-</dt>
-<dd>Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler. The default is "strict". (OS X only)
-</dd>
-<dt>ServerBin directory
-</dt>
-<dd></dd>
-<dd>Specifies the directory where backends, CGIs, daemons, and filters may
+<p style="margin-left: 5.0em; text-indent: -5.0em">Sandboxing off
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Sandboxing relaxed
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Sandboxing strict
+<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". (OS X only)
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerBin directory
+<br>
+<br>
+Specifies the directory where backends, CGIs, daemons, and filters may
be found.
-</dd>
-<dt>ServerKeychain path
-</dt>
-<dd></dd>
-<dd>Specifies the location of TLS certificates and private keys.
-</dd>
-<dt>ServerRoot directory
-</dt>
-<dd></dd>
-<dd>Specifies the directory where the server configuration files can be found.
-</dd>
-<dt>SyncOnClose Yes
-</dt>
-<dd></dd>
-<dt>SyncOnClose No
-</dt>
-<dd>Specifies whether the scheduler calls <i>fsync(2)</i> after writing configuration
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerKeychain path
+<br>
+<br>
+Specifies the location of TLS certificates and private keys.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerRoot directory
+<br>
+<br>
+Specifies the directory where the server configuration files can be found.
+<p style="margin-left: 5.0em; text-indent: -5.0em">SyncOnClose Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SyncOnClose No
+<br>
+Specifies whether the scheduler calls <i>fsync(2)</i> after writing configuration
or state files. The default is No.
-</dd>
-<dt>SystemGroup group-name [group-name ...]
-</dt>
-<dd></dd>
-<dd>Specifies the group(s) to use for System class authentication.
-</dd>
-<dt>TempDir directory
-</dt>
-<dd></dd>
-<dd>Specifies the directory where temporary files are stored.
-</dd>
-<dt>User user-name
-</dt>
-<dd></dd>
-<dd>Specifies the user name or ID that is used when running external programs.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SystemGroup group-name [group-name ...]
+<br>
+<br>
+Specifies the group(s) to use for System class authentication.
+<p style="margin-left: 5.0em; text-indent: -5.0em">TempDir directory
+<br>
+<br>
+Specifies the directory where temporary files are stored.
+<p style="margin-left: 5.0em; text-indent: -5.0em">User user-name
+<br>
+<br>
+Specifies the user name or ID that is used when running external programs.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>,
-<a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
-<a href='man-subscriptions.conf.html?TOPIC=Man+Pages'>subscriptions.conf(5)</a>,
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>, <i>mime.convs(5)</i>,
+<i>mime.types(5)</i>, <i>printers.conf(5)</i>,
+<i>subscriptions.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2014 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-lpd - receive print jobs and report printer status to lpd clients
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cups-lpd
-</b>[ -h
-<i>hostname[:port]
-</i>] [ -n ] [ -o
-<i>option=value
-</i>]
+<b>cups-lpd</b>
+[ -h
+<i>hostname[:port]</i>
+] [ -n ] [ -o
+<i>option=value</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cups-lpd</i> is the CUPS Line Printer Daemon ("LPD")
mini-server that supports legacy client systems that use the LPD
}
</pre>
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl>
-<dt>-h hostname[:port]
-</dt>
-<dd></dd>
-<dd>Sets the CUPS server (and port) to use.
-</dd>
-<dt>-n
-</dt>
-<dd></dd>
-<dd>Disables reverse address lookups; normally <i>cups-lpd</i> will
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h hostname[:port]
+<br>
+<br>
+Sets the CUPS server (and port) to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-n
+<br>
+<br>
+Disables reverse address lookups; normally <i>cups-lpd</i> will
try to discover the hostname of the client via a reverse DNS
lookup.
-</dd>
-<dt>-o name=value
-</dt>
-<dd></dd>
-<dd>Inserts options for all print queues. Most often this is used to
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value
+<br>
+<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 examples in the previous section set the
"document-format" option to "application/octet-stream" which
forces autodetection of the print file format.
-</dd>
-</dl>
<h2 class="title"><a name="PERFORMANCE">Performance</a></h2>
<i>cups-lpd</i> performs well with small numbers of clients and
printers. However, since a new process is created for each
use the native IPP support provided by CUPS instead.
<h2 class="title"><a name="SECURITY">Security</a></h2>
<i>cups-lpd</i> currently does not perform any access control
-based on the settings in <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a> or in the
+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. Therefore, running <i>cups-lpd</i> on your server will
allow any computer on your network (and perhaps the entire
stray from this definition, remote status reporting to LPD
clients may be unreliable.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>cups(1)</i>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <i>inetconv(1m)</i>,
+<i>cups(1)</i>, <i>cupsd(8)</i>, <i>inetconv(1m)</i>,
<i>inetd(8)</i>, <i>xinetd(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
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'>cups-snmp(8)</a>).
+apply only to the SNMP backend (<i>cups-snmp(8)</i>).
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
The following directives are understood by the CUPS network backends. Consult
the on-line help for detailed descriptions:
-<dl>
-<dt>Address @IF(<i>name</i>)
-</dt>
-<dd></dd>
-<dt>Address @LOCAL
-</dt>
-<dd></dd>
-<dt>Address <i>address</i>
-</dt>
-<dd></dd>
-<dd>Sends SNMP broadcast queries to the specified address(es). There is no default
+<p style="margin-left: 5.0em; text-indent: -5.0em">Address @IF(<i>name</i>)
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Address @LOCAL
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Address <i>address</i>
+<br>
+<br>
+Sends SNMP broadcast queries to the specified address(es). There is no default
for the broadcast address.
-</dd>
-<dt>Community <i>name</i>
-</dt>
-<dd></dd>
-<dd>Specifies the community name to use. Only a single community name may be
+<p style="margin-left: 5.0em; text-indent: -5.0em">Community <i>name</i>
+<br>
+<br>
+Specifies the community name to use. Only a single community name may be
specified. The default community name is "public".
-</dd>
-<dt>DebugLevel number
-</dt>
-<dd></dd>
-<dd>Specifies the logging level from 0 (none) to 3 (everything). Typically only used
+<p style="margin-left: 5.0em; text-indent: -5.0em">DebugLevel number
+<br>
+<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.
-</dd>
-<dt>DeviceURI "regular expression" device-uri [... device-uri]
-</dt>
-<dd></dd>
-<dd>Specifies one or more device URIs that should be used for a given make and model
+<p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI "regular expression" device-uri [... device-uri]
+<br>
+<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.
-</dd>
-<dt>HostNameLookups on
-</dt>
-<dd></dd>
-<dt>HostNameLookups off
-</dt>
-<dd></dd>
-<dd>Specifies whether the addresses of printers should be converted to hostnames or
+<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups on
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups off
+<br>
+<br>
+Specifies whether the addresses of printers should be converted to hostnames or
left as numeric IP addresses. The default is "off".
-</dd>
-<dt>MaxRunTime <i>seconds</i>
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of seconds that the SNMP backend will scan the
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxRunTime <i>seconds</i>
+<br>
+<br>
+Specifies the maximum number of seconds that the SNMP backend will scan the
network for printers. The default is 120 seconds (2 minutes).
-</dd>
-</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
cups-snmp(8),
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
snmp - cups snmp backend
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>/usr/lib/cups/backend/snmp
-</b><i>ip-address-or-hostname
-</i><br>
-<b>/usr/libexec/cups/backend/snmp
-</b><i>ip-address-or-hostname
-</i><br>
-<b>lpinfo -v --include-schemes snmp
-<
/b><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>/usr/lib/cups/backend/snmp</b>
+<i>ip-address-or-hostname</i>
+<br>
+<b>/usr/libexec/cups/backend/snmp</b>
+<i>ip-address-or-hostname</i>
+<br>
+<b>lpinfo</b> <b>-v</b> <b>--include-schemes</b> <b>snmp</b>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The 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
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'>lpinfo(8)</a>
+<p>In the second form, the SNMP backend is run indirectly using the <i>lpinfo(8)</i>
command. The output provides all printers detected via SNMP on the configured
broadcast addresses. <b>Note</b>: no broadcast addresses are configured by
default.
<h2 class="title"><a name="CONFIGURATION">Configuration</a></h2>
The SNMP backend reads the /etc/cups/snmp.conf configuration file, if
present, to set the default broadcast address, community name, and logging
-level. The configuration file is documented in <a href='man-cups-snmp.conf.html?TOPIC=Man+Pages'>cups-snmp.conf(5)</a>. The
+level. The configuration file is documented in <i>cups-snmp.conf(5)</i>. The
DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment
variable and the MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME
environment variable.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-backend.html?TOPIC=Man+Pages'>backend(7)</a>, <a href='man-cups-snmp.conf.html?TOPIC=Man+Pages'>cups-snmp.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a>, <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a>,
+<i>backend(7)</i>, <i>cups-snmp.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>filter(7)</i>, <i>lpinfo(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>hostname[:port]
-</i>] destination(s)
+<b>cupsaccept</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>hostname[:port]</i>
+] destination(s)
<br>
-<b>cupsreject
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>hostname[:port]
-</i>] [ -r
-<i>reason
-</i>] destination(s)
+<b>cupsreject</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>hostname[:port]</i>
+] [ -r
+<i>reason</i>
+] destination(s)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsaccept</i> instructs the printing system to accept print jobs to the
specified destinations.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are supported by both <i>cupsaccept</i> and
<i>cupsreject</i>:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Sets the username that is sent when connecting to the server.
-</dd>
-<dt>-h hostname[:port]
-</dt>
-<dd></dd>
-<dd>Chooses an alternate server.
-</dd>
-<dt>-r "reason"
-</dt>
-<dd></dd>
-<dd>Sets the reason string that is shown for a printer that is
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Sets the username that is sent when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h hostname[:port]
+<br>
+<br>
+Chooses an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r "reason"
+<br>
+<br>
+Sets the reason string that is shown for a printer that is
rejecting jobs.
-</dd>
-</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".
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-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-cupsenable.html?TOPIC=Man+Pages'>cupsenable(8)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>,
-<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>cupsenable(8)</i>, <i>lp(1)</i>,
+<i>lpadmin(8)</i>, <i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
cupsaddsmb - export printers to samba for windows clients
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsaddsmb
-</b>[ -H
-<i>samba-server
-</i>] [ -U
-<i>samba-user[%samba-password]
-</i>] [ -h
-<i>cups-server[:port]
-</i>] [ -v ] -a
+<b>cupsaddsmb</b>
+[ -H
+<i>samba-server</i>
+] [ -U
+<i>samba-user[%samba-password]</i>
+] [ -h
+<i>cups-server[:port]</i>
+] [ -v ] -a
<br>
-<b>cupsaddsmb
-</b>[ -H
-<i>samba-server
-</i>] [ -U
-<i>samba-user[%samba-password]
-</i>] [ -h
-<i>cups-server[:port]
-</i>] [ -v ] printer [ ... printer ]
+<b>cupsaddsmb</b>
+[ -H
+<i>samba-server</i>
+] [ -U
+<i>samba-user[%samba-password]</i>
+] [ -h
+<i>cups-server[:port]</i>
+] [ -v ] printer [ ... printer ]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsaddsmb</i> exports printers to the SAMBA software (version
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>cupsaddsmb</i> supports the following options:
-<dl>
-<dt>-H samba-server
-</dt>
-<dd></dd>
-<dd>Specifies the SAMBA server which defaults to the CUPS server.
-</dd>
-<dt>-U samba-user[%samba-password]
-</dt>
-<dd></dd>
-<dd>Specifies the SAMBA print admin username which defaults to your
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H samba-server
+<br>
+<br>
+Specifies the SAMBA server which defaults to the CUPS server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U samba-user[%samba-password]
+<br>
+<br>
+Specifies the SAMBA print admin username which defaults to your
current username. If the username contains a percent (%)
character, then the text following the percent is treated as the
SAMBA password to use.
-</dd>
-<dt>-a
-</dt>
-<dd></dd>
-<dd>Exports all known printers. Otherwise only the named printers are
+<p style="margin-left: 5.0em; text-indent: -5.0em">-a
+<br>
+<br>
+Exports all known printers. Otherwise only the named printers are
exported.
-</dd>
-<dt>-h cups-server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies a different CUPS server to use.
-</dd>
-<dt>-v
-</dt>
-<dd></dd>
-<dd>Specifies that verbose information should be shown. This is
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h cups-server[:port]
+<br>
+<br>
+Specifies a different CUPS server to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-v
+<br>
+<br>
+Specifies that verbose information should be shown. This is
useful for debugging SAMBA configuration problems.
-</dd>
-</dl>
<h2 class="title"><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h2>
<i>cupsaddsmb</i> uses the new RPC-based printing support in
SAMBA 2.2.x to provide printer drivers and PPD files to Windows
you use the lowercase filenames shown above, otherwise
<i>cupsaddsmb</i> will fail to export the drivers.
-<h2 class="title"><a name="ADOBE_POSTSCRIPT_DRIVERS_FOR_WINDOWS_95,_98,_AND_ME">Adobe Postscript Drivers For Windows 95, 98, And Me</a></h2>
+<h2 class="title"><a name="ADOBE_POSTSCRIPT_DRIVERS_FOR_WINDOWS_95__98__AND_ME">Adobe Postscript Drivers For Windows 95, 98, And Me</a></h2>
<i>cupsaddsmb</i> can use the Adobe PostScript printer driver for
Windows 95, 98, and ME, which are available for download from the
-Adobe web site (<a href='http://www.adobe.com).'>http://www.adobe.com).</a>
+Adobe web site (<a href="http://www.adobe.com).">http://www.adobe.com).</a>
<p>The Adobe driver does not support the page-label, job-billing, or
job-hold-until options.
<p>Once you have installed the driver on a Windows system, copy the
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<i>smbd(8)</i>, <i>smb.conf(5)</i>,
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [-U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
+<b>cupsctl</b>
+[ -E ] [-U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
[ --[no-]share-printers ] [ --[no-]user-cancel-any ]
[
-<i>name=value
-</i>]
+<i>name=value</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsctl</i> updates or queries the <b>cupsd.conf</b> 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>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Enables encryption on the connection to the scheduler.
-</dd>
-<dt>-U <i>username</i>
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username to use when authenticating with the scheduler.
-</dd>
-<dt>-h <i>server[:port]</i>
-</dt>
-<dd></dd>
-<dd>Specifies the server address.
-</dd>
-<dt>--[no-]debug-logging
-</dt>
-<dd></dd>
-<dd>Enables or disables debug logging in the <b>error_log</b> file.
-</dd>
-<dt>--[no-]remote-admin
-</dt>
-<dd></dd>
-<dd>Enables or disables remote administration.
-</dd>
-<dt>--[no-]remote-any
-</dt>
-<dd></dd>
-<dd>Enables or disables printing from any address, e.g. the Internet.
-</dd>
-<dt>--[no-]share-printers
-</dt>
-<dd></dd>
-<dd>Enables or disables sharing of local printers with other computers.
-</dd>
-<dt>--[no-]user-cancel-any
-</dt>
-<dd></dd>
-<dd>Allows or prevents users from canceling jobs owned by others.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Enables encryption on the connection to the scheduler.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U <i>username</i>
+<br>
+<br>
+Specifies an alternate username to use when authenticating with the scheduler.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h <i>server[:port]</i>
+<br>
+<br>
+Specifies the server address.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]debug-logging
+<br>
+<br>
+Enables or disables debug logging in the <b>error_log</b> file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]remote-admin
+<br>
+<br>
+Enables or disables remote administration.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]remote-any
+<br>
+<br>
+Enables or disables printing from any address, e.g. the Internet.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]share-printers
+<br>
+<br>
+Enables or disables sharing of local printers with other computers.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]user-cancel-any
+<br>
+<br>
+Allows or prevents users from canceling jobs owned by others.
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
Display the current settings:
<pre>
<h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
You cannot set the Listen or Port directives using <i>cupsctl</i>.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>,
+<i>cupsd.conf(5)</i>, <i>cupsd(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsd.conf - server configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>cupsd.conf</i> file configures the CUPS scheduler, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>. It
+The <i>cupsd.conf</i> file configures the CUPS scheduler, <i>cupsd(8)</i>. It
is normally located in the <i>/etc/cups</i> directory. <b>Note:</b>
File, directory, and user configuration directives that used to be allowed in
-the <i>cupsd.conf</i> file are now stored in the <a href='man-cups-files.conf.html?TOPIC=Man+Pages'>cups-files.conf(5)</a> instead
+the <i>cupsd.conf</i> file are now stored in the <i>cups-files.conf(5)</i> instead
in order to prevent certain types of privilege escalation attacks.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character. The
configuration directives are intentionally similar to those used by the
popular Apache web server software and are described below.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-The following directives are understood by <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>. Consult the
+The following directives are understood by <i>cupsd(8)</i>. Consult the
on-line help for detailed descriptions:
-<dl>
-<dt>AccessLogLevel config
-</dt>
-<dd></dd>
-<dt>AccessLogLevel actions
-</dt>
-<dd></dd>
-<dt>AccessLogLevel all
-</dt>
-<dd></dd>
-<dd>Specifies the logging level for the AccessLog file.
-</dd>
-<dt>Allow all
-</dt>
-<dd></dd>
-<dt>Allow none
-</dt>
-<dd></dd>
-<dt>Allow host.domain.com
-</dt>
-<dd></dd>
-<dt>Allow *.domain.com
-</dt>
-<dd></dd>
-<dt>Allow ip-address
-</dt>
-<dd></dd>
-<dt>Allow ip-address/netmask
-</dt>
-<dd></dd>
-<dt>Allow ip-address/mm
-</dt>
-<dd></dd>
-<dt>Allow @IF(name)
-</dt>
-<dd></dd>
-<dt>Allow @LOCAL
-</dt>
-<dd></dd>
-<dd>Allows access from the named hosts or addresses.
-</dd>
-<dt>AuthType None
-</dt>
-<dd></dd>
-<dt>AuthType Basic
-</dt>
-<dd></dd>
-<dt>AuthType BasicDigest
-</dt>
-<dd></dd>
-<dt>AuthType Digest
-</dt>
-<dd></dd>
-<dt>AuthType Negotiate
-</dt>
-<dd></dd>
-<dd>Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
-</dd>
-<dt>AutoPurgeJobs Yes
-</dt>
-<dd></dd>
-<dt>AutoPurgeJobs No
-</dt>
-<dd></dd>
-<dd>Specifies whether to purge job history data automatically when
+<p style="margin-left: 5.0em; text-indent: -5.0em">AccessLogLevel config
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AccessLogLevel actions
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AccessLogLevel all
+<br>
+<br>
+Specifies the logging level for the AccessLog file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow host.domain.com
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow *.domain.com
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow ip-address
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow ip-address/netmask
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow ip-address/mm
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow @IF(name)
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Allow @LOCAL
+<br>
+<br>
+Allows access from the named hosts or addresses.
+<p style="margin-left: 5.0em; text-indent: -5.0em">AuthType None
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AuthType Basic
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AuthType BasicDigest
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AuthType Digest
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AuthType Negotiate
+<br>
+<br>
+Specifies the authentication type (None, Basic, BasicDigest, Digest, Negotiate)
+<p style="margin-left: 5.0em; text-indent: -5.0em">AutoPurgeJobs Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">AutoPurgeJobs No
+<br>
+<br>
+Specifies whether to purge job history data automatically when
it is no longer required for quotas.
-</dd>
-<dt>BrowseLocalProtocols [All] [DNSSD]
-</dt>
-<dd></dd>
-<dd>Specifies the protocols to use for local printer sharing.
-</dd>
-<dt>BrowseWebIF Yes
-</dt>
-<dd></dd>
-<dt>BrowseWebIF No
-</dt>
-<dd></dd>
-<dd>Specifies whether the CUPS web interface is advertised via DNS-SD.
-</dd>
-<dt>Browsing Yes
-</dt>
-<dd></dd>
-<dt>Browsing No
-</dt>
-<dd></dd>
-<dd>Specifies whether or not shared printers should be advertised.
-</dd>
-<dt>Classification banner
-</dt>
-<dd></dd>
-<dd>Specifies the security classification of the server.
-</dd>
-<dt>ClassifyOverride Yes
-</dt>
-<dd></dd>
-<dt>ClassifyOverride No
-</dt>
-<dd></dd>
-<dd>Specifies whether to allow users to override the classification
+<p style="margin-left: 5.0em; text-indent: -5.0em">BrowseLocalProtocols [All] [DNSSD]
+<br>
+<br>
+Specifies the protocols to use for local printer sharing.
+<p style="margin-left: 5.0em; text-indent: -5.0em">BrowseWebIF Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">BrowseWebIF No
+<br>
+<br>
+Specifies whether the CUPS web interface is advertised via DNS-SD.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Browsing Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Browsing No
+<br>
+<br>
+Specifies whether or not shared printers should be advertised.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Classification banner
+<br>
+<br>
+Specifies the security classification of the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ClassifyOverride Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ClassifyOverride No
+<br>
+<br>
+Specifies whether to allow users to override the classification
of individual print jobs.
-</dd>
-<dt>DefaultAuthType Basic
-</dt>
-<dd></dd>
-<dt>DefaultAuthType BasicDigest
-</dt>
-<dd></dd>
-<dt>DefaultAuthType Digest
-</dt>
-<dd></dd>
-<dt>DefaultAuthType Negotiate
-</dt>
-<dd></dd>
-<dd>Specifies the default type of authentication to use.
-</dd>
-<dt>DefaultEncryption Never
-</dt>
-<dd></dd>
-<dt>DefaultEncryption IfRequested
-</dt>
-<dd></dd>
-<dt>DefaultEncryption Required
-</dt>
-<dd></dd>
-<dd>Specifies the type of encryption to use for authenticated requests.
-</dd>
-<dt>DefaultLanguage locale
-</dt>
-<dd></dd>
-<dd>Specifies the default language to use for text and web content.
-</dd>
-<dt>DefaultPaperSize Auto
-</dt>
-<dd></dd>
-<dt>DefaultPaperSize None
-</dt>
-<dd></dd>
-<dt>DefaultPaperSize sizename
-</dt>
-<dd></dd>
-<dd>Specifies the default paper size for new print queues. "Auto" uses a locale-
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultAuthType Basic
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultAuthType BasicDigest
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultAuthType Digest
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultAuthType Negotiate
+<br>
+<br>
+Specifies the default type of authentication to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultEncryption Never
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultEncryption IfRequested
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultEncryption Required
+<br>
+<br>
+Specifies the type of encryption to use for authenticated requests.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultLanguage locale
+<br>
+<br>
+Specifies the default language to use for text and web content.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultPaperSize Auto
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultPaperSize None
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultPaperSize sizename
+<br>
+<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.
-</dd>
-<dt>DefaultPolicy policy-name
-</dt>
-<dd></dd>
-<dd>Specifies the default access policy to use.
-</dd>
-<dt>DefaultShared Yes
-</dt>
-<dd></dd>
-<dt>DefaultShared No
-</dt>
-<dd></dd>
-<dd>Specifies whether local printers are shared by default.
-</dd>
-<dt>Deny all
-</dt>
-<dd></dd>
-<dt>Deny none
-</dt>
-<dd></dd>
-<dt>Deny host.domain.com
-</dt>
-<dd></dd>
-<dt>Deny *.domain.com
-</dt>
-<dd></dd>
-<dt>Deny ip-address
-</dt>
-<dd></dd>
-<dt>Deny ip-address/netmask
-</dt>
-<dd></dd>
-<dt>Deny ip-address/mm
-</dt>
-<dd></dd>
-<dt>Deny @IF(name)
-</dt>
-<dd></dd>
-<dt>Deny @LOCAL
-</dt>
-<dd></dd>
-<dd>Denies access to the named host or address.
-</dd>
-<dt>DirtyCleanInterval seconds
-</dt>
-<dd></dd>
-<dd>Specifies the delay for updating of configuration and state files. A value of 0
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultPolicy policy-name
+<br>
+<br>
+Specifies the default access policy to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultShared Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">DefaultShared No
+<br>
+<br>
+Specifies whether local printers are shared by default.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny host.domain.com
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny *.domain.com
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny ip-address
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny ip-address/netmask
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny ip-address/mm
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny @IF(name)
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Deny @LOCAL
+<br>
+<br>
+Denies access to the named host or address.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DirtyCleanInterval seconds
+<br>
+<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.
-</dd>
-<dt>Encryption IfRequested
-</dt>
-<dd></dd>
-<dt>Encryption Never
-</dt>
-<dd></dd>
-<dt>Encryption Required
-</dt>
-<dd></dd>
-<dd>Specifies the level of encryption that is required for a particular
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption IfRequested
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption Never
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Encryption Required
+<br>
+<br>
+Specifies the level of encryption that is required for a particular
location.
-</dd>
-<dt>FilterLimit limit
-</dt>
-<dd></dd>
-<dd>Specifies the maximum cost of filters that are run concurrently.
-</dd>
-<dt>FilterNice nice-value
-</dt>
-<dd></dd>
-<dd>Specifies the scheduling priority ("nice" value) of filters that
+<p style="margin-left: 5.0em; text-indent: -5.0em">FilterLimit limit
+<br>
+<br>
+Specifies the maximum cost of filters that are run concurrently.
+<p style="margin-left: 5.0em; text-indent: -5.0em">FilterNice nice-value
+<br>
+<br>
+Specifies the scheduling priority ("nice" value) of filters that
are run to print a job.
-</dd>
-<dt>GSSServiceName name
-</dt>
-<dd></dd>
-<dd>Specifies the service name when using Kerberos authentication. The default
+<p style="margin-left: 5.0em; text-indent: -5.0em">GSSServiceName name
+<br>
+<br>
+Specifies the service name when using Kerberos authentication. The default
service name is "http".
-</dd>
-<dt>HostNameLookups On
-</dt>
-<dd></dd>
-<dt>HostNameLookups Off
-</dt>
-<dd></dd>
-<dt>HostNameLookups Double
-</dt>
-<dd></dd>
-<dd>Specifies whether or not to do reverse lookups on client addresses.
-</dd>
-<dt>Include filename
-</dt>
-<dd></dd>
-<dd>Includes the named file.
-</dd>
-<dt>JobKillDelay seconds
-</dt>
-<dd></dd>
-<dd>Specifies the number of seconds to wait before killing the filters and backend
+<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups On
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups Off
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups Double
+<br>
+<br>
+Specifies whether or not to do reverse lookups on client addresses.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Include filename
+<br>
+<br>
+Includes the named file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobKillDelay seconds
+<br>
+<br>
+Specifies the number of seconds to wait before killing the filters and backend
associated with a canceled or held job.
-</dd>
-<dt>JobPrivateAccess all
-</dt>
-<dd></dd>
-<dt>JobPrivateAccess default
-</dt>
-<dd></dd>
-<dt>JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
-</dt>
-<dd></dd>
-<dd>Specifies an access list for a job's private values. The "default" access list
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateAccess all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateAccess default
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
+<br>
+<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.
-</dd>
-<dt>JobPrivateValues all
-</dt>
-<dd></dd>
-<dt>JobPrivateValues default
-</dt>
-<dd></dd>
-<dt>JobPrivateValues none
-</dt>
-<dd></dd>
-<dt>JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
-</dt>
-<dd>Specifies the list of job values to make private. The "default" values are
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateValues all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateValues default
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateValues none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobPrivateValues attribute-name-1 [ ... attribute-name-N ]
+<br>
+Specifies the list of job values to make private. The "default" values are
"job-name", "job-originating-host-name", and "job-originating-user-name".
-</dd>
-<dt>JobRetryInterval seconds
-</dt>
-<dd></dd>
-<dd>Specifies the interval between retries of jobs in seconds.
-</dd>
-<dt>JobRetryLimit count
-</dt>
-<dd></dd>
-<dd>Specifies the number of retries that are done for jobs.
-</dd>
-<dt>KeepAlive Yes
-</dt>
-<dd></dd>
-<dt>KeepAlive No
-</dt>
-<dd></dd>
-<dd>Specifies whether to support HTTP keep-alive connections.
-</dd>
-<dt>KeepAliveTimeout seconds
-</dt>
-<dd></dd>
-<dd>Specifies the amount of time that connections are kept alive.
-</dd>
-<dt><Limit operations> ... </Limit>
-</dt>
-<dd></dd>
-<dd>Specifies the IPP operations that are being limited inside a policy.
-</dd>
-<dt><Limit methods> ... </Limit>
-</dt>
-<dd></dd>
-<dt><LimitExcept methods> ... </LimitExcept>
-</dt>
-<dd></dd>
-<dd>Specifies the HTTP methods that are being limited inside a location.
-</dd>
-<dt>LimitRequestBody
-</dt>
-<dd></dd>
-<dd>Specifies the maximum size of any print job request.
-</dd>
-<dt>Listen ip-address:port
-</dt>
-<dd></dd>
-<dt>Listen *:port
-</dt>
-<dd></dd>
-<dt>Listen /path/to/domain/socket
-</dt>
-<dd></dd>
-<dd>Listens to the specified address and port or domain socket path.
-</dd>
-<dt><Location /path> ... </Location>
-</dt>
-<dd></dd>
-<dd>Specifies access control for the named location.
-</dd>
-<dt>LogDebugHistory #-messages
-</dt>
-<dd></dd>
-<dd>Specifies the number of debugging messages that are logged when an error
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobRetryInterval seconds
+<br>
+<br>
+Specifies the interval between retries of jobs in seconds.
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobRetryLimit count
+<br>
+<br>
+Specifies the number of retries that are done for jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">KeepAlive Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">KeepAlive No
+<br>
+<br>
+Specifies whether to support HTTP keep-alive connections.
+<p style="margin-left: 5.0em; text-indent: -5.0em">KeepAliveTimeout seconds
+<br>
+<br>
+Specifies the amount of time that connections are kept alive.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Limit operations> ... </Limit>
+<br>
+<br>
+Specifies the IPP operations that are being limited inside a policy.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Limit methods> ... </Limit>
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><LimitExcept methods> ... </LimitExcept>
+<br>
+<br>
+Specifies the HTTP methods that are being limited inside a location.
+<p style="margin-left: 5.0em; text-indent: -5.0em">LimitRequestBody
+<br>
+<br>
+Specifies the maximum size of any print job request.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Listen ip-address:port
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Listen *:port
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Listen /path/to/domain/socket
+<br>
+<br>
+Listens to the specified address and port or domain socket path.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Location /path> ... </Location>
+<br>
+<br>
+Specifies access control for the named location.
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogDebugHistory #-messages
+<br>
+<br>
+Specifies the number of debugging messages that are logged when an error
occurs in a print job.
-</dd>
-<dt>LogLevel alert
-</dt>
-<dd></dd>
-<dt>LogLevel crit
-</dt>
-<dd></dd>
-<dt>LogLevel debug2
-</dt>
-<dd></dd>
-<dt>LogLevel debug
-</dt>
-<dd></dd>
-<dt>LogLevel emerg
-</dt>
-<dd></dd>
-<dt>LogLevel error
-</dt>
-<dd></dd>
-<dt>LogLevel info
-</dt>
-<dd></dd>
-<dt>LogLevel none
-</dt>
-<dd></dd>
-<dt>LogLevel notice
-</dt>
-<dd></dd>
-<dt>LogLevel warn
-</dt>
-<dd></dd>
-<dd>Specifies the logging level for the ErrorLog file.
-</dd>
-<dt>LogTimeFormat standard
-</dt>
-<dd></dd>
-<dt>LogTimeFormat usecs
-</dt>
-<dd></dd>
-<dd>Specifies the format of the date and time in the log files.
-</dd>
-<dt>MaxClients number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of simultaneous clients to support.
-</dd>
-<dt>MaxClientsPerHost number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of simultaneous clients to support from a
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel alert
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel crit
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel debug2
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel debug
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel emerg
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel error
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel info
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel notice
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogLevel warn
+<br>
+<br>
+Specifies the logging level for the ErrorLog file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogTimeFormat standard
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">LogTimeFormat usecs
+<br>
+<br>
+Specifies the format of the date and time in the log files.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxClients number
+<br>
+<br>
+Specifies the maximum number of simultaneous clients to support.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxClientsPerHost number
+<br>
+<br>
+Specifies the maximum number of simultaneous clients to support from a
single address.
-</dd>
-<dt>MaxCopies number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of copies that a user can print of each job.
-</dd>
-<dt>MaxHoldTime seconds
-</dt>
-<dd></dd>
-<dd>Specifies the maximum time a job may remain in the "indefinite" hold state
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxCopies number
+<br>
+<br>
+Specifies the maximum number of copies that a user can print of each job.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxHoldTime seconds
+<br>
+<br>
+Specifies the maximum time a job may remain in the "indefinite" hold state
before it is canceled. Set to 0 to disable cancellation of held jobs.
-</dd>
-<dt>MaxJobs number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of simultaneous jobs to support.
-</dd>
-<dt>MaxJobsPerPrinter number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of simultaneous jobs per printer to support.
-</dd>
-<dt>MaxJobsPerUser number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of simultaneous jobs per user to support.
-</dd>
-<dt>MaxJobTime seconds
-</dt>
-<dd></dd>
-<dd>Specifies the maximum time a job may take to print before it is canceled. The
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxJobs number
+<br>
+<br>
+Specifies the maximum number of simultaneous jobs to support.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxJobsPerPrinter number
+<br>
+<br>
+Specifies the maximum number of simultaneous jobs per printer to support.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxJobsPerUser number
+<br>
+<br>
+Specifies the maximum number of simultaneous jobs per user to support.
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxJobTime seconds
+<br>
+<br>
+Specifies the maximum time a job may take to print before it is canceled. The
default is 10800 seconds (3 hours). Set to 0 to disable cancellation of "stuck"
jobs.
-</dd>
-<dt>MaxLogSize number-bytes
-</dt>
-<dd></dd>
-<dd>Specifies the maximum size of the log files before they are
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxLogSize number-bytes
+<br>
+<br>
+Specifies the maximum size of the log files before they are
rotated (0 to disable rotation)
-</dd>
-<dt>MaxRequestSize number-bytes
-</dt>
-<dd></dd>
-<dd>Specifies the maximum request/file size in bytes (0 for no limit)
-</dd>
-<dt>MultipleOperationTimeout seconds
-</dt>
-<dd></dd>
-<dd>Specifies the maximum amount of time to allow between files in a multiple file
+<p style="margin-left: 5.0em; text-indent: -5.0em">MaxRequestSize number-bytes
+<br>
+<br>
+Specifies the maximum request/file size in bytes (0 for no limit)
+<p style="margin-left: 5.0em; text-indent: -5.0em">MultipleOperationTimeout seconds
+<br>
+<br>
+Specifies the maximum amount of time to allow between files in a multiple file
print job.
-</dd>
-<dt>Order allow,deny
-</dt>
-<dd></dd>
-<dt>Order deny,allow
-</dt>
-<dd></dd>
-<dd>Specifies the order of HTTP access control (allow,deny or deny,allow)
-</dd>
-<dt>PageLogFormat format string
-</dt>
-<dd></dd>
-<dd>Specifies the format of page log lines.
-</dd>
-<dt>PassEnv variable [... variable]
-</dt>
-<dd></dd>
-<dd>Passes the specified environment variable(s) to child processes.
-</dd>
-<dt><Policy name> ... </Policy>
-</dt>
-<dd></dd>
-<dd>Specifies access control for the named policy.
-</dd>
-<dt>Port number
-</dt>
-<dd></dd>
-<dd>Specifies a port number to listen to for HTTP requests.
-</dd>
-<dt>PreserveJobFiles Yes
-</dt>
-<dd></dd>
-<dt>PreserveJobFiles No
-</dt>
-<dd></dd>
-<dd>Specifies whether or not to preserve job files after they are printed.
-</dd>
-<dt>PreserveJobHistory Yes
-</dt>
-<dd></dd>
-<dt>PreserveJobHistory No
-</dt>
-<dd></dd>
-<dd>Specifies whether or not to preserve the job history after they are
+<p style="margin-left: 5.0em; text-indent: -5.0em">Order allow,deny
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Order deny,allow
+<br>
+<br>
+Specifies the order of HTTP access control (allow,deny or deny,allow)
+<p style="margin-left: 5.0em; text-indent: -5.0em">PageLogFormat format string
+<br>
+<br>
+Specifies the format of page log lines.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PassEnv variable [... variable]
+<br>
+<br>
+Passes the specified environment variable(s) to child processes.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Policy name> ... </Policy>
+<br>
+<br>
+Specifies access control for the named policy.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Port number
+<br>
+<br>
+Specifies a port number to listen to for HTTP requests.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PreserveJobFiles Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PreserveJobFiles No
+<br>
+<br>
+Specifies whether or not to preserve job files after they are printed.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PreserveJobHistory Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PreserveJobHistory No
+<br>
+<br>
+Specifies whether or not to preserve the job history after they are
printed.
-</dd>
-<dt>PrintcapFormat bsd
-</dt>
-<dd></dd>
-<dt>PrintcapFormat plist
-</dt>
-<dd></dd>
-<dt>PrintcapFormat solaris
-</dt>
-<dd></dd>
-<dd>Specifies the format of the printcap file.
-</dd>
-<dt>ReloadTimeout seconds
-</dt>
-<dd></dd>
-<dd>Specifies the amount of time to wait for job completion before
+<p style="margin-left: 5.0em; text-indent: -5.0em">PrintcapFormat bsd
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PrintcapFormat plist
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PrintcapFormat solaris
+<br>
+<br>
+Specifies the format of the printcap file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ReloadTimeout seconds
+<br>
+<br>
+Specifies the amount of time to wait for job completion before
restarting the scheduler.
-</dd>
-<dt>Require group group-name-list
-</dt>
-<dd></dd>
-<dt>Require user user-name-list
-</dt>
-<dd></dd>
-<dt>Require valid-user
-</dt>
-<dd></dd>
-<dd>Specifies that user or group authentication is required.
-</dd>
-<dt>RIPCache bytes
-</dt>
-<dd></dd>
-<dd>Specifies the maximum amount of memory to use when converting images
+<p style="margin-left: 5.0em; text-indent: -5.0em">Require group group-name-list
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Require user user-name-list
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Require valid-user
+<br>
+<br>
+Specifies that user or group authentication is required.
+<p style="margin-left: 5.0em; text-indent: -5.0em">RIPCache bytes
+<br>
+<br>
+Specifies the maximum amount of memory to use when converting images
and PostScript files to bitmaps for a printer.
-</dd>
-<dt>Satisfy all
-</dt>
-<dd></dd>
-<dt>Satisfy any
-</dt>
-<dd></dd>
-<dd>Specifies whether all or any limits set for a Location must be
+<p style="margin-left: 5.0em; text-indent: -5.0em">Satisfy all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Satisfy any
+<br>
+<br>
+Specifies whether all or any limits set for a Location must be
satisfied to allow access.
-</dd>
-<dt>ServerAdmin user@domain.com
-</dt>
-<dd></dd>
-<dd>Specifies the email address of the server administrator.
-</dd>
-<dt>ServerAlias hostname [... hostname]
-</dt>
-<dd></dd>
-<dt>ServerAlias *
-</dt>
-<dd></dd>
-<dd>Specifies an alternate name that the server is known by. The special name "*"
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerAdmin user@domain.com
+<br>
+<br>
+Specifies the email address of the server administrator.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerAlias hostname [... hostname]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerAlias *
+<br>
+<br>
+Specifies an alternate name that the server is known by. The special name "*"
allows any name to be used.
-</dd>
-<dt>ServerName hostname-or-ip-address
-</dt>
-<dd></dd>
-<dd>Specifies the fully-qualified hostname of the server.
-</dd>
-<dt>ServerTokens Full
-</dt>
-<dd></dd>
-<dt>ServerTokens Major
-</dt>
-<dd></dd>
-<dt>ServerTokens Minimal
-</dt>
-<dd></dd>
-<dt>ServerTokens Minor
-</dt>
-<dd></dd>
-<dt>ServerTokens None
-</dt>
-<dd></dd>
-<dt>ServerTokens OS
-</dt>
-<dd></dd>
-<dt>ServerTokens ProductOnly
-</dt>
-<dd></dd>
-<dd>Specifies what information is included in the Server header of HTTP
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerName hostname-or-ip-address
+<br>
+<br>
+Specifies the fully-qualified hostname of the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens Full
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens Major
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens Minimal
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens Minor
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens None
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens OS
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ServerTokens ProductOnly
+<br>
+<br>
+Specifies what information is included in the Server header of HTTP
responses.
-</dd>
-<dt>SetEnv variable value
-</dt>
-<dd></dd>
-<dd>Set the specified environment variable to be passed to child processes.
-</dd>
-<dt>SSLListen
-</dt>
-<dd></dd>
-<dd>Listens on the specified address and port for encrypted connections.
-</dd>
-<dt>SSLPort
-</dt>
-<dd></dd>
-<dd>Listens on the specified port for encrypted connections.
-</dd>
-<dt>StrictConformance Yes
-</dt>
-<dd></dd>
-<dt>StrictConformance No
-</dt>
-<dd></dd>
-<dd>Specifies whether the scheduler requires clients to strictly adhere to the IPP
+<p style="margin-left: 5.0em; text-indent: -5.0em">SetEnv variable value
+<br>
+<br>
+Set the specified environment variable to be passed to child processes.
+<p style="margin-left: 5.0em; text-indent: -5.0em">SSLListen
+<br>
+<br>
+Listens on the specified address and port for encrypted connections.
+<p style="margin-left: 5.0em; text-indent: -5.0em">SSLPort
+<br>
+<br>
+Listens on the specified port for encrypted connections.
+<p style="margin-left: 5.0em; text-indent: -5.0em">StrictConformance Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">StrictConformance No
+<br>
+<br>
+Specifies whether the scheduler requires clients to strictly adhere to the IPP
specifications. The default is No.
-</dd>
-<dt>SubscriptionPrivateAccess all
-</dt>
-<dd></dd>
-<dt>SubscriptionPrivateAccess default
-</dt>
-<dd></dd>
-<dt>SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
-</dt>
-<dd></dd>
-<dd>Specifies an access list for a subscription's private values. The "default"
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateAccess all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateAccess default
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM}+
+<br>
+<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.
-</dd>
-<dt>SubscriptionPrivateValues all
-</dt>
-<dd></dd>
-<dt>SubscriptionPrivateValues default
-</dt>
-<dd></dd>
-<dt>SubscriptionPrivateValues none
-</dt>
-<dd></dd>
-<dt>SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ]
-</dt>
-<dd>Specifies the list of job values to make private. The "default" values are
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateValues all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateValues default
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateValues none
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SubscriptionPrivateValues attribute-name-1 [ ... attribute-name-N ]
+<br>
+Specifies the list of job values to make private. The "default" values are
"notify-events", "notify-pull-method", "notify-recipient-uri",
"notify-subscriber-user-name", and "notify-user-data".
-</dd>
-<dt>Timeout seconds
-</dt>
-<dd></dd>
-<dd>Specifies the HTTP request timeout in seconds.
-</dd>
-<dt>WebInterface yes
-</dt>
-<dd></dd>
-<dt>WebInterface no
-</dt>
-<dd>Specifies whether the web interface is enabled.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Timeout seconds
+<br>
+<br>
+Specifies the HTTP request timeout in seconds.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WebInterface yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WebInterface no
+<br>
+Specifies whether the web interface is enabled.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cups-files.conf.html?TOPIC=Man+Pages'>cups-files.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
-<a href='man-subscriptions.conf.html?TOPIC=Man+Pages'>subscriptions.conf(5)</a>,
+<i>classes.conf(5)</i>, <i>cups-files.conf(5)</i>, <i>cupsd(8)</i>,
+<i>mime.convs(5)</i>, <i>mime.types(5)</i>, <i>printers.conf(5)</i>,
+<i>subscriptions.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsd - cups scheduler
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsd
-</b>[ -c
-<i>config-file
-</i>] [ -f ] [ -F ] [ -h ] [ -l ] [ -t ]
+<b>cupsd</b>
+[ -c
+<i>config-file</i>
+] [ -f ] [ -F ] [ -h ] [ -l ] [ -t ]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>cupsd</i> is the scheduler for CUPS. It implements a printing system based
-upon the Internet Printing Protocol, version 2.1. If no options are specified
-on the command-line then the default configuration file
-<i>/etc/cups/cupsd.conf</i> will be used.
+<b>cupsd</b>
+is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1. If no options are specified on the command-line then the default configuration file
+<i>/etc/cups/cupsd.conf</i>
+will be used.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl>
-<dt>-c config-file
-</dt>
-<dd></dd>
-<dd>Uses the named configuration file.
-</dd>
-<dt>-f
-</dt>
-<dd></dd>
-<dd>Run <i>cupsd</i> in the foreground; the default is to run in the
-background as a "daemon".
-</dd>
-<dt>-F
-</dt>
-<dd></dd>
-<dd>Run <i>cupsd</i> in the foreground but detach the process from the
-controlling terminal and current directory. This is useful for
-running <i>cupsd</i> from <i>init(8)</i>.
-</dd>
-<dt>-h
-</dt>
-<dd></dd>
-<dd>Shows the program usage.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>This option is passed to <i>cupsd</i> when it is run from
-<i>launchd(8)</i>.
-</dd>
-<dt>-t
-</dt>
-<dd></dd>
-<dd>Test the configuration file for syntax errors.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c config-file
+<br>
+Uses the named configuration file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-f
+<br>
+Run
+<b>cupsd</b>
+in the foreground; the default is to run in the background as a "daemon".
+<p style="margin-left: 5.0em; text-indent: -5.0em">-F
+<br>
+Run
+<b>cupsd</b>
+in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
+<b>cupsd</b> from <b>init</b>(8).
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h
+<br>
+Shows the program usage.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+This option is passed to
+<b>cupsd</b>
+when it is run from
+<b>launchd</b>(8).
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t
+<br>
+Test the configuration file for syntax errors.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
-<i>cupsd</i> implements all of the required IPP/2.1 attributes and
-operations. It also implements several CUPS-specific administration
-operations.
+<b>cupsd</b>
+implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administration operations.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-backend.html?TOPIC=Man+Pages'>backend(7)</a>, <a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cups-deviced.html?TOPIC=Man+Pages'>cups-deviced(8)</a>,
-<a href='man-cups-driverd.html?TOPIC=Man+Pages'>cups-driverd(8)</a>, <a href='man-cups-lpd.html?TOPIC=Man+Pages'>cups-lpd(8)</a>, <i>cups-polld(8)</i>,
-<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a>, <i>launchd(8)</i>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
-<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a> <a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a> <a href="man-cups-deviced.html?TOPIC=Man+Pages"><b>cups-deviced</b>(8),</a> <a href="man-cups-driverd.html?TOPIC=Man+Pages"><b>cups-driverd</b>(8),</a> <a href="man-cups-lpd.html?TOPIC=Man+Pages"><b>cups-lpd</b>(8),</a> <a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a> <a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a> <b>launchd</b>(8), <a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a> <a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a> <a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [-U
-<i>username
-</i>] [ -c ] [ -h
-<i>server[:port]
-</i>] [ -r
-<i>reason
-</i>] [ --hold ] destination(s)
-<br>
-<b>cupsenable
-</b>[ -E ] [-U
-<i>username
-</i>] [ -c ] [ -h
-<i>server[:port]
-</i>] [ --release ] destination(s)
+<b>cupsdisable</b>
+[ -E ] [-U
+<i>username</i>
+] [ -c ] [ -h
+<i>server[:port]</i>
+] [ -r
+<i>reason</i>
+] [ --hold ] destination(s)
+<br>
+<b>cupsenable</b>
+[ -E ] [-U
+<i>username</i>
+] [ -c ] [ -h
+<i>server[:port]</i>
+] [ --release ] destination(s)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsenable</i> starts the named printers or classes.
<p><i>cupsdisable</i> stops the named printers or classes. The
following options may be used:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption of the connection to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Uses the specified username when connecting to the server.
-</dd>
-<dt>-c
-</dt>
-<dd></dd>
-<dd>Cancels all jobs on the named destination.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Uses the specified server and port.
-</dd>
-<dt>--hold
-</dt>
-<dd></dd>
-<dd>Holds remaining jobs on the named printer. Useful for allowing the current
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption of the connection to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Uses the specified username when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c
+<br>
+<br>
+Cancels all jobs on the named destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Uses the specified server and port.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--hold
+<br>
+<br>
+Holds remaining jobs on the named printer. Useful for allowing the current
job to complete before performing maintenance.
-</dd>
-<dt>-r "reason"
-</dt>
-<dd></dd>
-<dd>Sets the message associated with the stopped state. If no reason is specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r "reason"
+<br>
+<br>
+Sets the message associated with the stopped state. If no reason is specified
then the message is set to "Reason Unknown".
-</dd>
-<dt>--release
-</dt>
-<dd></dd>
-<dd>Releases pending jobs for printing. Use after running <i>cupsdisable</i> with
+<p style="margin-left: 5.0em; text-indent: -5.0em">--release
+<br>
+<br>
+Releases pending jobs for printing. Use after running <i>cupsdisable</i> with
the <i>--hold</i> option to resume printing.
-</dd>
-</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".
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'>cupsaccept(8)</a>, <i>cupsreject(8)</i>, <a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>,
-<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cupsaccept(8)</i>, <i>cupsreject(8)</i>, <i>cancel(1)</i>, <i>lp(1)</i>,
+<i>lpadmin(8)</i>, <i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsfilter - convert a file to another format using cups filters
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupsfilter
-</b>[ -D ] [ -U
-<i>user
-</i>] [ -c
-<i>config-file
-</i>] [ -d
-<i>printer
-</i>] [ -e ] [ -i
-<i>mime/type
-</i>] [ -j
-<i>job-id[,N]
-</i>] [ -m
-<i>mime/type
-</i>] [ -n
-<i>copies
-</i>] [ -o
-<i>name=value
-</i>] [ -p
-<i>filename.ppd
-</i>] [ -t
-<i>title
-</i>] [ -u ]
-<i>filename
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>cupsfilter</b>
+[ -D ] [ -U
+<i>user</i>
+] [ -c
+<i>config-file</i>
+] [ -d
+<i>printer</i>
+] [ -e ] [ -i
+<i>mime/type</i>
+] [ -j
+<i>job-id[,N]</i>
+] [ -m
+<i>mime/type</i>
+] [ -n
+<i>copies</i>
+] [ -o
+<i>name=value</i>
+] [ -p
+<i>filename.ppd</i>
+] [ -t
+<i>title</i>
+] [ -u ]
+<i>filename</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsfilter</i> 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, <i>cupsfilter</i> generates a PDF file.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl>
-<dt>-D
-</dt>
-<dd></dd>
-<dd>Delete the input file after conversion.
-</dd>
-<dt>-U user
-</dt>
-<dd></dd>
-<dd>Specifies the username passed to the filters. The default is the name of the current user.
-</dd>
-<dt>-c config-file
-</dt>
-<dd></dd>
-<dd>Uses the named cupsd.conf configuration file.
-</dd>
-<dt>-d printer
-</dt>
-<dd>Uses information from the named printer.
-</dd>
-<dt>-e
-</dt>
-<dd></dd>
-<dd>Use every filter from the PPD file.
-</dd>
-<dt>-i mime/type
-</dt>
-<dd></dd>
-<dd>Specifies the source file type. The default file type is guessed using the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-D
+<br>
+<br>
+Delete the input file after conversion.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U user
+<br>
+<br>
+Specifies the username passed to the filters. The default is the name of the current user.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c config-file
+<br>
+<br>
+Uses the named cupsd.conf configuration file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d printer
+<br>
+Uses information from the named printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-e
+<br>
+<br>
+Use every filter from the PPD file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-i mime/type
+<br>
+<br>
+Specifies the source file type. The default file type is guessed using the
filename and contents of the file.
-</dd>
-<dt>-j job-id[,N]
-</dt>
-<dd></dd>
-<dd>Converts document N from the specified job. If N is omitted, document 1 is
+<p style="margin-left: 5.0em; text-indent: -5.0em">-j job-id[,N]
+<br>
+<br>
+Converts document N from the specified job. If N is omitted, document 1 is
converted.
-</dd>
-<dt>-m mime/type
-</dt>
-<dd></dd>
-<dd>Specifies the destination file type. The default file type is application/pdf.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-m mime/type
+<br>
+<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.
-</dd>
-<dt>-n copies
-</dt>
-<dd></dd>
-<dd>Specifies the number of copies to generate.
-</dd>
-<dt>-o name=value
-</dt>
-<dd></dd>
-<dd>Specifies options to pass to the CUPS filters.
-</dd>
-<dt>-p filename.ppd
-</dt>
-<dd></dd>
-<dd>Specifies the PPD file to use.
-</dd>
-<dt>-t title
-</dt>
-<dd></dd>
-<dd>Specifies the document title.
-</dd>
-<dt>-u
-</dt>
-<dd></dd>
-<dd>Delete the PPD file after conversion.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-n copies
+<br>
+<br>
+Specifies the number of copies to generate.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value
+<br>
+<br>
+Specifies options to pass to the CUPS filters.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-p filename.ppd
+<br>
+<br>
+Specifies the PPD file to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t title
+<br>
+<br>
+Specifies the document title.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u
+<br>
+<br>
+Delete the PPD file after conversion.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>
+<i>cupsd.conf(5)</i>
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cupstestdsc - test conformance of postscript files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupstestdsc
-</b>[ -h ] filename.ps [ ...
-<i>filenameN.ps
-</i>]
+<b>cupstestdsc</b>
+[ -h ] filename.ps [ ...
+<i>filenameN.ps</i>
+]
<br>
-<b>cupstestdsc
-</b>[ -h ] -
+<b>cupstestdsc</b>
+[ -h ] -
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupstestdsc</i> tests the conformance of PostScript files to
the Adobe PostScript Language Document Structuring Conventions
etc.), and device-specific commands such as setpagedevice should
not be used.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<br>
Adobe PostScript Language Document Structuring Conventions
Specification, Version 3.0.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
cupstestppd - test conformance of ppd files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupstestppd
-</b>[ -I
-<i>category
-</i>] [ -R
-<i>rootdir
-</i>] [ -W
-<i>category
-</i>] [ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ]
-<br>
-<b>cupstestppd
-</b>[ -R
-<i>rootdir
-</i>] [ -W
-<i>category
-</i>] [ -q ] [-r] [ -v[v] ] -
+<b>cupstestppd</b>
+[ -I
+<i>category</i>
+] [ -R
+<i>rootdir</i>
+] [ -W
+<i>category</i>
+] [ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ]
+<br>
+<b>cupstestppd</b>
+[ -R
+<i>rootdir</i>
+] [ -W
+<i>category</i>
+] [ -q ] [-r] [ -v[v] ] -
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupstestppd</i> tests the conformance of PPD files to the
Adobe PostScript Printer Description file format specification
on the standard input.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>cupstestppd</i> supports the following options:
-<dl>
-<dt>-I filename
-</dt>
-<dd></dd>
-<dd>Ignores all PCFileName warnings.
-</dd>
-<dt>-I filters
-</dt>
-<dd></dd>
-<dd>Ignores all filter errors.
-</dd>
-<dt>-I profiles
-</dt>
-<dd></dd>
-<dd>Ignores all profile errors.
-</dd>
-<dt>-R rootdir
-</dt>
-<dd></dd>
-<dd>Specifies an alternate root directory for the filter, pre-filter,
+<p style="margin-left: 5.0em; text-indent: -5.0em">-I filename
+<br>
+<br>
+Ignores all PCFileName warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-I filters
+<br>
+<br>
+Ignores all filter errors.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-I profiles
+<br>
+<br>
+Ignores all profile errors.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-R rootdir
+<br>
+<br>
+Specifies an alternate root directory for the filter, pre-filter,
and other support file checks.
-</dd>
-<dt>-W constraints
-</dt>
-<dd></dd>
-<dd>Report all UIConstraint errors as warnings.
-</dd>
-<dt>-W defaults
-</dt>
-<dd></dd>
-<dd>Except for size-related options, report all default option errors as warnings.
-</dd>
-<dt>-W filters
-</dt>
-<dd></dd>
-<dd>Report all filter errors as warnings.
-</dd>
-<dt>-W profiles
-</dt>
-<dd></dd>
-<dd>Report all profile errors as warnings.
-</dd>
-<dt>-W sizes
-</dt>
-<dd></dd>
-<dd>Report all media size errors as warnings.
-</dd>
-<dt>-W translations
-</dt>
-<dd></dd>
-<dd>Report all translation errors as warnings.
-</dd>
-<dt>-W all
-</dt>
-<dd></dd>
-<dd>Report all of the previous errors as warnings.
-</dd>
-<dt>-W none
-</dt>
-<dd></dd>
-<dd>Report all of the previous errors as errors.
-</dd>
-<dt>-q
-</dt>
-<dd></dd>
-<dd>Specifies that no information should be displayed.
-</dd>
-<dt>-r
-</dt>
-<dd></dd>
-<dd>Relaxes the PPD conformance requirements so that common
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W constraints
+<br>
+<br>
+Report all UIConstraint errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W defaults
+<br>
+<br>
+Except for size-related options, report all default option errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W filters
+<br>
+<br>
+Report all filter errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W profiles
+<br>
+<br>
+Report all profile errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W sizes
+<br>
+<br>
+Report all media size errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W translations
+<br>
+<br>
+Report all translation errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W all
+<br>
+<br>
+Report all of the previous errors as warnings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W none
+<br>
+<br>
+Report all of the previous errors as errors.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-q
+<br>
+<br>
+Specifies that no information should be displayed.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r
+<br>
+<br>
+Relaxes the PPD conformance requirements so that common
whitespace, control character, and formatting problems are not
treated as hard errors.
-</dd>
-<dt>-v
-</dt>
-<dd></dd>
-<dd>Specifies that detailed conformance testing results should be
+<p style="margin-left: 5.0em; text-indent: -5.0em">-v
+<br>
+<br>
+Specifies that detailed conformance testing results should be
displayed rather than the concise PASS/FAIL/ERROR status.
-</dd>
-<dt>-vv
-</dt>
-<dd></dd>
-<dd>Specifies that all information in the PPD file should be
+<p style="margin-left: 5.0em; text-indent: -5.0em">-vv
+<br>
+<br>
+Specifies that all information in the PPD file should be
displayed in addition to the detailed conformance testing
results.
-</dd>
-</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>
<i>cupstestppd</i> returns zero on success and non-zero on error. The
error codes are as follows:
-<dl>
-<dt>1
-</dt>
-<dd></dd>
-<dd>Bad command-line arguments or missing PPD filename.
-</dd>
-<dt>2
-</dt>
-<dd></dd>
-<dd>Unable to open or read PPD file.
-</dd>
-<dt>3
-</dt>
-<dd></dd>
-<dd>The PPD file contains format errors that cannot be skipped.
-</dd>
-<dt>4
-</dt>
-<dd></dd>
-<dd>The PPD file does not conform to the Adobe PPD specification.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">1
+<br>
+<br>
+Bad command-line arguments or missing PPD filename.
+<p style="margin-left: 5.0em; text-indent: -5.0em">2
+<br>
+<br>
+Unable to open or read PPD file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">3
+<br>
+<br>
+The PPD file contains format errors that cannot be skipped.
+<p style="margin-left: 5.0em; text-indent: -5.0em">4
+<br>
+<br>
+The PPD file does not conform to the Adobe PPD specification.
<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
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>,
+<i>lpadmin(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<br>
Adobe PostScript Printer Description File Format Specification, Version 4.3.
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>job user title num-copies options [
-<i>filename
-</i>]
+<b>filter</b>
+job user title num-copies options [
+<i>filename</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The CUPS filter interface provides a standard method for adding support for
new document types to CUPS. Each filter is capable of converting from one
expect specific environment variables and file descriptors, and typically run in
a user session that (on OS X) 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'>cupsfilter(8)</a> program to use the
+filters directly. Instead, use the <i>cupsfilter(8)</i> program to use the
appropriate filters to do the conversions you need.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
Options passed on the command-line typically do not include the default choices
Messages sent to stderr are generally logged to
printer-state-message attribute and the current <i>ErrorLog</i>.
Each line begins with a standard prefix:
-<dl>
-<dt>ALERT: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">ALERT: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "alert" log level.
-</dd>
-<dt>ATTR: attribute=value [attribute=value]
-</dt>
-<dd></dd>
-<dd>Sets the named job or printer attribute(s). The following job attributes can be
+<p style="margin-left: 5.0em; text-indent: -5.0em">ATTR: attribute=value [attribute=value]
+<br>
+<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".
-</dd>
-<dt>CRIT: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">CRIT: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "critical" log level.
-</dd>
-<dt>DEBUG: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEBUG: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "debug" log level.
-</dd>
-<dt>DEBUG2: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEBUG2: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "debug2" log level.
-</dd>
-<dt>EMERG: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">EMERG: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "emergency" log level.
-</dd>
-<dt>ERROR: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">ERROR: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "error" log level.
-</dd>
-<dt>INFO: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute. If the current <i>LogLevel</i>
+<p style="margin-left: 5.0em; text-indent: -5.0em">INFO: message
+<br>
+<br>
+Sets the printer-state-message attribute. If the current <i>LogLevel</i>
is set to "debug2", also adds the specified message to the
current <i>ErrorLog</i> using the "info" log level.
-</dd>
-<dt>NOTICE: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">NOTICE: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "notice" log level.
-</dd>
-<dt>PAGE: page-number #-copies
-</dt>
-<dd></dd>
-<dt>PAGE: total #-pages
-</dt>
-<dd></dd>
-<dd>Adds an entry to the current <i>PageLog</i>. The first form adds
+<p style="margin-left: 5.0em; text-indent: -5.0em">PAGE: page-number #-copies
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">PAGE: total #-pages
+<br>
+<br>
+Adds an entry to the current <i>PageLog</i>. The first form adds
#-copies to the job-media-sheets-completed attribute. The second
form sets the job-media-sheets-completed attribute to #-pages.
-</dd>
-<dt>PPD: Keyword=Value ... KeywordN=Value
-</dt>
-<dd></dd>
-<dd>Sets the named keywords in the printer's PPD file. This is typically
+<p style="margin-left: 5.0em; text-indent: -5.0em">PPD: Keyword=Value ... KeywordN=Value
+<br>
+<br>
+Sets the named keywords in the printer's PPD file. This is typically
used to update default option keywords such as DefaultPageSize and
the various installable options in the PPD file.
-</dd>
-<dt>STATE: printer-state-reason [printer-state-reason ...]
-</dt>
-<dd></dd>
-<dt>STATE: + printer-state-reason [printer-state-reason ...]
-</dt>
-<dd></dd>
-<dt>STATE: - printer-state-reason [printer-state-reason ...]
-</dt>
-<dd></dd>
-<dd>Sets, adds, or removes printer-state-reason keywords to the
+<p style="margin-left: 5.0em; text-indent: -5.0em">STATE: printer-state-reason [printer-state-reason ...]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">STATE: + printer-state-reason [printer-state-reason ...]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">STATE: - printer-state-reason [printer-state-reason ...]
+<br>
+<br>
+Sets, adds, or removes printer-state-reason keywords to the
current queue. Typically this is used to indicate media, ink, and
toner conditions on a printer.
-</dd>
-<dt>WARNING: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">WARNING: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "warning" log level.
-</dd>
-</dl>
<h2 class="title"><a name="ENVIRONMENT_VARIABLES">Environment Variables</a></h2>
The following environment variables are defined by the CUPS
server when executing the filter:
-<dl>
-<dt>CHARSET
-</dt>
-<dd></dd>
-<dd>The default text character set, typically utf-8.
-</dd>
-<dt>CLASS
-</dt>
-<dd></dd>
-<dd>When a job is submitted to a printer class, contains the name of
+<p style="margin-left: 5.0em; text-indent: -5.0em">CHARSET
+<br>
+<br>
+The default text character set, typically utf-8.
+<p style="margin-left: 5.0em; text-indent: -5.0em">CLASS
+<br>
+<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.
-</dd>
-<dt>CONTENT_TYPE
-</dt>
-<dd></dd>
-<dd>The MIME type associated with the file (e.g.
+<p style="margin-left: 5.0em; text-indent: -5.0em">CONTENT_TYPE
+<br>
+<br>
+The MIME type associated with the file (e.g.
application/postscript).
-</dd>
-<dt>CUPS_CACHEDIR
-</dt>
-<dd></dd>
-<dd>The directory for semi-persistent cache files can be found.
-</dd>
-<dt>CUPS_DATADIR
-</dt>
-<dd></dd>
-<dd>The directory where data files can be found.
-</dd>
-<dt>CUPS_FILETYPE
-</dt>
-<dd></dd>
-<dd>The type of file being printed: "job-sheet" for a banner page and "document"
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_CACHEDIR
+<br>
+<br>
+The directory for semi-persistent cache files can be found.
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_DATADIR
+<br>
+<br>
+The directory where data files can be found.
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_FILETYPE
+<br>
+<br>
+The type of file being printed: "job-sheet" for a banner page and "document"
for a regular print file.
-</dd>
-<dt>CUPS_MAX_MESSAGE
-</dt>
-<dd></dd>
-<dd>The maximum size of a message sent to stderr, including any leading prefix and
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_MAX_MESSAGE
+<br>
+<br>
+The maximum size of a message sent to stderr, including any leading prefix and
the trailing newline.
-</dd>
-<dt>CUPS_SERVERROOT
-</dt>
-<dd></dd>
-<dd>The root directory of the server.
-</dd>
-<dt>DEVICE_URI
-</dt>
-<dd></dd>
-<dd>The device-uri associated with the printer.
-</dd>
-<dt>FINAL_CONTENT_TYPE
-</dt>
-<dd></dd>
-<dd>The MIME type associated with the printer (e.g.
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_SERVERROOT
+<br>
+<br>
+The root directory of the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEVICE_URI
+<br>
+<br>
+The device-uri associated with the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">FINAL_CONTENT_TYPE
+<br>
+<br>
+The MIME type associated with the printer (e.g.
application/vnd.cups-postscript).
-</dd>
-<dt>LANG
-</dt>
-<dd></dd>
-<dd>The default language locale (typically C or en).
-</dd>
-<dt>PATH
-</dt>
-<dd></dd>
-<dd>The standard execution path for external programs that may be run by
+<p style="margin-left: 5.0em; text-indent: -5.0em">LANG
+<br>
+<br>
+The default language locale (typically C or en).
+<p style="margin-left: 5.0em; text-indent: -5.0em">PATH
+<br>
+<br>
+The standard execution path for external programs that may be run by
the filter.
-</dd>
-<dt>PPD
-</dt>
-<dd></dd>
-<dd>The full pathname of the PostScript Printer Description (PPD)
+<p style="margin-left: 5.0em; text-indent: -5.0em">PPD
+<br>
+<br>
+The full pathname of the PostScript Printer Description (PPD)
file for this printer.
-</dd>
-<dt>PRINTER
-</dt>
-<dd></dd>
-<dd>The name of the printer.
-</dd>
-<dt>RIP_CACHE
-</dt>
-<dd></dd>
-<dd>The recommended amount of memory to use for Raster Image
+<p style="margin-left: 5.0em; text-indent: -5.0em">PRINTER
+<br>
+<br>
+The name of the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">RIP_CACHE
+<br>
+<br>
+The recommended amount of memory to use for Raster Image
Processors (RIPs).
-</dd>
-<dt>SOFTWARE
-</dt>
-<dd></dd>
-<dd>The name and version number of the server (typically CUPS/1.2).
-</dd>
-<dt>TZ
-</dt>
-<dd></dd>
-<dd>The timezone of the server.
-</dd>
-<dt>USER
-</dt>
-<dd></dd>
-<dd>The user executing the filter, typically "lp" or "root"; consult the
-<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a> file for the current setting.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SOFTWARE
+<br>
+<br>
+The name and version number of the server (typically CUPS/1.2).
+<p style="margin-left: 5.0em; text-indent: -5.0em">TZ
+<br>
+<br>
+The timezone of the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">USER
+<br>
+<br>
+The user executing the filter, typically "lp" or "root"; consult the
+<i>cupsd.conf(5)</i> file for the current setting.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
While the filter interface is compatible with System V interface
scripts, it will only work with the System V interface script as the
only filter. Typically the interface script will be provided via the
-<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a> command using the <i>-i</i> option.
+<i>lpadmin(8)</i> command using the <i>-i</i> option.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-backend.html?TOPIC=Man+Pages'>backend(7)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsfilter.html?TOPIC=Man+Pages'>cupsfilter(8)</a>,
+<i>backend(7)</i>, <i>cupsd(8)</i>, <i>cupsfilter(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[
-<i>options
-</i>] regtype[,subtype][.domain.] ... [
-<i>expression ...
-</i>]
-<b>ippfind
-</b>[
-<i>options
-</i>] name[.regtype[.domain.]] ... [
-<i>expression ...
-</i>]
-<b>ippfind
-</b>--help
-<b>ippfind
-</b>--version
+<b>ippfind</b>
+[
+<i>options</i>
+] regtype[,subtype][.domain.] ... [
+<i>expression</i> <i>...</i>
+]
+<b>ippfind</b>
+[
+<i>options</i>
+] name[.regtype[.domain.]] ... [
+<i>expression</i> <i>...</i>
+]
+<b>ippfind</b>
+--help
+<b>ippfind</b>
+--version
<h2 class="title"><a name="OPTIONS">Options</a></h2>
-<dl>
-<dt>--help
-</dt>
-<dd>Show program help
-</dd>
-<dt>--version
-</dt>
-<dd>Show program version
-</dd>
-<dt>-4
-</dt>
-<dd>Use IPv4 when listing
-</dd>
-<dt>-6
-</dt>
-<dd>Use IPv6 when listing
-</dd>
-<dt>-T seconds
-</dt>
-<dd>Specify find timeout in seconds. If 1 or less, <i>ippfind</i> stops as soon as it thinks it has found everything. The default is 1 second.
-</dd>
-<dt>-V version
-</dt>
-<dd>Specifies the IPP version when listing. Supported values are 1.1, 2.0, 2.1, and 2.2.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--help
+<br>
+Show program help
+<p style="margin-left: 5.0em; text-indent: -5.0em">--version
+<br>
+Show program version
+<p style="margin-left: 5.0em; text-indent: -5.0em">-4
+<br>
+Use IPv4 when listing
+<p style="margin-left: 5.0em; text-indent: -5.0em">-6
+<br>
+Use IPv6 when listing
+<p style="margin-left: 5.0em; text-indent: -5.0em">-T seconds
+<br>
+Specify find timeout in seconds. If 1 or less, <i>ippfind</i> stops as soon as it thinks it has found everything. The default is 1 second.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-V version
+<br>
+Specifies the IPP version when listing. Supported values are 1.1, 2.0, 2.1, and 2.2.
-</dd>
-</dl>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ippfind</i> 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. For example, to show the status of all registered IPP printers on your network, run:
<pre>
<h2 class="title"><a name="REGISTRATION_TYPES">Registration Types</a></h2>
<i>ippfind</i> supports the following registration types:
-<dl>
-<dt>_http._tcp
-</dt>
-<dd>HyperText Transport Protocol (HTTP, RFC 2616)
-</dd>
-<dt>_https._tcp
-</dt>
-<dd>Secure HyperText Transport Protocol (HTTPS, RFC 2818)
-</dd>
-<dt>_ipp._tcp
-</dt>
-<dd>Internet Printing Protocol (IPP, RFC 2911)
-</dd>
-<dt>_ipps._tcp
-</dt>
-<dd>Secure Internet Printing Protocol (IPPS, draft)
-</dd>
-<dt>_printer._tcp
-</dt>
-<dd>Line Printer Daemon (LPD, RFC 1179)
+<p style="margin-left: 5.0em; text-indent: -5.0em">_http._tcp
+<br>
+HyperText Transport Protocol (HTTP, RFC 2616)
+<p style="margin-left: 5.0em; text-indent: -5.0em">_https._tcp
+<br>
+Secure HyperText Transport Protocol (HTTPS, RFC 2818)
+<p style="margin-left: 5.0em; text-indent: -5.0em">_ipp._tcp
+<br>
+Internet Printing Protocol (IPP, RFC 2911)
+<p style="margin-left: 5.0em; text-indent: -5.0em">_ipps._tcp
+<br>
+Secure Internet Printing Protocol (IPPS, draft)
+<p style="margin-left: 5.0em; text-indent: -5.0em">_printer._tcp
+<br>
+Line Printer Daemon (LPD, RFC 1179)
-</dd>
-</dl>
<h2 class="title"><a name="EXPRESSIONS">Expressions</a></h2>
<i>ippfind</i> supports expressions much like the <i>find(1)</i> utility. However, unlike <i>find</i>, <i>ippfind</i> uses POSIX regular expressions instead of shell filename matching patterns. If --exec, -l, --ls, -p, --print, --print-name, -q, --quiet, -s, or -x is not specified, <i>ippfind</i> adds --print to print the service URI of anything it finds. The following expressions are supported:
-<dl>
-<dt>-d regex
-</dt>
-<dd></dd>
-<dt>--domain regex
-</dt>
-<dd>True if the domain matches the given regular expression.
-</dd>
-<dt>--false
-</dt>
-<dd>Always false.
-</dd>
-<dt>-h regex
-</dt>
-<dd></dd>
-<dt>--host regex
-</dt>
-<dd>True is the hostname matches the given regular expression.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dt>--ls
-</dt>
-<dd>Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <i>find</i> "-ls" output for HTTP URLs. The result is true if the URI is accessible, false otherwise.
-</dd>
-<dt>--local
-</dt>
-<dd>True if the service is local to this computer.
-</dd>
-<dt>-n regex
-</dt>
-<dd></dd>
-<dt>--name regex
-</dt>
-<dd>True if the service instance name matches the given regular expression.
-</dd>
-<dt>--path regex
-</dt>
-<dd>True if the URI resource path matches the given regular expression.
-</dd>
-<dt>-P number[-number]
-</dt>
-<dd></dd>
-<dt>--port number[-number]
-</dt>
-<dd>True if the port matches the given number or range.
-</dd>
-<dt>-p
-</dt>
-<dd></dd>
-<dt>--print
-</dt>
-<dd>Prints the URI if the result of previous expressions is true. The result is always true.
-</dd>
-<dt>-q
-</dt>
-<dd></dd>
-<dt>--quiet
-</dt>
-<dd>Quiet mode - just returns the exit codes below.
-</dd>
-<dt>-r
-</dt>
-<dd></dd>
-<dt>--remote
-</dt>
-<dd>True if the service is not local to this computer.
-</dd>
-<dt>-s
-</dt>
-<dd></dd>
-<dt>--print-name
-</dt>
-<dd>Prints the service instance name if the result of previous expressions is true. The result is always true.
-</dd>
-<dt>--true
-</dt>
-<dd>Always true.
-</dd>
-<dt>-t key
-</dt>
-<dd></dd>
-<dt>--txt key
-</dt>
-<dd>True if the TXT record contains the named key.
-</dd>
-<dt>--txt-<i>key</i> regex
-</dt>
-<dd>True if the TXT record contains the named key and matches the given regular
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d regex
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--domain regex
+<br>
+True if the domain matches the given regular expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--false
+<br>
+Always false.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h regex
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--host regex
+<br>
+True is the hostname matches the given regular expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--ls
+<br>
+Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <i>find</i> "-ls" output for HTTP URLs. The result is true if the URI is accessible, false otherwise.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--local
+<br>
+True if the service is local to this computer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-n regex
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--name regex
+<br>
+True if the service instance name matches the given regular expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--path regex
+<br>
+True if the URI resource path matches the given regular expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P number[-number]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--port number[-number]
+<br>
+True if the port matches the given number or range.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-p
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--print
+<br>
+Prints the URI if the result of previous expressions is true. The result is always true.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-q
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--quiet
+<br>
+Quiet mode - just returns the exit codes below.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--remote
+<br>
+True if the service is not local to this computer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-s
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--print-name
+<br>
+Prints the service instance name if the result of previous expressions is true. The result is always true.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--true
+<br>
+Always true.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t key
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--txt key
+<br>
+True if the TXT record contains the named key.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--txt-<i>key</i> regex
+<br>
+True if the TXT record contains the named key and matches the given regular
expression.
-</dd>
-<dt>-u regex
-</dt>
-<dd></dd>
-<dt>--uri regex
-</dt>
-<dd>True if the URI matches the given regular expression.
-</dd>
-<dt>-x utility [argument ...] ;
-</dt>
-<dd></dd>
-<dt>--exec utility [argument ...] ;
-</dt>
-<dd>Executes the specified program if the current result is true. "{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u regex
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--uri regex
+<br>
+True if the URI matches the given regular expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-x utility [argument ...] ;
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--exec utility [argument ...] ;
+<br>
+Executes the specified program if the current result is true. "{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
<p>Expressions may also contain modifiers:
-<dl>
-<dt>( expression )
-</dt>
-<dd>Group the result of expressions.
-</dd>
-<dt>! expression
-</dt>
-<dd></dd>
-<dt>--not expression
-</dt>
-<dd>Unary NOT of the expression.
-</dd>
-<dt>expression expression
-</dt>
-<dd></dd>
-<dt>expression --and expression
-</dt>
-<dd>Logical AND of expressions.
-</dd>
-<dt>expression --or expression
-</dt>
-<dd>Logical OR of expressions.
+<p style="margin-left: 5.0em; text-indent: -5.0em">( expression )
+<br>
+Group the result of expressions.
+<p style="margin-left: 5.0em; text-indent: -5.0em">! expression
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--not expression
+<br>
+Unary NOT of the expression.
+<p style="margin-left: 5.0em; text-indent: -5.0em">expression expression
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">expression --and expression
+<br>
+Logical AND of expressions.
+<p style="margin-left: 5.0em; text-indent: -5.0em">expression --or expression
+<br>
+Logical OR of expressions.
-</dd>
-</dl>
<h2 class="title"><a name="SUBSTITUTIONS">Substitutions</a></h2>
The substitutions for "{foo}" in -e and --exec are:
-<dl>
-<dt>{}
-</dt>
-<dd>URI
-</dd>
-<dt>{service_domain}
-</dt>
-<dd>Domain name, e.g., "example.com.", "local.", etc.
-</dd>
-<dt>{service_hostname}
-</dt>
-<dd>Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
-</dd>
-<dt>{service_name}
-</dt>
-<dd>Service instance name, e.g., "My Fine Printer".
-</dd>
-<dt>{service_port}
-</dt>
-<dd>Port number for server, typically 631 for IPP and 80 for HTTP.
-</dd>
-<dt>{service_regtype}
-</dt>
-<dd>DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
-</dd>
-<dt>{service_scheme}
-</dt>
-<dd>URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
-</dd>
-<dt>{service_uri}
-</dt>
-<dd>URI for service, e.g., "ipp://printer.local./ipp/print", "<a href='http://printer.local./",'>http://printer.local./",</a> etc.
-</dd>
-<dt>{txt_<i>key</i>}
-</dt>
-<dd>Value of TXT record <i>key</i> (lowercase).
+<p style="margin-left: 5.0em; text-indent: -5.0em">{}
+<br>
+URI
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_domain}
+<br>
+Domain name, e.g., "example.com.", "local.", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_hostname}
+<br>
+Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_name}
+<br>
+Service instance name, e.g., "My Fine Printer".
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_port}
+<br>
+Port number for server, typically 631 for IPP and 80 for HTTP.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_regtype}
+<br>
+DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_scheme}
+<br>
+URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{service_uri}
+<br>
+URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./", etc.">http://printer.local./", etc.</a> etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">{txt_<i>key</i>}
+<br>
+Value of TXT record <i>key</i> (lowercase).
-</dd>
-</dl>
<h2 class="title"><a name="ENVIRONMENT_VARIABLES">Environment Variables</a></h2>
When executing a program, <i>ippfind</i> sets the following environment variables for the matching service registration:
-<dl>
-<dt>IPPFIND_SERVICE_DOMAIN
-</dt>
-<dd>Domain name, e.g., "example.com.", "local.", etc.
-</dd>
-<dt>IPPFIND_SERVICE_HOSTNAME
-</dt>
-<dd>Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
-</dd>
-<dt>IPPFIND_SERVICE_NAME
-</dt>
-<dd>Service instance name, e.g., "My Fine Printer".
-</dd>
-<dt>IPPFIND_SERVICE_PORT
-</dt>
-<dd>Port number for server, typically 631 for IPP and 80 for HTTP.
-</dd>
-<dt>IPPFIND_SERVICE_REGTYPE
-</dt>
-<dd>DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
-</dd>
-<dt>IPPFIND_SERVICE_SCHEME
-</dt>
-<dd>URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
-</dd>
-<dt>IPPFIND_SERVICE_URI
-</dt>
-<dd>URI for service, e.g., "ipp://printer.local./ipp/print", "<a href='http://printer.local./",'>http://printer.local./",</a> etc.
-</dd>
-<dt>IPPFIND_TXT_<i>KEY</i>
-</dt>
-<dd>Values of TXT record <i>KEY</i> (uppercase).
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_DOMAIN
+<br>
+Domain name, e.g., "example.com.", "local.", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_HOSTNAME
+<br>
+Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_NAME
+<br>
+Service instance name, e.g., "My Fine Printer".
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_PORT
+<br>
+Port number for server, typically 631 for IPP and 80 for HTTP.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_REGTYPE
+<br>
+DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_SCHEME
+<br>
+URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_SERVICE_URI
+<br>
+URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./", etc.">http://printer.local./", etc.</a> etc.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IPPFIND_TXT_<i>KEY</i>
+<br>
+Values of TXT record <i>KEY</i> (uppercase).
-</dd>
-</dl>
<h2 class="title"><a name="EXIT_CODES">Exit Codes</a></h2>
<i>ippfind</i> 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="SEE_ALSO">See Also</a></h2>
-<a href='man-ipptool.html?TOPIC=Man+Pages'>ipptool(1)</a>
+<i>ipptool(1)</i>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ --help ] [ --stop-after-include-error ] [ --version ]
+<b>ipptool</b>
+[ --help ] [ --stop-after-include-error ] [ --version ]
[ -4 ] [ -6 ] [ -C ] [ -E ] [ -I ] [ -L ] [ -S ] [ -T
-<i>seconds
-</i>] [ -V
-<i>version
-</i>] [ -X ] [ -c ] [ -d
-<i>name=value
-</i>] [ -f
-<i>filename
-</i>] [ -i
-<i>seconds
-</i>] [ -n
-<i>repeat-count
-</i>] [ -q ] [ -t ] [ -v ]
-<i>URI
-</i><i>filename
-</i>[
-<i>... filenameN
-</i>]
+<i>seconds</i>
+] [ -V
+<i>version</i>
+] [ -X ] [ -c ] [ -d
+<i>name=value</i>
+] [ -f
+<i>filename</i>
+] [ -i
+<i>seconds</i>
+] [ -n
+<i>repeat-count</i>
+] [ -q ] [ -t ] [ -v ]
+<i>URI</i>
+<i>filename</i>
+[
+<i>...</i> <i>filenameN</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>ipptool</i> sends IPP requests to the specified URI and tests and/or displays the results. Each named file 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 file format is described in <a href='man-ipptoolfile.html?TOPIC=Man+Pages'>ipptoolfile(5)</a>.
+<i>ipptool</i> sends IPP requests to the specified URI and tests and/or displays the results. Each named file 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 file format is described in <i>ipptoolfile(5)</i>.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>ipptool</i>:
-<dl>
-<dt>--help
-</dt>
-<dd>Shows program help.
-</dd>
-<dt>--stop-after-include-error
-</dt>
-<dd>Tells <i>ipptool</i> to stop if an error occurs in an included file. Normally <i>ipptool</i> will continue with subsequent tests after the INCLUDE directive.
-</dd>
-<dt>--version
-</dt>
-<dd>Shows the version of <i>ipptool</i> being used.
-</dd>
-<dt>-4
-</dt>
-<dd>Specifies that <i>ipptool</i> must connect to the printer or server using IPv4.
-</dd>
-<dt>-6
-</dt>
-<dd>Specifies that <i>ipptool</i> must connect to the printer or server using IPv6.
-</dd>
-<dt>-C
-</dt>
-<dd>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.
-</dd>
-<dt>-E
-</dt>
-<dd>Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
-</dd>
-<dt>-I
-</dt>
-<dd>Specifies that <i>ipptool</i> will continue past errors.
-</dd>
-<dt>-L
-</dt>
-<dd>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.
-</dd>
-<dt>-S
-</dt>
-<dd>Forces (dedicated) SSL encryption when connecting to the server.
-</dd>
-<dt>-T seconds
-</dt>
-<dd>Specifies a timeout for IPP requests in seconds.
-</dd>
-<dt>-V version
-</dt>
-<dd>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.
-</dd>
-<dt>-X
-</dt>
-<dd>Specifies that XML (Apple plist) output is desired instead of the plain text report. This option is incompatible with the <i>-i</i> (interval) and <i>-n</i> (repeat-count) options.
-</dd>
-<dt>-c
-</dt>
-<dd>Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
-</dd>
-<dt>-d name=value
-</dt>
-<dd>Defines the named variable.
-</dd>
-<dt>-f filename
-</dt>
-<dd>Defines the default request filename for tests.
-</dd>
-<dt>-i seconds
-</dt>
-<dd>Specifies that the (last) file should be repeated at the specified interval. This option is incompatible with the <i>-X</i> (XML plist output) option.
-</dd>
-<dt>-l
-</dt>
-<dd>Specifies that plain text output is desired.
-</dd>
-<dt>-n repeat-count
-</dt>
-<dd>Specifies that the (last) file should be repeated the specified number of times. This option is incompatible with the <i>-X</i> (XML plist output) option.
-</dd>
-<dt>-t
-</dt>
-<dd>Specifies that CUPS test report output is desired instead of the plain text output.
-</dd>
-<dt>-v
-</dt>
-<dd>Specifies that all request and response attributes should be output in CUPS test mode (<i>-t</i>). This is the default for XML output.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--help
+<br>
+Shows program help.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--stop-after-include-error
+<br>
+Tells <i>ipptool</i> to stop if an error occurs in an included file. Normally <i>ipptool</i> will continue with subsequent tests after the INCLUDE directive.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--version
+<br>
+Shows the version of <i>ipptool</i> being used.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-4
+<br>
+Specifies that <i>ipptool</i> must connect to the printer or server using IPv4.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-6
+<br>
+Specifies that <i>ipptool</i> must connect to the printer or server using IPv6.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-C
+<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 style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-I
+<br>
+Specifies that <i>ipptool</i> will continue past errors.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-L
+<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 style="margin-left: 5.0em; text-indent: -5.0em">-S
+<br>
+Forces (dedicated) SSL encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-T seconds
+<br>
+Specifies a timeout for IPP requests in seconds.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-V version
+<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 style="margin-left: 5.0em; text-indent: -5.0em">-X
+<br>
+Specifies that XML (Apple plist) output is desired instead of the plain text report. This option is incompatible with the <i>-i</i> (interval) and <i>-n</i> (repeat-count) options.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c
+<br>
+Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d name=value
+<br>
+Defines the named variable.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-f filename
+<br>
+Defines the default request filename for tests.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-i seconds
+<br>
+Specifies that the (last) file should be repeated at the specified interval. This option is incompatible with the <i>-X</i> (XML plist output) option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+Specifies that plain text output is desired.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-n repeat-count
+<br>
+Specifies that the (last) file should be repeated the specified number of times. This option is incompatible with the <i>-X</i> (XML plist output) option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t
+<br>
+Specifies that CUPS test report output is desired instead of the plain text output.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-v
+<br>
+Specifies that all request and response attributes should be output in CUPS test mode (<i>-t</i>). This is the default for XML output.
<h2 class="title"><a name="EXIT_CODE">Exit Code</a></h2>
The <i>ipptool</i> program returns 0 if all tests were sucessful and 1 otherwise.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
validate-job.test
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-ipptoolfile.html?TOPIC=Man+Pages'>ipptoolfile(5)</a>, RFC 2911,
+<i>ipptoolfile(5)</i>, RFC 2911,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<br>
-<a href='http://www.iana.org/assignments/ipp-registrations'>http://www.iana.org/assignments/ipp-registrations</a>
+<a href="http://www.iana.org/assignments/ipp-registrations">http://www.iana.org/assignments/ipp-registrations</a>
<br>
-<a href='http://www.pwg.org/ipp'>http://www.pwg.org/ipp</a>
+<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2014 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
ipptoolfile - ipptool file format
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <a href='man-ipptool.html?TOPIC=Man+Pages'>ipptool(1)</a> 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. Each request is enclosed by curly braces, for example:
+The <i>ipptool(1)</i> 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. Each request is enclosed by curly braces, for example:
<pre>
# This is a comment
}
</pre>
-<h2 class="title"><a name="TOP-LEVEL_DIRECTIVES">Top-level Directives</a></h2>
+<h2 class="title"><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h2>
The following directives can be used outside of a test:
-<dl>
-<dt>{ test }
-</dt>
-<dd>Defines a test.
-</dd>
-<dt>DEFINE variable-name value
-</dt>
-<dd>Defines the named variable to the given value. This is equivalent to specifying
+<p style="margin-left: 5.0em; text-indent: -5.0em">{ test }
+<br>
+Defines a test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE variable-name value
+<br>
+Defines the named variable to the given value. This is equivalent to specifying
"-d variable-name=value" on the <i>ipptool</i> command-line.
-</dd>
-<dt>DEFINE-DEFAULT variable-name value
-</dt>
-<dd>Defines the named variable to the given value if it does not already have a
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-DEFAULT variable-name value
+<br>
+Defines the named variable to the given value if it does not already have a
value.
-</dd>
-<dt>FILE-ID "identifier"
-</dt>
-<dd>Specifies an identifier string for the current file.
-</dd>
-<dt>IGNORE-ERRORS yes
-</dt>
-<dd></dd>
-<dt>IGNORE-ERRORS no
-</dt>
-<dd>Specifies whether, by default, <i>ipptool</i> will ignore errors and continue with
+<p style="margin-left: 5.0em; text-indent: -5.0em">FILE-ID "identifier"
+<br>
+Specifies an identifier string for the current file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IGNORE-ERRORS yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">IGNORE-ERRORS no
+<br>
+Specifies whether, by default, <i>ipptool</i> will ignore errors and continue with
subsequent tests.
-</dd>
-<dt>INCLUDE "filename"
-</dt>
-<dd></dd>
-<dt>INCLUDE <filename>
-</dt>
-<dd>Includes another test file. The first form includes a file relative to the
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE "filename"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE <filename>
+<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 <i>ipptool</i>
include directory.
-</dd>
-<dt>INCLUDE-IF-DEFINED name "filename"
-</dt>
-<dd></dd>
-<dt>INCLUDE-IF-DEFINED name <filename>
-</dt>
-<dd>Includes another test file if the named variable is defined. The first form
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE-IF-DEFINED name "filename"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE-IF-DEFINED name <filename>
+<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 <i>ipptool</i> include directory.
-</dd>
-<dt>INCLUDE-IF-NOT-DEFINED name "filename"
-</dt>
-<dd></dd>
-<dt>INCLUDE-IF-NOT-DEFINED name <filename>
-</dt>
-<dd>Includes another test file if the named variable is not defined. The first form
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE-IF-NOT-DEFINED name "filename"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">INCLUDE-IF-NOT-DEFINED name <filename>
+<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 <i>ipptool</i> include directory.
-</dd>
-<dt>SKIP-IF-DEFINED variable-name
-</dt>
-<dd></dd>
-<dt>SKIP-IF-NOT-DEFINED variable-name
-</dt>
-<dd>Specifies that the remainder of the test file should be skipped when the
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-IF-DEFINED variable-name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-IF-NOT-DEFINED variable-name
+<br>
+Specifies that the remainder of the test file should be skipped when the
variable is or is not defined.
-</dd>
-<dt>STOP-AFTER-INCLUDE-ERROR no
-</dt>
-<dd></dd>
-<dt>STOP-AFTER-INCLUDE-ERROR yes
-</dt>
-<dd>Specifies whether tests will be stopped after an error in an included file.
-</dd>
-<dt>TRANSFER auto
-</dt>
-<dd>Specifies that tests will, by default, use "Transfer-Encoding: chunked" for
+<p style="margin-left: 5.0em; text-indent: -5.0em">STOP-AFTER-INCLUDE-ERROR no
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">STOP-AFTER-INCLUDE-ERROR yes
+<br>
+Specifies whether tests will be stopped after an error in an included file.
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER auto
+<br>
+Specifies that tests will, by default, use "Transfer-Encoding: chunked" for
requests with attached files and "Content-Length:" for requests without attached
files.
-</dd>
-<dt>TRANSFER chunked
-</dt>
-<dd>Specifies that tests will, by default, use the HTTP/1.1 "Transfer-Encoding:
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER chunked
+<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 "-c" on the
<i>ipptool</i> command-line. Support for chunked requests is required for
conformance with all versions of IPP.
-</dd>
-<dt>TRANSFER length
-</dt>
-<dd>Specifies that tests will, by default, use the HTTP/1.0 "Content-Length:"
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER length
+<br>
+Specifies that tests will, by default, use the HTTP/1.0 "Content-Length:"
header. This is equivalent to specifying "-l" on the <i>ipptool</i> command-line.
Support for content length requests is required for conformance with all
versions of IPP.
-</dd>
-<dt>VERSION 1.0
-</dt>
-<dd></dd>
-<dt>VERSION 1.1
-</dt>
-<dd></dd>
-<dt>VERSION 2.0
-</dt>
-<dd></dd>
-<dt>VERSION 2.1
-</dt>
-<dd></dd>
-<dt>VERSION 2.2
-</dt>
-<dd>Specifies the default IPP version number to use for the tests that follow.
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 1.0
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 1.1
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.0
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.1
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.2
+<br>
+Specifies the default IPP version number to use for the tests that follow.
-</dd>
-</dl>
<h2 class="title"><a name="TEST_DIRECTIVES">Test Directives</a></h2>
The following directives are understood in a test:
-<dl>
-<dt>ATTR tag attribute-name value(s)
-</dt>
-<dd>Adds an attribute to the test request. Values are separated by the comma (",")
+<p style="margin-left: 5.0em; text-indent: -5.0em">ATTR tag attribute-name value(s)
+<br>
+Adds an attribute to the test request. Values are separated by the comma (",")
character - escape commas using the "" character. Common attributes and values are listed in the IANA IPP registry - see references below.
-</dd>
-<dt>ATTR collection attribute-name { MEMBER tag member-name value(s) ... } [ ... { ... } ]
-</dt>
-<dd>Adds a collection attribute to the test request. Member attributes follow the
+<p style="margin-left: 5.0em; text-indent: -5.0em">ATTR collection attribute-name { MEMBER tag member-name value(s) ... } [ ... { ... } ]
+<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.
-</dd>
-<dt>COMPRESSION deflate
-</dt>
-<dd></dd>
-<dt>COMPRESSION gzip
-</dt>
-<dd></dd>
-<dt>COMPRESSION none
-</dt>
-<dd></dd>
-<dd>Uses the specified compression on the document data following the attributes in
+<p style="margin-left: 5.0em; text-indent: -5.0em">COMPRESSION deflate
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">COMPRESSION gzip
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">COMPRESSION none
+<br>
+<br>
+Uses the specified compression on the document data following the attributes in
a Print-Job or Send-Document request.
-</dd>
-<dt>DELAY seconds
-</dt>
-<dd>Specifies a delay before this test will be run.
-</dd>
-<dt>DISPLAY attribute-name
-</dt>
-<dd>Specifies that value of the named attribute should be output as part of the
+<p style="margin-left: 5.0em; text-indent: -5.0em">DELAY seconds
+<br>
+Specifies a delay before this test will be run.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DISPLAY attribute-name
+<br>
+Specifies that value of the named attribute should be output as part of the
test report.
-</dd>
-<dt>EXPECT attribute-name [ predicate(s) ]
-</dt>
-<dd></dd>
-<dt>EXPECT ?attribute-name predicate(s)
-</dt>
-<dd></dd>
-<dt>EXPECT !attribute-name
-</dt>
-<dd>Specifies that the response must/may/must not include the named attribute.
+<p style="margin-left: 5.0em; text-indent: -5.0em">EXPECT attribute-name [ predicate(s) ]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">EXPECT ?attribute-name predicate(s)
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">EXPECT !attribute-name
+<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.
-</dd>
-<dt>FILE filename
-</dt>
-<dd>Specifies a file to include at the end of the request. This is typically used
+<p style="margin-left: 5.0em; text-indent: -5.0em">FILE filename
+<br>
+Specifies a file to include at the end of the request. This is typically used
when sending a test print file.
-</dd>
-<dt>GROUP tag
-</dt>
-<dd>Specifies the group tag for subsequent attributes in the request.
-</dd>
-<dt>IGNORE-ERRORS yes
-</dt>
-<dd></dd>
-<dt>IGNORE-ERRORS no
-</dt>
-<dd>Specifies whether <i>ipptool</i> will ignore errors and continue with subsequent
+<p style="margin-left: 5.0em; text-indent: -5.0em">GROUP tag
+<br>
+Specifies the group tag for subsequent attributes in the request.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IGNORE-ERRORS yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">IGNORE-ERRORS no
+<br>
+Specifies whether <i>ipptool</i> will ignore errors and continue with subsequent
tests.
-</dd>
-<dt>NAME "literal string"
-</dt>
-<dd>Specifies the human-readable name of the test.
-</dd>
-<dt>OPERATION operation-code
-</dt>
-<dd>Specifies the operation to be performed.
-</dd>
-<dt>REQUEST-ID number
-</dt>
-<dd></dd>
-<dt>REQUEST-ID random
-</dt>
-<dd>Specifies the request-id value to use in the request, either an integer or the
+<p style="margin-left: 5.0em; text-indent: -5.0em">NAME "literal string"
+<br>
+Specifies the human-readable name of the test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">OPERATION operation-code
+<br>
+Specifies the operation to be performed.
+<p style="margin-left: 5.0em; text-indent: -5.0em">REQUEST-ID number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">REQUEST-ID random
+<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).
-</dd>
-<dt>RESOURCE path
-</dt>
-<dd>Specifies an alternate resource path that is used for the HTTP POST request.
+<p style="margin-left: 5.0em; text-indent: -5.0em">RESOURCE path
+<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 <i>ipptool</i> program.
-</dd>
-<dt>SKIP-IF-DEFINED variable-name
-</dt>
-<dd></dd>
-<dt>SKIP-IF-NOT-DEFINED variable-name
-</dt>
-<dd>Specifies that the current test should be skipped when the variable is or is not
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-IF-DEFINED variable-name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-IF-NOT-DEFINED variable-name
+<br>
+Specifies that the current test should be skipped when the variable is or is not
defined.
-</dd>
-<dt>SKIP-PREVIOUS-ERROR yes
-</dt>
-<dd></dd>
-<dt>SKIP-PREVIOUS-ERROR no
-</dt>
-<dd>Specifies whether <i>ipptool</i> will skip the current test if the previous test
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-PREVIOUS-ERROR yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SKIP-PREVIOUS-ERROR no
+<br>
+Specifies whether <i>ipptool</i> will skip the current test if the previous test
resulted in an error/failure.
-</dd>
-<dt>STATUS status-code [ predicate ]
-</dt>
-<dd>Specifies an expected response status-code value. Additional requirements can be
+<p style="margin-left: 5.0em; text-indent: -5.0em">STATUS status-code [ predicate ]
+<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.
-</dd>
-<dt>TEST-ID "identifier"
-</dt>
-<dd>Specifies an identifier string for the current test.
-</dd>
-<dt>TRANSFER auto
-</dt>
-<dd>Specifies that this test will use "Transfer-Encoding: chunked" if it has an
+<p style="margin-left: 5.0em; text-indent: -5.0em">TEST-ID "identifier"
+<br>
+Specifies an identifier string for the current test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER auto
+<br>
+Specifies that this test will use "Transfer-Encoding: chunked" if it has an
attached file or "Content-Length:" otherwise.
-</dd>
-<dt>TRANSFER chunked
-</dt>
-<dd>Specifies that this test will use the HTTP/1.1 "Transfer-Encoding: chunked"
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER chunked
+<br>
+Specifies that this test will use the HTTP/1.1 "Transfer-Encoding: chunked"
header.
-</dd>
-<dt>TRANSFER length
-</dt>
-<dd>Specifies that this test will use the HTTP/1.0 "Content-Length:" header.
-</dd>
-<dt>VERSION 1.0
-</dt>
-<dd></dd>
-<dt>VERSION 1.1
-</dt>
-<dd></dd>
-<dt>VERSION 2.0
-</dt>
-<dd></dd>
-<dt>VERSION 2.1
-</dt>
-<dd></dd>
-<dt>VERSION 2.2
-</dt>
-<dd>Specifies the IPP version number to use for this test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">TRANSFER length
+<br>
+Specifies that this test will use the HTTP/1.0 "Content-Length:" header.
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 1.0
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 1.1
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.0
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.1
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">VERSION 2.2
+<br>
+Specifies the IPP version number to use for this test.
-</dd>
-</dl>
<h2 class="title"><a name="EXPECT_PREDICATES">Expect Predicates</a></h2>
The following predicates are understood following the EXPECT test directive:
-<dl>
-<dt>COUNT number
-</dt>
-<dd>Requires the EXPECT attribute to have the specified number of values.
-</dd>
-<dt>DEFINE-MATCH variable-name
-</dt>
-<dd>Defines the variable to "1" when the EXPECT condition matches. A side-effect of
+<p style="margin-left: 5.0em; text-indent: -5.0em">COUNT number
+<br>
+Requires the EXPECT attribute to have the specified number of values.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-MATCH variable-name
+<br>
+Defines the variable to "1" when the EXPECT condition matches. A side-effect of
this predicate is that this EXPECT will never fail a test.
-</dd>
-<dt>DEFINE-NO-MATCH variable-name
-</dt>
-<dd>Defines the variable to "1" when the EXPECT condition does not match. A side-
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-NO-MATCH variable-name
+<br>
+Defines the variable to "1" when the EXPECT condition does not match. A side-
effect of this predicate is that this EXPECT will never fail a test.
-</dd>
-<dt>DEFINE-VALUE variable-name
-</dt>
-<dd>Defines the variable to the value of the attribute when the EXPECT condition
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-VALUE variable-name
+<br>
+Defines the variable to the value of the attribute when the EXPECT condition
matches. A side-effect of this predicate is that this EXPECT will never fail a test.
-</dd>
-<dt>IF-DEFINED variable-name
-</dt>
-<dd>Makes the EXPECT conditions apply only if the specified variable is defined.
-</dd>
-<dt>IF-NOT-DEFINED variable-name
-</dt>
-<dd>Makes the EXPECT conditions apply only if the specified variable is not
+<p style="margin-left: 5.0em; text-indent: -5.0em">IF-DEFINED variable-name
+<br>
+Makes the EXPECT conditions apply only if the specified variable is defined.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IF-NOT-DEFINED variable-name
+<br>
+Makes the EXPECT conditions apply only if the specified variable is not
defined.
-</dd>
-<dt>IN-GROUP tag
-</dt>
-<dd>Requires the EXPECT attribute to be in the specified group tag.
-</dd>
-<dt>OF-TYPE tag[,tag,...]
-</dt>
-<dd>Requires the EXPECT attribute to use the specified value tag(s).
-</dd>
-<dt>REPEAT-LIMIT number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of times to repeat. The default value is 1000.
-</dd>
-<dt>REPEAT-MATCH
-</dt>
-<dd></dd>
-<dt>REPEAT-NO-MATCH
-</dt>
-<dd>Specifies that the current test should be repeated when the EXPECT condition
+<p style="margin-left: 5.0em; text-indent: -5.0em">IN-GROUP tag
+<br>
+Requires the EXPECT attribute to be in the specified group tag.
+<p style="margin-left: 5.0em; text-indent: -5.0em">OF-TYPE tag[,tag,...]
+<br>
+Requires the EXPECT attribute to use the specified value tag(s).
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-LIMIT number
+<br>
+<br>
+Specifies the maximum number of times to repeat. The default value is 1000.
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-MATCH
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-NO-MATCH
+<br>
+Specifies that the current test should be repeated when the EXPECT condition
matches or does not match.
-</dd>
-<dt>SAME-COUNT-AS attribute-name
-</dt>
-<dd>Requires the EXPECT attribute to have the same number of values as the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">SAME-COUNT-AS attribute-name
+<br>
+Requires the EXPECT attribute to have the same number of values as the specified
parallel attribute.
-</dd>
-<dt>WITH-ALL-HOSTNAMES "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-ALL-HOSTNAMES "/regular expression/"
-</dt>
-<dd>Requires that all URI values contain a matching hostname.
-</dd>
-<dt>WITH-ALL-RESOURCES "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-ALL-RESOURCES "/regular expression/"
-</dt>
-<dd>Requires that all URI values contain a matching resource (including leading /).
-</dd>
-<dt>WITH-ALL-SCHEMES "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-ALL-SCHEMES "/regular expression/"
-</dt>
-<dd>Requires that all URI values contain a matching scheme.
-</dd>
-<dt>WITH-ALL-VALUES "literal string"
-</dt>
-<dd>Requires that all values of the EXPECT attribute match the literal string. Comparisons are case-sensitive.
-</dd>
-<dt>WITH-ALL-VALUES <number
-</dt>
-<dd></dd>
-<dt>WITH-ALL-VALUES =number
-</dt>
-<dd></dd>
-<dt>WITH-ALL-VALUES >number
-</dt>
-<dd></dd>
-<dt>WITH-ALL-VALUES number[,number,...]
-</dt>
-<dd>Requires that all values of the EXPECT attribute match the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
-</dd>
-<dt>WITH-ALL-VALUES "false"
-</dt>
-<dd></dd>
-<dt>WITH-ALL-VALUES "true"
-</dt>
-<dd>Requires that all values of the EXPECT attribute match the boolean value given.
-</dd>
-<dt>WITH-ALL-VALUES "/regular expression/"
-</dt>
-<dd>Requires that all values of the EXPECT attribute match the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
-</dd>
-<dt>WITH-HOSTNAME "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-HOSTNAME "/regular expression/"
-</dt>
-<dd>Requires that at least one URI value contains a matching hostname.
-</dd>
-<dt>WITH-RESOURCE "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-RESOURCE "/regular expression/"
-</dt>
-<dd>Requires that at least one URI value contains a matching resource (including leading /).
-</dd>
-<dt>WITH-SCHEME "literal string"
-</dt>
-<dd></dd>
-<dt>WITH-SCHEME "/regular expression/"
-</dt>
-<dd>Requires that at least one URI value contains a matching scheme.
-</dd>
-<dt>WITH-VALUE "literal string"
-</dt>
-<dd>Requires that at least one value of the EXPECT attribute matches the literal string. Comparisons are case-sensitive.
-</dd>
-<dt>WITH-VALUE <number
-</dt>
-<dd></dd>
-<dt>WITH-VALUE =number
-</dt>
-<dd></dd>
-<dt>WITH-VALUE >number
-</dt>
-<dd></dd>
-<dt>WITH-VALUE number[,number,...]
-</dt>
-<dd>Requires that at least one value of the EXPECT attribute matches the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
-</dd>
-<dt>WITH-VALUE "false"
-</dt>
-<dd></dd>
-<dt>WITH-VALUE "true"
-</dt>
-<dd>Requires that at least one value of the EXPECT attribute matches the boolean value given.
-</dd>
-<dt>WITH-VALUE "/regular expression/"
-</dt>
-<dd>Requires that at least one value of the EXPECT attribute matches the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-HOSTNAMES "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-HOSTNAMES "/regular expression/"
+<br>
+Requires that all URI values contain a matching hostname.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-RESOURCES "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-RESOURCES "/regular expression/"
+<br>
+Requires that all URI values contain a matching resource (including leading /).
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-SCHEMES "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-SCHEMES "/regular expression/"
+<br>
+Requires that all URI values contain a matching scheme.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES "literal string"
+<br>
+Requires that all values of the EXPECT attribute match the literal string. Comparisons are case-sensitive.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES <number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES =number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES >number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES number[,number,...]
+<br>
+Requires that all values of the EXPECT attribute match the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES "false"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES "true"
+<br>
+Requires that all values of the EXPECT attribute match the boolean value given.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-ALL-VALUES "/regular expression/"
+<br>
+Requires that all values of the EXPECT attribute match the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-HOSTNAME "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-HOSTNAME "/regular expression/"
+<br>
+Requires that at least one URI value contains a matching hostname.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-RESOURCE "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-RESOURCE "/regular expression/"
+<br>
+Requires that at least one URI value contains a matching resource (including leading /).
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-SCHEME "literal string"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-SCHEME "/regular expression/"
+<br>
+Requires that at least one URI value contains a matching scheme.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE "literal string"
+<br>
+Requires that at least one value of the EXPECT attribute matches the literal string. Comparisons are case-sensitive.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE <number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE =number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE >number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE number[,number,...]
+<br>
+Requires that at least one value of the EXPECT attribute matches the number(s) or numeric comparison. When comparing rangeOfInteger values, the "<" and ">" operators only check the upper bound of the range.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE "false"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE "true"
+<br>
+Requires that at least one value of the EXPECT attribute matches the boolean value given.
+<p style="margin-left: 5.0em; text-indent: -5.0em">WITH-VALUE "/regular expression/"
+<br>
+Requires that at least one value of the EXPECT attribute matches the regular expression, which must conform to the POSIX regular expression syntax. Comparisons are case-sensitive.
-</dd>
-</dl>
<h2 class="title"><a name="STATUS_PREDICATES">Status Predicates</a></h2>
The following predicates are understood following the STATUS test directive:
-<dl>
-<dt>DEFINE-MATCH variable-name
-</dt>
-<dd>Defines the variable to "1" when the STATUS matches. A side-effect of this predicate is that this STATUS will never fail a test.
-</dd>
-<dt>DEFINE-NO-MATCH variable-name
-</dt>
-<dd>Defines the variable to "1" when the STATUS does not match. A side-effect of this predicate is that this STATUS will never fail a test.
-</dd>
-<dt>IF-DEFINED variable-name
-</dt>
-<dd>Makes the STATUS apply only if the specified variable is defined.
-</dd>
-<dt>IF-NOT-DEFINED variable-name
-</dt>
-<dd>Makes the STATUS apply only if the specified variable is not defined.
-</dd>
-<dt>REPEAT-LIMIT number
-</dt>
-<dd></dd>
-<dd>Specifies the maximum number of times to repeat. The default value is 1000.
-</dd>
-<dt>REPEAT-MATCH
-</dt>
-<dd></dd>
-<dt>REPEAT-NO-MATCH
-</dt>
-<dd>Specifies that the current test should be repeated when the response status-code
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-MATCH variable-name
+<br>
+Defines the variable to "1" when the STATUS matches. A side-effect of this predicate is that this STATUS will never fail a test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEFINE-NO-MATCH variable-name
+<br>
+Defines the variable to "1" when the STATUS does not match. A side-effect of this predicate is that this STATUS will never fail a test.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IF-DEFINED variable-name
+<br>
+Makes the STATUS apply only if the specified variable is defined.
+<p style="margin-left: 5.0em; text-indent: -5.0em">IF-NOT-DEFINED variable-name
+<br>
+Makes the STATUS apply only if the specified variable is not defined.
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-LIMIT number
+<br>
+<br>
+Specifies the maximum number of times to repeat. The default value is 1000.
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-MATCH
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">REPEAT-NO-MATCH
+<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.
-</dd>
-</dl>
<h2 class="title"><a name="OPERATION_CODES">Operation Codes</a></h2>
Operation codes correspond to the hexadecimal numbers (0xHHHH) and names from
RFC 2911 and other IPP extension specifications. Here is a complete list:
literal string or attribute value by specifying "$variable-name". Aside from
variables defined using the "-d" option or "DEFINE" directive, the following
pre-defined variables are available:
-<dl>
-<dt>$$
-</dt>
-<dd>Inserts a single "$" character.
-</dd>
-<dt>$ENV[name]
-</dt>
-<dd>Inserts the value of the named environment variable, or an empty string if the
+<p style="margin-left: 5.0em; text-indent: -5.0em">$$
+<br>
+Inserts a single "$" character.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$ENV[name]
+<br>
+Inserts the value of the named environment variable, or an empty string if the
environment variable is not defined.
-</dd>
-<dt>$filename
-</dt>
-<dd>Inserts the filename provided to <i>ipptool</i> with the "-f" option.
-</dd>
-<dt>$hostname
-</dt>
-<dd>Inserts the hostname from the URI provided to <i>ipptool</i>.
-</dd>
-<dt>$job-id
-</dt>
-<dd>Inserts the last job-id value returned in a test response or 0 if no job-id has
+<p style="margin-left: 5.0em; text-indent: -5.0em">$filename
+<br>
+Inserts the filename provided to <i>ipptool</i> with the "-f" option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$hostname
+<br>
+Inserts the hostname from the URI provided to <i>ipptool</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$job-id
+<br>
+Inserts the last job-id value returned in a test response or 0 if no job-id has
been seen.
-</dd>
-<dt>$job-uri
-</dt>
-<dd>Inserts the last job-uri value returned in a test response or an empty string if
+<p style="margin-left: 5.0em; text-indent: -5.0em">$job-uri
+<br>
+Inserts the last job-uri value returned in a test response or an empty string if
no job-uri has been seen.
-</dd>
-<dt>$scheme
-</dt>
-<dd>Inserts the scheme from the URI provided to <i>ipptool</i>.
-</dd>
-<dt>$notify-subscription-id
-</dt>
-<dd>Inserts the last notify-subscription-id value returned in a test response or 0 if
+<p style="margin-left: 5.0em; text-indent: -5.0em">$scheme
+<br>
+Inserts the scheme from the URI provided to <i>ipptool</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$notify-subscription-id
+<br>
+Inserts the last notify-subscription-id value returned in a test response or 0 if
no notify-subscription-id has been seen.
-</dd>
-<dt>$port
-</dt>
-<dd>Inserts the port number from the URI provided to <i>ipptool</i>.
-</dd>
-<dt>$resource
-</dt>
-<dd>Inserts the resource path from the URI provided to <i>ipptool</i>.
-</dd>
-<dt>$uri
-</dt>
-<dd>Inserts the URI provided to <i>ipptool</i>.
-</dd>
-<dt>$user
-</dt>
-<dd>Inserts the current user's login name.
-</dd>
-<dt>$username
-</dt>
-<dd>Inserts the username from the URI provided to <i>ipptool</i>, if any.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$port
+<br>
+Inserts the port number from the URI provided to <i>ipptool</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$resource
+<br>
+Inserts the resource path from the URI provided to <i>ipptool</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$uri
+<br>
+Inserts the URI provided to <i>ipptool</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$user
+<br>
+Inserts the current user's login name.
+<p style="margin-left: 5.0em; text-indent: -5.0em">$username
+<br>
+Inserts the username from the URI provided to <i>ipptool</i>, if any.
-</dd>
-</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-ipptool.html?TOPIC=Man+Pages'>ipptool(1)</a>, RFC 2911,
+<i>ipptool(1)</i>, RFC 2911,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<br>
-<a href='http://www.iana.org/assignments/ipp-registrations'>http://www.iana.org/assignments/ipp-registrations</a>
+<a href="http://www.iana.org/assignments/ipp-registrations">http://www.iana.org/assignments/ipp-registrations</a>
<br>
-<a href='http://www.pwg.org/ipp'>http://www.pwg.org/ipp</a>
+<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2014 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
lp - print files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lp
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -c ] [ -d
-<i>destination[/instance]
-</i>] [ -h
-<i>hostname[:port]
-</i>] [ -m ] [ -n
-<i>num-copies
-</i>] [ -o
-<i>option[=value]
-</i>] [ -q
-<i>priority
-</i>] [ -s ] [ -t
-<i>title
-</i>] [ -H
-<i>handling
-</i>] [ -P
-<i>page-list
-</i>] [ -- ] [
-<i>file(s)
-</i>]
-<br>
-<b>lp
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -c ] [ -h
-<i>hostname[:port]
-</i>] [ -i
-<i>job-id
-</i>] [ -n
-<i>num-copies
-</i>] [ -o
-<i>option[=value]
-</i>] [ -q
-<i>priority
-</i>] [ -t
-<i>title
-</i>] [ -H
-<i>handling
-</i>] [ -P
-<i>page-list
-</i>]
+<b>lp</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -c ] [ -d
+<i>destination[/instance]</i>
+] [ -h
+<i>hostname[:port]</i>
+] [ -m ] [ -n
+<i>num-copies</i>
+] [ -o
+<i>option[=value]</i>
+] [ -q
+<i>priority</i>
+] [ -s ] [ -t
+<i>title</i>
+] [ -H
+<i>handling</i>
+] [ -P
+<i>page-list</i>
+] [ -- ] [
+<i>file(s)</i>
+]
+<br>
+<b>lp</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -c ] [ -h
+<i>hostname[:port]</i>
+] [ -i
+<i>job-id</i>
+] [ -n
+<i>num-copies</i>
+] [ -o
+<i>option[=value]</i>
+] [ -q
+<i>priority</i>
+] [ -t
+<i>title</i>
+] [ -H
+<i>handling</i>
+] [ -P
+<i>page-list</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lp</i> submits files for printing or alters a pending job. Use
a filename of "-" to force printing from the standard input.
<h2 class="title"><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h2>
CUPS provides many ways to set the default destination. The "LPDEST" and
"PRINTER" environment variables are consulted first. If neither are set,
-the current default set using the <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command is used,
-followed by the default set using the <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a> command.
+the current default set using the <i>lpoptions(1)</i> command is used,
+followed by the default set using the <i>lpadmin(8)</i> command.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>lp</i>:
-<dl>
-<dt>--
-</dt>
-<dd></dd>
-<dd>Marks the end of options; use this to print a file whose name
+<p style="margin-left: 5.0em; text-indent: -5.0em">--
+<br>
+<br>
+Marks the end of options; use this to print a file whose name
begins with a dash (-).
-</dd>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies the username to use when connecting to the server.
-</dd>
-<dt>-c
-</dt>
-<dd></dd>
-<dd>This option is provided for backwards-compatibility only. On
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies the username to use when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c
+<br>
+<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.
-</dd>
-<dt>-d destination
-</dt>
-<dd></dd>
-<dd>Prints files to the named printer.
-</dd>
-<dt>-h hostname[:port]
-</dt>
-<dd></dd>
-<dd>Chooses an alternate server.
-</dd>
-<dt>-i job-id
-</dt>
-<dd></dd>
-<dd>Specifies an existing job to modify.
-</dd>
-<dt>-m
-</dt>
-<dd></dd>
-<dd>Sends an email when the job is completed.
-</dd>
-<dt>-n copies
-</dt>
-<dd></dd>
-<dd>Sets the number of copies to print from 1 to 100.
-</dd>
-<dt>-o "name=value [name=value ...]"
-</dt>
-<dd></dd>
-<dd>Sets one or more job options.
-</dd>
-<dt>-q priority
-</dt>
-<dd></dd>
-<dd>Sets the job priority from 1 (lowest) to 100 (highest). The
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d destination
+<br>
+<br>
+Prints files to the named printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h hostname[:port]
+<br>
+<br>
+Chooses an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-i job-id
+<br>
+<br>
+Specifies an existing job to modify.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-m
+<br>
+<br>
+Sends an email when the job is completed.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-n copies
+<br>
+<br>
+Sets the number of copies to print from 1 to 100.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o "name=value [name=value ...]"
+<br>
+<br>
+Sets one or more job options.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-q priority
+<br>
+<br>
+Sets the job priority from 1 (lowest) to 100 (highest). The
default priority is 50.
-</dd>
-<dt>-s
-</dt>
-<dd></dd>
-<dd>Do not report the resulting job IDs (silent mode.)
-</dd>
-<dt>-t "name"
-</dt>
-<dd></dd>
-<dd>Sets the job name.
-</dd>
-<dt>-H hh:mm
-</dt>
-<dd></dd>
-<dt>-H hold
-</dt>
-<dd></dd>
-<dt>-H immediate
-</dt>
-<dd></dd>
-<dt>-H restart
-</dt>
-<dd></dd>
-<dt>-H resume
-</dt>
-<dd></dd>
-<dd>Specifies when the job should be printed. A value of <i>immediate</i> will print
+<p style="margin-left: 5.0em; text-indent: -5.0em">-s
+<br>
+<br>
+Do not report the resulting job IDs (silent mode.)
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t "name"
+<br>
+<br>
+Sets the job name.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H hh:mm
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H hold
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H immediate
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H restart
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H resume
+<br>
+<br>
+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.
-</dd>
-<dt>-P page-list
-</dt>
-<dd></dd>
-<dd>Specifies which pages to print in the document. The list can
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P page-list
+<br>
+<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.
-</dd>
-</dl>
<h2 class="title"><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h2>
Aside from the printer-specific options reported by the
-<a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command, the following generic options are
+<i>lpoptions(1)</i> command, the following generic options are
available:
-<dl>
-<dt>-o media=size
-</dt>
-<dd></dd>
-<dd>Sets the page size to <i>size</i>. Most printers support at least
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o media=size
+<br>
+<br>
+Sets the page size to <i>size</i>. Most printers support at least
the size names "a4", "letter", and "legal".
-</dd>
-<dt>-o landscape
-</dt>
-<dd></dd>
-<dt>-o orientation-requested=4
-</dt>
-<dd></dd>
-<dd>Prints the job in landscape (rotated 90 degrees).
-</dd>
-<dt>-o sides=one-sided
-</dt>
-<dd></dd>
-<dt>-o sides=two-sided-long-edge
-</dt>
-<dd></dd>
-<dt>-o sides=two-sided-short-edge
-</dt>
-<dd></dd>
-<dd>Prints on one or two sides of the paper. The value
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o landscape
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o orientation-requested=4
+<br>
+<br>
+Prints the job in landscape (rotated 90 degrees).
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o sides=one-sided
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o sides=two-sided-long-edge
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o sides=two-sided-short-edge
+<br>
+<br>
+Prints on one or two sides of the paper. The value
"two-sided-long-edge" is normally used when printing portrait
(unrotated) pages, while "two-sided-short-edge" is used for
landscape pages.
-</dd>
-<dt>-o fit-to-page
-</dt>
-<dd></dd>
-<dd>Scales the print file to fit on the page.
-</dd>
-<dt>-o number-up=2
-</dt>
-<dd></dd>
-<dt>-o number-up=4
-</dt>
-<dd></dd>
-<dt>-o number-up=6
-</dt>
-<dd></dd>
-<dt>-o number-up=9
-</dt>
-<dd></dd>
-<dt>-o number-up=16
-</dt>
-<dd></dd>
-<dd>Prints multiple document pages on each output page.
-</dd>
-<dt>-o cpi=N
-</dt>
-<dd></dd>
-<dd>Sets the number of characters per inch to use when printing a
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o fit-to-page
+<br>
+<br>
+Scales the print file to fit on the page.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o number-up=2
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o number-up=4
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o number-up=6
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o number-up=9
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o number-up=16
+<br>
+<br>
+Prints multiple document pages on each output page.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o cpi=N
+<br>
+<br>
+Sets the number of characters per inch to use when printing a
text file. The default is 10.
-</dd>
-<dt>-o lpi=N
-</dt>
-<dd></dd>
-<dd>Sets the number of lines per inch to use when printing a text
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o lpi=N
+<br>
+<br>
+Sets the number of lines per inch to use when printing a text
file. The default is 6.
-</dd>
-<dt>-o page-bottom=N
-</dt>
-<dd></dd>
-<dt>-o page-left=N
-</dt>
-<dd></dd>
-<dt>-o page-right=N
-</dt>
-<dd></dd>
-<dt>-o page-top=N
-</dt>
-<dd></dd>
-<dd>Sets the page margins when printing text files. The values are in
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o page-bottom=N
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o page-left=N
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o page-right=N
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o page-top=N
+<br>
+<br>
+Sets the page margins when printing text files. The values are in
points - there are 72 points to the inch.
-</dd>
-</dl>
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
Print a double-sided legal document to a printer called "foo":
<pre>
100 is highest priority) instead of the Solaris values (0-39, 0
is highest priority).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpmove.html?TOPIC=Man+Pages'>lpmove(8)</a>, <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a>,
-<a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>lpadmin(8)</i>, <i>lpmove(8)</i>, <i>lpoptions(1)</i>,
+<i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [-U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] -d
-<i>destination
-</i><br>
-<b>lpadmin
-</b>[ -E ] [-U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] -p
-<i>destination
-</i>[ -R
-<i>name-default
-</i>]
-<i>option(s)
-</i><br>
-<b>lpadmin
-</b>[ -E ] [-U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] -x
-<i>destination
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>lpadmin</b>
+[ -E ] [-U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] -d
+<i>destination</i>
+<br>
+<b>lpadmin</b>
+[ -E ] [-U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] -p
+<i>destination</i>
+[ -R
+<i>name-default</i>
+]
+<i>option(s)</i>
+<br>
+<b>lpadmin</b>
+[ -E ] [-U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] -x
+<i>destination</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpadmin</i> configures printer and class queues provided by
CUPS. It can also be used to set the server default printer or
class.
the server.
<p>The first form of the command (<i>-d</i>) sets the default printer
or class to <i>destination</i>. Subsequent print jobs submitted
-via the <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> or <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> commands will use this
+via the <i>lp(1)</i> or <i>lpr(1)</i> commands will use this
destination unless the user specifies otherwise with the
-<a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command.
+<i>lpoptions(1)</i> 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
<h2 class="title"><a name="CONFIGURATION_OPTIONS">Configuration Options</a></h2>
The following options are recognized when configuring a printer
queue:
-<dl>
-<dt>-c class
-</dt>
-<dd></dd>
-<dd>Adds the named <i>printer</i> to <i>class</i>. If <i>class</i> does
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c class
+<br>
+<br>
+Adds the named <i>printer</i> to <i>class</i>. If <i>class</i> does
not exist it is created automatically.
-</dd>
-<dt>-i interface
-</dt>
-<dd></dd>
-<dd>Sets a System V style interface script for the printer. This
+<p style="margin-left: 5.0em; text-indent: -5.0em">-i interface
+<br>
+<br>
+Sets a System V style interface script for the printer. This
option cannot be specified with the <i>-P</i> option (PPD file)
and is intended for providing support for legacy printer drivers.
-</dd>
-<dt>-m model
-</dt>
-<dd></dd>
-<dd>Sets a standard System V interface script or PPD file for the printer from the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-m model
+<br>
+<br>
+Sets a standard System V interface script or 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'>lpinfo(8)</a> command to get a list of supported models.
-</dd>
-<dt>-o cupsIPPSupplies=true
-</dt>
-<dd></dd>
-<dt>-o cupsIPPSupplies=false
-</dt>
-<dd></dd>
-<dd>Specifies whether IPP supply level values should be reported.
-</dd>
-<dt>-o cupsSNMPSupplies=true
-</dt>
-<dd></dd>
-<dt>-o cupsSNMPSupplies=false
-</dt>
-<dd></dd>
-<dd>Specifies whether SNMP supply level (RFC 3805) values should be reported.
-</dd>
-<dt>-o job-k-limit=value
-</dt>
-<dd></dd>
-<dd>Sets the kilobyte limit for per-user quotas. The value is an
+option with the <i>lpinfo(8)</i> command to get a list of supported models.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsIPPSupplies=true
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsIPPSupplies=false
+<br>
+<br>
+Specifies whether IPP supply level values should be reported.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsSNMPSupplies=true
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o cupsSNMPSupplies=false
+<br>
+<br>
+Specifies whether SNMP supply level (RFC 3805) values should be reported.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-k-limit=value
+<br>
+<br>
+Sets the kilobyte limit for per-user quotas. The value is an
integer number of kilobytes; one kilobyte is 1024 bytes.
-</dd>
-<dt>-o job-page-limit=value
-</dt>
-<dd></dd>
-<dd>Sets the page limit for per-user quotas. The value is the integer
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-page-limit=value
+<br>
+<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.
-</dd>
-<dt>-o job-quota-period=value
-</dt>
-<dd></dd>
-<dd>Sets the accounting period for per-user quotas. The value is an
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-quota-period=value
+<br>
+<br>
+Sets the accounting period for per-user quotas. The value is an
integer number of seconds; 86,400 seconds are in one day.
-</dd>
-<dt>-o job-sheets-default=banner
-</dt>
-<dd></dd>
-<dt>-o job-sheets-default=banner,banner
-</dt>
-<dd></dd>
-<dd>Sets the default banner page(s) to use for print jobs.
-</dd>
-<dt>-o name=value
-</dt>
-<dd></dd>
-<dd>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'>lpoptions(1)</a> command.
-</dd>
-<dt>-o name-default=value
-</dt>
-<dd></dd>
-<dd>Sets a default server-side option for the destination. Any print-time
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-sheets-default=banner
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o job-sheets-default=banner,banner
+<br>
+<br>
+Sets the default banner page(s) to use for print jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value
+<br>
+<br>
+Sets a PPD option for the printer. PPD options can be listed using the <i>-l</i>
+option with the <i>lpoptions(1)</i> command.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o name-default=value
+<br>
+<br>
+Sets a default server-side option for the destination. Any print-time
option can be defaulted, e.g. "-o cpi-default=17" to set the default
"cpi" option value to 17.
-</dd>
-<dt>-o port-monitor=name
-</dt>
-<dd></dd>
-<dd>Sets the binary communications program to use when printing,
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o port-monitor=name
+<br>
+<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.
-</dd>
-<dt>-o printer-error-policy=name
-</dt>
-<dd></dd>
-<dd>Sets the error policy to be used when the printer backend is
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-error-policy=name
+<br>
+<br>
+Sets the error policy to be used when the printer backend is
unable to send the job to the printer. The name must be one of
"abort-job", "retry-job", "retry-current-job", or "stop-printer". The default
error policy is "stop-printer" for printers and "retry-current-job" for
classes.
-</dd>
-<dt>-o printer-is-shared=true/false
-</dt>
-<dd></dd>
-<dd>Sets the destination to shared/published or unshared/unpublished.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-is-shared=true/false
+<br>
+<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
<b>cupsd.conf</b>, while unshared/unpublished destinations are not
announced. The default value is "true".
-</dd>
-<dt>-o printer-op-policy=name
-</dt>
-<dd></dd>
-<dd>Sets the IPP operation policy associated with the destination. The
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o printer-op-policy=name
+<br>
+<br>
+Sets the IPP operation policy associated with the destination. The
name must be defined in the <b>cupsd.conf</b> in a Policy section.
The default operation policy is "default".
-</dd>
-<dt>-R name-default
-</dt>
-<dd></dd>
-<dd>Deletes the named option from <i>printer</i>.
-</dd>
-<dt>-r class
-</dt>
-<dd></dd>
-<dd>Removes the named <i>printer</i> from <i>class</i>. If the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-R name-default
+<br>
+<br>
+Deletes the named option from <i>printer</i>.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r class
+<br>
+<br>
+Removes the named <i>printer</i> from <i>class</i>. If the
resulting class becomes empty it is removed.
-</dd>
-<dt>-u allow:user,user,@group
-</dt>
-<dd></dd>
-<dt>-u deny:user,user,@group
-</dt>
-<dd></dd>
-<dt>-u allow:all
-</dt>
-<dd></dd>
-<dt>-u deny:none
-</dt>
-<dd></dd>
-<dd>Sets user-level access control on a destination. Names starting with
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u allow:user,user,@group
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u deny:user,user,@group
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u allow:all
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u deny:none
+<br>
+<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.
-</dd>
-<dt>-v "device-uri"
-</dt>
-<dd></dd>
-<dd>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'>lpinfo(8)</a> command to get a list of supported device URIs
+<p style="margin-left: 5.0em; text-indent: -5.0em">-v "device-uri"
+<br>
+<br>
+Sets the <i>device-uri</i> attribute of the printer queue. Use the <i>-v</i>
+option with the <i>lpinfo(8)</i> command to get a list of supported device URIs
and schemes.
-</dd>
-<dt>-D "info"
-</dt>
-<dd></dd>
-<dd>Provides a textual description of the destination.
-</dd>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Enables the destination and accepts jobs; this is the same as running the
-<a href='man-cupsaccept.html?TOPIC=Man+Pages'>cupsaccept(8)</a> and <a href='man-cupsenable.html?TOPIC=Man+Pages'>cupsenable(8)</a> programs on the destination.
-</dd>
-<dt>-L "location"
-</dt>
-<dd></dd>
-<dd>Provides a textual location of the destination.
-</dd>
-<dt>-P ppd-file
-</dt>
-<dd></dd>
-<dd>Specifies a PostScript Printer Description file to use with the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-D "info"
+<br>
+<br>
+Provides a textual description of the destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Enables the destination and accepts jobs; this is the same as running the
+<i>cupsaccept(8)</i> and <i>cupsenable(8)</i> programs on the destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-L "location"
+<br>
+<br>
+Provides a textual location of the destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P ppd-file
+<br>
+<br>
+Specifies a PostScript Printer Description file to use with the
printer. If specified, this option overrides the <i>-i</i> option
(interface script).
-</dd>
-</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".
The CUPS version of <i>lpadmin</i> does not support all of the
System V or Solaris printing system configuration options.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cupsaccept.html?TOPIC=Man+Pages'>cupsaccept(8)</a>, <a href='man-cupsenable.html?TOPIC=Man+Pages'>cupsenable(8)</a>, <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a>,
-<a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a>,
+<i>cupsaccept(8)</i>, <i>cupsenable(8)</i>, <i>lpinfo(8)</i>,
+<i>lpoptions(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
lpc - line printer control program
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpc
-</b>[
-<i>command
-</i>[
-<i>parameter(s)
-</i>] ]
+<b>lpc</b>
+[
+<i>command</i>
+[
+<i>parameter(s)</i>
+] ]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpc</i> provides limited control over printer and class queues
provided by CUPS. It can also be used to query the state of
<h2 class="title"><a name="COMMANDS">Commands</a></h2>
The <i>lpc</i> program accepts a subset of commands accepted by
the Berkeley <i>lpc</i> program of the same name:
-<dl>
-<dt>exit
-</dt>
-<dd></dd>
-<dd>Exits the command interpreter.
-</dd>
-<dt>help [command]
-</dt>
-<dd></dd>
-<dt>? [command]
-</dt>
-<dd></dd>
-<dd>Displays a short help message.
-</dd>
-<dt>quit
-</dt>
-<dd></dd>
-<dd>Exits the command interpreter.
-</dd>
-<dt>status [queue]
-</dt>
-<dd></dd>
-<dd>Displays the status of one or more printer or class queues.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">exit
+<br>
+<br>
+Exits the command interpreter.
+<p style="margin-left: 5.0em; text-indent: -5.0em">help [command]
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">? [command]
+<br>
+<br>
+Displays a short help message.
+<p style="margin-left: 5.0em; text-indent: -5.0em">quit
+<br>
+<br>
+Exits the command interpreter.
+<p style="margin-left: 5.0em; text-indent: -5.0em">status [queue]
+<br>
+<br>
+Displays the status of one or more printer or class queues.
<h2 class="title"><a name="LIMITATIONS">Limitations</a></h2>
Since <i>lpc</i> is geared towards the Berkeley printing system,
it is impossible to use <i>lpc</i> 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'>lpadmin(8)</a> command or another
+you must use the <i>lpadmin(8)</i> command or another
CUPS-compatible client with that functionality.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
The CUPS version of <i>lpc</i> does not implement all of the
standard Berkeley or LPRng commands.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-cupsaccept.html?TOPIC=Man+Pages'>cupsaccept(8)</a>, <a href='man-cupsenable.html?TOPIC=Man+Pages'>cupsenable(8)</a>,
-<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>, <a href='man-lprm.html?TOPIC=Man+Pages'>lprm(1)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>cupsaccept(8)</i>, <i>cupsenable(8)</i>,
+<i>lp(1)</i>, <i>lpr(1)</i>, <i>lprm(1)</i>, <i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
lpinfo - show available devices or drivers
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpinfo
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -l ] [ --device-id
-<i>device-id-string
-</i>] [ --exclude-schemes
-<i>scheme-list
-</i>] [ --include-schemes
-<i>scheme-list
-</i>] [ --language
-<i>locale
-</i>] [ --make-and-model
-<i>name
-</i>] [ --product
-<i>name
-</i>] -m
-<br>
-<b>lpinfo
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -l ] [ --exclude-schemes
-<i>scheme-list
-</i>] [ --include-schemes
-<i>scheme-list
-</i>] [ --timeout
-<i>seconds
-</i>] -v
+<b>lpinfo</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -l ] [ --device-id
+<i>device-id-string</i>
+] [ --exclude-schemes
+<i>scheme-list</i>
+] [ --include-schemes
+<i>scheme-list</i>
+] [ --language
+<i>locale</i>
+] [ --make-and-model
+<i>name</i>
+] [ --product
+<i>name</i>
+] -m
+<br>
+<b>lpinfo</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -l ] [ --exclude-schemes
+<i>scheme-list</i>
+] [ --include-schemes
+<i>scheme-list</i>
+] [ --timeout
+<i>seconds</i>
+] -v
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpinfo</i> lists the available devices or drivers known to the
CUPS server. The first form (<i>-m</i>) lists the available
devices.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>lpinfo</i> accepts the following options:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Sets the username to use when connecting to the server.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Selects an alternate server.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>Shows a "long" listing of devices or drivers.
-</dd>
-<dt>--device-id device-id-string
-</dt>
-<dd></dd>
-<dd>Specifies the IEEE-1284 device ID to match when listing drivers with the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Sets the username to use when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Selects an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<br>
+Shows a "long" listing of devices or drivers.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--device-id device-id-string
+<br>
+<br>
+Specifies the IEEE-1284 device ID to match when listing drivers with the
<i>-m</i> option.
-</dd>
-<dt>--exclude-schemes scheme-list
-</dt>
-<dd></dd>
-<dd>Specifies a comma-separated list of device or PPD schemes that should be
+<p style="margin-left: 5.0em; text-indent: -5.0em">--exclude-schemes scheme-list
+<br>
+<br>
+Specifies a comma-separated list of device or PPD schemes that should be
excluded from the results. Static PPD files use the "file" scheme.
-</dd>
-<dt>--include-schemes scheme-list
-</dt>
-<dd></dd>
-<dd>Specifies a comma-separated list of device or PPD schemes that should be
+<p style="margin-left: 5.0em; text-indent: -5.0em">--include-schemes scheme-list
+<br>
+<br>
+Specifies a comma-separated list of device or PPD schemes that should be
included in the results. Static PPD files use the "file" scheme.
-</dd>
-<dt>--language locale
-</dt>
-<dd></dd>
-<dd>Specifies the language to match when listing drivers with the <i>-m</i> option.
-</dd>
-<dt>--make-and-model name
-</dt>
-<dd></dd>
-<dd>Specifies the make and model to match when listing drivers with the <i>-m</i>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--language locale
+<br>
+<br>
+Specifies the language to match when listing drivers with the <i>-m</i> option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--make-and-model name
+<br>
+<br>
+Specifies the make and model to match when listing drivers with the <i>-m</i>
option.
-</dd>
-<dt>--product name
-</dt>
-<dd></dd>
-<dd>Specifies the product to match when listing drivers with the <i>-m</i> option.
-</dd>
-<dt>--timeout seconds
-</dt>
-<dd></dd>
-<dd>Specifies the timeout when listing devices with the <i>-v</i> option.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">--product name
+<br>
+<br>
+Specifies the product to match when listing drivers with the <i>-m</i> option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">--timeout seconds
+<br>
+<br>
+Specifies the timeout when listing devices with the <i>-v</i> option.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
The <i>lpinfo</i> command is unique to CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>,
+<i>lpadmin(8)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -h
-<i>server[:port]
-</i>] [ -U
-<i>username
-</i>]
-<i>job destination
-</i><br>
-<b>lpmove
-</b>[ -E ] [ -h
-<i>server[:port]
-</i>] [ -U
-<i>username
-</i>]
-<i>source destination
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>lpmove</b>
+[ -E ] [ -h
+<i>server[:port]</i>
+] [ -U
+<i>username</i>
+]
+<i>job</i> <i>destination</i>
+<br>
+<b>lpmove</b>
+[ -E ] [ -h
+<i>server[:port]</i>
+] [ -U
+<i>username</i>
+]
+<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:
</pre>
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The <i>lpmove</i> command supports the following options:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate server.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Specifies an alternate server.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] -d
-<i>destination[/instance]
-</i>[ -o
-<i>option[=value]
-</i>] ... [ -o
-<i>option[=value]
-</i>]
-<br>
-<b>lpoptions
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -p
-<i>destination[/instance]
-</i>] -l
-<br>
-<b>lpoptions
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -o
-<i>option[=value]
-</i>] ... [ -o
-<i>option[=value]
-</i>] [ -p
-<i>destination[/instance]
-</i>] -r
-<i>option
-</i><br>
-<b>lpoptions
-</b>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] -x
-<i>destination[/instance]
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>lpoptions</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] -d
+<i>destination[/instance]</i>
+[ -o
+<i>option[=value]</i>
+] ... [ -o
+<i>option[=value]</i>
+]
+<br>
+<b>lpoptions</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -p
+<i>destination[/instance]</i>
+] -l
+<br>
+<b>lpoptions</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -o
+<i>option[=value]</i>
+] ... [ -o
+<i>option[=value]</i>
+] [ -p
+<i>destination[/instance]</i>
+] -r
+<i>option</i>
+<br>
+<b>lpoptions</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] -x
+<i>destination[/instance]</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpoptions</i> displays or sets printer options and defaults.
<i>lpoptions</i> shows the default printer options when run with no
arguments. Other options include:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Enables encryption when communicating with the CUPS server.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Uses an alternate username.
-</dd>
-<dt>-d destination[/instance]
-</dt>
-<dd></dd>
-<dd>Sets the user default printer to <i>destination</i>. If <i>instance</i>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Enables encryption when communicating with the CUPS server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Uses an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d destination[/instance]
+<br>
+<br>
+Sets the user default printer to <i>destination</i>. If <i>instance</i>
is supplied then that particular instance is used. This option
overrides the system default printer for the current user.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Uses an alternate server.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>Lists the printer specific options and their current settings.
-</dd>
-<dt>-o option[=value]
-</dt>
-<dd></dd>
-<dd>Specifies a new option for the named destination.
-</dd>
-<dt>-p destination[/instance]
-</dt>
-<dd></dd>
-<dd>Sets the destination and instance, if specified, for any options
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Uses an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<br>
+Lists the printer specific options and their current settings.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o option[=value]
+<br>
+<br>
+Specifies a new option for the named destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-p destination[/instance]
+<br>
+<br>
+Sets the destination and instance, if specified, for any options
that follow. If the named instance does not exist then it is
created.
-</dd>
-<dt>-r option
-</dt>
-<dd></dd>
-<dd>Removes the specified option for the named destination.
-</dd>
-<dt>-x destination[/instance]
-</dt>
-<dd></dd>
-<dd>Removes the options for the named destination and instance, if
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r option
+<br>
+<br>
+Removes the specified option for the named destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-x destination[/instance]
+<br>
+<br>
+Removes the options for the named destination and instance, if
specified. If the named instance does not exist then this does
nothing.
-</dd>
-</dl>
<p>If no options are specified using the <i>-o</i> option, then the
current options for the named printer are reported on the
standard output.
<p>Options set with the <i>lpoptions</i> command are used by the
-<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a> and <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a> commands when submitting jobs.
+<i>lp(1)</i> and <i>lpr(1)</i> commands when submitting jobs.
<h2 class="title"><a name="ROOT_ACCOUNT_OPTIONS">Root Account Options</a></h2>
When run by the root user, <i>lpoptions</i> gets and sets default
options and instances for <i>all users</i> in the
/etc/cups/lpoptions - system-wide defaults and instances
created by the root user.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpr(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
lppasswd - add, change, or delete digest passwords.
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lppasswd
-</b>[
-<i>username
-</i>]
+<b>lppasswd</b>
+[
+<i>username</i>
+]
<br>
-<b>lppasswd
-</b>-a [ -g
-<i>groupname
-</i>]
-<i>username
-</i><br>
-<b>lppasswd
-</b>-x
-<i>username
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>lppasswd</b>
+-a [ -g
+<i>groupname</i>
+]
+<i>username</i>
+<br>
+<b>lppasswd</b>
+-x
+<i>username</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lppasswd</i> adds, changes, or deletes passwords in the CUPS
digest password file, <i>passwd.md5</i>. When run by a normal
user, <i>lppasswd</i> will prompt for the old and new passwords.
file. Digest usernames do not have to match local UNIX usernames.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>lppasswd</i> supports the following options:
-<dl>
-<dt>-g groupname
-</dt>
-<dd></dd>
-<dd>Specifies a group other than the default system group.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-g groupname
+<br>
+<br>
+Specifies a group other than the default system group.
<h2 class="title"><a name="SECURITY_ISSUES">Security Issues</a></h2>
By default, the <i>lppasswd</i> program is not installed to allow ordinary
users to change their passwords. To enable this, the <i>lppasswd</i> command
paranoid system administrators may wish to use Basic authentication with
accounts managed by PAM instead.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
+<i>lp(1)</i>, <i>lpr(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -P
-<i>destination[/instance]
-</i>] [ -a ] [ -l ] [
-<i>+interval
-</i>]
+<b>lpq</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -P
+<i>destination[/instance]</i>
+] [ -a ] [ -l ] [
+<i>+interval</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpq</i> shows the current print queue status on the named
printer. Jobs queued on the default destination will be shown if
shown once every <i>interval</i> seconds.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>lpq</i> supports the following options:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-P destination[/instance]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate printer or class name.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username.
-</dd>
-<dt>-a
-</dt>
-<dd></dd>
-<dd>Reports jobs on all printers.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate server.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>Requests a more verbose (long) reporting format.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P destination[/instance]
+<br>
+<br>
+Specifies an alternate printer or class name.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-a
+<br>
+<br>
+Reports jobs on all printers.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Specifies an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<br>
+Requests a more verbose (long) reporting format.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>, <a href='man-lprm.html?TOPIC=Man+Pages'>lprm(1)</a>,
-<a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpr(1)</i>, <i>lprm(1)</i>,
+<i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
lpr - print files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>lpr
-</b>[ -E ] [ -H
-<i>server[:port]
-</i>] [ -U
-<i>username
-</i>] [ -P
-<i>destination[/instance]
-</i>] [ -#
-<i>num-copies
-</i>[ -h ] [ -l ] [ -m ] [ -o
-<i>option[=value]
-</i>] [ -p] [ -q ] [ -r ] [ -C/J/T
-<i>title
-</i>] [
-<i>file(s)
-</i>]
+<b>lpr</b>
+[ -E ] [ -H
+<i>server[:port]</i>
+] [ -U
+<i>username</i>
+] [ -P
+<i>destination[/instance]</i>
+] [ -#
+<i>num-copies</i>
+[ -h ] [ -l ] [ -m ] [ -o
+<i>option[=value]</i>
+] [ -p] [ -q ] [ -r ] [ -C/J/T
+<i>title</i>
+] [
+<i>file(s)</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpr</i> submits files for printing. Files named on the command
line are sent to the named printer (or the default destination if no
<h2 class="title"><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h2>
CUPS provides many ways to set the default destination. The "LPDEST" and
"PRINTER" environment variables are consulted first. If neither are set,
-the current default set using the <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command is used,
-followed by the default set using the <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a> command.
+the current default set using the <i>lpoptions(1)</i> command is used,
+followed by the default set using the <i>lpadmin(8)</i> command.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>lpr</i>:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-H server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate server.
-</dd>
-<dt>-C "name"
-</dt>
-<dd></dd>
-<dt>-J "name"
-</dt>
-<dd></dd>
-<dt>-T "name"
-</dt>
-<dd></dd>
-<dd>Sets the job name.
-</dd>
-<dt>-P destination[/instance]
-</dt>
-<dd></dd>
-<dd>Prints files to the named printer.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username.
-</dd>
-<dt>-# <i>copies</i>
-</dt>
-<dd></dd>
-<dd>Sets the number of copies to print from 1 to 100.
-</dd>
-<dt>-h
-</dt>
-<dd></dd>
-<dd>Disables banner printing. This option is equivalent to "-o
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H server[:port]
+<br>
+<br>
+Specifies an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-C "name"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-J "name"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-T "name"
+<br>
+<br>
+Sets the job name.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P destination[/instance]
+<br>
+<br>
+Prints files to the named printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-# <i>copies</i>
+<br>
+<br>
+Sets the number of copies to print from 1 to 100.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h
+<br>
+<br>
+Disables banner printing. This option is equivalent to "-o
job-sheets=none".
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>Specifies that the print file is already formatted for the
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<br>
+Specifies that the print file is already formatted for the
destination and should be sent without filtering. This option is
equivalent to "-o raw".
-</dd>
-<dt>-m
-</dt>
-<dd></dd>
-<dd>Send an email on job completion.
-</dd>
-<dt>-o option[=value]
-</dt>
-<dd></dd>
-<dd>Sets a job option.
-</dd>
-<dt>-p
-</dt>
-<dd></dd>
-<dd>Specifies that the print file should be formatted with a shaded
+<p style="margin-left: 5.0em; text-indent: -5.0em">-m
+<br>
+<br>
+Send an email on job completion.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o option[=value]
+<br>
+<br>
+Sets a job option.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-p
+<br>
+<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 "-o prettyprint" and is only useful when
printing text files.
-</dd>
-<dt>-q
-</dt>
-<dd></dd>
-<dd>Hold job for printing.
-</dd>
-<dt>-r
-</dt>
-<dd></dd>
-<dd>Specifies that the named print files should be deleted after
+<p style="margin-left: 5.0em; text-indent: -5.0em">-q
+<br>
+<br>
+Hold job for printing.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r
+<br>
+<br>
+Specifies that the named print files should be deleted after
printing them.
-</dd>
-</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options
are not supported by CUPS and produce a warning message if used.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a>,
-<a href='man-lpq.html?TOPIC=Man+Pages'>lpq(1)</a>, <a href='man-lprm.html?TOPIC=Man+Pages'>lprm(1)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpadmin(8)</i>, <i>lpoptions(1)</i>,
+<i>lpq(1)</i>, <i>lprm(1)</i>, <i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -U
-<i>username
-</i>] [ -h
-<i>server[:port]
-</i>] [ -P
-<i>destination[/instance]
-</i>] [ - ] [
-<i>job ID(s)
-</i>]
+<b>lprm</b>
+[ -E ] [ -U
+<i>username</i>
+] [ -h
+<i>server[:port]</i>
+] [ -P
+<i>destination[/instance]</i>
+] [ - ] [
+<i>job</i> <i>ID(s)</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lprm</i> cancels print jobs that have been queued for printing.
If no arguments are supplied, the current job on the default
all jobs.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The <i>lprm</i> command supports the following options:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-P destination[/instance]
-</dt>
-<dd></dd>
-<dd>Specifies the destination printer or class.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate server.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-P destination[/instance]
+<br>
+<br>
+Specifies the destination printer or class.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Specifies an alternate server.
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
The CUPS version of <i>lprm</i> is compatible with the standard
Berkeley <i>lprm</i> command.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpq.html?TOPIC=Man+Pages'>lpq(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
-<a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>, <i>lpq(1)</i>, <i>lpr(1)</i>,
+<i>lpstat(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[ -E ] [ -H ] [ -U
-<i>username
-</i>] [ -h
-<i>hostname[:port]
-</i>] [ -l ] [ -W
-<i>which-jobs
-</i>] [ -a [
-<i>destination(s)
-</i>] ] [ -c [
-<i>class(es)
-</i>] ] [ -d ] [ -o [
-<i>destination(s)
-</i>] ] [ -p [
-<i>printer(s)
-</i>] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [
-<i>user(s)
-</i>] ] [ -v [
-<i>printer(s)
-</i>] ]
+<b>lpstat</b>
+[ -E ] [ -H ] [ -U
+<i>username</i>
+] [ -h
+<i>hostname[:port]</i>
+] [ -l ] [ -W
+<i>which-jobs</i>
+] [ -a [
+<i>destination(s)</i>
+] ] [ -c [
+<i>class(es)</i>
+] ] [ -d ] [ -o [
+<i>destination(s)</i>
+] ] [ -p [
+<i>printer(s)</i>
+] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [
+<i>user(s)</i>
+] ] [ -v [
+<i>printer(s)</i>
+] ]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lpstat</i> displays status information about the current
classes, jobs, and printers. When run with no arguments,
<i>lpstat</i> will list jobs queued by the current user.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The <i>lpstat</i> command supports the following options:
-<dl>
-<dt>-E
-</dt>
-<dd></dd>
-<dd>Forces encryption when connecting to the server.
-</dd>
-<dt>-H
-</dt>
-<dd></dd>
-<dd>Shows the server hostname and port.
-</dd>
-<dt>-R
-</dt>
-<dd></dd>
-<dd>Shows the ranking of print jobs.
-</dd>
-<dt>-U username
-</dt>
-<dd></dd>
-<dd>Specifies an alternate username.
-</dd>
-<dt>-W which-jobs
-</dt>
-<dd></dd>
-<dd>Specifies which jobs to show, <i>completed</i> or
+<p style="margin-left: 5.0em; text-indent: -5.0em">-E
+<br>
+<br>
+Forces encryption when connecting to the server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-H
+<br>
+<br>
+Shows the server hostname and port.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-R
+<br>
+<br>
+Shows the ranking of print jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
+<br>
+<br>
+Specifies an alternate username.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-W which-jobs
+<br>
+<br>
+Specifies which jobs to show, <i>completed</i> or
<i>not-completed</i> (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.
-</dd>
-<dt>-a [printer(s)]
-</dt>
-<dd></dd>
-<dd>Shows the accepting state of printer queues. If no printers are
+<p style="margin-left: 5.0em; text-indent: -5.0em">-a [printer(s)]
+<br>
+<br>
+Shows the accepting state of printer queues. If no printers are
specified then all printers are listed.
-</dd>
-<dt>-c [class(es)]
-</dt>
-<dd></dd>
-<dd>Shows the printer classes and the printers that belong to them.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-c [class(es)]
+<br>
+<br>
+Shows the printer classes and the printers that belong to them.
If no classes are specified then all classes are listed.
-</dd>
-<dt>-d
-</dt>
-<dd></dd>
-<dd>Shows the current default destination.
-</dd>
-<dt>-h server[:port]
-</dt>
-<dd></dd>
-<dd>Specifies an alternate server.
-</dd>
-<dt>-l
-</dt>
-<dd></dd>
-<dd>Shows a long listing of printers, classes, or jobs.
-</dd>
-<dt>-o [destination(s)]
-</dt>
-<dd></dd>
-<dd>Shows the jobs queue on the specified destinations. If no destinations are
+<p style="margin-left: 5.0em; text-indent: -5.0em">-d
+<br>
+<br>
+Shows the current default destination.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
+<br>
+<br>
+Specifies an alternate server.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-l
+<br>
+<br>
+Shows a long listing of printers, classes, or jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-o [destination(s)]
+<br>
+<br>
+Shows the jobs queue on the specified destinations. If no destinations are
specified all jobs are shown.
-</dd>
-<dt>-p [printer(s)]
-</dt>
-<dd></dd>
-<dd>Shows the printers and whether or not they are enabled for printing. If
+<p style="margin-left: 5.0em; text-indent: -5.0em">-p [printer(s)]
+<br>
+<br>
+Shows the printers and whether or not they are enabled for printing. If
no printers are specified then all printers are listed.
-</dd>
-<dt>-r
-</dt>
-<dd></dd>
-<dd>Shows whether the CUPS server is running.
-</dd>
-<dt>-s
-</dt>
-<dd></dd>
-<dd>Shows a status summary, including the default destination, a
+<p style="margin-left: 5.0em; text-indent: -5.0em">-r
+<br>
+<br>
+Shows whether the CUPS server is running.
+<p style="margin-left: 5.0em; text-indent: -5.0em">-s
+<br>
+<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 "-d", "-c",
and "-v" options.
-</dd>
-<dt>-t
-</dt>
-<dd></dd>
-<dd>Shows all status information. This is equivalent to using the "-r",
+<p style="margin-left: 5.0em; text-indent: -5.0em">-t
+<br>
+<br>
+Shows all status information. This is equivalent to using the "-r",
"-d", "-c", "-v", "-a", "-p", and "-o" options.
-</dd>
-<dt>-u [user(s)]
-</dt>
-<dd></dd>
-<dd>Shows a list of print jobs queued by the specified users. If no users
+<p style="margin-left: 5.0em; text-indent: -5.0em">-u [user(s)]
+<br>
+<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.
-</dd>
-<dt>-v [printer(s)]
-</dt>
-<dd></dd>
-<dd>Shows the printers and what device they are attached to. If no printers
+<p style="margin-left: 5.0em; text-indent: -5.0em">-v [printer(s)]
+<br>
+<br>
+Shows the printers and what device they are attached to. If no printers
are specified then all printers are listed.
-</dd>
-</dl>
<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", and "#".
<p>The "-h", "-E", "-U", and "-W" options are unique to CUPS.
<p>The Solaris "-f", "-P", and "-S" options are silently ignored.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>,
+<i>cancel(1)</i>, <i>lp(1)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl>
-<dt>Cc <i>cc-address@domain.com</i>
-</dt>
-<dd></dd>
-<dd>Specifies an additional recipient for all email notifications.
-</dd>
-<dt>From <i>from-address@domain.com</i>
-</dt>
-<dd></dd>
-<dd>Specifies the sender of email notifications.
-</dd>
-<dt>Sendmail <i>sendmail command and options</i>
-</dt>
-<dd></dd>
-<dd>Specifies the sendmail command to use when sending email
+<p style="margin-left: 5.0em; text-indent: -5.0em">Cc <i>cc-address@domain.com</i>
+<br>
+<br>
+Specifies an additional recipient for all email notifications.
+<p style="margin-left: 5.0em; text-indent: -5.0em">From <i>from-address@domain.com</i>
+<br>
+<br>
+Specifies the sender of email notifications.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Sendmail <i>sendmail command and options</i>
+<br>
+<br>
+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 <i>mailto.conf</i> file. If multiple lines
are present, only the last one is used.
-</dd>
-<dt>SMTPServer <i>servername</i>
-</dt>
-<dd></dd>
-<dd>Specifies a SMTP server to send email notifications to. Only one
+<p style="margin-left: 5.0em; text-indent: -5.0em">SMTPServer <i>servername</i>
+<br>
+<br>
+Specifies a SMTP server to send email notifications to. Only one
<i>Sendmail</i> or <i>SMTPServer</i> line may be present in the
<i>mailto.conf</i> file. If multiple lines are present, only the
last one is used.
-</dd>
-<dt>Subject <i>subject-prefix</i>
-</dt>
-<dd></dd>
-<dd>Specifies a prefix string for the subject line of an email notification.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Subject <i>subject-prefix</i>
+<br>
+<br>
+Specifies a prefix string for the subject line of an email notification.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>mime.convs(5)</i>, <i>mime.types(5)</i>, <i>printers.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
application/postscript application/vnd.cups-raster 50 pstoraster
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>mime.types(5)</i>, <i>printers.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="RULES">Rules</a></h2>
Rules take two forms - a filename extension by itself and functions with test
values inside parenthesis. The following functions are available:
-<dl>
-<dt>match("pattern")
-</dt>
-<dd></dd>
-<dd>Pattern match on filename
-</dd>
-<dt>ascii(offset,length)
-</dt>
-<dd></dd>
-<dd>True if bytes are valid printable ASCII (CR, NL, TAB, BS, 32-126)
-</dd>
-<dt>printable(offset,length)
-</dt>
-<dd></dd>
-<dd>True if bytes are printable 8-bit chars (CR, NL, TAB, BS, 32-126, 128-254)
-</dd>
-<dt>priority(number)
-</dt>
-<dd></dd>
-<dd>Specifies the relative priority of this MIME type. The default priority is 100.
+<p style="margin-left: 5.0em; text-indent: -5.0em">match("pattern")
+<br>
+<br>
+Pattern match on filename
+<p style="margin-left: 5.0em; text-indent: -5.0em">ascii(offset,length)
+<br>
+<br>
+True if bytes are valid printable ASCII (CR, NL, TAB, BS, 32-126)
+<p style="margin-left: 5.0em; text-indent: -5.0em">printable(offset,length)
+<br>
+<br>
+True if bytes are printable 8-bit chars (CR, NL, TAB, BS, 32-126, 128-254)
+<p style="margin-left: 5.0em; text-indent: -5.0em">priority(number)
+<br>
+<br>
+Specifies the relative priority of this MIME type. The default priority is 100.
Larger values have higher priority while smaller values have lower priority.
-</dd>
-<dt>string(offset,"string")
-</dt>
-<dd></dd>
-<dd>True if bytes are identical to string
-</dd>
-<dt>istring(offset,"string")
-</dt>
-<dd></dd>
-<dd>True if a case-insensitive comparison of the bytes is identical
-</dd>
-<dt>char(offset,value)
-</dt>
-<dd></dd>
-<dd>True if byte is identical
-</dd>
-<dt>short(offset,value)
-</dt>
-<dd></dd>
-<dd>True if 16-bit integer is identical
-</dd>
-<dt>int(offset,value)
-</dt>
-<dd></dd>
-<dd>True if 32-bit integer is identical
-</dd>
-<dt>locale("string")
-</dt>
-<dd></dd>
-<dd>True if current locale matches string
-</dd>
-<dt>contains(offset,range,"string")
-</dt>
-<dd></dd>
-<dd>True if the range contains the string
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em">string(offset,"string")
+<br>
+<br>
+True if bytes are identical to string
+<p style="margin-left: 5.0em; text-indent: -5.0em">istring(offset,"string")
+<br>
+<br>
+True if a case-insensitive comparison of the bytes is identical
+<p style="margin-left: 5.0em; text-indent: -5.0em">char(offset,value)
+<br>
+<br>
+True if byte is identical
+<p style="margin-left: 5.0em; text-indent: -5.0em">short(offset,value)
+<br>
+<br>
+True if 16-bit integer is identical
+<p style="margin-left: 5.0em; text-indent: -5.0em">int(offset,value)
+<br>
+<br>
+True if 32-bit integer is identical
+<p style="margin-left: 5.0em; text-indent: -5.0em">locale("string")
+<br>
+<br>
+True if current locale matches string
+<p style="margin-left: 5.0em; text-indent: -5.0em">contains(offset,range,"string")
+<br>
+<br>
+True if the range contains the string
<h2 class="title"><a name="STRING_CONSTANTS">String Constants</a></h2>
String constants can be specified inside quotes ("") for strings
containing whitespace and angle brackets (<>) for hexadecimal
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="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-printers.conf.html?TOPIC=Man+Pages'>printers.conf(5)</a>,
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>mime.convs(5)</i>, <i>printers.conf(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>[
-<i>user-data
-</i>]
+<b>notifier</b>
+<i>recipient</i>
+[
+<i>user-data</i>
+]
<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. Each notifier delivers one or more IPP
Messages sent to stderr are generally logged to the current <i>ErrorLog</i>.
Each line begins with a standard prefix:
-<dl>
-<dt>ALERT: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">ALERT: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "alert" log level.
-</dd>
-<dt>CRIT: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">CRIT: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "critical" log level.
-</dd>
-<dt>DEBUG: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEBUG: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "debug" log level.
-</dd>
-<dt>DEBUG2: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">DEBUG2: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "debug2" log level.
-</dd>
-<dt>EMERG: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">EMERG: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "emergency" log level.
-</dd>
-<dt>ERROR: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">ERROR: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "error" log level.
-</dd>
-<dt>INFO: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute. If the current <i>LogLevel</i>
+<p style="margin-left: 5.0em; text-indent: -5.0em">INFO: message
+<br>
+<br>
+Sets the printer-state-message attribute. If the current <i>LogLevel</i>
is set to "debug2", also adds the specified message to the
current <i>ErrorLog</i> using the "info" log level.
-</dd>
-<dt>NOTICE: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">NOTICE: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "notice" log level.
-</dd>
-<dt>WARNING: message
-</dt>
-<dd></dd>
-<dd>Sets the printer-state-message attribute and adds the specified
+<p style="margin-left: 5.0em; text-indent: -5.0em">WARNING: message
+<br>
+<br>
+Sets the printer-state-message attribute and adds the specified
message to the current <i>ErrorLog</i> using the "warning" log level.
-</dd>
-</dl>
<h2 class="title"><a name="ENVIRONMENT_VARIABLES">Environment Variables</a></h2>
The following environment variables are defined by the CUPS server when
executing the notifier:
-<dl>
-<dt>CHARSET
-</dt>
-<dd></dd>
-<dd>The default text character set, typically utf-8.
-
-</dd>
-<dt>CUPS_CACHEDIR
-</dt>
-<dd></dd>
-<dd>The directory for semi-persistent cache files can be found.
-
-</dd>
-<dt>CUPS_DATADIR
-</dt>
-<dd></dd>
-<dd>The directory where data files can be found.
-
-</dd>
-<dt>CUPS_FILETYPE
-</dt>
-<dd></dd>
-<dd>The type of file being printed: "job-sheet" for a banner page and "document"
+<p style="margin-left: 5.0em; text-indent: -5.0em">CHARSET
+<br>
+<br>
+The default text character set, typically utf-8.
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_CACHEDIR
+<br>
+<br>
+The directory for semi-persistent cache files can be found.
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_DATADIR
+<br>
+<br>
+The directory where data files can be found.
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_FILETYPE
+<br>
+<br>
+The type of file being printed: "job-sheet" for a banner page and "document"
for a regular print file.
-</dd>
-<dt>CUPS_SERVERROOT
-</dt>
-<dd></dd>
-<dd>The root directory of the server.
-
-</dd>
-<dt>LANG
-</dt>
-<dd></dd>
-<dd>The default language locale (typically C or en).
-
-</dd>
-<dt>PATH
-</dt>
-<dd></dd>
-<dd>The standard execution path for external programs that may be run by
+<p style="margin-left: 5.0em; text-indent: -5.0em">CUPS_SERVERROOT
+<br>
+<br>
+The root directory of the server.
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">LANG
+<br>
+<br>
+The default language locale (typically C or en).
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">PATH
+<br>
+<br>
+The standard execution path for external programs that may be run by
the filter.
-</dd>
-<dt>SOFTWARE
-</dt>
-<dd></dd>
-<dd>The name and version number of the server (typically CUPS/1.2).
-
-</dd>
-<dt>TZ
-</dt>
-<dd></dd>
-<dd>The timezone of the server.
-
-</dd>
-<dt>USER
-</dt>
-<dd></dd>
-<dd>The user executing the filter, typically "lp"; consult the <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>
+<p style="margin-left: 5.0em; text-indent: -5.0em">SOFTWARE
+<br>
+<br>
+The name and version number of the server (typically CUPS/1.2).
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">TZ
+<br>
+<br>
+The timezone of the server.
+
+<p style="margin-left: 5.0em; text-indent: -5.0em">USER
+<br>
+<br>
+The user executing the filter, typically "lp"; consult the <i>cupsd.conf(5)</i>
file for the current setting.
-</dd>
-</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-backend.html?TOPIC=Man+Pages'>backend(7)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a>,
+<i>backend(7)</i>, <i>cupsd(8)</i>, <i>filter(7)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
ppdc - cups ppd compiler
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdc
-</b>[ -D
-<i>name[=value]
-</i>] [ -I
-<i>include-directory
-</i>] [ -c
-<i>message-catalog
-</i>] [ -d
-<i>output-directory
-</i>] [ -l
-<i>language(s)
-</i>] [-m] [-t] [ -v ] [ -z ] [ --cr ] [ --crlf ] [ --lf ]
-<i>source-file
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>ppdc</b>
+[ -D
+<i>name[=value]</i>
+] [ -I
+<i>include-directory</i>
+] [ -c
+<i>message-catalog</i>
+] [ -d
+<i>output-directory</i>
+] [ -l
+<i>language(s)</i>
+] [-m] [-t] [ -v ] [ -z ] [ --cr ] [ --crlf ] [ --lf ]
+<i>source-file</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ppdc</i> 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="SEE_ALSO">See Also</a></h2>
ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1), ppdcfile(5)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<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>
-<dt><b>#define</b> name value
-</dt>
-<dd></dd>
-<dt><b>#elif</b> {name | value}
-</dt>
-<dd></dd>
-<dt><b>#else</b>
-</dt>
-<dd></dd>
-<dt><b>#endif</b>
-</dt>
-<dd></dd>
-<dt><b>#font</b> name encoding "version" charset status
-</dt>
-<dd></dd>
-<dt><b>#if</b> {name | value}
-</dt>
-<dd></dd>
-<dt><b>#include</b> <filename>
-</dt>
-<dd></dd>
-<dt><b>#include</b> "filename"
-</dt>
-<dd></dd>
-<dt><b>#media</b> name width length
-</dt>
-<dd></dd>
-<dt><b>#media</b> "name/text" width length
-</dt>
-<dd></dd>
-<dt><b>#po</b> locale "filename.po"
-</dt>
-<dd></dd>
-<dt><b>Attribute</b> name "" value
-</dt>
-<dd></dd>
-<dt><b>Attribute</b> name keyword value
-</dt>
-<dd></dd>
-<dt><b>Attribute</b> name "keyword/text" value
-</dt>
-<dd></dd>
-<dt><b>Choice</b> name "code"
-</dt>
-<dd></dd>
-<dt><b>Choice</b> "name/text" "code"
-</dt>
-<dd></dd>
-<dt><b>ColorDevice</b> boolean-value
-</dt>
-<dd></dd>
-<dt><b>ColorModel</b> name colorspace colororder compression
-</dt>
-<dd></dd>
-<dt><b>ColorModel</b> "name/text" colorspace colororder compression
-</dt>
-<dd></dd>
-<dt><b>ColorProfile</b> resolution/mediatype gamma density matrix
-</dt>
-<dd></dd>
-<dt><b>Copyright</b> "text"
-</dt>
-<dd></dd>
-<dt><b>CustomMedia</b> name width length left bottom right top "size-code" "region-code"
-</dt>
-<dd></dd>
-<dt><b>CustomMedia</b> "name/text" width length left bottom right top "size-code" "region-code"
-</dt>
-<dd></dd>
-<dt><b>Cutter</b> boolean-value
-</dt>
-<dd></dd>
-<dt><b>Darkness</b> temperature name
-</dt>
-<dd></dd>
-<dt><b>Darkness</b> temperature "name/text"
-</dt>
-<dd></dd>
-<dt><b>DriverType</b> type
-</dt>
-<dd></dd>
-<dt><b>Duplex</b> type
-</dt>
-<dd></dd>
-<dt><b>Filter</b> mime-type cost program
-</dt>
-<dd></dd>
-<dt><b>Finishing</b> name
-</dt>
-<dd></dd>
-<dt><b>Finishing</b> "name/text"
-</dt>
-<dd></dd>
-<dt><b>Font</b> *
-</dt>
-<dd></dd>
-<dt><b>Font</b> name encoding "version" charset status
-</dt>
-<dd></dd>
-<dt><b>Group</b> name
-</dt>
-<dd></dd>
-<dt><b>Group</b> "name/text"
-</dt>
-<dd></dd>
-<dt><b>HWMargins</b> left bottom right top
-</dt>
-<dd></dd>
-<dt><b>InputSlot</b> position name
-</dt>
-<dd></dd>
-<dt><b>InputSlot</b> position "name/text"
-</dt>
-<dd></dd>
-<dt><b>Installable</b> name
-</dt>
-<dd></dd>
-<dt><b>Installable</b> "name/text"
-</dt>
-<dd></dd>
-<dt><b>LocAttribute</b> name "keyword/text" value
-</dt>
-<dd></dd>
-<dt><b>ManualCopies</b> boolean-value
-</dt>
-<dd></dd>
-<dt><b>Manufacturer</b> "name"
-</dt>
-<dd></dd>
-<dt><b>MaxSize</b> width length
-</dt>
-<dd></dd>
-<dt><b>MediaSize</b> name
-</dt>
-<dd></dd>
-<dt><b>MediaType</b> type name
-</dt>
-<dd></dd>
-<dt><b>MediaType</b> type "name/text"
-</dt>
-<dd></dd>
-<dt><b>MinSize</b> width length
-</dt>
-<dd></dd>
-<dt><b>ModelName</b> "name"
-</dt>
-<dd></dd>
-<dt><b>ModelNumber</b> number
-</dt>
-<dd></dd>
-<dt><b>Option</b> name type section order
-</dt>
-<dd></dd>
-<dt><b>Option</b> "name/text" type section order
-</dt>
-<dd></dd>
-<dt><b>PCFileName</b> "filename.ppd"
-</dt>
-<dd></dd>
-<dt><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step name
-</dt>
-<dd></dd>
-<dt><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step "name/text"
-</dt>
-<dd></dd>
-<dt><b>SimpleColorProfile</b> resolution/mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust
-</dt>
-<dd></dd>
-<dt><b>Throughput</b> pages-per-minute
-</dt>
-<dd></dd>
-<dt><b>UIConstraints</b> "*Option1 *Option2"
-</dt>
-<dd></dd>
-<dt><b>UIConstraints</b> "*Option1 Choice1 *Option2"
-</dt>
-<dd></dd>
-<dt><b>UIConstraints</b> "*Option1 *Option2 Choice2"
-</dt>
-<dd></dd>
-<dt><b>UIConstraints</b> "*Option1 Choice1 *Option2 Choice2"
-</dt>
-<dd></dd>
-<dt><b>VariablePaperSize</b> boolean-value
-</dt>
-<dd></dd>
-<dt><b>Version</b> number
-</dt>
-<dd></dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#define</b> name value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#elif</b> {name | value}
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#else</b>
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#endif</b>
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#font</b> name encoding "version" charset status
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#if</b> {name | value}
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#include</b> <filename>
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#include</b> "filename"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#media</b> name width length
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#media</b> "name/text" width length
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#po</b> locale "filename.po"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name "" value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name keyword value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name "keyword/text" value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Choice</b> name "code"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Choice</b> "name/text" "code"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorDevice</b> boolean-value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorModel</b> name colorspace colororder compression
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorModel</b> "name/text" colorspace colororder compression
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorProfile</b> resolution/mediatype gamma density matrix
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Copyright</b> "text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>CustomMedia</b> name width length left bottom right top "size-code" "region-code"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>CustomMedia</b> "name/text" width length left bottom right top "size-code" "region-code"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Cutter</b> boolean-value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Darkness</b> temperature name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Darkness</b> temperature "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>DriverType</b> type
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Duplex</b> type
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Filter</b> mime-type cost program
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Finishing</b> name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Finishing</b> "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Font</b> *
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Font</b> name encoding "version" charset status
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Group</b> name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Group</b> "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>HWMargins</b> left bottom right top
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>InputSlot</b> position name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>InputSlot</b> position "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Installable</b> name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Installable</b> "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>LocAttribute</b> name "keyword/text" value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ManualCopies</b> boolean-value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Manufacturer</b> "name"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MaxSize</b> width length
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaSize</b> name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaType</b> type name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaType</b> type "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MinSize</b> width length
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ModelName</b> "name"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ModelNumber</b> number
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Option</b> name type section order
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Option</b> "name/text" type section order
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>PCFileName</b> "filename.ppd"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step name
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step "name/text"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>SimpleColorProfile</b> resolution/mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Throughput</b> pages-per-minute
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 *Option2"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 Choice1 *Option2"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 *Option2 Choice2"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 Choice1 *Option2 Choice2"
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>VariablePaperSize</b> boolean-value
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Version</b> number
+<br>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
ppdc(1), ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
ppdhtml - cups html summary generator
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdhtml
-</b>[ -D
-<i>name[=value]
-</i>] [ -I
-<i>include-directory
-</i>]
-<i>source-file
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>ppdhtml</b>
+[ -D
+<i>name[=value]</i>
+] [ -I
+<i>include-directory</i>
+]
+<i>source-file</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ppdhtml</i> reads a driver information file and produces a
HTML summary page that lists all of the drivers in a file and
the supported options.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
ppdc(1), ppdcfile(5), ppdi(1), ppdmerge(1), ppdpo(1)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
ppdi - import ppd files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdi
-</b>[ -I
-<i>include-directory
-</i>] [ -o
-<i>source-file
-</i>]
-<i>ppd-file
-</i>[
-<i>ppd-file2 ... ppd-fileN
-</i>]
+<b>ppdi</b>
+[ -I
+<i>include-directory</i>
+] [ -o
+<i>source-file</i>
+]
+<i>ppd-file</i>
+[
+<i>ppd-file2</i> <i>...</i> <i>ppd-fileN</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ppdi</i> 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
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
ppdc(1), ppdhtml(1), ppdmerge(1), ppdpo(1), ppdcfile(5)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
ppdmerge - merge ppd files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdmerge
-</b>[ -o
-<i>output-ppd-file
-</i>]
-<i>ppd-file
-</i><i>ppd-file2
-</i>[
-<i>... ppd-fileN
-</i>]
+<b>ppdmerge</b>
+[ -o
+<i>output-ppd-file</i>
+]
+<i>ppd-file</i>
+<i>ppd-file2</i>
+[
+<i>...</i> <i>ppd-fileN</i>
+]
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ppdmerge</i> merges two or more PPD files into a single, multi-language
PPD file.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
cupsprofile(1), ppdc(1), ppdhtml(1), ppdi(1), ppdpo(1), ppdcfile(5)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="NAME">Name</a></h2>
ppdpo - ppd message catalog generator
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>ppdpo
-</b>[ -D
-<i>name[=value]
-</i>] [ -I
-<i>include-directory
-</i>] [ -o
-<i>output-file
-</i>]
-<i>source-file
-<
/i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<b>ppdpo</b>
+[ -D
+<i>name[=value]</i>
+] [ -I
+<i>include-directory</i>
+] [ -o
+<i>output-file</i>
+]
+<i>source-file</i>
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>ppdpo</i> extracts UI strings from PPDC source files and updates either
a GNU gettext or OS X strings format message catalog source file for
translation.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
ppdc(1), ppdhtml(1), ppdi(1), ppdmerge(1), ppdcfile(5)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <i>printers.conf</i> file defines the local printers that are
available. It is normally located in the <i>/etc/cups</i> directory and
-is generated automatically by the <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a> program when printers
+is generated automatically by the <i>cupsd(8)</i> program when printers
are added or deleted.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl>
-<dt><Printer name> ... </Printer>
-</dt>
-<dd></dd>
-<dd>Defines a specific printer.
-</dd>
-<dt><DefaultPrinter name> ... </Printer>
-</dt>
-<dd></dd>
-<dd>Defines a default printer.
-</dd>
-<dt>Accepting Yes
-</dt>
-<dd></dd>
-<dt>Accepting No
-</dt>
-<dd></dd>
-<dd>Specifies whether the printer is accepting new jobs.
-</dd>
-<dt>AllowUser [ user @group ... ]
-</dt>
-<dd></dd>
-<dd>Allows specific users and groups to print to the printer.
-</dd>
-<dt>DenyUser [ user @group ... ]
-</dt>
-<dd></dd>
-<dd>Prevents specific users and groups from printing to the printer.
-</dd>
-<dt>DeviceURI uri
-</dt>
-<dd></dd>
-<dd>Specifies the device URI for a printer.
-</dd>
-<dt>ErrorPolicy abort-job
-</dt>
-<dd></dd>
-<dt>ErrorPolicy retry-current-job
-</dt>
-<dd></dd>
-<dt>ErrorPolicy retry-job
-</dt>
-<dd></dd>
-<dt>ErrorPolicy stop-printer
-</dt>
-<dd></dd>
-<dd>Specifies the error policy for the printer.
-</dd>
-<dt>Info text
-</dt>
-<dd></dd>
-<dd>Specifies human-readable text describing the printer.
-</dd>
-<dt>JobSheets banner banner
-</dt>
-<dd></dd>
-<dd>Specifies the banner pages to use for the printer.
-</dd>
-<dt>KLimit number
-</dt>
-<dd></dd>
-<dd>Specifies the job-k-limit value for the printer.
-</dd>
-<dt>Location text
-</dt>
-<dd></dd>
-<dd>Specifies human-readable text describing the location of the printer.
-</dd>
-<dt>OpPolicy name
-</dt>
-<dd></dd>
-<dd>Specifies the operation policy for the printer.
-</dd>
-<dt>PageLimit number
-</dt>
-<dd></dd>
-<dd>Specifies the job-page-limit value for the printer.
-</dd>
-<dt>PortMonitor monitor
-</dt>
-<dd></dd>
-<dd>Specifies the port monitor for a printer.
-</dd>
-<dt>QuotaPeriod seconds
-</dt>
-<dd></dd>
-<dd>Specifies the job-quota-period value for the printer.
-</dd>
-<dt>Shared Yes
-</dt>
-<dd></dd>
-<dt>Shared No
-</dt>
-<dd></dd>
-<dd>Specifies whether the printer is shared.
-</dd>
-<dt>State idle
-</dt>
-<dd></dd>
-<dt>State stopped
-</dt>
-<dd></dd>
-<dd>Specifies the initial state of the printer (Idle or Stopped)
-</dd>
-<dt>StateMessage text
-</dt>
-<dd></dd>
-<dd>Specifies the message associated with the state.
-</dd>
-<dt>StateTime seconds
-</dt>
-<dd></dd>
-<dd>Specifies the date/time associated with the state.
-</dd>
-</dl>
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Printer name> ... </Printer>
+<br>
+<br>
+Defines a specific printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em"><DefaultPrinter name> ... </Printer>
+<br>
+<br>
+Defines a default printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting No
+<br>
+<br>
+Specifies whether the printer is accepting new jobs.
+<p style="margin-left: 5.0em; text-indent: -5.0em">AllowUser [ user @group ... ]
+<br>
+<br>
+Allows specific users and groups to print to the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DenyUser [ user @group ... ]
+<br>
+<br>
+Prevents specific users and groups from printing to the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI uri
+<br>
+<br>
+Specifies the device URI for a printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy abort-job
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-current-job
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-job
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy stop-printer
+<br>
+<br>
+Specifies the error policy for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Info text
+<br>
+<br>
+Specifies human-readable text describing the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobSheets banner banner
+<br>
+<br>
+Specifies the banner pages to use for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">KLimit number
+<br>
+<br>
+Specifies the job-k-limit value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Location text
+<br>
+<br>
+Specifies human-readable text describing the location of the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">OpPolicy name
+<br>
+<br>
+Specifies the operation policy for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PageLimit number
+<br>
+<br>
+Specifies the job-page-limit value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PortMonitor monitor
+<br>
+<br>
+Specifies the port monitor for a printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">QuotaPeriod seconds
+<br>
+<br>
+Specifies the job-quota-period value for the printer.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Shared Yes
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">Shared No
+<br>
+<br>
+Specifies whether the printer is shared.
+<p style="margin-left: 5.0em; text-indent: -5.0em">State idle
+<br>
+<p style="margin-left: 5.0em; text-indent: -5.0em">State stopped
+<br>
+<br>
+Specifies the initial state of the printer (Idle or Stopped)
+<p style="margin-left: 5.0em; text-indent: -5.0em">StateMessage text
+<br>
+<br>
+Specifies the message associated with the state.
+<p style="margin-left: 5.0em; text-indent: -5.0em">StateTime seconds
+<br>
+<br>
+Specifies the date/time associated with the state.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>,
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>mime.convs(5)</i>, <i>mime.types(5)</i>,
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <i>subscriptions.conf</i> file defines the local subscriptions
that are active. It is normally located in the <i>/etc/cups</i>
-directory and is generated automatically by the <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>
+directory and is generated automatically by the <i>cupsd(8)</i>
program when subscriptions are created, renewed, or cancelled.
<p>Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<dl>
-<dt><Subscription NNN> ... </Subscription>
-</dt>
-<dd></dd>
-<dd>Defines a subscription.
-</dd>
-<dt>Events name [ ... name ]
-</dt>
-<dd></dd>
-<dd>Specifies the events that are subscribed.
-</dd>
-<dt>ExpirationTime unix-time
-</dt>
-<dd></dd>
-<dd>Specifies the expiration time of a subscription as a UNIX time
+<p style="margin-left: 5.0em; text-indent: -5.0em"><Subscription NNN> ... </Subscription>
+<br>
+<br>
+Defines a subscription.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Events name [ ... name ]
+<br>
+<br>
+Specifies the events that are subscribed.
+<p style="margin-left: 5.0em; text-indent: -5.0em">ExpirationTime unix-time
+<br>
+<br>
+Specifies the expiration time of a subscription as a UNIX time
value in seconds since January 1st, 1970.
-</dd>
-<dt>Interval seconds
-</dt>
-<dd></dd>
-<dd>Specifies the preferred time interval for event notifications in
+<p style="margin-left: 5.0em; text-indent: -5.0em">Interval seconds
+<br>
+<br>
+Specifies the preferred time interval for event notifications in
seconds.
-</dd>
-<dt>JobId job-id
-</dt>
-<dd></dd>
-<dd>Specifies the job ID associated with the subscription.
-</dd>
-<dt>LeaseDuration seconds
-</dt>
-<dd></dd>
-<dd>Specifies the number of seconds that the subscription is valid
+<p style="margin-left: 5.0em; text-indent: -5.0em">JobId job-id
+<br>
+<br>
+Specifies the job ID associated with the subscription.
+<p style="margin-left: 5.0em; text-indent: -5.0em">LeaseDuration seconds
+<br>
+<br>
+Specifies the number of seconds that the subscription is valid
for. If 0, the subscription does not expire.
-</dd>
-<dt>NextEventId number
-</dt>
-<dd></dd>
-<dd>Specifies the next notify-sequence-number to use for the
+<p style="margin-left: 5.0em; text-indent: -5.0em">NextEventId number
+<br>
+<br>
+Specifies the next notify-sequence-number to use for the
subscription.
-</dd>
-<dt>NextSubscriptionId number
-</dt>
-<dd></dd>
-<dd>Specifies the next subscription-id to use.
-</dd>
-<dt>Owner username
-</dt>
-<dd></dd>
-<dd>Specifies the user that owns the subscription.
-</dd>
-<dt>PrinterName printername
-</dt>
-<dd></dd>
-<dd>Specifies the printer or class associated with the subscription.
-</dd>
-<dt>Recipient uri
-</dt>
-<dd></dd>
-<dd>Specifies the notify-recipient-uri value for push-type notifications.
-</dd>
-<dt>UserData hex-escaped-data
-</dt>
-<dd></dd>
-<dd>Specifies user data to be included in event notifications. This
+<p style="margin-left: 5.0em; text-indent: -5.0em">NextSubscriptionId number
+<br>
+<br>
+Specifies the next subscription-id to use.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Owner username
+<br>
+<br>
+Specifies the user that owns the subscription.
+<p style="margin-left: 5.0em; text-indent: -5.0em">PrinterName printername
+<br>
+<br>
+Specifies the printer or class associated with the subscription.
+<p style="margin-left: 5.0em; text-indent: -5.0em">Recipient uri
+<br>
+<br>
+Specifies the notify-recipient-uri value for push-type notifications.
+<p style="margin-left: 5.0em; text-indent: -5.0em">UserData hex-escaped-data
+<br>
+<br>
+Specifies user data to be included in event notifications. This
is typically the "from" address in mailto: notifications.
-</dd>
-</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
-<a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>, printers.conf(5)
+<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
+<i>mime.convs(5)</i>, <i>mime.types(5)</i>, printers.conf(5)
<br>
-<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<a href="http://localhost:631/help">http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.
.\"
.\" "$Id$"
.\"
-.\" cupsd man page for CUPS.
+.\" cupsd man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
.\"
-.\" These coded instructions, statements, and computer programs are the
-.\" property of Apple Inc. and are protected by Federal copyright
-.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
-.\" which should have been included with this file. If this file is
-.\" file is missing or damaged, see the license at "http://www.cups.org/".
+.\" These coded instructions, statements, and computer programs are the
+.\" property of Apple Inc. and are protected by Federal copyright
+.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
+.\" which should have been included with this file. If this file is
+.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
-.TH cupsd 8 "CUPS" "8 July 2013" "Apple Inc."
+.TH cupsd 8 "CUPS" "4 March 2014" "Apple Inc."
.SH NAME
cupsd \- cups scheduler
.SH SYNOPSIS
.I config-file
] [ -f ] [ -F ] [ -h ] [ -l ] [ -t ]
.SH DESCRIPTION
-\fIcupsd\fR is the scheduler for CUPS. It implements a printing system based
-upon the Internet Printing Protocol, version 2.1. If no options are specified
-on the command-line then the default configuration file
-\fI/etc/cups/cupsd.conf\fR will be used.
+.B cupsd
+is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1. If no options are specified on the command-line then the default configuration file
+.I /etc/cups/cupsd.conf
+will be used.
.SH OPTIONS
.TP 5
-c config-file
-.br
Uses the named configuration file.
.TP 5
-f
-.br
-Run \fIcupsd\fR in the foreground; the default is to run in the
-background as a "daemon".
+Run
+.B cupsd
+in the foreground; the default is to run in the background as a "daemon".
.TP 5
-F
-.br
-Run \fIcupsd\fR in the foreground but detach the process from the
-controlling terminal and current directory. This is useful for
-running \fIcupsd\fR from \fIinit(8)\fR.
+Run
+.B cupsd
+in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
+.BR cupsd from init (8).
.TP 5
-h
-.br
Shows the program usage.
.TP 5
-l
-.br
-This option is passed to \fIcupsd\fR when it is run from
-\fIlaunchd(8)\fR.
+This option is passed to
+.B cupsd
+when it is run from
+.BR launchd (8).
.TP 5
-t
-.br
Test the configuration file for syntax errors.
.SH COMPATIBILITY
-\fIcupsd\fR implements all of the required IPP/2.1 attributes and
-operations. It also implements several CUPS-specific administration
-operations.
+.B cupsd
+implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administration operations.
.SH SEE ALSO
-\fIbackend(7)\fR, \fIclasses.conf(5)\fR, \fIcups-deviced(8)\fR,
-\fIcups-driverd(8)\fR, \fIcups-lpd(8)\fR, \fIcups-polld(8)\fR,
-\fIcupsd.conf(5)\fR, \fIfilter(7)\fR, \fIlaunchd(8)\fR,
-\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
-.br
+.BR backend (7), classes.conf (5), cups-deviced (8), cups-driverd (8), cups-lpd (8), cupsd.conf (5), filter (7), launchd (8), mime.convs (5), mime.types (5), printers.conf (5),
http://localhost:631/help
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
/*
* "$Id$"
*
- * Man page to HTML conversion program.
+ * Man page to HTML conversion program.
*
- * Copyright 2007-2010 by Apple Inc.
- * Copyright 2004-2006 by Easy Software Products.
+ * Copyright 2007-2010, 2014 by Apple Inc.
+ * Copyright 2004-2006 by Easy Software Products.
*
- * These coded instructions, statements, and computer programs are the
- * property of Apple Inc. and are protected by Federal copyright
- * law. Distribution and use rights are outlined in the file "LICENSE.txt"
- * which should have been included with this file. If this file is
- * file is missing or damaged, see the license at "http://www.cups.org/".
- *
- * Contents:
- *
- * main() - Convert a man page to HTML.
- * putc_entity() - Put a single character, using entities as needed.
- * strmove() - Move characters within a string.
+ * These coded instructions, statements, and computer programs are the
+ * property of Apple Inc. and are protected by Federal copyright
+ * law. Distribution and use rights are outlined in the file "LICENSE.txt"
+ * which should have been included with this file. If this file is
+ * file is missing or damaged, see the license at "http://www.cups.org/".
*/
/*
*/
#include <cups/string-private.h>
+#include <cups/array-private.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 putc_entity(int ch, FILE *fp);
+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);
*outfile; /* Output file */
char line[1024], /* Line from file */
*lineptr, /* Pointer into line */
- *endptr, /* Pointer to end of current */
- endchar, /* End character */
- *paren, /* Pointer to parenthesis */
name[1024]; /* Man page name */
- int section, /* Man page section */
- pre, /* Preformatted */
- font, /* Current font */
- blist, /* In a bullet list? */
- list, /* In a list? */
- linenum; /* Current line number */
- const char *post; /* Text to add after the current line */
- static const char /* Start/end tags for fonts */
- * const start_fonts[] = { "", "<b>", "<i>" },
- * const end_fonts[] = { "", "</b>", "</i>" };
+ int section = -1, /* Man page section */
+ pre = 0, /* Preformatted */
+ font = 0, /* Current font */
+ linenum = 0; /* Current line number */
+ const char *list = NULL; /* Current list, if any */
+ const char *post = NULL; /* Text to add after the current line */
+
/*
* Check arguments...
* Read from input and write the output...
*/
- fputs("<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" "
- "\"http://www.w3.org/TR/html4/loose.dtd\">\n"
+ 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);
- blist = 0;
- font = 0;
- list = 0;
- linenum = 0;
- pre = 0;
- post = NULL;
- section = -1;
-
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] == '.')
int first = 1;
fputs(end_fonts[font], outfile);
-
- if (blist)
- {
- fputs("</li>\n</ul>\n", outfile);
- blist = 0;
- }
+ font = 0;
if (list)
{
- if (list == 1)
- fputs("</dt>\n", outfile);
- else if (list)
- fputs("</dd>\n", outfile);
-
- fputs("</dl>\n", outfile);
- list = 0;
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
}
- line[strlen(line) - 1] = '\0'; /* Strip LF */
-
if (line[2] == 'H')
fputs("<h2 class=\"title\"><a name=\"", outfile);
else
fputs("<h3><a name=\"", outfile);
for (lineptr = line + 4; *lineptr; lineptr ++)
- if (*lineptr == '\"')
+ if (*lineptr == '\"')
continue;
- else if (*lineptr == ' ')
- putc_entity('_', outfile);
+ else if (isalnum(*lineptr & 255))
+ html_putc(*lineptr, outfile);
else
- putc_entity(*lineptr, outfile);
+ html_putc('_', outfile);
fputs("\">", outfile);
for (lineptr = line + 4; *lineptr; lineptr ++)
+ {
if (*lineptr == '\"')
continue;
else if (*lineptr == ' ')
{
- putc_entity(' ', outfile);
+ html_putc(' ', outfile);
first = 1;
}
else
{
if (first)
- putc_entity(*lineptr, outfile);
+ html_putc(*lineptr, outfile);
else
- putc_entity(tolower(*lineptr), outfile);
+ html_putc(tolower(*lineptr & 255), outfile);
first = 0;
}
+ }
if (line[2] == 'H')
- fprintf(outfile, "</a></h2>\n%s", start_fonts[font]);
+ fputs("</a></h2>\n", outfile);
else
- fprintf(outfile, "</a></h3>\n%s", start_fonts[font]);
+ fputs("</a></h3>\n", outfile);
}
- else if (!strncmp(line, ".LP", 3) || !strncmp(line, ".PP", 3))
+ else if (!strncmp(line, ".B ", 3))
{
/*
- * New paragraph...
+ * Grab bold text...
*/
fputs(end_fonts[font], outfile);
+ font = 0;
- if (blist)
- {
- fputs("</li>\n</ul>\n", outfile);
- blist = 0;
- }
+ html_alternate(line + 3, "b", "b", outfile);
+ }
+ else if (!strncmp(line, ".I ", 3))
+ {
+ /*
+ * Grab italic text...
+ */
- if (list)
- {
- if (list == 1)
- fputs("</dt>\n", outfile);
- else if (list)
- fputs("</dd>\n", outfile);
+ fputs(end_fonts[font], outfile);
+ font = 0;
- fputs("</dl>\n", outfile);
- list = 0;
- }
+ html_alternate(line + 3, "i", "i", outfile);
+ }
+ else if (!strncmp(line, ".BI ", 4))
+ {
+ /*
+ * Alternating bold and italic text...
+ */
- fputs("<p>", outfile);
+ fputs(end_fonts[font], outfile);
font = 0;
+
+ html_alternate(line + 4, "b", "i", outfile);
}
- else if (!strncmp(line, ".TP ", 4))
+ else if (!strncmp(line, ".BR ", 4))
{
/*
- * Grab list...
- */
+ * Alternating bold and roman (plain) text...
+ */
fputs(end_fonts[font], outfile);
+ font = 0;
- if (blist)
- {
- fputs("</li>\n</ul>\n", outfile);
- blist = 0;
- }
+ html_alternate(line + 4, "b", NULL, outfile);
+ }
+ else if (!strncmp(line, ".IB ", 4))
+ {
+ /*
+ * Alternating italic and bold text...
+ */
- if (!list)
- fputs("<dl>\n", outfile);
- else if (list == 1)
- fputs("</dt>\n", outfile);
- else if (list)
- fputs("</dd>\n", outfile);
+ fputs(end_fonts[font], outfile);
+ font = 0;
- fputs("<dt>", outfile);
- list = 1;
+ html_alternate(line + 4, "i", "b", outfile);
+ }
+ else if (!strncmp(line, ".IR ", 4))
+ {
+ /*
+ * Alternating italic and roman (plain) text...
+ */
+
+ fputs(end_fonts[font], outfile);
font = 0;
+
+ html_alternate(line + 4, "i", NULL, outfile);
}
- else if (!strncmp(line, ".br", 3))
+ else if (!strncmp(line, ".RB ", 4))
{
/*
- * Grab line break...
- */
+ * Alternating roman (plain) and bold text...
+ */
- if (list == 1)
- {
- fputs("</dt>\n<dd>", outfile);
- list = 2;
- }
- else if (list)
- fputs("</dd>\n<dd>", outfile);
- else
- fputs("<br>\n", outfile);
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ html_alternate(line + 4, NULL, "b", outfile);
}
- else if (!strncmp(line, ".de ", 4))
+ else if (!strncmp(line, ".RI ", 4))
{
/*
- * Define macro - ignore...
- */
+ * Alternating roman (plain) and italic text...
+ */
- while (fgets(line, sizeof(line), infile))
- {
- linenum ++;
+ fputs(end_fonts[font], outfile);
+ font = 0;
- if (!strncmp(line, "..", 2))
- break;
- }
+ html_alternate(line + 4, NULL, "i", outfile);
}
- else if (!strncmp(line, ".RS", 3))
+ else if (!strncmp(line, ".SB ", 4))
{
/*
- * Indent...
- */
+ * Alternating small and bold text...
+ */
+
+ fputs(end_fonts[font], outfile);
+ font = 0;
- fputs("<div style='margin-left: 3em;'>\n", outfile);
+ html_alternate(line + 4, "small", "b", outfile);
}
- else if (!strncmp(line, ".RE", 3))
+ else if (!strncmp(line, ".SM ", 4))
{
/*
- * Unindent...
- */
+ * Small text...
+ */
- fputs("</div>\n", outfile);
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ html_alternate(line + 4, "small", "small", outfile);
}
- 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))
+ else if (!strcmp(line, ".LP") || !strcmp(line, ".PP") || !strcmp(line, ".P"))
{
/*
- * Ignore unused commands...
+ * New paragraph...
*/
+
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ if (list)
+ {
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
+ }
+
+ fputs("<p>", outfile);
}
- else if (!strncmp(line, ".Vb", 3) || !strncmp(line, ".nf", 3))
+ else if (!strcmp(line, ".RS") || !strncmp(line, ".RS ", 4))
{
/*
- * Start preformatted...
+ * Indent...
*/
- pre = 1;
- fputs("<pre>\n", outfile);
+ float amount = 3.0; /* Indentation */
+
+ if (line[3])
+ amount = atof(line + 4);
+
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ if (list)
+ {
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
+ }
+
+ fprintf(outfile, "<div style=\"margin-left: %.1fem;\">\n", amount);
}
- else if (!strncmp(line, ".Ve", 3) || !strncmp(line, ".fi", 3))
+ else if (!strcmp(line, ".RE"))
{
/*
- * End preformatted...
+ * Unindent...
*/
- if (pre)
- {
- pre = 0;
- fputs("</pre>\n", outfile);
- }
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ fputs("</div>\n", outfile);
}
- else if (!strncmp(line, ".IP \\(bu", 8))
+ else if (!strcmp(line, ".HP") || !strncmp(line, ".HP ", 4) ||
+ !strcmp(line, ".TP") || !strncmp(line, ".TP ", 4))
{
/*
- * Bullet list...
+ * Hanging paragraph/tagged list...
+ *
+ * .HP i
+ * .TP i
*/
- if (blist)
- fputs("</li>\n", outfile);
- else
- {
- fputs("<ul>\n", outfile);
- blist = 1;
- }
+ float amount = 3.0; /* Indentation */
+
+ if (line[3])
+ amount = atof(line + 4);
- fputs("<li>", outfile);
+ 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 (line[1] == 'T')
+ post = "<br>\n";
}
else if (!strncmp(line, ".IP ", 4))
{
/*
* Indented paragraph...
+ *
+ * .IP x i
*/
- if (blist)
+ float amount = 3.0; /* 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))
{
- fputs("</li>\n</ul>\n", outfile);
- blist = 0;
- }
+ /*
+ * Bullet list...
+ */
- fputs("<p style='margin-left: 3em;'>", outfile);
+ newlist = "ul";
+ }
+ else if (isdigit(*lineptr & 255))
+ {
+ /*
+ * Numbered list...
+ */
- for (lineptr = line + 4; isspace(*lineptr); lineptr ++);
+ newlist = "ol";
+ }
+ else if (islower(*lineptr & 255))
+ {
+ /*
+ * Lowercase alpha list...
+ */
- if (*lineptr == '\"')
+ newlist = "ol";
+ newtype = "a";
+ }
+ else if (isupper(*lineptr & 255))
{
- strmove(line, lineptr + 1);
+ /*
+ * Lowercase alpha list...
+ */
+
+ newlist = "ol";
+ newtype = "A";
+ }
+
+ while (!isspace(*lineptr & 255))
+ lineptr ++;
+ while (isspace(*lineptr & 255))
+ lineptr ++;
+
+ if (isdigit(*lineptr & 255))
+ amount = atof(lineptr);
- if ((lineptr = strchr(line, '\"')) != NULL)
- *lineptr = '\0';
+ if (newlist && list && strcmp(newlist, list))
+ {
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
}
- else
- {
- strmove(line, lineptr);
- if ((lineptr = strchr(line, ' ')) != NULL)
- *lineptr = '\0';
+ 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);
+ }
+ 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))
+ {
+ /*
+ * Start preformatted...
+ */
+
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ if (list)
+ {
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
+ }
+
+ pre = 1;
+ fputs("<pre>\n", outfile);
+ }
+ else if (!strncmp(line, ".Ve", 3) || !strncmp(line, ".fi", 3))
+ {
/*
- * Process the text as if it was in-line...
+ * End preformatted...
*/
- post = "\n<br>\n<br>";
- goto process_text;
+ fputs(end_fonts[font], outfile);
+ font = 0;
+
+ if (pre)
+ {
+ pre = 0;
+ fputs("</pre>\n", outfile);
+ }
}
else if (!strncmp(line, ".\\}", 3))
{
*/
}
#endif /* 0 */
- else if (!strncmp(line, ".B ", 3))
- {
- /*
- * Grab bold text...
- */
-
- fprintf(outfile, "%s<b>%s</b>%s", end_fonts[font], line + 3,
- start_fonts[font]);
- }
- else if (!strncmp(line, ".I ", 3))
- {
- /*
- * Grab italic text...
- */
-
- fprintf(outfile, "%s<i>%s</i>%s", end_fonts[font], line + 3,
- start_fonts[font]);
- }
else if (strncmp(line, ".\\\"", 3))
{
/*
else if ((lineptr = strchr(line, '\n')) != NULL)
*lineptr = '\0';
- fprintf(stderr, "mantohtml: Unknown man page command \'%s\' on line %d!\n",
- line, linenum);
+ fprintf(stderr, "mantohtml: Unknown man page command \'%s\' on line %d.\n", line, linenum);
}
/*
* Skip continuation lines...
*/
- lineptr = line + strlen(line) - 2;
+ lineptr = line + strlen(line) - 1;
if (lineptr >= line && *lineptr == '\\')
{
while (fgets(line, sizeof(line), infile))
* Process man page text...
*/
-process_text:
-
- for (lineptr = line; *lineptr; lineptr ++)
- {
- if (!strncmp(lineptr, "http://", 7))
- {
- /*
- * Embed URL...
- */
-
- for (endptr = lineptr + 7;
- *endptr && !isspace(*endptr & 255);
- endptr ++);
-
- endchar = *endptr;
- *endptr = '\0';
-
- fprintf(outfile, "<a href='%s'>%s</a>", lineptr, lineptr);
- *endptr = endchar;
- lineptr = endptr - 1;
- }
- else if (!strncmp(lineptr, "\\fI", 3) &&
- (endptr = strstr(lineptr, "\\fR")) != NULL &&
- (paren = strchr(lineptr, '(')) != NULL &&
- paren < endptr)
- {
- /*
- * Link to man page?
- */
-
- char manfile[1024], /* Man page filename */
- manurl[1024]; /* Man page URL */
-
-
- /*
- * See if the man file is available locally...
- */
-
- lineptr += 3;
- endchar = *paren;
- *paren = '\0';
-
- snprintf(manfile, sizeof(manfile), "%s.man", lineptr);
- snprintf(manurl, sizeof(manurl), "man-%s.html?TOPIC=Man+Pages",
- lineptr);
-
- *paren = endchar;
- endchar = *endptr;
- *endptr = '\0';
-
- if (access(manfile, 0))
- {
- /*
- * Not a local man page, just do it italic...
- */
-
- fputs("<i>", outfile);
- while (*lineptr)
- putc_entity(*lineptr++, outfile);
- fputs("</i>", outfile);
- }
- else
- {
- /*
- * Local man page, do a link...
- */
-
- fprintf(outfile, "<a href='%s'>", manurl);
- while (*lineptr)
- putc_entity(*lineptr++, outfile);
- fputs("</a>", outfile);
- }
-
- *endptr = endchar;
- lineptr = endptr + 2;
- }
- else if (*lineptr == '\\')
- {
- lineptr ++;
- if (!*lineptr)
- break;
- else if (isdigit(lineptr[0]) && isdigit(lineptr[1]) &&
- isdigit(lineptr[2]))
- {
- fprintf(outfile, "&#%d;", ((lineptr[0] - '0') * 8 +
- lineptr[1] - '0') * 8 +
- lineptr[2] - '0');
- lineptr += 2;
- }
- else if (*lineptr == '&')
- continue;
- else if (*lineptr == 's')
- {
- while (lineptr[1] == '-' || isdigit(lineptr[1]))
- lineptr ++;
- }
- else if (*lineptr == '*')
- {
- lineptr += 2;
- }
- else if (*lineptr != 'f')
- putc_entity(*lineptr, outfile);
- else
- {
- lineptr ++;
- if (!*lineptr)
- break;
- else
- {
- fputs(end_fonts[font], outfile);
-
- switch (*lineptr)
- {
- default : /* Regular */
- font = 0;
- break;
- case 'B' : /* Bold */
- case 'b' :
- font = 1;
- break;
- case 'I' : /* Italic */
- case 'i' :
- font = 2;
- break;
- }
-
- fputs(start_fonts[font], outfile);
- }
- }
- }
- else
- putc_entity(*lineptr, outfile);
- }
+ html_fputs(line, &font, outfile);
+ putc('\n', outfile);
if (post)
{
fputs(post, outfile);
post = NULL;
}
-
- if (list == 1)
- {
- fputs("</dt>\n<dd>", outfile);
- list = 2;
- }
}
}
fprintf(outfile, "%s\n", end_fonts[font]);
-
- if (blist)
- {
- fputs("</li>\n</ul>\n", outfile);
- }
+ font = 0;
if (list)
{
- if (list == 1)
- fputs("</dt>\n", outfile);
- else if (list)
- fputs("</dd>\n", outfile);
-
- fputs("</dl>\n", outfile);
+ fprintf(outfile, "</%s>\n", list);
+ list = NULL;
}
fputs("</body>\n"
/*
- * 'putc_entity()' - Put a single character, using entities as needed.
+ * '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 == '(')
+ {
+ /*
+ * See if the man file is available locally...
+ */
+
+ char name[1024], /* Name */
+ manfile[1024], /* Man page filename */
+ manurl[1024]; /* Man page URL */
+
+ strlcpy(name, s, sizeof(name));
+ if ((size_t)(end - s) < sizeof(name))
+ name[end - s] = '\0';
+
+ snprintf(manfile, sizeof(manfile), "%s.man", name);
+ snprintf(manurl, sizeof(manurl), "man-%s.html?TOPIC=Man+Pages", name);
+
+ 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;
+ else 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 - i;
+
+ /*
+ * Skip trailing whitespace...
+ */
+
+ while (isspace(*s & 255))
+ s ++;
+
+ if (*s && *s != '(')
+ putc(' ', fp);
+ }
+
+ 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 == '[')
+ {
+ /*
+ * 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(*s++, fp);
+ }
+ }
+ else if (!strncmp(s, "http://", 7) || !strncmp(s, "https://", 8) || !strncmp(s, "ftp://", 6))
+ {
+ /*
+ * Embed URL...
+ */
+
+ const char *end = s + 6; /* End of URL */
+
+ while (*end && !isspace(*end & 255))
+ end ++;
+
+ fprintf(fp, "<a href=\"%*s\">%*s</a>", (int)(end - s), s, (int)(end - s), s);
+ s = end;
+ }
+ else
+ html_putc(*s++ & 255, fp);
+ }
+}
+
+
+/*
+ * 'html_putc()' - Put a single character, using entities as needed.
*/
static void
-putc_entity(int ch, /* I - Character */
- FILE *fp) /* I - File */
+html_putc(int ch, /* I - Character */
+ FILE *fp) /* I - File */
{
if (ch == '&')
fputs("&", fp);
projects / thirdparty / cups.git / commitdiff
