man-lpoptions.html [plain text]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
<link rel="stylesheet" type="text/css" href="../cups-printable.css">
<title>lpoptions(1)</title>
</head>
<body>
<h1 class="title">lpoptions(1)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
lpoptions - display or set printer options and defaults
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lpoptions
</b>[ -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>
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
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
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.
<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.
<h2 class="title"><a name="FILES">Files</a></h2>
~/.cups/lpoptions - user defaults and instances created by non-root
users.
<br>
/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>,
<br>
<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.
</body>
</html>