|
|
1.1 root 1: .\" Copyright (c) 1983 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted
5: .\" provided that the above copyright notice and this paragraph are
6: .\" duplicated in all such forms and that any documentation,
7: .\" advertising materials, and other materials related to such
8: .\" distribution and use acknowledge that the software was developed
9: .\" by the University of California, Berkeley. The name of the
10: .\" University may not be used to endorse or promote products derived
11: .\" from this software without specific prior written permission.
12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15: .\"
16: .\" @(#)4.t 6.5 (Berkeley) 3/7/89
17: .\"
18: .NH 1
19: Setting up
20: .PP
21: The 4.3BSD release comes with the necessary programs
22: installed and with the default line printer queue
23: created. If the system must be modified, the
24: makefile in the directory /usr/src/usr.lib/lpr
25: should be used in recompiling and reinstalling
26: the necessary programs.
27: .PP
28: The real work in setting up is to create the
29: .I printcap
30: file and any printer filters for printers not supported
31: in the distribution system.
32: .NH 2
33: Creating a printcap file
34: .PP
35: The
36: .I printcap
37: database contains one or more entries per printer.
38: A printer should have a separate spooling directory;
39: otherwise, jobs will be printed on
40: different printers depending on which printer daemon starts first.
41: This section describes how to create entries for printers that do not
42: conform to the default printer description (an LP-11 style interface to a
43: standard, band printer).
44: .NH 3
45: Printers on serial lines
46: .PP
47: When a printer is connected via a serial communication line
48: it must have the proper baud rate and terminal modes set.
49: The following example is for a DecWriter III printer connected
50: locally via a 1200 baud serial line.
51: .DS
52: .DT
53: lp|LA-180 DecWriter III:\e
54: :lp=/dev/lp:br#1200:fs#06320:\e
55: :tr=\ef:of=/usr/lib/lpf:lf=/usr/adm/lpd-errs:
56: .DE
57: The
58: .B lp
59: entry specifies the file name to open for output. Here it could
60: be left out since ``/dev/lp'' is the default.
61: The
62: .B br
63: entry sets the baud rate for the tty line and the
64: .B fs
65: entry sets CRMOD, no parity, and XTABS (see \fItty\fP\|(4)).
66: The
67: .B tr
68: entry indicates that a form-feed should be printed when the queue
69: empties so the paper can be torn off without turning the printer off-line and
70: pressing form feed.
71: The
72: .B of
73: entry specifies the filter program
74: .I lpf
75: should be used for printing the files;
76: more will be said about filters later.
77: The last entry causes errors
78: to be written to the file ``/usr/adm/lpd-errs''
79: instead of the console. Most errors from \fIlpd\fP are logged using
80: \fIsyslogd\fP\|(8) and will not be logged in the specified file. The
81: filters should use \fIsyslogd\fP to report errors; only those that
82: write to standard error output will end up with errors in the \fBlf\fP file.
83: (Occasionally errors sent to standard error output have not appeared
84: in the log file; the use of \fIsyslogd\fP is highly recommended.)
85: .NH 3
86: Remote printers
87: .PP
88: Printers that reside on remote hosts should have an empty
89: .B lp
90: entry.
91: For example, the following printcap entry would send output to the printer
92: named ``lp'' on the machine ``ucbvax''.
93: .DS
94: .DT
95: lp|default line printer:\e
96: :lp=:rm=ucbvax:rp=lp:sd=/usr/spool/vaxlpd:
97: .DE
98: The
99: .B rm
100: entry is the name of the remote machine to connect to; this name must
101: be a known host name for a machine on the network.
102: The
103: .B rp
104: capability indicates
105: the name of the printer on the remote machine is ``lp'';
106: here it could be left out since this is the default value.
107: The
108: .B sd
109: entry specifies ``/usr/spool/vaxlpd''
110: as the spooling directory instead of the
111: default value of ``/usr/spool/lpd''.
112: .NH 2
113: Output filters
114: .PP
115: Filters are used to handle device dependencies and to
116: do accounting functions. The output filtering of
117: .B of
118: is used when accounting is
119: not being done or when all text data must be passed through a filter.
120: It is not intended to do accounting since it is started only once,
121: all text files are filtered through it, and no provision is made for passing
122: owners' login name, identifying the beginning and ending of jobs, etc.
123: The other filters (if specified) are started for each file
124: printed and do accounting if there is an
125: .B af
126: entry.
127: If entries for both
128: .B of
129: and other filters are specified,
130: the output filter is used only to print the banner page;
131: it is then stopped to allow other filters access to the printer.
132: An example of a printer that requires output filters
133: is the Benson-Varian.
134: .DS
135: .DT
136: va|varian|Benson-Varian:\e
137: :lp=/dev/va0:sd=/usr/spool/vad:of=/usr/lib/vpf:\e
138: :tf=/usr/lib/rvcat:mx#2000:pl#58:px=2112:py=1700:tr=\ef:
139: .DE
140: The
141: .B tf
142: entry specifies ``/usr/lib/rvcat'' as the filter to be
143: used in printing \fItroff\fP\|(1) output.
144: This filter is needed to set the device into print mode
145: for text, and plot mode for printing
146: .I troff
147: files and raster images (see \fIva\fP\|(4V)).
148: Note that the page length is set to 58 lines by the
149: .B pl
150: entry for 8.5" by 11" fan-fold paper.
151: To enable accounting, the varian entry would be
152: augmented with an
153: .B af
154: filter as shown below.
155: .DS
156: .DT
157: va|varian|Benson-Varian:\e
158: :lp=/dev/va0:sd=/usr/spool/vad:of=/usr/lib/vpf:\e
159: :if=/usr/lib/vpf:tf=/usr/lib/rvcat:af=/usr/adm/vaacct:\e
160: :mx#2000:pl#58:px=2112:py=1700:tr=\ef:
161: .DE
162: .NH 2
163: Access Control
164: .PP
165: Local access to printer queues is controlled with the
166: .B rg
167: printcap entry.
168: .DS
169: :rg=lprgroup:
170: .DE
171: Users must be in the group
172: .I lprgroup
173: to submit jobs to the specified printer.
174: The default is to allow all users access.
175: Note that once the files are in the local queue, they can be printed
176: locally or forwarded to another host depending on the configuration.
177: .PP
178: Remote access is controlled by listing the hosts in either the file
179: /etc/hosts.equiv or /etc/hosts.lpd, one host per line. Note that
180: .IR rsh (1)
181: and
182: .IR rlogin (1)
183: use /etc/hosts.equiv to determine which hosts are equivalent for allowing logins
184: without passwords. The file /etc/hosts.lpd is only used to control
185: which hosts have line printer access.
186: Remote access can be further restricted to only allow remote users with accounts
187: on the local host to print jobs by using the \fBrs\fP printcap entry.
188: .DS
189: :rs:
190: .DE
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.