| blob | 3f1e84796b42d3edbd0e88d5dc00856987009c3c |
1 '\" te
2 .\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
3 .\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved
4 .TH LPR 1B "Feb 25, 2017"
5 .SH NAME
6 lpr \- submit print requests
7 .SH SYNOPSIS
8 .LP
9 .nf
10 \fB/usr/ucb/lpr\fR [\fB-P\fR \fIdestination\fR] [\fB-#\fR \fInumber\fR] [\fB-C\fR \fIclass\fR]
11 [\fB-J\fR \fIjob\fR] [\fB-T\fR \fItitle\fR] [\fB-i\fR [\fIindent\fR]]
12 [\fB-1\fR | \fB-2\fR | \fB-3\fR | \fB-4\fR \fIfont\fR] [\fB-w\fR \fIcols\fR] [\fB-m\fR] [\fB-h\fR] [\fB-s\fR]
13 [\fB-filter_option\fR] [\fIfile\fR]...
14 .fi
16 .SH DESCRIPTION
17 .LP
18 The \fBlpr\fR utility submits print requests to a destination. \fBlpr\fR prints
19 files (\fIfile\fR) and associated information, collectively called a \fIprint
20 request\fR. If \fIfile\fR is not specified, \fBlpr\fR assumes the standard
21 input.
22 .sp
23 .LP
24 The print client commands locate destination information using the "printers"
25 database in the name service switch. See \fBnsswitch.conf\fR(4),
26 \fBprinters\fR(4), and \fBprinters.conf\fR(4) for details.
27 .sp
28 .LP
29 Print requests with more than 52 \fIfile\fRs specified is truncated to 52 files
30 when the BSD print protocol is used for job submission.
31 .SH OPTIONS
32 .LP
33 The following options are supported:
34 .sp
35 .ne 2
36 .na
37 \fB\fB-C\fR \fIclass\fR\fR
38 .ad
39 .sp .6
40 .RS 4n
41 Prints \fIclass\fR as the job classification on the banner page of the output.
42 Enclose \fIclass\fR in double quotes if it contains blanks. If \fIclass\fR is
43 not specified, the name of the system (as returned by \fBhostname\fR) is
44 printed as the job classification. See \fBhostname\fR(1).
45 .RE
47 .sp
48 .ne 2
49 .na
50 \fB\fB-h\fR\fR
51 .ad
52 .sp .6
53 .RS 4n
54 Suppresses printing of the banner page of the output.
55 .RE
57 .sp
58 .ne 2
59 .na
60 \fB\fB-i\fR \fIindent\fR\fR
61 .ad
62 .sp .6
63 .RS 4n
64 Indents the output a specific number of \fISPACE\fR characters. Use
65 \fIindent\fR to indicate the number of \fISPACE\fR characters to be indented.
66 Specify \fIindent\fR as a positive integer. If the optional argument to indent
67 is not specified, then eight \fISPACE\fR characters is the default. The
68 \fB-i\fR option is ignored unless it is specified with the \fB-p\fR filter
69 option.
70 .RE
72 .sp
73 .ne 2
74 .na
75 \fB\fB-J\fR \fIjob\fR\fR
76 .ad
77 .sp .6
78 .RS 4n
79 Prints \fIjob\fR as the \fIjob name\fR on the banner page of the output.
80 Enclose \fIjob\fR in double quotes if it contains blanks. If \fIjob\fR is not
81 specified, \fIfile\fR (or in the case of multiple files, the first \fIfile\fR
82 specified on the command line) is printed as the job name on the banner page of
83 the output.
84 .RE
86 .sp
87 .ne 2
88 .na
89 \fB\fB-m\fR\fR
90 .ad
91 .sp .6
92 .RS 4n
93 Sends mail after \fIfile\fR has printed. See \fBmail\fR(1). By default, no mail
94 is sent upon normal completion of a print request.
95 .RE
97 .sp
98 .ne 2
99 .na
100 \fB\fB-P\fR \fIdestination\fR\fR
101 .ad
102 .sp .6
103 .RS 4n
104 Prints \fIfile\fR on a specific printer or class of printers (see
105 \fBlpadmin\fR(1M)). Specify \fIdestination\fR using atomic, URI-style
106 (\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
107 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
108 information regarding destination names.
109 .RE
111 .sp
112 .ne 2
113 .na
114 \fB\fB-s\fR\fR
115 .ad
116 .sp .6
117 .RS 4n
118 Prints files by reference rather than copying them. This means that files
119 should not be modified or removed until they have completed printing. This
120 option only prevents copying of files when the print queue is on the local
121 machine and the files are specified on the command line.
122 .RE
124 .sp
125 .ne 2
126 .na
127 \fB\fB-T\fR \fItitle\fR\fR
128 .ad
129 .sp .6
130 .RS 4n
131 Prints a title on the page header of the output. Enclose \fItitle\fR in double
132 quotes if it contains blanks. The \fB-T\fR option is ignored unless it is
133 specified with the \fB-p\fR filter option.
134 .RE
136 .sp
137 .ne 2
138 .na
139 \fB\fB-w\fR \fIcols\fR\fR
140 .ad
141 .sp .6
142 .RS 4n
143 Prints \fIfile\fR with pages of a specific width. \fIcols\fR indicates the
144 number of columns wide. The \fB-w\fR option is ignored unless it is specified
145 with the \fB-p\fR filter option.
146 .RE
148 .sp
149 .ne 2
150 .na
151 \fB\(mi\fB1\fR|\(mi\fB2\fR|\(mi\fB3\fR|\(mi\fB4\fR \fIfont\fR\fR
152 .ad
153 .sp .6
154 .RS 4n
155 Mounts the specified font in the font position \fB1\fR, \fB2\fR, \fB3\fR, or
156 \fB4\fR. Specify \fIfont\fR as a valid font name.
157 .RE
159 .sp
160 .ne 2
161 .na
162 \fB\fB\(mi\fR \fIfilter_option\fR\fR
163 .ad
164 .sp .6
165 .RS 4n
166 Notifies the print spooler that \fIfile\fR is not a standard text file. Enables
167 the spooling daemon to use the appropriate filters to print \fIfile\fR.
168 .sp
169 \fIfilter_option\fRs offer a standard user interface. All filter options might
170 not be available for, or applicable to, all printers.
171 .sp
172 Specify \fIfilter_option\fR as a single character.
173 .sp
174 If \fIfilter_option\fR is not specified and the printer can interpret
175 PostScript\(rg, inserting `\fB%!\fR' as the first two characters of \fIfile\fR
176 causes \fIfile\fR to be interpreted as PostScript.
177 .sp
178 The following filter options are supported:
179 .sp
180 .ne 2
181 .na
182 \fBc\fR
183 .ad
184 .RS 5n
185 \fIfile\fR contains data produced by \fIcifplot\fR.
186 .RE
188 .sp
189 .ne 2
190 .na
191 \fBd\fR
192 .ad
193 .RS 5n
194 \fIfile\fR contains \fBtex\fR data in \fBDVI\fR format from Stanford.
195 .RE
197 .sp
198 .ne 2
199 .na
200 \fBf\fR
201 .ad
202 .RS 5n
203 Interprets the first character of each line as a standard FORTRAN carriage
204 control character.
205 .RE
207 .sp
208 .ne 2
209 .na
210 \fBg\fR
211 .ad
212 .RS 5n
213 \fIfile\fR contains standard plot data produced by \fBplot\fR(1B) routines.
214 .RE
216 .sp
217 .ne 2
218 .na
219 \fBl\fR
220 .ad
221 .RS 5n
222 Print control characters and suppress page breaks.
223 .RE
225 .sp
226 .ne 2
227 .na
228 \fBn\fR
229 .ad
230 .RS 5n
231 \fIfile\fR contains \fBditroff\fR data from device independent troff.
232 .RE
234 .sp
235 .ne 2
236 .na
237 \fBp\fR
238 .ad
239 .RS 5n
240 Use \fBpr\fR to format the files. See \fBpr\fR(1).
241 .RE
243 .sp
244 .ne 2
245 .na
246 \fBt\fR
247 .ad
248 .RS 5n
249 \fIfile\fR contains \fBtroff\fR (cat phototypesetter) binary data.
250 .RE
252 .sp
253 .ne 2
254 .na
255 \fBv\fR
256 .ad
257 .RS 5n
258 \fIfile\fR contains a raster image. \fIprinter\fR must support an appropriate
259 imaging model such as PostScript in order to print the image.
260 .RE
262 .RE
264 .sp
265 .ne 2
266 .na
267 \fB\fB-#\fR \fInumber\fR\fR
268 .ad
269 .sp .6
270 .RS 4n
271 Prints a specific number of copies. Specify \fInumber\fR as a positive integer.
272 The default for \fInumber\fR is \fB1\fR.
273 .RE
275 .SH OPERANDS
276 .LP
277 The following operand is supported:
278 .sp
279 .ne 2
280 .na
281 \fB\fIfile\fR\fR
282 .ad
283 .RS 8n
284 The name of the file to be printed. Specify \fIfile\fR as a pathname. If
285 \fIfile\fR is not specified, \fBlpr\fR uses the standard input.
286 .RE
288 .SH USAGE
289 .LP
290 See \fBlargefile\fR(5) for the description of the behavior of \fBlpr\fR when
291 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
292 .SH EXIT STATUS
293 .LP
294 The following exit values are returned:
295 .sp
296 .ne 2
297 .na
298 \fB\fB0\fR\fR
299 .ad
300 .RS 12n
301 Successful completion.
302 .RE
304 .sp
305 .ne 2
306 .na
307 \fBnon-zero\fR
308 .ad
309 .RS 12n
310 An error occurred.
311 .RE
313 .SH FILES
314 .ne 2
315 .na
316 \fB\fB/etc/printers.conf\fR\fR
317 .ad
318 .RS 24n
319 System printer configuration database
320 .RE
322 .sp
323 .ne 2
324 .na
325 \fB\fB$HOME/.printers\fR\fR
326 .ad
327 .RS 24n
328 User-configurable printer database
329 .RE
331 .sp
332 .ne 2
333 .na
334 \fB\fBou=printers\fR\fR
335 .ad
336 .RS 24n
337 LDAP version of \fB/etc/printers.conf\fR
338 .RE
340 .sp
341 .ne 2
342 .na
343 \fB\fBprinters.conf.byname\fR\fR
344 .ad
345 .RS 24n
346 NIS version of \fB/etc/printers.conf\fR
347 .RE
349 .SH ATTRIBUTES
350 .LP
351 See \fBattributes\fR(5) for descriptions of the following attributes:
352 .sp
354 .sp
355 .TS
356 box;
357 c | c
358 l | l .
359 ATTRIBUTE TYPE ATTRIBUTE VALUE
360 _
361 Interface Stability Standard
362 _
363 CSI Enabled. See NOTES
364 .TE
366 .SH SEE ALSO
367 .LP
368 \fBhostname\fR(1), \fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlprm\fR(1B),
369 \fBlpstat\fR(1), \fBmail\fR(1), \fBplot\fR(1B), \fBpr\fR(1), \fBtroff\fR(1),
370 \fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4),
371 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5),
372 \fBstandards\fR(5)
373 .SH DIAGNOSTICS
374 .ne 2
375 .na
376 \fB\fBlpr:\fR \fIdestination\fR \fB|: unknown destination\fR\fR
377 .ad
378 .sp .6
379 .RS 4n
380 \fIdestination\fR was not found in the \fBLP\fR configuration database. Usually
381 this is a typing mistake; however, it can indicate that the \fIdestination\fR
382 does not exist on the system. Use \fBlpstat\fR \fB-p\fR to display information
383 about the status of the print service.
384 .RE
386 .SH NOTES
387 .LP
388 \fBlpr\fR is CSI-enabled except for the \fIprinter\fR name.
389 .sp
390 .LP
391 Print jobs are assumed to contain one type of data. That type of data is either
392 specified on the command line or autodetected (simple, PostScript) based on the
393 contents of the first file in the job.
394 .sp
395 .LP
396 When IPP is in use, the user is prompted for a passphrase if the remote print
397 service is configured to require authentication.