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