]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
cfa19b58 | 2 | .\" lpadmin man page for CUPS. |
ef416fc2 | 3 | .\" |
f61dfc0d | 4 | .\" Copyright 2007-2018 by Apple Inc. |
cfa19b58 | 5 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 6 | .\" |
e3101897 | 7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. |
ef416fc2 | 8 | .\" |
003c1790 | 9 | .TH lpadmin 8 "CUPS" "19 March 2018" "Apple Inc." |
ef416fc2 | 10 | .SH NAME |
11 | lpadmin \- configure cups printers and classes | |
12 | .SH SYNOPSIS | |
13 | .B lpadmin | |
cfa19b58 MS |
14 | [ |
15 | .B \-E | |
16 | ] [ | |
17 | .B \-U | |
bd7854cb | 18 | .I username |
cfa19b58 MS |
19 | ] [ |
20 | \fB\-h \fIserver\fR[\fB:\fIport\fR] | |
21 | ] | |
22 | .B \-d | |
ef416fc2 | 23 | .I destination |
24 | .br | |
25 | .B lpadmin | |
cfa19b58 MS |
26 | [ |
27 | .B \-E | |
28 | ] [ | |
29 | .B \-U | |
bd7854cb | 30 | .I username |
cfa19b58 MS |
31 | ] [ |
32 | \fB\-h \fIserver\fR[\fB:\fIport\fR] | |
33 | ] | |
34 | .B \-p | |
eac3a0a0 | 35 | .I destination |
cfa19b58 MS |
36 | [ |
37 | .B \-R | |
eac3a0a0 MS |
38 | .I name-default |
39 | ] | |
40 | .I option(s) | |
ef416fc2 | 41 | .br |
42 | .B lpadmin | |
cfa19b58 MS |
43 | [ |
44 | .B \-E | |
45 | ] [ | |
46 | .B \-U | |
bd7854cb | 47 | .I username |
cfa19b58 MS |
48 | ] [ |
49 | \fB\-h \fIserver\fR[\fB:\fIport\fR] | |
50 | ] | |
51 | .B \-x | |
ef416fc2 | 52 | .I destination |
53 | .SH DESCRIPTION | |
cfa19b58 MS |
54 | \fBlpadmin\fR configures printer and class queues provided by CUPS. |
55 | It can also be used to set the server default printer or class. | |
ef416fc2 | 56 | .LP |
cfa19b58 | 57 | When specified before the \fI-d\fR, \fI-p\fR, or \fI-x\fR options, the \fI-E\fR option forces encryption when connecting to the server. |
ef416fc2 | 58 | .LP |
cfa19b58 MS |
59 | The first form of the command (\fI-d\fR) sets the default printer or class to \fIdestination\fR. |
60 | Subsequent print jobs submitted via the | |
61 | .BR lp (1) | |
62 | or | |
63 | .BR lpr (1) | |
64 | commands will use this destination unless the user specifies otherwise with the | |
65 | .BR lpoptions (1) | |
66 | command. | |
ef416fc2 | 67 | .LP |
cfa19b58 | 68 | The second form of the command (\fI-p\fR) configures the named printer or class. The additional options are described below. |
ef416fc2 | 69 | .LP |
cfa19b58 MS |
70 | The third form of the command (\fI-x\fR) deletes the printer or class \fIdestination\fR. |
71 | Any jobs that are pending for the destination will be removed and any job that is currently printed will be aborted. | |
72 | .SH OPTIONS | |
73 | The following options are recognized when configuring a printer queue: | |
ef416fc2 | 74 | .TP 5 |
cfa19b58 MS |
75 | \fB\-c \fIclass\fR |
76 | Adds the named \fIprinter\fR to \fIclass\fR. | |
77 | If \fIclass\fR does not exist it is created automatically. | |
ef416fc2 | 78 | .TP 5 |
cfa19b58 | 79 | \fB\-m \fImodel\fR |
e67e2f9e | 80 | Sets a standard PPD file for the printer from the \fImodel\fR directory or using one of the driver interfaces. |
cfa19b58 MS |
81 | Use the \fI-m\fR option with the |
82 | .BR lpinfo (8) | |
83 | command to get a list of supported models. | |
e67e2f9e | 84 | The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP \fIdevice-uri\fR. |
ada35e59 | 85 | Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS. |
eac3a0a0 | 86 | .TP 5 |
cfa19b58 MS |
87 | \fB\-o cupsIPPSupplies=true\fR |
88 | .TP 5 | |
89 | \fB\-o cupsIPPSupplies=false\fR | |
eac3a0a0 MS |
90 | Specifies whether IPP supply level values should be reported. |
91 | .TP 5 | |
cfa19b58 | 92 | \fB\-o cupsSNMPSupplies=true\fR |
eac3a0a0 | 93 | .TP 5 |
cfa19b58 | 94 | \fB\-o cupsSNMPSupplies=false\fR |
eac3a0a0 MS |
95 | Specifies whether SNMP supply level (RFC 3805) values should be reported. |
96 | .TP 5 | |
cfa19b58 MS |
97 | \fB\-o job\-k\-limit=\fIvalue\fR |
98 | Sets the kilobyte limit for per-user quotas. | |
99 | The value is an integer number of kilobytes; one kilobyte is 1024 bytes. | |
ef416fc2 | 100 | .TP 5 |
cfa19b58 MS |
101 | \fB\-o job\-page\-limit=\fIvalue\fR |
102 | Sets the page limit for per-user quotas. | |
103 | The value is the integer number of pages that can be printed; double-sided pages are counted as two pages. | |
ef416fc2 | 104 | .TP 5 |
cfa19b58 MS |
105 | \fB-o job\-quota\-period=\fIvalue\fR |
106 | Sets the accounting period for per-user quotas. | |
107 | The value is an integer number of seconds; 86,400 seconds are in one day. | |
ef416fc2 | 108 | .TP 5 |
cfa19b58 | 109 | \fB\-o job\-sheets\-default=\fIbanner\fR |
bd7854cb | 110 | .TP 5 |
cfa19b58 | 111 | \fB\-o job\-sheets\-default=\fIbanner\fB,\fIbanner\fR |
bd7854cb | 112 | Sets the default banner page(s) to use for print jobs. |
113 | .TP 5 | |
cfa19b58 MS |
114 | \fB\-o \fIname\fB=\fIvalue\fR |
115 | Sets a PPD option for the printer. | |
116 | PPD options can be listed using the \fI-l\fR option with the | |
117 | .BR lpoptions (1) | |
118 | command. | |
119 | .TP 5 | |
120 | \fB\-o \fIname\fB-default=\fIvalue\fR | |
121 | Sets a default server-side option for the destination. | |
122 | Any print-time option can be defaulted, e.g., "-o number-up-default=2" to set the default "number-up" option value to 2. | |
123 | .TP 5 | |
124 | \fB\-o port\-monitor=\fIname\fR | |
125 | Sets the binary communications program to use when printing, "none", "bcp", or "tbcp". | |
126 | The default program is "none". | |
127 | The specified port monitor must be listed in the printer's PPD file. | |
128 | .TP 5 | |
129 | \fB\-o printer-error-policy=\fIname\fR | |
130 | Sets the error policy to be used when the printer backend is unable to send the job to the printer. | |
131 | The name must be one of "abort-job", "retry-job", "retry-current-job", or "stop-printer". | |
132 | The default error policy is "stop-printer" for printers and "retry-current-job" for | |
7cf5915e | 133 | classes. |
8ca02f3c | 134 | .TP 5 |
cfa19b58 MS |
135 | \fB\-o printer\-is\-shared=true\fR |
136 | .TP 5 | |
137 | \fB\-o printer\-is\-shared=false\fR | |
7cf5915e | 138 | Sets the destination to shared/published or unshared/unpublished. |
cfa19b58 MS |
139 | Shared/published destinations are publicly announced by the server on the LAN based on the browsing configuration in \fIcupsd.conf\fR, while unshared/unpublished destinations are not announced. |
140 | The default value is "true". | |
8ca02f3c | 141 | .TP 5 |
cfa19b58 MS |
142 | \fB\-o printer-op-policy=\fIname\fR |
143 | Sets the IPP operation policy associated with the destination. | |
144 | The name must be defined in the \fIcupsd.conf\fR in a Policy section. | |
8ca02f3c | 145 | The default operation policy is "default". |
146 | .TP 5 | |
cfa19b58 | 147 | \fB\-R \fIname\fB\-default\fR |
eac3a0a0 MS |
148 | Deletes the named option from \fIprinter\fR. |
149 | .TP 5 | |
cfa19b58 MS |
150 | \fB\-r \fIclass\fR |
151 | Removes the named \fIprinter\fR from \fIclass\fR. | |
152 | If the resulting class becomes empty it is removed. | |
ef416fc2 | 153 | .TP 5 |
cfa19b58 | 154 | \fB-u allow:\fR{\fIuser\fR|\fB@\fIgroup\fR}{\fB,\fIuser\fR|\fB,@\fIgroup\fR}* |
80ca4592 | 155 | .TP 5 |
cfa19b58 | 156 | \fB-u deny:\fR{\fIuser\fR|\fB@\fIgroup\fR}{\fB,\fIuser\fR|\fB,@\fIgroup\fR}* |
80ca4592 | 157 | .TP 5 |
cfa19b58 | 158 | \fB\-u allow:all\fR |
80ca4592 | 159 | .TP 5 |
cfa19b58 MS |
160 | \fB\-u deny:none\fR |
161 | Sets user-level access control on a destination. | |
162 | Names starting with "@" are interpreted as UNIX groups. | |
163 | The latter two forms turn user-level access control off. | |
f80e6f38 | 164 | Note: The user 'root' is not granted special access - using "-u allow:foo,bar" will allow users 'foo' and 'bar' to access the printer but NOT 'root'. |
ef416fc2 | 165 | .TP 5 |
cfa19b58 MS |
166 | \fB\-v "\fIdevice-uri\fB"\fR |
167 | Sets the \fIdevice-uri\fR attribute of the printer queue. | |
168 | Use the \fI-v\fR option with the | |
169 | .BR lpinfo (8) | |
170 | command to get a list of supported device URIs and schemes. | |
ef416fc2 | 171 | .TP 5 |
cfa19b58 | 172 | \fB\-D "\fIinfo\fB"\fR |
7cf5915e | 173 | Provides a textual description of the destination. |
ef416fc2 | 174 | .TP 5 |
cfa19b58 | 175 | .B \-E |
7cf5915e | 176 | Enables the destination and accepts jobs; this is the same as running the |
cfa19b58 MS |
177 | .BR cupsaccept (8) |
178 | and | |
179 | .BR cupsenable (8) | |
180 | programs on the destination. | |
ef416fc2 | 181 | .TP 5 |
cfa19b58 | 182 | \fB\-L "\fIlocation\fB"\fR |
7cf5915e | 183 | Provides a textual location of the destination. |
d0df9cd3 MS |
184 | .SH DEPRECATED OPTIONS |
185 | The following \fBlpadmin\fR options are deprecated: | |
186 | .TP 5 | |
187 | \fB\-i \fIfilename\fR | |
188 | This option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file. | |
ada35e59 MS |
189 | Note: Interface scripts are not supported by CUPS. |
190 | PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS. | |
191 | .TP 5 | |
192 | \fB\-P \fIppd-file\fR | |
193 | Specifies a PostScript Printer Description (PPD) file to use with the printer. | |
194 | Note: PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS. | |
cfa19b58 MS |
195 | .SH CONFORMING TO |
196 | Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". | |
bd7854cb | 197 | Also, printer and class names are \fInot\fR case-sensitive. |
cfa19b58 MS |
198 | Finally, the CUPS version of \fBlpadmin\fR may ask the user for an access password depending on the printing system configuration. |
199 | This differs from the System V version which requires the root user to execute this command. | |
200 | .SH NOTES | |
201 | The CUPS version of \fBlpadmin\fR does not support all of the System V or Solaris printing system configuration options. | |
d0df9cd3 | 202 | Interface scripts are not supported for security reasons. |
fffed089 MS |
203 | .SH EXAMPLE |
204 | Create an IPP Everywhere print queue: | |
205 | .nf | |
206 | ||
207 | lpadmin -p myprinter -E -v ipp://myprinter.local/ipp/print -m everywhere | |
208 | ||
209 | .fi | |
ef416fc2 | 210 | .SH SEE ALSO |
cfa19b58 MS |
211 | .BR cupsaccept (8), |
212 | .BR cupsenable (8), | |
213 | .BR lpinfo (8), | |
214 | .BR lpoptions (1), | |
215 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 216 | .SH COPYRIGHT |
f61dfc0d | 217 | Copyright \[co] 2007-2018 by Apple Inc. |