<!DOCTYPE HTML> <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> [ <b>-E</b> ] [ <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> [ <b>-E</b> ] [ <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> [ <b>-E</b> ] [ <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> [ <b>-E</b> ] [ <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> <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 <b>lp</b>(1). <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 <b>lp</b>(1) and <b>lpr</b>(1) 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>-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 <b>lpadmin</b>(8) 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 <b>lpadmin</b>(8) command. </dl> <h2 class="title"><a name="FILES">Files</a></h2> <i>~/.cups/lpoptions</i> - user defaults and instances created by non-root users. <br> <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> <b>cancel</b>(1), <b>lp</b>(1), <b>lpadmin</b>(8), <b>lpr</b>(1), <b>lprm</b>(1), 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-2019 by Apple Inc. </body> </html>
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| accounting.html | File | 2.63 KB | 0644 |
|
| admin.html | File | 11.66 KB | 0644 |
|
| api-admin.html | File | 19.99 KB | 0644 |
|
| api-filter.html | File | 61.66 KB | 0644 |
|
| api-ppd.html | File | 92.21 KB | 0644 |
|
| api-raster.html | File | 59.02 KB | 0644 |
|
| cgi.html | File | 2.58 KB | 0644 |
|
| cupspm.html | File | 370.35 KB | 0644 |
|
| encryption.html | File | 4.21 KB | 0644 |
|
| firewalls.html | File | 3.94 KB | 0644 |
|
| glossary.html | File | 2.66 KB | 0644 |
|
| kerberos.html | File | 4.21 KB | 0644 |
|
| license.html | File | 11.78 KB | 0644 |
|
| man-backend.html | File | 9.35 KB | 0644 |
|
| man-cancel.html | File | 2.56 KB | 0644 |
|
| man-classes.conf.html | File | 1.15 KB | 0644 |
|
| man-client.conf.html | File | 6.91 KB | 0644 |
|
| man-cups-config.html | File | 3.3 KB | 0644 |
|
| man-cups-files.conf.html | File | 12.26 KB | 0644 |
|
| man-cups-lpd.html | File | 4.75 KB | 0644 |
|
| man-cups-snmp.html | File | 2.72 KB | 0644 |
|
| man-cups.html | File | 7.43 KB | 0644 |
|
| man-cupsaccept.html | File | 2.48 KB | 0644 |
|
| man-cupsd-helper.html | File | 2.59 KB | 0644 |
|
| man-cupsd-logs.html | File | 9.55 KB | 0644 |
|
| man-cupsd.conf.html | File | 37.78 KB | 0644 |
|
| man-cupsd.html | File | 3.22 KB | 0644 |
|
| man-cupsenable.html | File | 2.97 KB | 0644 |
|
| man-cupstestppd.html | File | 4.83 KB | 0644 |
|
| man-filter.html | File | 11.36 KB | 0644 |
|
| man-ippevepcl.html | File | 1.88 KB | 0644 |
|
| man-ippeveprinter.html | File | 9.88 KB | 0644 |
|
| man-ippfind.html | File | 9.72 KB | 0644 |
|
| man-ipptool.html | File | 7.53 KB | 0644 |
|
| man-ipptoolfile.html | File | 27.3 KB | 0644 |
|
| man-lp.html | File | 7.32 KB | 0644 |
|
| man-lpadmin.html | File | 10.04 KB | 0644 |
|
| man-lpc.html | File | 2.11 KB | 0644 |
|
| man-lpinfo.html | File | 3.66 KB | 0644 |
|
| man-lpmove.html | File | 1.91 KB | 0644 |
|
| man-lpoptions.html | File | 3.88 KB | 0644 |
|
| man-lpq.html | File | 1.97 KB | 0644 |
|
| man-lpr.html | File | 5.93 KB | 0644 |
|
| man-lprm.html | File | 2.08 KB | 0644 |
|
| man-lpstat.html | File | 4.55 KB | 0644 |
|
| man-mime.convs.html | File | 2.59 KB | 0644 |
|
| man-mime.types.html | File | 5.47 KB | 0644 |
|
| man-notifier.html | File | 1.35 KB | 0644 |
|
| man-ppdc.html | File | 3.5 KB | 0644 |
|
| man-ppdhtml.html | File | 1.83 KB | 0644 |
|
| man-ppdi.html | File | 1.99 KB | 0644 |
|
| man-ppdmerge.html | File | 1.75 KB | 0644 |
|
| man-ppdpo.html | File | 2.09 KB | 0644 |
|
| man-printers.conf.html | File | 1.18 KB | 0644 |
|
| man-subscriptions.conf.html | File | 1.22 KB | 0644 |
|
| network.html | File | 18.56 KB | 0644 |
|
| options.html | File | 16.42 KB | 0644 |
|
| overview.html | File | 3.4 KB | 0644 |
|
| policies.html | File | 21.25 KB | 0644 |
|
| postscript-driver.html | File | 23.26 KB | 0644 |
|
| ppd-compiler.html | File | 45.13 KB | 0644 |
|
| raster-driver.html | File | 20.32 KB | 0644 |
|
| ref-ppdcfile.html | File | 69.29 KB | 0644 |
|
| security.html | File | 4.44 KB | 0644 |
|
| sharing.html | File | 4.45 KB | 0644 |
|
| spec-banner.html | File | 4.05 KB | 0644 |
|
| spec-command.html | File | 6.08 KB | 0644 |
|
| spec-design.html | File | 13.05 KB | 0644 |
|
| spec-ipp.html | File | 65.4 KB | 0644 |
|
| spec-ppd.html | File | 90.33 KB | 0644 |
|
| spec-raster.html | File | 23.34 KB | 0644 |
|
| spec-stp.html | File | 3.79 KB | 0644 |
|
| translation.html | File | 24.29 KB | 0644 |
|