lpoptions - display or set printer options and defaults
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lpoptions</b>
-[ -E ] [ -U
+[
+<b>-E</b>
+] [
+<b>-U</b>
<i>username</i>
-] [ -h
-<i>server[:port]</i>
-] -d
-<i>destination[/instance]</i>
-[ -o
-<i>option[=value]</i>
-] ... [ -o
-<i>option[=value]</i>
+] [
+<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+]
+<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
+[
+<b>-l</b>
]
<br>
<b>lpoptions</b>
-[ -E ] [ -U
+[
+<b>-E</b>
+] [
+<b>-U</b>
<i>username</i>
-] [ -h
-<i>server[:port]</i>
-] [ -p
-<i>destination[/instance]</i>
-] -l
+] [
+<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+] [
+<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
+]
+<b>-o </b><i>option</i>[<b>=</b><i>value</i>] ...
<br>
<b>lpoptions</b>
-[ -E ] [ -U
+[
+<b>-E</b>
+] [
+<b>-U</b>
<i>username</i>
-] [ -h
-<i>server[:port]</i>
-] [ -o
-<i>option[=value]</i>
-] ... [ -o
-<i>option[=value]</i>
-] [ -p
-<i>destination[/instance]</i>
-] -r
+] [
+<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+] [
+<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
+]
+<b>-r</b>
<i>option</i>
<br>
<b>lpoptions</b>
-[ -E ] [ -U
+[
+<b>-E</b>
+] [
+<b>-U</b>
<i>username</i>
-] [ -h
-<i>server[:port]</i>
-] -x
-<i>destination[/instance]</i>
+] [
+<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+]
+<b>-x </b><i>destination</i>[<b>/</b><i>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:
-<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.
-<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.
-<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.
-<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
-<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 file.
-<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
-The <i>lpoptions</i> command is unique to CUPS.
+<b>lpoptions</b> displays or sets printer options and defaults.
+If no printer is specified using the <i>-p</i> option, the default printer is used as described in
+<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1).</a>
+<p>If no <i>-l</i>, <i>-o</i>, or <i>-r</i> options are specified, the current options are reported on the standard output.
+<p>Options set with the <b>lpoptions</b> command are used by the
+<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+and
+<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+commands when submitting jobs.
+<p>When run by the root user, <b>lpoptions</b> gets and sets default options and instances for all users in the <i>/etc/cups/lpoptions</i> file.
+Otherwise, the per-user defaults are managed in the <i>~/.cups/lpoptions</i> file.
+<h2 class="title"><a name="OPTIONS">Options</a></h2>
+<b>lpoptions</b> supports the following options:
+<dl class="man">
+<dt><b>-E</b>
+<dd style="margin-left: 5.0em">Enables encryption when communicating with the CUPS server.
+<dt><b>-U </b><i>username</i>
+<dd style="margin-left: 5.0em">Uses an alternate username.
+<dt><b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
+<dd style="margin-left: 5.0em">Sets the user default printer to <i>destination</i>.
+If <i>instance</i> is supplied then that particular instance is used.
+This option overrides the system default printer for the current user.
+<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
+<dd style="margin-left: 5.0em">Uses an alternate server.
+<dt><b>-l</b>
+<dd style="margin-left: 5.0em">Lists the printer specific options and their current settings.
+<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
+<dd style="margin-left: 5.0em">Specifies a new option for the named destination.
+<dt><b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
+<dd style="margin-left: 5.0em">Sets the destination and instance, if specified, for any options that follow.
+If the named instance does not exist then it is created.
+Destinations can only be created using the
+<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+program.
+<dt><b>-r </b><i>option</i>
+<dd style="margin-left: 5.0em">Removes the specified option from the named destination.
+<dt><b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
+<dd style="margin-left: 5.0em">Removes the options for the named destination and instance, if specified.
+If the named instance does not exist then this does nothing.
+Destinations can only be removed using the
+<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+command.
+</dl>
<h2 class="title"><a name="FILES">Files</a></h2>
-~/.cups/lpoptions - user defaults and instances created by non-root
-users.
+<i>~/.cups/lpoptions</i> - user defaults and instances created by non-root users.
<br>
-/etc/cups/lpoptions - system-wide defaults and instances
-created by the root user.
+<i>/etc/cups/lpoptions</i> - system-wide defaults and instances created by the root user.
+<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
+The <b>lpoptions</b> command is unique to CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<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="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
+<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
+<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
+<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
+<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright © 2007-2014 by Apple Inc.
</body>
</html>
projects / thirdparty / cups.git / blobdiff