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