<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
<style type='text/css'><!--
h1, h2, h3, p { font-family: sans-serif; text-align: justify; }
tt, pre a:link, pre a:visited, tt a:link, tt a:visited { font-weight: bold; color: #7f0000; }
pre { font-weight: bold; color: #7f0000; margin-left: 2em; }
h1.title, h2.title, h3.title { border-bottom: solid 2px #000000; }
--></style>
<title>lpoptions(1)</title>
</head>
<body>
<h2><a name='NAME'>Name</a></h2>
lpoptions - display or set printer options and defaults
<h2><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><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>Enables encryption when communicating with the CUPS server.
</dd>
<dt>-U username
</dt>
<dd>Uses an alternate username.
</dd>
<dt>-d destination[/instance]
</dt>
<dd>Sets the 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>Uses an alternate server.
</dd>
<dt>-l
</dt>
<dd>Lists the printer specific options and their current settings.
</dd>
<dt>-o option[=value]
</dt>
<dd>Specifies a new option for the named destination.
</dd>
<dt>-p destination[/instance]
</dt>
<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>Removes the specified option for the named destination.
</dd>
<dt>-x destination[/instance]
</dt>
<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><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><a name='COMPATIBILITY'>Compatibility</a></h2>
The <i>lpoptions</i> command is unique to CUPS.
<h2><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><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>,
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<h2><a name='COPYRIGHT'>Copyright</a></h2>
Copyright 2007 by Apple Inc.
</body>
</html>
distrib
>
Scientific%20Linux
>
5x
>
x86_64
>
by-pkgid
>
a186c65a8aa653fe7d3034349bdce096
>
files
>
1226
