]>
Commit | Line | Data |
---|---|---|
c277f98c | 1 | <!DOCTYPE HTML> |
94436c5a MS |
2 | <html> |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>lpoptions(1)</title> | |
7 | </head> | |
8 | <body> | |
9 | <h1 class="title">lpoptions(1)</h1> | |
10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
11 | lpoptions - display or set printer options and defaults | |
12 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
c277f98c | 13 | <b>lpoptions</b> |
6e12033b MS |
14 | [ |
15 | <b>-E</b> | |
16 | ] [ | |
17 | <b>-U</b> | |
c277f98c | 18 | <i>username</i> |
6e12033b MS |
19 | ] [ |
20 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
21 | ] | |
22 | <b>-d </b><i>destination</i>[<b>/</b><i>instance</i>] | |
23 | [ | |
24 | <b>-l</b> | |
c277f98c MS |
25 | ] |
26 | <br> | |
27 | <b>lpoptions</b> | |
6e12033b MS |
28 | [ |
29 | <b>-E</b> | |
30 | ] [ | |
31 | <b>-U</b> | |
c277f98c | 32 | <i>username</i> |
6e12033b MS |
33 | ] [ |
34 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
35 | ] [ | |
36 | <b>-p </b><i>destination</i>[<b>/</b><i>instance</i>] | |
37 | ] | |
38 | <b>-o </b><i>option</i>[<b>=</b><i>value</i>] ... | |
c277f98c MS |
39 | <br> |
40 | <b>lpoptions</b> | |
6e12033b MS |
41 | [ |
42 | <b>-E</b> | |
43 | ] [ | |
44 | <b>-U</b> | |
c277f98c | 45 | <i>username</i> |
6e12033b MS |
46 | ] [ |
47 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
48 | ] [ | |
49 | <b>-p </b><i>destination</i>[<b>/</b><i>instance</i>] | |
50 | ] | |
51 | <b>-r</b> | |
c277f98c MS |
52 | <i>option</i> |
53 | <br> | |
54 | <b>lpoptions</b> | |
6e12033b MS |
55 | [ |
56 | <b>-E</b> | |
57 | ] [ | |
58 | <b>-U</b> | |
c277f98c | 59 | <i>username</i> |
6e12033b MS |
60 | ] [ |
61 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
62 | ] | |
63 | <b>-x </b><i>destination</i>[<b>/</b><i>instance</i>] | |
c277f98c | 64 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
6e12033b MS |
65 | <b>lpoptions</b> displays or sets printer options and defaults. |
66 | If no printer is specified using the <i>-p</i> option, the default printer is used as described in | |
67 | <a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1).</a> | |
68 | <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. | |
69 | <p>Options set with the <b>lpoptions</b> command are used by the | |
70 | <a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a> | |
71 | and | |
72 | <a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a> | |
73 | commands when submitting jobs. | |
74 | <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. | |
75 | Otherwise, the per-user defaults are managed in the <i>~/.cups/lpoptions</i> file. | |
76 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
77 | <b>lpoptions</b> supports the following options: | |
2909c66c | 78 | <dl class="man"> |
6e12033b MS |
79 | <dt><b>-E</b> |
80 | <dd style="margin-left: 5.0em">Enables encryption when communicating with the CUPS server. | |
81 | <dt><b>-U </b><i>username</i> | |
82 | <dd style="margin-left: 5.0em">Uses an alternate username. | |
83 | <dt><b>-d </b><i>destination</i>[<b>/</b><i>instance</i>] | |
84 | <dd style="margin-left: 5.0em">Sets the user default printer to <i>destination</i>. | |
85 | If <i>instance</i> is supplied then that particular instance is used. | |
86 | This option overrides the system default printer for the current user. | |
87 | <dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
88 | <dd style="margin-left: 5.0em">Uses an alternate server. | |
89 | <dt><b>-l</b> | |
90 | <dd style="margin-left: 5.0em">Lists the printer specific options and their current settings. | |
91 | <dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>] | |
92 | <dd style="margin-left: 5.0em">Specifies a new option for the named destination. | |
93 | <dt><b>-p </b><i>destination</i>[<b>/</b><i>instance</i>] | |
94 | <dd style="margin-left: 5.0em">Sets the destination and instance, if specified, for any options that follow. | |
95 | If the named instance does not exist then it is created. | |
96 | Destinations can only be created using the | |
97 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a> | |
98 | program. | |
99 | <dt><b>-r </b><i>option</i> | |
100 | <dd style="margin-left: 5.0em">Removes the specified option from the named destination. | |
101 | <dt><b>-x </b><i>destination</i>[<b>/</b><i>instance</i>] | |
102 | <dd style="margin-left: 5.0em">Removes the options for the named destination and instance, if specified. | |
103 | If the named instance does not exist then this does nothing. | |
104 | Destinations can only be removed using the | |
105 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a> | |
106 | command. | |
2909c66c | 107 | </dl> |
94436c5a | 108 | <h2 class="title"><a name="FILES">Files</a></h2> |
6e12033b | 109 | <i>~/.cups/lpoptions</i> - user defaults and instances created by non-root users. |
94436c5a | 110 | <br> |
6e12033b MS |
111 | <i>/etc/cups/lpoptions</i> - system-wide defaults and instances created by the root user. |
112 | <h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2> | |
113 | The <b>lpoptions</b> command is unique to CUPS. | |
94436c5a | 114 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> |
6e12033b MS |
115 | <a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a> |
116 | <a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a> | |
117 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a> | |
118 | <a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a> | |
119 | <a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a> | |
120 | CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) | |
94436c5a | 121 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
96a9a53e | 122 | Copyright © 2007-2015 by Apple Inc. |
94436c5a MS |
123 | |
124 | </body> | |
125 | </html> |