|
|
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)lpr.1 6.1 (Berkeley) 4/29/85
6: .\"
7: .TH LPR 1 "April 29, 1985"
8: .UC 4
9: .SH NAME
10: lpr \- off line print
11: .SH SYNOPSIS
12: .B lpr
13: [
14: .BI \-P printer
15: ] [
16: .BI \-# num
17: ] [
18: .B \-C
19: .I class
20: ] [
21: .B \-J
22: .I job
23: ] [
24: .B \-T
25: .I title
26: ] [
27: .B \-i
28: [
29: .I numcols
30: ]] [
31: .B \-1234
32: .I font
33: ] [
34: .BI \-w num
35: ] [
36: .B \-pltndgvcfrmhs
37: ] [
38: name ...
39: ]
40: .SH DESCRIPTION
41: .B Lpr
42: uses a spooling daemon to print the named files when facilities
43: become available. If no names appear, the standard input is assumed.
44: The
45: .B \-P
46: option may be used to force output to a specific printer. Normally,
47: the default printer is used (site dependent), or the value of the
48: environment variable PRINTER is used.
49: .PP
50: The following single letter options are used to notify the line printer
51: spooler that the files are not standard text files. The spooling daemon will
52: use the appropriate filters to print the data accordingly.
53: .IP \fB\-p\fP 5
54: Use
55: .IR pr (1)
56: to format the files (equivalent to
57: .IR print ).
58: .IP \fB\-l\fP 5
59: Use a filter which allows control characters to be printed and suppresses
60: page breaks.
61: .IP \fB\-t\fP 5
62: The files are assumed to contain data from
63: .IR troff (1)
64: (cat phototypesetter commands).
65: .IP \fB\-n\fP 5
66: The files are assumed to contain data from
67: .I ditroff
68: (device independent troff).
69: .IP \fB\-d\fP 5
70: The files are assumed to contain data from
71: .IR tex (l)
72: (DVI format from Stanford).
73: .IP \fB\-g\fP 5
74: The files are assumed to contain standard plot data as produced by the
75: .IR plot (3X)
76: routines (see also
77: .IR plot (1G)
78: for the filters used by the printer spooler).
79: .IP \fB\-v\fP 5
80: The files are assumed to contain a raster image for devices like the
81: Benson Varian.
82: .IP \fB\-c\fP 5
83: The files are assumed to contain data produced by
84: .IR cifplot (l).
85: .IP \fB\-f\fP 5
86: Use a filter which interprets the first character of each line as a
87: standard FORTRAN carriage control character.
88: .PP
89: The remaining single letter options have the following meaning.
90: .IP \fB\-r\fP 5
91: Remove the file upon completion of spooling or upon completion of
92: printing (with the \fB\-s\fP option).
93: .IP \fB\-m\fP 5
94: Send mail upon completion.
95: .IP \fB\-h\fP 5
96: Suppress the printing of the burst page.
97: .IP \fB\-s\fP 5
98: Use symbolic links. Usually files are copied to the spool directory.
99: .PP
100: The
101: .B \-C
102: option takes the following argument as a job classification
103: for use on the burst page. For example,
104: .PP
105: .ti +0.5i
106: lpr \-C EECS foo.c
107: .PP
108: causes the system name (the name returned by
109: .IR hostname (1))
110: to be replaced on the burst page by EECS,
111: and the file foo.c to be printed.
112: .PP
113: The
114: .B \-J
115: option takes the following argument as the job name to print on the burst page.
116: Normally, the first file's name is used.
117: .PP
118: The
119: .B \-T
120: option uses the next argument as the title used by
121: .IR pr (1)
122: instead of the file name.
123: .PP
124: To get multiple copies of output, use the
125: .BI \-# num
126: option,
127: where
128: .I num
129: is the number of copies desired of each file named. For example,
130: .PP
131: .ti +0.5i
132: lpr \-#3 foo.c bar.c more.c
133: .PP
134: would result in 3 copies of the file foo.c, followed by 3 copies
135: of the file bar.c, etc. On the other hand,
136: .PP
137: .ti +0.5i
138: cat foo.c bar.c more.c | lpr \-#3
139: .PP
140: will give three copies of the concatenation of the files.
141: .PP
142: The
143: .B \-i
144: option causes the output to be indented. If the next argument
145: is numeric, it is used as the number of blanks to be printed before each
146: line; otherwise, 8 characters are printed.
147: .PP
148: The
149: .B \-w
150: option takes the immediately following number to be
151: the page width for
152: .IR pr .
153: .PP
154: The
155: .B \-s
156: option will use
157: .IR symlink (2)
158: to link data files rather than trying to copy them so large files can be
159: printed. This means the files should
160: not be modified or removed until they have been printed.
161: .PP
162: The option
163: .B \-1234
164: Specifies a font to be mounted on font position \fIi\fR. The daemon
165: will construct a \fI.railmag\fR file referencing
166: \fI/usr/lib/vfont/name.size\fR.
167: .SH FILES
168: .nf
169: .ta \w'/usr/spool/*/cf* 'u
170: /etc/passwd personal identification
171: /etc/printcap printer capabilities data base
172: /usr/lib/lpd* line printer daemons
173: /usr/spool/* directories used for spooling
174: /usr/spool/*/cf* daemon control files
175: /usr/spool/*/df* data files specified in "cf" files
176: /usr/spool/*/tf* temporary copies of "cf" files
177: .fi
178: .SH "SEE ALSO"
179: lpq(1),
180: lprm(1),
181: pr(1),
182: symlink(2),
183: printcap(5),
184: lpc(8),
185: lpd(8)
186: .SH DIAGNOSTICS
187: If you try to spool too large a file, it will be truncated.
188: .I Lpr
189: will object to printing binary files.
190: If a user other than root prints a file and spooling is disabled,
191: .I lpr
192: will print a message saying so and will not put jobs in the queue.
193: If a connection to
194: .I lpd
195: on the local machine cannot be made,
196: .I lpr
197: will say that the daemon cannot be started.
198: Diagnostics may be printed in the daemon's log file
199: regarding missing spool files by
200: .IR lpd .
201: .SH BUGS
202: Fonts for
203: .I troff
204: and
205: .I tex
206: reside on the host with the printer. It is currently not possible to
207: use local font libraries.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.