]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
e4e5666b | 2 | .\" "$Id$" |
ef416fc2 | 3 | .\" |
321d8d57 | 4 | .\" lpoptions man page for CUPS. |
ef416fc2 | 5 | .\" |
0fa6c7fa | 6 | .\" Copyright 2007-2013 by Apple Inc. |
bd7854cb | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 14 | .\" |
ffa2ca90 | 15 | .TH lpoptions 1 "CUPS" "8 July 2013" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
17 | lpoptions \- display or set printer options and defaults | |
18 | .SH SYNOPSIS | |
19 | .B lpoptions | |
bd7854cb | 20 | [ -E ] [ -U |
21 | .I username | |
22 | ] [ -h | |
23 | .I server[:port] | |
ef416fc2 | 24 | ] -d |
bd7854cb | 25 | .I destination[/instance] |
ef416fc2 | 26 | [ -o |
bd7854cb | 27 | .I option[=value] |
ef416fc2 | 28 | ] ... [ -o |
bd7854cb | 29 | .I option[=value] |
ef416fc2 | 30 | ] |
31 | .br | |
32 | .B lpoptions | |
bd7854cb | 33 | [ -E ] [ -U |
34 | .I username | |
35 | ] [ -h | |
36 | .I server[:port] | |
37 | ] [ -p | |
38 | .I destination[/instance] | |
ef416fc2 | 39 | ] -l |
40 | .br | |
41 | .B lpoptions | |
bd7854cb | 42 | [ -E ] [ -U |
43 | .I username | |
44 | ] [ -h | |
45 | .I server[:port] | |
46 | ] [ -o | |
47 | .I option[=value] | |
ef416fc2 | 48 | ] ... [ -o |
bd7854cb | 49 | .I option[=value] |
ef416fc2 | 50 | ] [ -p |
bd7854cb | 51 | .I destination[/instance] |
ef416fc2 | 52 | ] -r |
53 | .I option | |
54 | .br | |
55 | .B lpoptions | |
bd7854cb | 56 | [ -E ] [ -U |
57 | .I username | |
58 | ] [ -h | |
59 | .I server[:port] | |
60 | ] -x | |
61 | .I destination[/instance] | |
ef416fc2 | 62 | .SH DESCRIPTION |
bd7854cb | 63 | \fIlpoptions\fR displays or sets printer options and defaults. |
64 | \fIlpoptions\fR shows the default printer options when run with no | |
ef416fc2 | 65 | arguments. Other options include: |
66 | .TP 5 | |
bd7854cb | 67 | -E |
ef416fc2 | 68 | .br |
69 | Enables encryption when communicating with the CUPS server. | |
70 | .TP 5 | |
bd7854cb | 71 | -U username |
72 | .br | |
73 | Uses an alternate username. | |
74 | .TP 5 | |
75 | -d destination[/instance] | |
ef416fc2 | 76 | .br |
c5571a1d | 77 | Sets the user default printer to \fIdestination\fR. If \fIinstance\fR |
bd7854cb | 78 | is supplied then that particular instance is used. This option |
79 | overrides the system default printer for the current user. | |
ef416fc2 | 80 | .TP 5 |
bd7854cb | 81 | -h server[:port] |
ef416fc2 | 82 | .br |
bd7854cb | 83 | Uses an alternate server. |
ef416fc2 | 84 | .TP 5 |
bd7854cb | 85 | -l |
ef416fc2 | 86 | .br |
87 | Lists the printer specific options and their current settings. | |
88 | .TP 5 | |
bd7854cb | 89 | -o option[=value] |
ef416fc2 | 90 | .br |
91 | Specifies a new option for the named destination. | |
92 | .TP 5 | |
bd7854cb | 93 | -p destination[/instance] |
ef416fc2 | 94 | .br |
bd7854cb | 95 | Sets the destination and instance, if specified, for any options |
96 | that follow. If the named instance does not exist then it is | |
97 | created. | |
ef416fc2 | 98 | .TP 5 |
bd7854cb | 99 | -r option |
ef416fc2 | 100 | .br |
101 | Removes the specified option for the named destination. | |
102 | .TP 5 | |
bd7854cb | 103 | -x destination[/instance] |
ef416fc2 | 104 | .br |
bd7854cb | 105 | Removes the options for the named destination and instance, if |
106 | specified. If the named instance does not exist then this does | |
107 | nothing. | |
ef416fc2 | 108 | .LP |
bd7854cb | 109 | If no options are specified using the \fI-o\fR option, then the |
110 | current options for the named printer are reported on the | |
111 | standard output. | |
ef416fc2 | 112 | .LP |
bd7854cb | 113 | Options set with the \fIlpoptions\fR command are used by the |
114 | \fIlp(1)\fR and \fIlpr(1)\fR commands when submitting jobs. | |
ef416fc2 | 115 | .SH ROOT ACCOUNT OPTIONS |
bd7854cb | 116 | When run by the root user, \fIlpoptions\fR gets and sets default |
ef416fc2 | 117 | options and instances for \fIall users\fR in the |
ffa2ca90 | 118 | /etc/cups/lpoptions file. |
ef416fc2 | 119 | .SH COMPATIBILITY |
bd7854cb | 120 | The \fIlpoptions\fR command is unique to CUPS. |
ef416fc2 | 121 | .SH FILES |
b423cd4c | 122 | ~/.cups/lpoptions - user defaults and instances created by non-root |
bd7854cb | 123 | users. |
ef416fc2 | 124 | .br |
ffa2ca90 | 125 | /etc/cups/lpoptions - system-wide defaults and instances |
b423cd4c | 126 | created by the root user. |
ef416fc2 | 127 | .SH SEE ALSO |
c5571a1d | 128 | \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR, \fIlpr(1)\fR, |
bd7854cb | 129 | .br |
130 | http://localhost:631/help | |
ef416fc2 | 131 | .SH COPYRIGHT |
0fa6c7fa | 132 | Copyright 2007-2013 by Apple Inc. |
ef416fc2 | 133 | .\" |
e4e5666b | 134 | .\" End of "$Id$". |
ef416fc2 | 135 | .\" |