<!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>