Print this page
9842 man page typos and spelling
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/lp.1
+++ new/usr/src/man/man1/lp.1
1 1 .\"
2 2 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for
3 3 .\" permission to reproduce portions of its copyrighted documentation.
4 4 .\" Original documentation from The Open Group can be obtained online at
5 5 .\" http://www.opengroup.org/bookstore/.
6 6 .\"
7 7 .\" The Institute of Electrical and Electronics Engineers and The Open
8 8 .\" Group, have given us permission to reprint portions of their
9 9 .\" documentation.
10 10 .\"
11 11 .\" In the following statement, the phrase ``this text'' refers to portions
12 12 .\" of the system documentation.
13 13 .\"
14 14 .\" Portions of this text are reprinted and reproduced in electronic form
15 15 .\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
16 16 .\" Standard for Information Technology -- Portable Operating System
17 17 .\" Interface (POSIX), The Open Group Base Specifications Issue 6,
18 18 .\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
19 19 .\" Engineers, Inc and The Open Group. In the event of any discrepancy
20 20 .\" between these versions and the original IEEE and The Open Group
21 21 .\" Standard, the original IEEE and The Open Group Standard is the referee
22 22 .\" document. The original Standard can be obtained online at
23 23 .\" http://www.opengroup.org/unix/online.html.
24 24 .\"
25 25 .\" This notice shall appear on any product containing this material.
26 26 .\"
27 27 .\" The contents of this file are subject to the terms of the
28 28 .\" Common Development and Distribution License (the "License").
29 29 .\" You may not use this file except in compliance with the License.
30 30 .\"
31 31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 32 .\" or http://www.opensolaris.org/os/licensing.
33 33 .\" See the License for the specific language governing permissions
34 34 .\" and limitations under the License.
35 35 .\"
36 36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 38 .\" If applicable, add the following below this CDDL HEADER, with the
39 39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 41 .\"
42 42 .\"
43 43 .\" Copyright 1989 AT&T
44 44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 45 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
46 46 .\"
47 47 .TH LP 1 "Feb 25, 2017"
48 48 .SH NAME
49 49 lp \- submit print request
50 50 .SH SYNOPSIS
51 51 .LP
52 52 .nf
53 53 \fBlp\fR [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR]
54 54 [\fB-H\fR \fIspecial-handling\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR]
55 55 [\fB-P\fR \fIpage-list\fR] [\fB-q\fR \fIpriority-level\fR]
56 56 [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] [\fB-t\fR \fItitle\fR]
57 57 [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR] [\fIfile\fR]...
58 58 .fi
59 59
60 60 .LP
61 61 .nf
62 62 \fBlp\fR \fB-i\fR \fIrequest-ID\fR... [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR]
63 63 [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] [\fB-H\fR \fIspecial-handling\fR]
64 64 [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] [\fB-P\fR \fIpage-list\fR]
65 65 [\fB-q\fR \fIpriority-level\fR] [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR]
66 66 [\fB-t\fR \fItitle\fR] [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR]
67 67 .fi
68 68
69 69 .SH DESCRIPTION
70 70 .LP
71 71 The \fBlp\fR utility submits print requests to a destination. There are two
72 72 formats of the \fBlp\fR command.
73 73 .sp
74 74 .LP
75 75 The first form of \fBlp\fR prints files (\fIfile\fR) and associated information
76 76 (collectively called a \fIprint request\fR). If \fIfile\fR is not specified,
77 77 \fBlp\fR assumes the standard input. Use a hyphen (\fB\(mi\fR) with \fIfile\fR
78 78 to specify the standard input. Files are printed in the order in which they
79 79 appear on the command line.
80 80 .sp
81 81 .LP
82 82 The second form of \fBlp\fR changes print request options. This form of
83 83 \fBlp\fR can only be used with print services and protocols that support job
84 84 modification. The LP print service allows print requests to be modified when
85 85 they are in a queue local to the system that the lp commands was executed on.
86 86 The Internet Print Protocol (IPP) allows job modification on remote ipp print
87 87 services.
88 88 .sp
89 89 .LP
90 90 The print request identified by \fIrequest-ID\fR is changed according to the
91 91 printing options specified. The printing options available are the same as
92 92 those with the first form of the \fBlp\fR. If the request has finished printing
93 93 when the \fBlp\fR command is executed, the change is rejected. If the request
94 94 is in the process of printing, it is stopped and restarted from the beginning
95 95 (unless the \fB-P\fR option has been given).
96 96 .sp
97 97 .LP
98 98 The print client commands locate destination information using the "printers"
99 99 database in the name service switch. See \fBnsswitch.conf\fR(4),
100 100 \fBprinters\fR(4), and \fBprinters.conf\fR(4) for details.
101 101 .SH OPTIONS
102 102 .LP
103 103 Printers that have a 4.\fIx\fR or \fBBSD-based print server\fR are not
104 104 configured to handle \fBBSD\fR protocol extensions. \fBlp\fR handles print
105 105 requests sent to such destinations differently (see NOTES).
106 106 .sp
107 107 .LP
108 108 The following options are supported:
109 109 .sp
110 110 .ne 2
111 111 .na
112 112 \fB\fB-c\fR\fR
113 113 .ad
114 114 .RS 23n
115 115 Copies \fIfile\fR before printing.
116 116 .sp
117 117 Unless \fB-c\fR is specified, users should not remove any \fIfile\fR before the
118 118 print request has completely printed. Changes made to \fIfile\fR after the
119 119 print request is made but before it is printed might be reflected in the
120 120 printed output. \fIfile\fR is linked (as opposed to copied).
121 121 .RE
122 122
123 123 .sp
124 124 .ne 2
125 125 .na
126 126 \fB\fB-d\fR \fIdestination\fR\fR
127 127 .ad
128 128 .RS 23n
129 129 Prints \fIfile\fR on a specific destination. The \fB-d\fR option is used to set
130 130 the destination only when the job is first created. (\fBNote:\fR To move
131 131 existing jobs to a different destination, see \fBlpmove\fR(1M).)
132 132 \fIdestination\fR can be either a printer or a class of printers (see
133 133 \fBlpadmin\fR(1M)). Specify \fIdestination\fR using atomic, URI-style
134 134 (\fIscheme\fR://\fIendpoint\fR), or POSIX-style
135 135 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
136 136 more information.
137 137 .RE
138 138
139 139 .sp
140 140 .ne 2
141 141 .na
142 142 \fB\fB-f\fR \fIform-name\fR\fR
143 143 .ad
144 144 .RS 23n
145 145 Prints \fIfile\fR on \fIform-name\fR. The \fBLP\fR print service ensures that
146 146 the form is mounted on the printer. The print request is rejected if the
147 147 printer does not support \fIform-name\fR, if \fIform-name\fR is not defined for
148 148 the system, or if the user is not allowed to use \fIform-name\fR (see
149 149 \fBlpforms\fR(1M)).
150 150 .RE
151 151
152 152 .sp
153 153 .ne 2
154 154 .na
155 155 \fB\fB-H\fR \fIspecial-handling\fR\fR
156 156 .ad
157 157 .RS 23n
158 158 Prints the print request according to the value of \fIspecial-handling\fR. The
159 159 following \fIspecial-handling\fR values are acceptable:
160 160 .sp
161 161 .ne 2
162 162 .na
163 163 \fB\fBhold\fR\fR
164 164 .ad
165 165 .RS 13n
166 166 Do not print the print request until notified. If printing has already begun,
167 167 stop it. Other print requests are placed ahead of a request that has been put
168 168 on hold (\fIheld print request\fR) until the print request is resumed.
169 169 .RE
170 170
171 171 .sp
172 172 .ne 2
173 173 .na
174 174 \fB\fBresume\fR\fR
175 175 .ad
176 176 .RS 13n
177 177 Resume a held print request. If the print request had begun to print when held,
178 178 it is the next print request printed, unless it is superseded by an
179 179 \fIimmediate\fR print request.
180 180 .RE
181 181
182 182 .sp
183 183 .ne 2
184 184 .na
185 185 \fB\fBimmediate\fR\fR
186 186 .ad
187 187 .RS 13n
188 188 Print the print request next. If more than one print request is assigned, the
189 189 most recent print request is printed next. If a print request is currently
190 190 printing on the desired printer, a \fBhold\fR request must be issued to allow
191 191 the immediate request to print. The \fBimmediate\fR request is only available
192 192 to \fBLP\fR administrators.
193 193 .RE
194 194
195 195 .RE
196 196
197 197 .sp
198 198 .ne 2
199 199 .na
200 200 \fB\fB-i\fR \fIrequest-ID\fR\fR
201 201 .ad
202 202 .RS 23n
203 203 Changes options for the print request identified by \fIrequest-ID\fR. There
204 204 must be a space between \fB-i\fR and \fIrequest-ID\fR.
205 205 .sp
206 206 This option applies to jobs that are in a local queue on a print server. This
207 207 also applies to remote queues on when the remote print server supports IPP with
208 208 job modification.
209 209 .RE
210 210
211 211 .sp
212 212 .ne 2
213 213 .na
214 214 \fB\fB-m\fR\fR
215 215 .ad
216 216 .RS 23n
217 217 Sends mail after \fIfile\fR has printed (see \fBmail\fR(1)). By default, no
218 218 mail is sent upon normal completion of a print request.
219 219 .RE
220 220
221 221 .sp
222 222 .ne 2
223 223 .na
224 224 \fB\fB-n\fR \fInumber\fR\fR
225 225 .ad
226 226 .RS 23n
227 227 Prints a specific number of copies of \fIfile\fR. Specify \fInumber\fR as a
228 228 digit. The default for \fInumber\fR is \fB1\fR.
229 229 .RE
230 230
231 231 .sp
232 232 .ne 2
233 233 .na
234 234 \fB\fB-o\fR \fIoption\fR\fR
235 235 .ad
236 236 .RS 23n
237 237 Specifies printer-dependent \fIoptions\fR. Specify several options by
238 238 specifying \fB-o\fR \fIoption\fR multiple times (\fB-o\fR \fIoption\fR \fB-o\fR
239 239 \fIoption\fR \fB-o\fR \fIoption\fR ). Printer-dependent options can also be
240 240 specified using the \fB-o\fR keyletter once, followed by a list of options
241 241 enclosed in double quotes (\fB-o\fR"\fIoption\fR \fIoption option\fR").
242 242 .sp
243 243 \fIoption\fRs take the following forms:
244 244 .sp
245 245 .ne 2
246 246 .na
247 247 \fB\fIkey\fR\fB=\fR\fIvalue\fR\fR
248 248 .ad
249 249 .RS 13n
250 250 Associates information with the request for use by the backend print service.
251 251 The keys and values that can be used are specific to the backend print service
252 252 and queue configuration.
253 253 .RE
254 254
255 255 .sp
256 256 .ne 2
257 257 .na
258 258 \fB\fB[no]key\fR\fR
259 259 .ad
260 260 .RS 13n
261 261 Associates boolean information with the request for use by the backend print
262 262 service. The keys that can be used are specific to the backend print service
263 263 and queue configuration.
264 264 .RE
265 265
266 266 The following options are commonly used with the LP print service:
267 267 .sp
268 268 .ne 2
269 269 .na
270 270 \fB\fBnobanner\fR\fR
271 271 .ad
272 272 .sp .6
273 273 .RS 4n
274 274 Does not print a banner page with the request. This option can be disallowed by
275 275 the \fBLP\fR administrator.
276 276 .sp
277 277 On a system that is configured with Trusted Extensions, use of this option
278 278 requires the \fBsolaris.print.nobanner\fR authorization.
279 279 .RE
280 280
281 281 .sp
282 282 .ne 2
283 283 .na
284 284 \fB\fBnofilebreak\fR\fR
285 285 .ad
286 286 .sp .6
287 287 .RS 4n
288 288 Prints multiple files without inserting a form feed between them.
289 289 .RE
290 290
291 291 .sp
292 292 .ne 2
293 293 .na
294 294 \fB\fBnolabels\fR\fR
295 295 .ad
296 296 .sp .6
297 297 .RS 4n
298 298 On a system that is configured with Trusted Extensions, specifies suppression
299 299 of page header and footer labels. Use of this option requires the
300 300 \fBsolaris.print.unlabeled\fR authorization.
301 301 .RE
|
↓ open down ↓ |
301 lines elided |
↑ open up ↑ |
302 302
303 303 .sp
304 304 .ne 2
305 305 .na
306 306 \fB\fBlength=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR
307 307 .ad
308 308 .sp .6
309 309 .RS 4n
310 310 Prints the print request with pages of a specific length in inches,
311 311 centimeters, or number of lines. Append the letter \fBi\fR for inches or
312 -\fBc\fR for centimenters to \fInumber\fR. Indicate the number of lines by
312 +\fBc\fR for centimeters to \fInumber\fR. Indicate the number of lines by
313 313 specifying \fInumber\fR alone. \fBlength=66\fR indicates a page length of
314 314 \fB66\fR lines. \fBlength=11i\fR indicates a page length of \fB11\fR inches.
315 315 \fBlength=27.94c\fR indicates a page length of \fB27.94\fR centimeters.
316 316 .sp
317 317 This option can not be used with the \fB-f\fR option.
318 318 .RE
319 319
320 320 .sp
321 321 .ne 2
322 322 .na
323 323 \fB\fBwidth=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR
324 324 .ad
325 325 .sp .6
326 326 .RS 4n
327 327 Prints the print request with pages of a specific width in inches, centimeters,
328 328 or number of columns. Append the letter \fBi\fR for inches or \fBc\fR for
329 329 centimeters to \fInumber\fR. Indicate the number of columns by specifying
330 330 \fInumber\fR alone. \fBwidth=65\fR indicates a page width of \fB65\fR columns.
331 331 \fBwidth=6.5i\fR indicates a page width of \fB6.5\fR inches. \fBwidth=10c\fR
332 332 indicates a page width of \fB10\fR centimeters.
333 333 .sp
334 334 This option can not be used with the \fB-f\fR option.
335 335 .RE
336 336
337 337 .sp
338 338 .ne 2
339 339 .na
340 340 \fB\fBlpi=\fR\fInumber\fR\fR
341 341 .ad
342 342 .sp .6
343 343 .RS 4n
344 344 Prints the print request with the line pitch set to \fInumber\fR lines in an
345 345 inch. Use \fInumber\fR to specify the number of lines in an inch.
346 346 .sp
347 347 This option can not be used with the \fB-f\fR option.
348 348 .RE
349 349
350 350 .sp
351 351 .ne 2
352 352 .na
353 353 \fB\fBcpi=\fR\fIn\fR|\fBpica\fR|\fBelite\fR|\fBcompressed\fR\fR
354 354 .ad
355 355 .sp .6
356 356 .RS 4n
357 357 Prints the print request with the character pitch set to \fInumber\fR
358 358 characters in an inch. Use \fInumber\fR to specify the number of characters in
359 359 an inch. Use \fBpica\fR to set character pitch to pica (\fB10\fR characters per
360 360 inch), or \fBelite\fR to set character pitch to elite (\fB12\fR characters per
361 361 inch) Use \fBcompressed\fR to set character pitch to as many characters as the
362 362 printer can handle. There is no standard number of characters per inch for all
363 363 printers; see the \fBterminfo\fR database (see \fBterminfo\fR(4)) for the
364 364 default character pitch for your printer. This option can not be used with the
365 365 \fB-f\fR option.
366 366 .RE
367 367
368 368 .sp
369 369 .ne 2
370 370 .na
371 371 \fB\fBstty=\fR\fIstty-option-list\fR\fR
372 372 .ad
373 373 .sp .6
374 374 .RS 4n
375 375 Prints the request using a list of options valid for the \fBstty\fR command
376 376 (see \fBstty\fR(1). Enclose the list in single quotes (\fB`'\fR) if it contains
377 377 blanks.
378 378 .RE
379 379
380 380 .RE
381 381
382 382 .sp
383 383 .ne 2
384 384 .na
385 385 \fB\fB-P\fR \fIpage-list\fR\fR
386 386 .ad
387 387 .RS 23n
388 388 Prints the pages specified in \fIpage-list\fR in ascending order. Specify
389 389 \fIpage-list\fR as a of range of numbers, single page number, or a combination
390 390 of both.
391 391 .sp
392 392 The \fB-P\fR option can only be used if there is a filter available to handle
393 393 it; otherwise, the print request is rejected.
394 394 .RE
395 395
396 396 .sp
397 397 .ne 2
398 398 .na
399 399 \fB\fB-p\fR\fR
400 400 .ad
401 401 .RS 23n
402 402 Enables notification on completion of the print request. Delivery of the
403 403 notification is dependent on additional software.
404 404 .RE
405 405
406 406 .sp
407 407 .ne 2
408 408 .na
409 409 \fB\fB-q\fR \fIpriority-level\fR\fR
410 410 .ad
411 411 .RS 23n
412 412 Assigns the print request a priority in the print queue. Specify
413 413 \fIpriority-level\fR as an integer between from \fB0\fR and \fB39\fR. Use
414 414 \fB0\fR to indicate the highest priority; \fB39\fR to indicate the lowest
415 415 priority. If no priority is specified, the default priority for a print service
416 416 is assigned by the \fBLP\fR administrator. The \fBLP\fR administrator can also
417 417 assign a default priority to individual users.
418 418 .RE
419 419
420 420 .sp
421 421 .ne 2
422 422 .na
423 423 \fB\fB-s\fR\fR
424 424 .ad
425 425 .RS 23n
426 426 Suppresses the display of messages sent from \fBlp\fR.
427 427 .RE
428 428
429 429 .sp
430 430 .ne 2
431 431 .na
432 432 \fB\fB-S\fR \fIcharacter-set\fR \fB|\fR\fR
433 433 .ad
434 434 .br
435 435 .na
436 436 \fB\fB-S\fR \fIprint-wheel\fR\fR
437 437 .ad
438 438 .RS 23n
439 439 Prints the request using the \fIcharacter-set\fR or \fIprint-wheel\fR. If a
440 440 form was requested and requires a character set or print wheel other than the
441 441 one specified with the \fB-S\fR option, the request is rejected. Printers using
442 442 mountable print wheels or font cartridges use the print wheel or font cartridge
443 443 mounted at the time of the print request, unless the \fB-S\fR option is
444 444 specified.
445 445 .sp
446 446 Printers Using Print Wheels: If \fBprint\fR \fIwheel\fR is not one listed by
447 447 the \fBLP\fR administrator as acceptable for the printer the request is
448 448 rejected unless the print wheel is already mounted on the printer.
449 449 .sp
450 450 Printers Using Selectable or Programmable Character Sets: If the \fB-S\fR
451 451 option is not specified, \fBlp\fR uses the standard character set. If
452 452 \fIcharacter-set\fR is not defined in the \fBterminfo\fR database for the
453 453 printer (see \fBterminfo\fR(4)), or is not an alias defined by the \fBLP\fR
454 454 administrator, the request is rejected.
455 455 .RE
456 456
457 457 .sp
458 458 .ne 2
459 459 .na
460 460 \fB\fB-t\fR \fItitle\fR\fR
461 461 .ad
462 462 .RS 23n
463 463 Prints a title on the banner page of the output. Enclose \fItitle\fR in quotes
464 464 if it contains blanks. If \fItitle\fR is not not specified, the name of the
465 465 file is printed on the banner page.
466 466 .RE
467 467
468 468 .sp
469 469 .ne 2
470 470 .na
471 471 \fB\fB\fR\fB-T\fR\fIcontent-type\fR [\fB-r\fR]\fR
472 472 .ad
473 473 .RS 23n
474 474 Prints the request on a printer that can support the specified
475 475 \fIcontent-type\fR. If no printer accepts this type directly, a filter is used
476 476 to convert the content into an acceptable type. If the \fB-r\fR option is
477 477 specified, a filter is not used. If \fB-r\fR is specified, and no printer
478 478 accepts the \fIcontent-type\fR directly, the request is rejected. If the
479 479 \fIcontent-type\fR is not acceptable to any printer, either directly or with a
480 480 filter, the request is rejected.
481 481 .RE
482 482
483 483 .sp
484 484 .ne 2
485 485 .na
486 486 \fB\fB-w\fR\fR
487 487 .ad
488 488 .RS 23n
489 489 Writes a message on the user's terminal after the \fIfile\fRs have been
490 490 printed. If the user is not logged in, then mail is sent instead.
491 491 .RE
492 492
493 493 .sp
494 494 .ne 2
495 495 .na
496 496 \fB\fB-y\fR \fImode-list\fR\fR
497 497 .ad
498 498 .RS 23n
499 499 Prints the request according to the printing modes listed in \fImode-list\fR.
500 500 The allowed values for \fImode-list\fR are locally defined.
501 501 .sp
502 502 This option can be used only if there is a filter available to handle it;
503 503 otherwise, the print request is rejected.
504 504 .RE
505 505
506 506 .SH OPERANDS
507 507 .LP
508 508 The following operand is supported:
509 509 .sp
510 510 .ne 2
511 511 .na
512 512 \fB\fIfile\fR\fR
513 513 .ad
514 514 .RS 8n
515 515 The name of the file to be printed. Specify \fIfile\fR as a pathname or as a
516 516 hyphen (\fB\(mi\fR) to indicate the standard input. If \fIfile\fR is not
517 517 specified, \fBlp\fR uses the standard input.
518 518 .RE
519 519
520 520 .SH USAGE
521 521 .LP
522 522 See \fBlargefile\fR(5) for the description of the behavior of \fBlp\fR when
523 523 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
524 524 .SH ENVIRONMENT VARIABLES
525 525 .LP
526 526 See \fBenviron\fR(5) for descriptions of the following environment variables
527 527 that affect the execution of \fBlp\fR: \fBLANG\fR, \fBLC_ALL\fR,
528 528 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBNLSPATH\fR, and \fBPATH\fR.
529 529 .sp
530 530 .ne 2
531 531 .na
532 532 \fB\fBLC_TIME\fR\fR
533 533 .ad
534 534 .RS 11n
535 535 Determine the format and contents of date and time strings displayed in the
536 536 \fBlp\fR banner page, if any.
537 537 .RE
538 538
539 539 .sp
540 540 .ne 2
541 541 .na
542 542 \fB\fBLPDEST\fR\fR
543 543 .ad
544 544 .RS 11n
545 545 Determine the destination. If the \fBLPDEST\fR environment variable is not set,
546 546 the \fBPRINTER\fR environment variable shall be used. The \fB-d\fR \fIdest\fR
547 547 option takes precedence over \fBLPDEST\fR. Results are undefined when \fB-d\fR
548 548 is not specified and \fBLPDEST\fR contains a value that is not a valid
549 549 destination name.
550 550 .RE
551 551
552 552 .sp
553 553 .ne 2
554 554 .na
555 555 \fB\fBPRINTER\fR\fR
556 556 .ad
557 557 .RS 11n
558 558 Determine the output device or destination. If the \fBLPDEST\fR and
559 559 \fBPRINTER\fR environment variables are not set, an unspecified output device
560 560 is used. The \fB-d\fR \fIdest\fR option and the \fBLPDEST\fR environment
561 561 variable shall take precedence over \fBPRINTER\fR. Results are undefined when
562 562 \fB-d\fR is not specified, \fBLPDEST\fR is unset, and \fBPRINTER\fR contains a
563 563 value that is not a valid device or destination name.
564 564 .RE
565 565
566 566 .sp
567 567 .ne 2
568 568 .na
569 569 \fB\fBTZ\fR\fR
570 570 .ad
571 571 .RS 11n
572 572 Determine the timezone used to calculate date and time strings displayed in the
573 573 \fBlp\fR banner page, if any. If \fBTZ\fR is unset or null, an unspecified
574 574 default timezone shall be used.
575 575 .RE
576 576
577 577 .SH EXIT STATUS
578 578 .LP
579 579 The following exit values are returned:
580 580 .sp
581 581 .ne 2
582 582 .na
583 583 \fB\fB0\fR\fR
584 584 .ad
585 585 .RS 12n
586 586 Successful completion.
587 587 .RE
588 588
589 589 .sp
590 590 .ne 2
591 591 .na
592 592 \fBnon-zero\fR
593 593 .ad
594 594 .RS 12n
595 595 An error occurred.
596 596 .RE
597 597
598 598 .SH FILES
599 599 .ne 2
600 600 .na
601 601 \fB\fB/etc/printers.conf\fR\fR
602 602 .ad
603 603 .RS 24n
604 604 System printer configuration database
605 605 .RE
606 606
607 607 .sp
608 608 .ne 2
609 609 .na
610 610 \fB\fB$HOME/.printers\fR\fR
611 611 .ad
612 612 .RS 24n
613 613 User-configurable printer database
614 614 .RE
615 615
616 616 .sp
617 617 .ne 2
618 618 .na
619 619 \fB\fBou=printers\fR\fR
620 620 .ad
621 621 .RS 24n
622 622 LDAP version of \fB/etc/printers.conf\fR
623 623 .RE
624 624
625 625 .sp
626 626 .ne 2
627 627 .na
628 628 \fB\fBprinters.conf.byname\fR\fR
629 629 .ad
630 630 .RS 24n
631 631 \fBNIS\fR version of \fB/etc/printers.conf\fR
632 632 .RE
633 633
634 634 .SH ATTRIBUTES
635 635 .LP
636 636 See \fBattributes\fR(5) for descriptions of the following attributes:
637 637 .sp
638 638
639 639 .sp
640 640 .TS
641 641 box;
642 642 c | c
643 643 l | l .
644 644 ATTRIBUTE TYPE ATTRIBUTE VALUE
645 645 _
646 646 CSI Enabled. See \fBNOTES\fR.
647 647 _
648 648 Interface Stability Standard
649 649 .TE
650 650
651 651 .SH SEE ALSO
652 652 .LP
653 653 \fBcancel\fR(1), \fBenable\fR(1), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlprm\fR(1B),
654 654 \fBlpstat\fR(1), \fBmail\fR(1), \fBpostprint\fR(1), \fBpr\fR(1), \fBstty\fR(1),
655 655 \fBaccept\fR(1M), \fBlpadmin\fR(1M), \fBlpfilter\fR(1M), \fBlpforms\fR(1M),
656 656 \fBlpmove\fR(1M), \fBlpsched\fR(1M), \fBlpshut\fR(1M), \fBlpsystem\fR(1M),
657 657 \fBlpusers\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4),
658 658 \fBprinters.conf\fR(4), \fBterminfo\fR(4), \fBattributes\fR(5),
659 659 \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
660 660 .SH NOTES
661 661 .LP
662 662 \fBCSI\fR-capability assumes that printer names are composed of \fBASCII\fR
663 663 characters.
664 664 .sp
665 665 .LP
666 666 Print jobs are assumed to contain one type of data. That type of data is either
667 667 specified on the command line or autodetected (simple, PostScript) based on the
668 668 contents of the first file in the job.
669 669 .sp
670 670 .LP
671 671 When using the BSD printing protocol to send print requests to a remote print
672 672 service, functionality is limited.
673 673 .sp
674 674 .LP
675 675 Printers that have a 4.\fIx\fR or BSD-based print server are not configured to
676 676 handle BSD protocol extensions. \fBlp\fR handles print requests sent to such
677 677 printers in the following ways:
678 678 .RS +4
679 679 .TP
680 680 1.
681 681 Print requests with more than 52 filenames are truncated to 52 files.
682 682 .RE
683 683 .RS +4
684 684 .TP
685 685 2.
686 686 The \fB-f\fR, \fB-H\fR, \fB-o\fR, \fB-P\fR, \fB-p\fR, \fB-q\fR, \fB-S\fR,
687 687 \fB-T\fR, and \fB-y\fR options might require a protocol extension to pass to a
688 688 print server. If \fBlp\fR cannot handle the print request, it displays a
689 689 warning message.
690 690 .sp
691 691 \fBLP\fR administrators enable protocol extensions by setting a printer's
692 692 \fBprinter-uri-supported\fR (or \fBbsdaddr\fR) entry in
693 693 \fB/etc/printers.conf\fR. Changing the \fBprinter-uri-supported\fR entry in
694 694 \fB/etc/printers.conf\fR to:
695 695 .sp
696 696 .in +2
697 697 .nf
698 698 \fBprinter-uri-supported=lpd\e://\fR\fIserver\fR\fB/\fR\fIprinters\fR\fB/\fR\fIdestination\fR\fB#Solaris\fR
699 699 .fi
700 700 .in -2
701 701 .sp
702 702
703 703 .sp
704 704 .in +2
705 705 .nf
706 706 \fBbsdaddr=\fR\fIserver\fR\fB,\fR\fIdestination\fR\fB,Solaris\fR
707 707 .fi
708 708 .in -2
709 709 .sp
710 710
711 711 Adding \fBSolaris\fR to either of these values causes the \fBlp\fR command to
712 712 generate a set of BSD print protocol extensions that can be processed by a
713 713 Solaris print server.
714 714 .RE
715 715 .sp
716 716 .LP
717 717 As a result of several limitations in the BSD print protocol, it is recommended
718 718 that the IPP protocol be used for communication with print servers.
719 719 .sp
720 720 .LP
721 721 When IPP is in use, the user is prompted for a passphrase if the remote print
722 722 service is configured to require authentication.
|
↓ open down ↓ |
400 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX