not used (Issue #674)
- Updated `cups_enum_dests()` timeout for listing available IPP printers
(Issue #751)
+- Updated default destination documentation (Issue #819)
- Updated `httpAddrConnect2()` to handle `POLLHUP` together with `POLLIN` or
`POLLOUT` (Issue #839)
- Updated the policies help document with the correct `Order` directive to deny
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>backend(7)</title>
</head>
<body>
</pre>
<h2 id="backend-7.description">Description</h2>
<p>Backends are a special type of
-<strong>filter</strong>(7)
+<a href="filter.html"><strong>filter</strong>(7)</a>
which is used to send print data to and discover different devices on the system.
</p>
</p>
<h2 id="backend-7.environment">Environment</h2>
<p>In addition to the environment variables listed in
-<strong>cups</strong>(1)
+<a href="cups.html"><strong>cups</strong>(1)</a>
and
-<strong>filter</strong>(7),
+<a href="filter.html"><strong>filter</strong>(7),</a>
CUPS backends can expect the following environment variable:
</p>
</p>
<p>Unless you are a developer and know what you are doing, please do not run backends directly.
Instead, use the
-<strong>lp</strong>(1)
+<a href="lp.html"><strong>lp</strong>(1)</a>
or
-<strong>lpr</strong>(1)
+<a href="lpr.html"><strong>lpr</strong>(1)</a>
programs to send print jobs or
-<strong>lpinfo</strong>(8)
+<a href="lpinfo.html"><strong>lpinfo</strong>(8)</a>
to query for available printers using the backend.
The one exception is the SNMP backend - see
-<strong>cups-snmp</strong>(8)
+<a href="cups-snmp.html"><strong>cups-snmp</strong>(8)</a>
for more information.
</p>
<h2 id="backend-7.notes">Notes</h2>
<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="backend-7.see-also">See Also</h2>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cancel(1)</title>
</head>
<body>
</pre>
<h2 id="cancel-1.notes">Notes</h2>
<p>Administrators wishing to prevent unauthorized cancellation of jobs via the <em>-u</em> option should require authentication for Cancel-Jobs operations in
-<strong>cupsd.conf</strong>(5).
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5).</a>
</p>
<h2 id="cancel-1.see-also">See Also</h2>
-<p><strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><p><strong>cupsd.conf</strong>(5),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpmove</strong>(8),
+<a href="lpmove.html"><strong>lpmove</strong>(8),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>classes.conf(5)</title>
</head>
<body>
<h2 id="classes.conf-5.description">Description</h2>
<p>The <strong>classes.conf</strong> file defines the local printer classes that are available.
It is normally located in the <em>/etc/cups</em> directory and is maintained by the
-<strong>cupsd</strong>(8)
+<a href="cupsd.html"><strong>cupsd</strong>(8)</a>
program.
This file is not intended to be edited or managed manually.
<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
</p>
<h2 id="classes.conf-5.see-also">See Also</h2>
-<p><strong>cupsd</strong>(8),
+<a href="cupsd.html"><p><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>printers.conf</strong>(5),
+<a href="printers.conf.html"><strong>printers.conf</strong>(5),</a>
-<strong>subscriptions.conf</strong>(5),
+<a href="subscriptions.conf.html"><strong>subscriptions.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>client.conf(5)</title>
</head>
<body>
<p>On Linux and other systems using GNU TLS, the <em>/etc/cups/ssl/site.crl</em> file, if present, provides a list of revoked X.509 certificates and is used when validating certificates.
</p>
<h2 id="client.conf-5.see-also">See Also</h2>
-<p><strong>cups</strong>(1),
+<a href="cups.html"><p><strong>cups</strong>(1),</a>
<strong>default</strong>(1),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cups-config(1)</title>
</head>
<body>
Formerly used to add the CUPS imaging library to the list of libraries.
</p>
<h2 id="cups-config-1.see-also">See Also</h2>
-<p><strong>cups</strong>(1),
+<a href="cups.html"><p><strong>cups</strong>(1),</a>
<strong>pkg-config</strong>(1),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cups-files.conf(5)</title>
</head>
<body>
</p>
<h2 id="cups-files.conf-5.description">Description</h2>
<p>The <strong>cups-files.conf</strong> file configures the files and directories used by the CUPS scheduler,
-<strong>cupsd</strong>(8).
+<a href="cupsd.html"><strong>cupsd</strong>(8).</a>
It is normally located in the <em>/etc/cups</em> directory.
</p>
</p>
<h3 id="cups-files.conf-5.description.directives">Directives</h3>
<p>The following directives are understood by
-<strong>cupsd</strong>(8):
+<a href="cupsd.html"><strong>cupsd</strong>(8):</a>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLog</strong><br>
command is used instead.
</p>
<h2 id="cups-files.conf-5.see-also">See Also</h2>
-<p><strong>classes.conf</strong>(5),
+<a href="classes.conf.html"><p><strong>classes.conf</strong>(5),</a>
-<strong>cups</strong>(1),
+<a href="cups.html"><strong>cups</strong>(1),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>printers.conf</strong>(5),
+<a href="printers.conf.html"><strong>printers.conf</strong>(5),</a>
-<strong>subscriptions.conf</strong>(5),
+<a href="subscriptions.conf.html"><strong>subscriptions.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cups-lpd(8)</title>
</head>
<body>
service using the corresponding control program.
</p>
<h2 id="cups-lpd-8.see-also">See Also</h2>
-<p><strong>cups</strong>(1),
+<a href="cups.html"><p><strong>cups</strong>(1),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
<strong>inetd</strong>(8),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>snmp.conf(5)</title>
</head>
<body>
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
</p>
<p>The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
-<strong>cups-snmp</strong>(8).
+<a href="cups-snmp.html"><strong>cups-snmp</strong>(8).</a>
</p>
<h2 id="snmp.conf-5.directives">Directives</h2>
<h2 id="snmp.conf-5.notes">Notes</h2>
<p>CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="snmp.conf-5.see-also">See Also</h2>
-<p><strong>cups-snmp</strong>(8),
+<a href="cups-snmp.html"><p><strong>cups-snmp</strong>(8),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cups-snmp(8)</title>
</head>
<body>
This can be used for programs that need to configure print queues where the user has supplied an address but nothing else.
</p>
<p>In the second form, the SNMP backend is run indirectly using the
-<strong>lpinfo</strong>(8)
+<a href="lpinfo.html"><strong>lpinfo</strong>(8)</a>
command.
The output provides all printers detected via SNMP on the configured
<p>The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer.
</p>
<h2 id="cups-snmp-8.see-also">See Also</h2>
-<p><strong>backend</strong>(7),
+<a href="backend.html"><p><strong>backend</strong>(7),</a>
-<strong>cups-snmp.conf</strong>(5),
+<a href="cups-snmp.conf.html"><strong>cups-snmp.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>lpinfo</strong>(8),
+<a href="lpinfo.html"><strong>lpinfo</strong>(8),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cups(1)</title>
</head>
<body>
<p>Once you have added the printer, you can print to it from any application. You can also choose Print Test Page from the maintenance menu to print a simple test page and verify that everything is working properly.
</p>
<p>You can also use the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
and
-<strong>lpinfo</strong>(8)
+<a href="lpinfo.html"><strong>lpinfo</strong>(8)</a>
commands to add printers to
<strong>CUPS</strong>.
<h2 id="cups-1.notes">Notes</h2>
<p>CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="cups-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>client.conf</strong>(5),
+<a href="client.conf.html"><strong>client.conf</strong>(5),</a>
-<strong>cupsctl</strong>(8),
+<a href="cupsctl.html"><strong>cupsctl</strong>(8),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpinfo</strong>(8),
+<a href="lpinfo.html"><strong>lpinfo</strong>(8),</a>
-<strong>lpoptions</strong>(1),
+<a href="lpoptions.html"><strong>lpoptions</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
-<strong>lpq</strong>(1),
+<a href="lpq.html"><strong>lpq</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>),
OpenPrinting CUPS Web Site (<a href="https://openprinting.github.io/cups">https://openprinting.github.io/cups</a>),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsaccept(8)</title>
</head>
<body>
<p>Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
</p>
<h2 id="cupsaccept-8.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>cupsenable</strong>(8),
+<a href="cupsenable.html"><strong>cupsenable</strong>(8),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsctl(8)</title>
</head>
<body>
<p>You cannot set the Listen or Port directives using <strong>cupsctl</strong>.
</p>
<h2 id="cupsctl-8.see-also">See Also</h2>
-<p><strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><p><strong>cupsd.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsd-helper(8)</title>
</head>
<body>
</p>
<h2 id="cupsd-helper-8.description">Description</h2>
<p>The <strong>cupsd-helper</strong> programs perform long-running operations on behalf of the scheduler,
-<strong>cupsd</strong>(8).
+<a href="cupsd.html"><strong>cupsd</strong>(8).</a>
The <strong>cups-deviced</strong> helper program runs each CUPS
-<strong>backend</strong>(7)
+<a href="backend.html"><strong>backend</strong>(7)</a>
with no arguments in order to discover the available printers.
</p>
archives to further reduce their size.
</p>
<p>Driver information files must conform to the format defined in
-<strong>ppdcfile</strong>(5).
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5).</a>
</p>
<h2 id="cupsd-helper-8.notes">Notes</h2>
<p>CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="cupsd-helper-8.see-also">See Also</h2>
-<p><strong>backend</strong>(7),
+<a href="backend.html"><p><strong>backend</strong>(7),</a>
-<strong>cups</strong>(1),
+<a href="cups.html"><strong>cups</strong>(1),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>filter</strong>(7),
+<a href="filter.html"><strong>filter</strong>(7),</a>
-<strong>ppdcfile</strong>(5),
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsd-logs(5)</title>
</head>
<body>
<p>cupsd-logs - cupsd log files (access_log, error_log, and page_log)
</p>
<h2 id="cupsd-logs-5.description">Description</h2>
-<p><strong>cupsd</strong>(8)
+<a href="cupsd.html"><p><strong>cupsd</strong>(8)</a>
normally maintains three log files: <em>access_log</em> to track requests that are submitted to the scheduler, <em>error_log</em> to track progress and errors, and <em>page_log</em> to track pages that are printed.
Configuration directives in
-<strong>cupsd.conf</strong>(5)
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5)</a>
and
-<strong>cups-files.conf</strong>(5)
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5)</a>
control what information is logged and where it is stored.
</p>
</p>
<h3 id="cupsd-logs-5.description.error-log-file-format">Error Log File Format</h3>
<p>The <em>error_log</em> file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the
-<strong>cupsd.conf</strong>(5)
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5)</a>
file controls which messages are logged:
</p>
</pre>
<p>The PageLogFormat directive in the
-<strong>cupsd.conf</strong>(5)
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5)</a>
file can be used to change this information.
</p>
<p>The <em>sides</em> field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
</p>
<h2 id="cupsd-logs-5.see-also">See Also</h2>
-<p><strong>cupsd</strong>(8),
+<a href="cupsd.html"><p><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsd.conf(5)</title>
</head>
<body>
<p>The
<em>cupsd.conf</em>
file configures the CUPS scheduler,
-<strong>cupsd</strong>(8).
+<a href="cupsd.html"><strong>cupsd</strong>(8).</a>
It is normally located in the
<em>/etc/cups</em>
</p>
<h3 id="cupsd.conf-5.description.top-level-directives">Top-Level Directives</h3>
<p>The following top-level directives are understood by
-<strong>cupsd</strong>(8):
+<a href="cupsd.html"><strong>cupsd</strong>(8):</a>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>AccessLogLevel config</strong><br>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>HostNameLookups Double</strong><br>
Specifies whether to do reverse lookups on connecting clients.
The "Double" setting causes
-<strong>cupsd</strong>(8)
+<a href="cupsd.html"><strong>cupsd</strong>(8)</a>
to verify that the hostname resolved from the address matches one of the addresses returned for that hostname.
Double lookups also prevent clients with unregistered addresses from connecting to your server.
Specifies the length of time to wait before shutting down due to inactivity.
The default is "60" seconds.
Note: Only applicable when
-<strong>cupsd</strong>(8)
+<a href="cupsd.html"><strong>cupsd</strong>(8)</a>
is run on-demand (e.g., with <strong>-l</strong>).
</p>
</p>
<h3 id="cupsd.conf-5.description.http-method-names">Http Method Names</h3>
<p>The following HTTP methods are supported by
-<strong>cupsd</strong>(8):
+<a href="cupsd.html"><strong>cupsd</strong>(8):</a>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;">GET<br>
</p>
<h3 id="cupsd.conf-5.description.ipp-operation-names">Ipp Operation Names</h3>
<p>The following IPP operations are supported by
-<strong>cupsd</strong>(8):
+<a href="cupsd.html"><strong>cupsd</strong>(8):</a>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;">CUPS-Accept-Jobs<br>
</p>
<h3 id="cupsd.conf-5.description.location-paths">Location Paths</h3>
<p>The following paths are commonly used when configuring
-<strong>cupsd</strong>(8):
+<a href="cupsd.html"><strong>cupsd</strong>(8):</a>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;">/<br>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Require user {</strong><em>user-name</em>|<strong>@</strong><em>group-name</em>} ...<br>
Specifies that an authenticated user must match one of the named users or be a member of one of the named groups.
The group name "@SYSTEM" corresponds to the list of groups defined by the SystemGroup directive in the
-<strong>cups-files.conf</strong>(5)
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5)</a>
file.
The group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job.
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<strong>cups-files.conf</strong>(5)
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5)</a>
file.
</p>
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<strong>cups-files.conf</strong>(5)
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5)</a>
file.
</p>
</p>
<h2 id="cupsd.conf-5.notes">Notes</h2>
<p>File, directory, and user configuration directives that used to be allowed in the <strong>cupsd.conf</strong> file are now stored in the
-<strong>cups-files.conf</strong>(5)
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5)</a>
file instead in order to prevent certain types of privilege escalation attacks.
</p>
</Location>
</pre>
<h2 id="cupsd.conf-5.see-also">See Also</h2>
-<p><strong>classes.conf</strong>(5),
+<a href="classes.conf.html"><p><strong>classes.conf</strong>(5),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>printers.conf</strong>(5),
+<a href="printers.conf.html"><strong>printers.conf</strong>(5),</a>
-<strong>subscriptions.conf</strong>(5),
+<a href="subscriptions.conf.html"><strong>subscriptions.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsd(8)</title>
</head>
<body>
</pre>
<h2 id="cupsd-8.see-also">See Also</h2>
-<p><strong>backend</strong>(7),
+<a href="backend.html"><p><strong>backend</strong>(7),</a>
-<strong>classes.conf</strong>(5),
+<a href="classes.conf.html"><strong>classes.conf</strong>(5),</a>
-<strong>cups</strong>(1),
+<a href="cups.html"><strong>cups</strong>(1),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
-<strong>cups-lpd</strong>(8),
+<a href="cups-lpd.html"><strong>cups-lpd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>cupsd-helper</strong>(8),
+<a href="cupsd-helper.html"><strong>cupsd-helper</strong>(8),</a>
<strong>cupsd-logs</strong>(8),
-<strong>filter</strong>(7),
+<a href="filter.html"><strong>filter</strong>(7),</a>
<strong>launchd</strong>(8),
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>printers.conf</strong>(5),
+<a href="printers.conf.html"><strong>printers.conf</strong>(5),</a>
<strong>systemd</strong>(8),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsenable(8)</title>
</head>
<body>
This differs from the System V versions which require the root user to execute these commands.
</p>
<h2 id="cupsenable-8.see-also">See Also</h2>
-<p><strong>cupsaccept</strong>(8),
+<a href="cupsaccept.html"><p><strong>cupsaccept</strong>(8),</a>
<strong>cupsreject</strong>(8),
-<strong>cancel</strong>(1),
+<a href="cancel.html"><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupsfilter(8)</title>
</head>
<body>
</p>
<h2 id="cupsfilter-8.environment">Environment</h2>
<p>All of the standard
-<strong>cups</strong>(1)
+<a href="cups.html"><strong>cups</strong>(1)</a>
environment variables affect the operation of
<strong>cupsfilter</strong>.
<h2 id="cupsfilter-8.notes">Notes</h2>
<p>CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<p>Unlike when printing, filters run using the
cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
</pre>
<h2 id="cupsfilter-8.see-also">See Also</h2>
-<p><strong>cups</strong>(1),
+<a href="cups.html"><p><strong>cups</strong>(1),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
<strong>filter(7),</strong>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>cupstestppd(1)</title>
</head>
<body>
<h2 id="cupstestppd-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="cupstestppd-1.see-also">See Also</h2>
-<p><strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><p><strong>lpadmin</strong>(8),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>),
Adobe PostScript Printer Description File Format Specification, Version 4.3.
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>filter(7)</title>
</head>
<body>
<h2 id="filter-7.notes">Notes</h2>
<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<p>CUPS filters are not meant to be run directly by the user.
Aside from the legacy System V interface issues (<em>argv[0]</em> is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
Unless you are a developer and know what you are doing, please do not run filters directly.
Instead, use the
-<strong>cupsfilter</strong>(8)
+<a href="cupsfilter.html"><strong>cupsfilter</strong>(8)</a>
program to use the appropriate filters to do the conversions you need.
</p>
<h2 id="filter-7.see-also">See Also</h2>
-<p><strong>backend</strong>(7),
+<a href="backend.html"><p><strong>backend</strong>(7),</a>
-<strong>cups</strong>(1),
+<a href="cups.html"><strong>cups</strong>(1),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsfilter</strong>(8),
+<a href="cupsfilter.html"><strong>cupsfilter</strong>(8),</a>
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ippevepcl/ps(7)</title>
</head>
<body>
and
<strong>ippeveps</strong>
are print commands for
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
As with all print commands, these commands read either the filename specified on the command-line or from the standard input.
Output is sent to the standard output.
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ippeveprinter(1)</title>
</head>
<body>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong><em>filename.conf</em><br>
Load printer attributes from "filename.conf".
Attribute files can be created using the
-<strong>ipptool</strong>(1)
+<a href="ipptool.html"><strong>ipptool</strong>(1)</a>
command with the
<em>--ippserver</em>
<strong>ippeveprinter</strong>
looks for the command in the "command" subdirectory of the CUPS binary directory, typically /usr/lib/cups/command or /usr/libexec/cups/command.
The
-<strong>cups-config</strong>(1)
+<a href="cups-config.html"><strong>cups-config</strong>(1)</a>
command can be used to discover the correct binary directory ("cups-config --serverbin").
In addition, the CUPS_SERVERBIN environment variable can be used to override the default location of this directory - see the
-<strong>cups</strong>(1)
+<a href="cups.html"><strong>cups</strong>(1)</a>
man page for more details.
</p>
ippeveprinter -c /usr/bin/file "My Cool Printer"
</pre>
<h2 id="ippeveprinter-1.see-also">See Also</h2>
-<p><strong>ippevepcl</strong>(7),
+<a href="ippevepcl.html"><p><strong>ippevepcl</strong>(7),</a>
<strong>ippeveps</strong>(7),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ippfind(1)</title>
</head>
<body>
-f onepage-letter.ps '{}' print-job.test \;
</pre>
<h2 id="ippfind-1.see-also">See Also</h2>
-<p><strong>ipptool</strong>(1)
+<a href="ipptool.html"><p><strong>ipptool</strong>(1)</a>
</p>
<h2 id="ippfind-1.copyright">Copyright</h2>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ipptool(1)</title>
</head>
<body>
The
<em>testfile</em>
format is described in
-<strong>ipptoolfile</strong>(5).
+<a href="ipptoolfile.html"><strong>ipptoolfile</strong>(5).</a>
</p>
<h2 id="ipptool-1.options">Options</h2>
ipp://localhost/printers/myprinter create-printer-subscription.test
</pre>
<h2 id="ipptool-1.see-also">See Also</h2>
-<p><strong>ipptoolfile</strong>(5),
+<a href="ipptoolfile.html"><p><strong>ipptoolfile</strong>(5),</a>
IANA IPP Registry (<a href="https://www.iana.org/assignments/ipp-registrations">https://www.iana.org/assignments/ipp-registrations</a>),
PWG Internet Printing Protocol Workgroup (<a href="https://www.pwg.org/ipp">https://www.pwg.org/ipp</a>)
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ipptoolfile(5)</title>
</head>
<body>
</p>
<h2 id="ipptoolfile-5.description">Description</h2>
<p>The
-<strong>ipptool</strong>(1)
+<a href="ipptool.html"><strong>ipptool</strong>(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.
Inserts the current user's login name.
</p>
<h2 id="ipptoolfile-5.see-also">See Also</h2>
-<p><strong>ipptool</strong>(1),
+<a href="ipptool.html"><p><strong>ipptool</strong>(1),</a>
IANA IPP Registry (<a href="https://www.iana.org/assignments/ipp-registrations">https://www.iana.org/assignments/ipp-registrations</a>),
PWG Internet Printing Protocol Workgroup (<a href="https://www.pwg.org/ipp">https://www.pwg.org/ipp</a>),
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lp(1)</title>
</head>
<body>
<h3 id="lp-1.description.the-default-destination">The Default Destination</h3>
<p>CUPS provides many ways to set the default destination. The <strong>LPDEST</strong> and <strong>PRINTER</strong> environment variables are consulted first.
If neither are set, the current default set using the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command is used, followed by the default set using the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
command.
</p>
</p>
<h3 id="lp-1.options.common-job-options">Common Job Options</h3>
<p>Aside from the printer-specific options reported by the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command, the following generic options are available:
</p>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o sides=two-sided-short-edge</strong><br>
Prints on both sides of the paper for landscape output.
+</p>
+ <h2 id="lp-1.environment">Environment</h2>
+<p>The following environment variables override the default destination:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
+Specifies the default print queue (System V standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+Specifies the default print queue (Berkeley standard).
</p>
<h2 id="lp-1.conforming-to">Conforming To</h2>
<p>Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
lp -d bar -o number-up=2 filename
</pre>
<h2 id="lp-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpoptions</strong>(1),
+<a href="lpoptions.html"><strong>lpoptions</strong>(1),</a>
-<strong>lpq</strong>(1),
+<a href="lpq.html"><strong>lpq</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpadmin(8)</title>
</head>
<body>
<h1 id="lpadmin-8">lpadmin(8)</h1>
<h2 id="lpadmin-8.name">Name</h2>
-<p>lpadmin - configure cups printers and classes
+<p>lpadmin - configure cups printers and classes on cups scheduler
</p>
<h2 id="lpadmin-8.synopsis">Synopsis</h2>
<p><strong>lpadmin</strong>
</p>
<p>When specified before the <em>-d</em>, <em>-p</em>, or <em>-x</em> options, the <em>-E</em> option forces encryption when connecting to the server.
</p>
- <p>The first form of the command (<em>-d</em>) sets the default printer or class to <em>destination</em>.
+ <p>The first form of the command (<em>-d</em>) sets the scheduler's default printer or class to <em>destination</em>.
Subsequent print jobs submitted via the
-<strong>lp</strong>(1)
+<a href="lp.html"><strong>lp</strong>(1)</a>
or
-<strong>lpr</strong>(1)
+<a href="lpr.html"><strong>lpr</strong>(1)</a>
commands will use this destination unless the user specifies otherwise with the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>model</em><br>
Sets a standard PPD file for the printer from the <em>model</em> directory or using one of the driver interfaces.
Use the <em>-m</em> option with the
-<strong>lpinfo</strong>(8)
+<a href="lpinfo.html"><strong>lpinfo</strong>(8)</a>
command to get a list of supported models.
The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP <em>device-uri</em>.
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name</em><strong>=</strong><em>value</em><br>
Sets a PPD option for the printer.
PPD options can be listed using the <em>-l</em> option with the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v "</strong><em>device-uri</em><strong>"</strong><br>
Sets the <em>device-uri</em> attribute of the printer queue.
Use the <em>-v</em> option with the
-<strong>lpinfo</strong>(8)
+<a href="lpinfo.html"><strong>lpinfo</strong>(8)</a>
command to get a list of supported device URIs and schemes.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
When specified before the <strong>-d</strong>, <strong>-p</strong>, or <strong>-x</strong> options, forces the use of TLS encryption on the connection to the scheduler.
Otherwise, enables the destination and accepts jobs; this is the same as running the
-<strong>cupsaccept</strong>(8)
+<a href="cupsaccept.html"><strong>cupsaccept</strong>(8)</a>
and
-<strong>cupsenable</strong>(8)
+<a href="cupsenable.html"><strong>cupsenable</strong>(8)</a>
programs on the destination.
</p>
<h2 id="lpadmin-8.notes">Notes</h2>
<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<p>The CUPS version of <strong>lpadmin</strong> does not support all of the System V or Solaris printing system configuration options.
</pre>
<h2 id="lpadmin-8.see-also">See Also</h2>
-<p><strong>cupsaccept</strong>(8),
+<a href="cupsaccept.html"><p><strong>cupsaccept</strong>(8),</a>
-<strong>cupsenable</strong>(8),
+<a href="cupsenable.html"><strong>cupsenable</strong>(8),</a>
-<strong>lpinfo</strong>(8),
+<a href="lpinfo.html"><strong>lpinfo</strong>(8),</a>
-<strong>lpoptions</strong>(1),
+<a href="lpoptions.html"><strong>lpoptions</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpc(8)</title>
</head>
<body>
</p>
<p>Since <strong>lpc</strong> is geared towards the Berkeley printing system, it is impossible to use <strong>lpc</strong> to configure printer or class queues provided by CUPS.
To configure printer or class queues you must use the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
command or another CUPS-compatible client with that functionality.
</p>
<h2 id="lpc-8.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>cupsaccept</strong>(8),
+<a href="cupsaccept.html"><strong>cupsaccept</strong>(8),</a>
-<strong>cupsenable</strong>(8),
+<a href="cupsenable.html"><strong>cupsenable</strong>(8),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpinfo(8)</title>
</head>
<body>
<h2 id="lpinfo-8.notes">Notes</h2>
<p>CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="lpinfo-8.see-also">See Also</h2>
-<p><strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><p><strong>lpadmin</strong>(8),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpmove(8)</title>
</head>
<body>
lpmove oldprinter newprinter
</pre>
<h2 id="lpmove-8.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpoptions(1)</title>
</head>
<body>
<h1 id="lpoptions-1">lpoptions(1)</h1>
<h2 id="lpoptions-1.name">Name</h2>
-<p>lpoptions - display or set printer options and defaults
+<p>lpoptions - display or set per-user printer options and defaults
</p>
<h2 id="lpoptions-1.synopsis">Synopsis</h2>
<p><strong>lpoptions</strong>
<h2 id="lpoptions-1.description">Description</h2>
<p><strong>lpoptions</strong> displays or sets printer options and defaults.
If no printer is specified using the <em>-p</em> option, the default printer is used as described in
-<strong>lp</strong>(1).
+<a href="lp.html"><strong>lp</strong>(1).</a>
</p>
<p>If no <em>-l</em>, <em>-o</em>, or <em>-r</em> options are specified, the current options are reported on the standard output.
</p>
<p>Options set with the <strong>lpoptions</strong> command are used by the
-<strong>lp</strong>(1)
+<a href="lp.html"><strong>lp</strong>(1)</a>
and
-<strong>lpr</strong>(1)
+<a href="lpr.html"><strong>lpr</strong>(1)</a>
commands when submitting jobs.
</p>
Sets the destination and instance, if specified, for any options that follow.
If the named instance does not exist then it is created.
Destinations can only be created using the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
program.
</p>
Removes the options for the named destination and instance, if specified.
If the named instance does not exist then this does nothing.
Destinations can only be removed using the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
command.
+</p>
+ <h2 id="lpoptions-1.environment">Environment</h2>
+<p>The following environment variables override the default destination:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
+Specifies the default print queue (System V standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+Specifies the default print queue (Berkeley standard).
</p>
<h2 id="lpoptions-1.files">Files</h2>
<p><em>~/.cups/lpoptions</em> - user defaults and instances created by non-root users.
<p>The <strong>lpoptions</strong> command is unique to CUPS.
</p>
<h2 id="lpoptions-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpq(1)</title>
</head>
<body>
Requests a more verbose (long) reporting format.
</p>
<h2 id="lpq-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpr(1)</title>
</head>
<body>
<h3 id="lpr-1.description.the-default-destination">The Default Destination</h3>
<p>CUPS provides many ways to set the default destination. The <strong>LPDEST</strong> and <strong>PRINTER</strong> environment variables are consulted first.
If neither are set, the current default set using the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command is used, followed by the default set using the
-<strong>lpadmin</strong>(8)
+<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>
command.
</p>
</p>
<h3 id="lpr-1.options.common-job-options">Common Job Options</h3>
<p>Aside from the printer-specific options reported by the
-<strong>lpoptions</strong>(1)
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
command, the following generic options are available:
</p>
</p>
<h2 id="lpr-1.notes">Notes</h2>
<p>The <em>-c</em>, <em>-d</em>, <em>-f</em>, <em>-g</em>, <em>-i</em>, <em>-n</em>, <em>-t</em>, <em>-v</em>, and <em>-w</em> options are not supported by CUPS and produce a warning message if used.
+</p>
+ <h2 id="lpr-1.environment">Environment</h2>
+<p>The following environment variables override the default destination:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
+Specifies the default print queue (System V standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+Specifies the default print queue (Berkeley standard).
</p>
<h2 id="lpr-1.examples">Examples</h2>
<p>Print two copies of a document to the default printer:
lpr -P foo -o number-up=2 filename
</pre>
<h2 id="lpr-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpadmin</strong>(8),
+<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>
-<strong>lpoptions</strong>(1),
+<a href="lpoptions.html"><strong>lpoptions</strong>(1),</a>
-<strong>lpq</strong>(1),
+<a href="lpq.html"><strong>lpq</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lprm(1)</title>
</head>
<body>
lprm -
</pre>
<h2 id="lprm-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpq</strong>(1),
+<a href="lpq.html"><strong>lpq</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lpstat</strong>(1),
+<a href="lpstat.html"><strong>lpstat</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>lpstat(1)</title>
</head>
<body>
Specifies an alternate username.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W </strong><em>which-jobs</em><br>
-Specifies which jobs to show, "all", "successful", "completed" or "not-completed" (the default).
+Specifies which jobs to show, "all, "successful", "completed" or "not-completed" (the default).
This option <em>must</em> appear before the <em>-o</em> option and/or any printer names, otherwise the default ("not-completed") value will be used in the request to the scheduler.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong>[<em>printer(s)</em>]<br>
If no classes are specified then all classes are listed.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d</strong><br>
-Shows the current default destination.
+Shows the current default destination, either the
+<a href="lpoptions.html"><strong>lpoptions</strong>(1)</a>
+
+default (if set) or the scheduler default (otherwise).
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-e</strong><br>
Shows all available destinations on the local network.
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v </strong>[<em>printer(s)</em>]<br>
Shows the printers and what device they are attached to.
If no printers are specified then all printers are listed.
+</p>
+ <h2 id="lpstat-1.environment">Environment</h2>
+<p>The following environment variables override the default destination:
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
+Specifies the default print queue (System V standard).
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
+Specifies the default print queue (Berkeley standard).
</p>
<h2 id="lpstat-1.conforming-to">Conforming To</h2>
<p>Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#".
<p>The Solaris <em>-f</em>, <em>-P</em>, and <em>-S</em> options are silently ignored.
</p>
<h2 id="lpstat-1.see-also">See Also</h2>
-<p><strong>cancel</strong>(1),
+<a href="cancel.html"><p><strong>cancel</strong>(1),</a>
-<strong>lp</strong>(1),
+<a href="lp.html"><strong>lp</strong>(1),</a>
-<strong>lpq</strong>(1),
+<a href="lpq.html"><strong>lpq</strong>(1),</a>
-<strong>lpr</strong>(1),
+<a href="lpr.html"><strong>lpr</strong>(1),</a>
-<strong>lprm</strong>(1),
+<a href="lprm.html"><strong>lprm</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>mailto.conf(5)</title>
</head>
<body>
Specifies a prefix string for the subject line of an email notification.
</p>
<h2 id="mailto.conf-5.see-also">See Also</h2>
-<p><strong>cupsd</strong>(8),
+<a href="cupsd.html"><p><strong>cupsd</strong>(8),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>mime.convs(5)</title>
</head>
<body>
<h2 id="mime.convs-5.notes">Notes</h2>
<p>CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="mime.convs-5.see-also">See Also</h2>
-<p><strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><p><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsfilter</strong>(8),
+<a href="cupsfilter.html"><strong>cupsfilter</strong>(8),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>mime.types(5)</title>
</head>
<body>
string(4,PwgRaster<00>) priority(150)
</pre>
<h2 id="mime.types-5.see-also">See Also</h2>
-<p><strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><p><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsfilter</strong>(8),
+<a href="cupsfilter.html"><strong>cupsfilter</strong>(8),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>notifier(7)</title>
</head>
<body>
functions and exit on error.
Notifiers are encouraged to exit after a suitable period of inactivity, however they may exit after reading the first message or stay running until an error is seen.
Notifiers inherit the environment and can use the logging mechanism documented in
-<strong>filter</strong>(7).
+<a href="filter.html"><strong>filter</strong>(7).</a>
</p>
<h2 id="notifier-7.see-also">See Also</h2>
-<p><strong>cupsd</strong>(8),
+<a href="cupsd.html"><p><strong>cupsd</strong>(8),</a>
-<strong>filter</strong>(7),
+<a href="filter.html"><strong>filter</strong>(7),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdc(1)</title>
</head>
<body>
<h2 id="ppdc-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="ppdc-1.see-also">See Also</h2>
-<p><strong>ppdhtml</strong>(1),
+<a href="ppdhtml.html"><p><strong>ppdhtml</strong>(1),</a>
-<strong>ppdi</strong>(1),
+<a href="ppdi.html"><strong>ppdi</strong>(1),</a>
-<strong>ppdmerge</strong>(1),
+<a href="ppdmerge.html"><strong>ppdmerge</strong>(1),</a>
-<strong>ppdpo</strong>(1),
+<a href="ppdpo.html"><strong>ppdpo</strong>(1),</a>
-<strong>ppdcfile</strong>(5),
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdcfile(5)</title>
</head>
<body>
</p>
<h2 id="ppdcfile-5.description">Description</h2>
<p>The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
-<strong>ppdc</strong>(1).
+<a href="ppdc.html"><strong>ppdc</strong>(1).</a>
This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS.
</p>
<h2 id="ppdcfile-5.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="ppdcfile-5.see-also">See Also</h2>
-<p><strong>ppdc</strong>(1),
+<a href="ppdc.html"><p><strong>ppdc</strong>(1),</a>
-<strong>ppdhtml</strong>(1),
+<a href="ppdhtml.html"><strong>ppdhtml</strong>(1),</a>
-<strong>ppdi</strong>(1),
+<a href="ppdi.html"><strong>ppdi</strong>(1),</a>
-<strong>ppdmerge</strong>(1),
+<a href="ppdmerge.html"><strong>ppdmerge</strong>(1),</a>
-<strong>ppdpo</strong>(1),
+<a href="ppdpo.html"><strong>ppdpo</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdhtml(1)</title>
</head>
<body>
<h2 id="ppdhtml-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="ppdhtml-1.see-also">See Also</h2>
-<p><strong>ppdc</strong>(1),
+<a href="ppdc.html"><p><strong>ppdc</strong>(1),</a>
-<strong>ppdcfile</strong>(5),
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5),</a>
-<strong>ppdi</strong>(1),
+<a href="ppdi.html"><strong>ppdi</strong>(1),</a>
-<strong>ppdmerge</strong>(1),
+<a href="ppdmerge.html"><strong>ppdmerge</strong>(1),</a>
-<strong>ppdpo</strong>(1),
+<a href="ppdpo.html"><strong>ppdpo</strong>(1),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdi(1)</title>
</head>
<body>
<h2 id="ppdi-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="ppdi-1.see-also">See Also</h2>
-<p><strong>ppdc</strong>(1),
+<a href="ppdc.html"><p><strong>ppdc</strong>(1),</a>
-<strong>ppdhtml</strong>(1),
+<a href="ppdhtml.html"><strong>ppdhtml</strong>(1),</a>
-<strong>ppdmerge</strong>(1),
+<a href="ppdmerge.html"><strong>ppdmerge</strong>(1),</a>
-<strong>ppdpo</strong>(1),
+<a href="ppdpo.html"><strong>ppdpo</strong>(1),</a>
-<strong>ppdcfile</strong>(5),
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdmerge(1)</title>
</head>
<body>
<h2 id="ppdmerge-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<p><strong>ppdmerge</strong> does not check whether the merged PPD files are for the same device.
Merging of different device PPDs will yield unpredictable results.
</p>
<h2 id="ppdmerge-1.see-also">See Also</h2>
-<p><strong>ppdc</strong>(1),
+<a href="ppdc.html"><p><strong>ppdc</strong>(1),</a>
-<strong>ppdhtml</strong>(1),
+<a href="ppdhtml.html"><strong>ppdhtml</strong>(1),</a>
-<strong>ppdi</strong>(1),
+<a href="ppdi.html"><strong>ppdi</strong>(1),</a>
-<strong>ppdpo</strong>(1),
+<a href="ppdpo.html"><strong>ppdpo</strong>(1),</a>
-<strong>ppdcfile</strong>(5),
+<a href="ppdcfile.html"><strong>ppdcfile</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>ppdpo(1)</title>
</head>
<body>
<h2 id="ppdpo-1.notes">Notes</h2>
<p>PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
-<strong>ippeveprinter</strong>(1).
+<a href="ippeveprinter.html"><strong>ippeveprinter</strong>(1).</a>
</p>
<h2 id="ppdpo-1.see-also">See Also</h2>
-<p><strong>ppdc</strong>(1),
+<a href="ppdc.html"><p><strong>ppdc</strong>(1),</a>
-<strong>ppdhtml</strong>(1),
+<a href="ppdhtml.html"><strong>ppdhtml</strong>(1),</a>
-<strong>ppdi</strong>(1),
+<a href="ppdi.html"><strong>ppdi</strong>(1),</a>
-<strong>ppdmerge</strong>(1),
+<a href="ppdmerge.html"><strong>ppdmerge</strong>(1),</a>
<strong>ppdcfile(5),</strong>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>printers.conf(5)</title>
</head>
<body>
</p>
<h2 id="printers.conf-5.description">Description</h2>
<p>The <strong>printers.conf</strong> file defines the local printers that are available. It is normally located in the <em>/etc/cups</em> directory and is maintained by the
-<strong>cupsd</strong>(8)
+<a href="cupsd.html"><strong>cupsd</strong>(8)</a>
program. This file is not intended to be edited or managed manually.
</p>
<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
</p>
<h2 id="printers.conf-5.see-also">See Also</h2>
-<p><strong>classes.conf</strong>(5),
+<a href="classes.conf.html"><p><strong>classes.conf</strong>(5),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>subscriptions.conf</strong>(5),
+<a href="subscriptions.conf.html"><strong>subscriptions.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<!DOCTYPE html>
<html>
<head>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>subscriptions.conf(5)</title>
</head>
<body>
<h2 id="subscriptions.conf-5.description">Description</h2>
<p>The <strong>subscriptions.conf</strong> file defines the local event notification subscriptions that are active.
It is normally located in the <em>/etc/cups</em> directory and is maintained by the
-<strong>cupsd</strong>(8)
+<a href="cupsd.html"><strong>cupsd</strong>(8)</a>
program.
This file is not intended to be edited or managed manually.
<p>The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
</p>
<h2 id="subscriptions.conf-5.see-also">See Also</h2>
-<p><strong>classes.conf</strong>(5),
+<a href="classes.conf.html"><p><strong>classes.conf</strong>(5),</a>
-<strong>cups-files.conf</strong>(5),
+<a href="cups-files.conf.html"><strong>cups-files.conf</strong>(5),</a>
-<strong>cupsd</strong>(8),
+<a href="cupsd.html"><strong>cupsd</strong>(8),</a>
-<strong>cupsd.conf</strong>(5),
+<a href="cupsd.conf.html"><strong>cupsd.conf</strong>(5),</a>
-<strong>mime.convs</strong>(5),
+<a href="mime.convs.html"><strong>mime.convs</strong>(5),</a>
-<strong>mime.types</strong>(5),
+<a href="mime.types.html"><strong>mime.types</strong>(5),</a>
-<strong>printers.conf</strong>(5),
+<a href="printers.conf.html"><strong>printers.conf</strong>(5),</a>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lp 1 "CUPS" "2022-05-02" "OpenPrinting"
+.TH lp 1 "CUPS" "2024-04-02" "OpenPrinting"
.SH NAME
lp \- print files
.SH SYNOPSIS
.TP 5
\fB\-o sides=two\-sided\-short\-edge\fR
Prints on both sides of the paper for landscape output.
+.SH ENVIRONMENT
+The following environment variables override the default destination:
+.TP 5
+.B LPDEST
+Specifies the default print queue (System V standard).
+.TP 5
+.B PRINTER
+Specifies the default print queue (Berkeley standard).
.SH CONFORMING TO
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
Also, printer and class names are \fInot\fR case-sensitive.
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lpadmin 8 "CUPS" "2021-02-28" "OpenPrinting"
+.TH lpadmin 8 "CUPS" "2024-04-02" "OpenPrinting"
.SH NAME
-lpadmin \- configure cups printers and classes
+lpadmin \- configure cups printers and classes on cups scheduler
.SH SYNOPSIS
.B lpadmin
[
.LP
When specified before the \fI-d\fR, \fI-p\fR, or \fI-x\fR options, the \fI-E\fR option forces encryption when connecting to the server.
.LP
-The first form of the command (\fI-d\fR) sets the default printer or class to \fIdestination\fR.
+The first form of the command (\fI-d\fR) sets the scheduler's default printer or class to \fIdestination\fR.
Subsequent print jobs submitted via the
.BR lp (1)
or
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lpoptions 1 "CUPS" "2022-05-02" "OpenPrinting"
+.TH lpoptions 1 "CUPS" "2024-04-02" "OpenPrinting"
.SH NAME
-lpoptions \- display or set printer options and defaults
+lpoptions \- display or set per-user printer options and defaults
.SH SYNOPSIS
.B lpoptions
[
Destinations can only be removed using the
.BR lpadmin (8)
command.
+.SH ENVIRONMENT
+The following environment variables override the default destination:
+.TP 5
+.B LPDEST
+Specifies the default print queue (System V standard).
+.TP 5
+.B PRINTER
+Specifies the default print queue (Berkeley standard).
.SH FILES
\fI~/.cups/lpoptions\fR - user defaults and instances created by non-root users.
.br
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lpr 1 "CUPS" "2022-05-02" "OpenPrinting"
+.TH lpr 1 "CUPS" "2024-04-02" "OpenPrinting"
.SH NAME
lpr \- print files
.SH SYNOPSIS
Prints on both sides of the paper for landscape output.
.SH NOTES
The \fI\-c\fR, \fI\-d\fR, \fI\-f\fR, \fI\-g\fR, \fI\-i\fR, \fI\-n\fR, \fI\-t\fR, \fI\-v\fR, and \fI\-w\fR options are not supported by CUPS and produce a warning message if used.
+.SH ENVIRONMENT
+The following environment variables override the default destination:
+.TP 5
+.B LPDEST
+Specifies the default print queue (System V standard).
+.TP 5
+.B PRINTER
+Specifies the default print queue (Berkeley standard).
.SH EXAMPLES
Print two copies of a document to the default printer:
.nf
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
.\"
-.TH lpstat 1 "CUPS" "2022-05-02" "OpenPrinting"
+.TH lpstat 1 "CUPS" "2024-04-02" "OpenPrinting"
.SH NAME
lpstat \- print cups status information
.SH SYNOPSIS
If no classes are specified then all classes are listed.
.TP 5
.B \-d
-Shows the current default destination.
+Shows the current default destination, either the
+.BR lpoptions (1)
+default (if set) or the scheduler default (otherwise).
.TP 5
.B \-e
Shows all available destinations on the local network.
\fB\-v \fR[\fIprinter(s)\fR]
Shows the printers and what device they are attached to.
If no printers are specified then all printers are listed.
+.SH ENVIRONMENT
+The following environment variables override the default destination:
+.TP 5
+.B LPDEST
+Specifies the default print queue (System V standard).
+.TP 5
+.B PRINTER
+Specifies the default print queue (Berkeley standard).
.SH CONFORMING TO
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#".
Also, printer and class names are \fInot\fR case-sensitive.
projects / thirdparty / cups.git / commitdiff
