]>
Commit | Line | Data |
---|---|---|
1 | .\" | |
2 | .\" "$Id: lpoptions.man.in 6649 2007-07-11 21:46:42Z mike $" | |
3 | .\" | |
4 | .\" lpoptions man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
6 | .\" Copyright 2007 by Apple Inc. | |
7 | .\" Copyright 1997-2006 by Easy Software Products. | |
8 | .\" | |
9 | .\" These coded instructions, statements, and computer programs are the | |
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/". | |
14 | .\" | |
15 | .TH lpoptions 1 "Common UNIX Printing System" "20 March 2006" "Apple Inc." | |
16 | .SH NAME | |
17 | lpoptions \- display or set printer options and defaults | |
18 | .SH SYNOPSIS | |
19 | .B lpoptions | |
20 | [ -E ] [ -U | |
21 | .I username | |
22 | ] [ -h | |
23 | .I server[:port] | |
24 | ] -d | |
25 | .I destination[/instance] | |
26 | [ -o | |
27 | .I option[=value] | |
28 | ] ... [ -o | |
29 | .I option[=value] | |
30 | ] | |
31 | .br | |
32 | .B lpoptions | |
33 | [ -E ] [ -U | |
34 | .I username | |
35 | ] [ -h | |
36 | .I server[:port] | |
37 | ] [ -p | |
38 | .I destination[/instance] | |
39 | ] -l | |
40 | .br | |
41 | .B lpoptions | |
42 | [ -E ] [ -U | |
43 | .I username | |
44 | ] [ -h | |
45 | .I server[:port] | |
46 | ] [ -o | |
47 | .I option[=value] | |
48 | ] ... [ -o | |
49 | .I option[=value] | |
50 | ] [ -p | |
51 | .I destination[/instance] | |
52 | ] -r | |
53 | .I option | |
54 | .br | |
55 | .B lpoptions | |
56 | [ -E ] [ -U | |
57 | .I username | |
58 | ] [ -h | |
59 | .I server[:port] | |
60 | ] -x | |
61 | .I destination[/instance] | |
62 | .SH DESCRIPTION | |
63 | \fIlpoptions\fR displays or sets printer options and defaults. | |
64 | \fIlpoptions\fR shows the default printer options when run with no | |
65 | arguments. Other options include: | |
66 | .TP 5 | |
67 | -E | |
68 | .br | |
69 | Enables encryption when communicating with the CUPS server. | |
70 | .TP 5 | |
71 | -U username | |
72 | .br | |
73 | Uses an alternate username. | |
74 | .TP 5 | |
75 | -d destination[/instance] | |
76 | .br | |
77 | Sets the default printer to \fIdestination\fR. If \fIinstance\fR | |
78 | is supplied then that particular instance is used. This option | |
79 | overrides the system default printer for the current user. | |
80 | .TP 5 | |
81 | -h server[:port] | |
82 | .br | |
83 | Uses an alternate server. | |
84 | .TP 5 | |
85 | -l | |
86 | .br | |
87 | Lists the printer specific options and their current settings. | |
88 | .TP 5 | |
89 | -o option[=value] | |
90 | .br | |
91 | Specifies a new option for the named destination. | |
92 | .TP 5 | |
93 | -p destination[/instance] | |
94 | .br | |
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. | |
98 | .TP 5 | |
99 | -r option | |
100 | .br | |
101 | Removes the specified option for the named destination. | |
102 | .TP 5 | |
103 | -x destination[/instance] | |
104 | .br | |
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. | |
108 | .LP | |
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. | |
112 | .LP | |
113 | Options set with the \fIlpoptions\fR command are used by the | |
114 | \fIlp(1)\fR and \fIlpr(1)\fR commands when submitting jobs. | |
115 | .SH ROOT ACCOUNT OPTIONS | |
116 | When run by the root user, \fIlpoptions\fR gets and sets default | |
117 | options and instances for \fIall users\fR in the | |
118 | @CUPS_SERVERROOT@/lpoptions file. | |
119 | .SH COMPATIBILITY | |
120 | The \fIlpoptions\fR command is unique to CUPS. | |
121 | .SH FILES | |
122 | ~/.cups/lpoptions - user defaults and instances created by non-root | |
123 | users. | |
124 | .br | |
125 | @CUPS_SERVERROOT@/lpoptions - system-wide defaults and instances | |
126 | created by the root user. | |
127 | .SH SEE ALSO | |
128 | \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpr(1)\fR, | |
129 | .br | |
130 | http://localhost:631/help | |
131 | .SH COPYRIGHT | |
132 | Copyright 2007 by Apple Inc. | |
133 | .\" | |
134 | .\" End of "$Id: lpoptions.man.in 6649 2007-07-11 21:46:42Z mike $". | |
135 | .\" |