Penguin
Recent Changes
Annotated edit history of lp(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LP
2 !!!LP
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 OPERANDS
8 PRINTCAP INFORMATION
9 ENVIRONMENT
10 EXIT STATUS
11 FILES
12 SEE ALSO
13 DIAGNOSTICS
14 HISTORY
15 AUTHOR
16 ----
17 !!NAME
18
19
20 lp - send requests to an LPRng print service
21 !!SYNOPSIS
22
23
24 __lp__ [[ __-A__ ] [[ __-B__ ] [[ __-c__ ] [[
25 __-G__ ] [[ __-m__ ] [[ __-p__ ] [[ __-s__ ] [[
26 __-w__ ] [[ __-d__ ''dest'' ] [[ __-f__
27 ''form-name'' [[ __-d any__ ] ]
28
29
30 [[ __-H__ ''special-handling'' ] [[ __-n__
31 ''number'' ] [[ __-o__ ''option'' ] [[ __-P__
32 ''page-list'' ] [[ __-q__ ''priority-level'' ] [[
33 __-S__ ''character-set'' [[ __-d any__ ] ] [[
34 __-S__ ''print-wheel'' [[ __-t__ ''title'' ] [[
35 __-T__ ''content-type'' [[ __-r__ ] ] [[ __-y__
36 ''mode-list'' ] [[ __-X__ ''path'' ] [[ __-D__
37 ''debug-options'' ] [[ ''file''... ]
38 !!DESCRIPTION
39
40
41 The LPRng __lpr__ client supports an __lp__ interface
42 when invoked with the __lp__ program name. This is
43 usually done by making a symbolic link to the __lpr__
44 program with the name __lp__. This is similar to the
45 ex(1) and vi(1) programs. The supported form
46 of the __lp__ command arranges for the named
47 ''file(s)'' and associated information (collectively
48 called a ''request'') to be printed. If no file names are
49 specified on the command line, the standard input is
50 assumed. The standard input may be specified along with a
51 named ''file''(s) on the command line by listing the file
52 name(s) and specifying __-__ (dash) for the standard
53 input. The ''files'' will be printed in the order in
54 which they appear on the shell command line.
55
56
57 The LP print service associates a unique
58 ''request-ID'' with each request and displays it on the
59 standard output. The job number portion or full request-ID
60 can be used later with cancel(1) or lprm(1)
61 when canceling a job or when determining its status. See
62 cancel(1) and lprm(1) for details about
63 canceling a request, and lpstat(1) and lpq(1)
64 for information about checking the status of a print
65 request.
66 !!OPTIONS
67
68
69 Options to __lp__ always precede any file names, but may
70 be specified in any order. The following options are
71 available for __lp__:
72
73
74 __-A__ Use authenticated transfer. Note that this is not
75 a standard lp(1) option but has been added for
76 compatibilty with LPRng. The authentication type is set by
77 the value of the AUTH environment variable. __-B__
78 Process jobs using filters specified in the printcap
79 information. The filter output is combined into a single
80 file and sent to the print spooler.
81
82
83 __-c__ Make a copy of the ''file'' before printing.
84 (This has no effect as LPRng always sends jobs immediately
85 to the remote server for printing.)
86
87
88 __-d__ ''dest'' The print queue or printer to be used.
89 By default, the destination printer is taken from the
90 command line ''dest'' value, then the environment
91 variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
92 entry in the printcap information, and and finally the
93 default_printer entry from the configuration file, and then
94 the compile time default.
95
96
97 __-f__ ''form-name''
98
99
100 Print the request on the form ''form-name''. This sets
101 the job class to ''form-name'' and is similar to the lpr
102 -C option. __-G__ Process jobs using filters specified in
103 the printcap information. The filter output for individual
104 files is sent to the print spooler.
105
106
107 __-H__ ''special-handling''
108
109
110 These options are ignored.
111
112
113 __-m__ Send mail (see mail(1)) after the files
114 have been printed. The mail address is taken from the USER
115 enviroment variable. By default, no mail is sent upon normal
116 completion of the print request.
117
118
119 __-n__ ''number''
120
121
122 Print ''number'' copies (default is __1__) of the
123 output.
124
125
126 __-o__ ''option''
127
128
129 Specify printer-dependent ''options''. Several such
130 ''options'' may be collected by specifying the __-o__
131 keyletter more than once (__-o $option sub 1$ -o $option
132 sub 2$__ ''...'' __-o $option sub n$__), or by
133 specifying the __-o__ keyletter followed by a list of
134 options enclosed in double quotes (that is, __-o
135 __ ''... $option sub
136 n$''____). The following options have a immediate
137 effect; other options are passed as a __Z__ line entry in
138 the control file, i.e. - as an __lpr__''(1)''
139 __-Z__ option.
140
141
142 __nobanner__
143
144
145 Do not print a banner page with this request. This is the
146 same as the __lpr__''(1)'' __-h__ (no header)
147 option.
148
149
150 __width__''=number''
151
152
153 Print this request with page-width set to ''number''.
154 This is the same as the __lpr__''(1)'' __-w__
155 ''width'' option.
156
157
158 __-P__ ''page-list''
159
160
161 Print the pages specified in ''page-list''. This option
162 is ignored.
163
164
165 __-p__ Enable notification on completion of the print
166 request. This option is ignored.
167
168
169 __-q__ ''priority-level''
170
171
172 Assign this request ''priority-level'' in the printing
173 queue. The values of ''priority-level'' range from
174 __0__, the highest priority, to __25__, the lowest
175 priority. If a priority is not specified, the default for
176 the print service is used, as assigned by the system
177 administrator. A priority limit may be assigned to
178 individual users by the system administrator. The numerical
179 values are translated to corresponding letter priority
180 values.
181
182
183 __-s__ Suppress messages from __lp__ such as those
184 that begin with __request id
185 is__...__
186
187
188 __-S__ ''character-set''
189
190
191 __-S__ ''print-wheel''
192
193
194 Print this request using the specified ''character-set''
195 or ''print-wheel''. The options are passed as an
196 __lpr__''(1)'' __-Z__ option.
197
198
199 __-t__ ''title''
200
201
202 Print ''title'' on the banner page of the output. If
203 ''title'' is not supplied the name of the file is printed
204 on the banner page. Enclose ''title'' in quotes if it
205 contains blanks.
206
207
208 __-T__ ''content-type'' [[__-r__]
209
210
211 Print the request on a printer that can support the
212 specified ''content-type''. The ''content-type'' is
213 passed as an __lpr__''(1)'' __-Z__
214 option.
215
216
217 __-w__ Write a message on the user's terminal after the
218 ''files'' have been printed. This option is
219 ignored.
220
221
222 __-X__ ''path'' Filter individual job files using the
223 specified program and send the filter output to the print
224 spooler.
225
226
227 __-y__ ''mode-list''
228
229
230 Print this request according to the printing modes listed in
231 ''mode-list''. The ''mode-list-type'' is passed as an
232 __lpr__''(1)'' __-Z__ option.
233
234
235 __-D__ ''debug-optios''
236
237
238 A list of debug options for the program. These can be a
239 number (debug level) or keyword and level (flag), such as 9,
240 network, network+2, etc.
241 !!OPERANDS
242
243
244 The following operands are supported by
245 __lp__:
246
247
248 ''file'' A path name of a file to be output. If no
249 ''file'' operands are specified, or if a ''file''
250 operand is __-__, the standard input will be used. The
251 __-__ option must be last in the list.
252 !!PRINTCAP INFORMATION
253
254
255 The printer names and other information is obtained by using
256 a printcap file or some other database. The
257 ${HOME}/.printcap file can be used to specify user level
258 options and configuration information. See printcap(5) for
259 more information.
260 !!ENVIRONMENT
261
262
263 By default, the destination printer is taken from the
264 command line ''dest'' value, then the environment
265 variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
266 entry in the printcap information, and and finally the
267 default_printer entry from the configuration file, and then
268 the compile time default.
269 !!EXIT STATUS
270
271
272 The following exit values are returned:
273
274
275 __zero (0)__
276
277
278 Successful completion
279
280
281 __nonzero (!= 0)__
282
283
284 An error occurred.
285 !!FILES
286
287
288 The files used by LPRng are set by values in the LPRng
289 configuration file. The default values are:
290
291
292 /etc/lprng/lpd.conf LPRng configuration file
293 ${HOME}/.printcap user printer description file
294 /etc/lprng/printcap printer description file
295 /etc/lprng/lpd.perms permissions
296 /var/run/lprng/lpd lock file for queue control
297 /var/spool/lpd spool directories
298 /var/spool/lpd/QUEUE/control queue control
299 /var/spool/lpd/QUEUE/log trace or debug log file
300 /var/spool/lpd/QUEUE/acct accounting file
301 /var/spool/lpd/QUEUE/status status file
302 !!SEE ALSO
303
304
305 lpd.conf(5), lpc(8), lpd(8), lpr(1), lpq(1), lprm(1),
306 printcap(5), lpd.perms(5), pr(1).
307 !!DIAGNOSTICS
308
309
310 Most of the diagnostics are self explanatory.
311 If you are puzzled over the exact cause of failure,
312 set the debugging level on (-D5) and run again.
313 The debugging information will
314 help you to pinpoint the exact cause of failure.
315 !!HISTORY
316
317
318 LPRng is a enhanced printer spooler system with
319 functionality similar to the Berkeley LPR software. The
320 LPRng mailing list is lprng@lprng.com; subscribe by sending
321 mail to lprng-request@lprng.com with the word subscribe in
322 the body. The software is available from
323 ftp://ftp.lprng.com/pub/LPRng.
324 !!AUTHOR
325
326
327 Patrick Powell
328 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.