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