]>
Commit | Line | Data |
---|---|---|
1 | ## The Super Quick Guide to LPRng Printcaps | |
2 | ## Patrick Powell <papowell@lprng.com> | |
3 | ## 23 Dec 2000 | |
4 | # VERSION=3.7.4 | |
5 | # | |
6 | # This printcap provides a very simple way to configure your UNIX | |
7 | # or Linux or MS or Apple LPRng printcap. There are several choices | |
8 | # to make and some default printcap entries to use. These handle | |
9 | # the majority of printing setups for most simple setups. | |
10 | # | |
11 | # Step 1: Send all jobs to LPD running on Local Host or Remote Host? | |
12 | # | |
13 | # If you want to send all jobs to the LPD spooler running on the localhost | |
14 | # uncomment the following line. This is the normal case for most | |
15 | # single user systems with attached printers or simple network printers. | |
16 | # | |
17 | #lp:force_localhost:client | |
18 | #*:force_localhost:client | |
19 | # [Translation: | |
20 | # lp - default print queue . If you do not want 'lp' to be the | |
21 | # to be the default print queue, set it to the appropriate value | |
22 | # * - wildcard matches all print queue names, and simply causes | |
23 | # the supplied name to be used as the destination print queue. | |
24 | # :force_localhost - connect to the server running on the localhost | |
25 | # :client - for lpr,lpq,lprm, and lpc to use to get information | |
26 | # ] | |
27 | # | |
28 | # If you want to send all jobs to the LPD spooler running on REMOTEHOST | |
29 | # then uncomment the next line and change REMOTEHOST to the IP | |
30 | # address or Fully Qualified Domain Name of REMOTEHOST. If you are | |
31 | # using this entry then your printcap configuration is complete | |
32 | # and you can skip the other steps. | |
33 | # | |
34 | #lp:force_localhost@:client:rm=REMOTEHOST | |
35 | #*:force_localhost@:client:rm=REMOTEHOST | |
36 | # [Translation: | |
37 | # lp - default print queue . If you do not want 'lp' to be the | |
38 | # to be the default print queue, set it to the appropriate value | |
39 | # * - wildcard matches all print queue names, and simply causes | |
40 | # the supplied name to be used as the destination print queue. | |
41 | # :force_localhost@ - do not connect to localhost, use :rm information | |
42 | # :client - for lpr,lpq,lprm, and lpc to use to get information | |
43 | # :rm=REMOTEHOST - the IP address or Fully Qualified Domain Name of | |
44 | # REMOTEHOST. All jobs will be sent there | |
45 | # ] | |
46 | # | |
47 | # Step 2: Default options? | |
48 | # | |
49 | # The printcap entry below sets defaults. Add any other default option | |
50 | # you want here. | |
51 | # | |
52 | .common: | |
53 | :sd=/var/spool/lpd/%P | |
54 | :sh:sf:mx=0:mc=0 | |
55 | # | |
56 | # [Translation: | |
57 | # .common - the period (.) causes LPRng to treat this as a 'information | |
58 | # only entry. This idea was stolen^H^H^H^H^H^H borrowed from the Unix | |
59 | # 'hidden' file convention, i.e. file names starting with a period | |
60 | # are not displayed by 'ls' or matched by '*' | |
61 | # :sd=/var/spool/lpd/%P | |
62 | # Spool queue directory for temporary storage of print jobs. The | |
63 | # %P will be expanded with the print queue name. Each print queue | |
64 | # MUST have a different spool queue directory, and by using %P | |
65 | # this is guaranteed. | |
66 | # :sh - suppress banners or header pages | |
67 | # :sf - suppress form feeds | |
68 | # :mx=0 - maximum job size in K bytes (0 is unlimited) | |
69 | # :mc=0 - maximum number of copies (0 is unlimited) | |
70 | # ] | |
71 | # | |
72 | # Step 3: Define print queues | |
73 | # | |
74 | # A) printer on parallel port (i.e. - /dev/lpt0) | |
75 | #lp:lp=DEVICE:tc=.common:server | |
76 | # Example: | |
77 | # lp:tc=.common:server:lp=/dev/lpt0 | |
78 | # [Translation: | |
79 | # lp - name of the print queue | |
80 | # :tc=.common - include the options in the .common printcap entry | |
81 | # the 'tc' options will be put at the START of the printcap entry | |
82 | # :server - marked as only for lpd server use | |
83 | # :lp=/dev/lpt0 - open and write the print job to /dev/lpt0 | |
84 | # ] | |
85 | # | |
86 | # B) printer on serial port | |
87 | # Use the :stty to set the speed, bits, and parity using 'stty(1)' | |
88 | # options. Note: almost all printers use 8 bits, no parity. | |
89 | #lp:tc=.common:server:lp=DEVICE:stty=STTY OPTIONS | |
90 | # Example: | |
91 | # lp:tc=.common:server:lp=/dev/tty0:stty=19200 cs8 -parenb | |
92 | # [Translation: lp, :tc, :server, :lp as for A) above. | |
93 | # :stty= options used to configure serial port after | |
94 | # opening it | |
95 | # ] | |
96 | # | |
97 | # C) printer on Network Print Server (i.e. - HP JetDirect) | |
98 | # connecting via a TCP/IP socket. IPADDR is IP address or Fully Qualified | |
99 | # Domain Name of the print server, PORT is the TCP/IP port. | |
100 | # | |
101 | # HP JetDirect uses port 9100 by default. | |
102 | # | |
103 | # Warning: check the Network Print Server documentation for correct | |
104 | # port number. Most non-HP Network Print Servers and non-HP printers | |
105 | # do not use port 9100. | |
106 | # | |
107 | #lp:tc=.common:server:lp=IPADDR%PORT | |
108 | # Example: | |
109 | # lp:tc=.common:server:lp=10.0.0.2%9100 | |
110 | # [Translation: lp, :tc, :server as for A) above. | |
111 | # lp=10.0.0.2%9100 - open a connection to 10.0.0.2, port 9100 | |
112 | # and write the print job to this port. | |
113 | # ] | |
114 | # | |
115 | # D) printer on Network Print Server (i.e. - HP JetDirect or LPD server) | |
116 | # connecting via the LPD print protocol. QUEUE is the name of the | |
117 | # print queue and IPADDR is the IP address or Fully Qualified Domain | |
118 | # Name of the print server. | |
119 | # | |
120 | # Warning: check the Network Print Server documentation for correct | |
121 | # QUEUE name. The 'lp' queue is used on the HP JetDirect as the | |
122 | # default print queue. If there are multiple printer ports on the | |
123 | # device then the QUEUE name is used to select the port. | |
124 | # | |
125 | # Warning: Using this protocol with JetDirect units will almost always | |
126 | # cause a 'banner page' to be generated by the JetDirect unit. | |
127 | # Check the HP documentation on how to disable this most annoying feature. | |
128 | # Usually you simply telnet to the JetDirect and then use the | |
129 | # simple configuration menu presented when you first make connection. | |
130 | # | |
131 | #lp:tc=.common:server:lp=QUEUE@IPADDR | |
132 | # | |
133 | # Example: | |
134 | # lp:tc=.common:server:lp=lp@10.0.0.2 | |
135 | # [Translation: lp, :tc, :server as for A) above. | |
136 | # lp=lp@10.0.0.2 - open a connection to 10.0.0.2, port 515, | |
137 | # and use the RFC1179 (LPD) protocol to transfer the job | |
138 | # to the QUEUE print queue. | |
139 | # ] | |
140 | # | |
141 | # Step 4: Format Conversion (Filter) Required? | |
142 | # | |
143 | # You may discover that your printer does not support PostScript or | |
144 | # requires a special initialization to be done. This is handled | |
145 | # by a filter program. The 'ifhp' filter program is supplied with | |
146 | # LPRng and supports a very wide number of printers. If you need | |
147 | # to have a filter, then add the following lines to the printcap | |
148 | # entry: | |
149 | # | |
150 | # :filter=PATH_TO_IFHP_FILTER | |
151 | # :ifhp=IFHP_OPTIONS | |
152 | # | |
153 | # Note: the LPRng :filter= option replaces the legacy BSD lpd options | |
154 | # :if, :vf, ... options that specify filters for 'f' format, 'v' format, | |
155 | # and so forth (yes, yes, :if is for 'f' format, don't ask). | |
156 | # The :filter option specifies a default filter for all job formats. | |
157 | # Most modern filters such as IFHP, Magikfilter, and RedHat print | |
158 | # filters are smart enough to determine the job format and perform | |
159 | # the appropriate conversions. | |
160 | # | |
161 | # Examples: | |
162 | # | |
163 | # lp:tc=.common:server:lp=/dev/lpt0 | |
164 | # :filter=/usr/libexec/filters/ifhp | |
165 | # :ifhp=model=hp4simx | |
166 | # | |
167 | # lp:tc=.common:server:lp=10.0.0.2%9100 | |
168 | # :filter=/usr/libexec/filters/ifhp | |
169 | # :ifhp=model=hp4simx | |
170 | # | |
171 | # lp:tc=.common:server:lp=lp@10.0.0.2 | |
172 | # :filter=/usr/libexec/filters/ifhp | |
173 | # :ifhp=model=hp4simx | |
174 | # | |
175 | # IFHP Options: | |
176 | # For almost all simple configurations you will only need to | |
177 | # supply the model of printer that you have attached. See the | |
178 | # /etc/ifhp.conf file for a complete listing of supported models. | |
179 | # The default model is for an HP Laserjet 4 SiMx, which supports | |
180 | # PostScript, PCL, and PJL. | |
181 | # | |
182 | # Warning: | |
183 | # IF: | |
184 | # Your model of printer normally provides status and error | |
185 | # reporting over a TCP/IP link | |
186 | # AND: | |
187 | # You are using lp=IPADDR%PORT to connect to the printer | |
188 | # THEN: | |
189 | # The IFHP filter will normally expect to have status information | |
190 | # returned by the printer to tell it that the printer is in working | |
191 | # condition. This will have a small but significant overhead | |
192 | # on job throughput, but you will also get error information. | |
193 | # | |
194 | # HOWEVER: | |
195 | # If the printer SHOULD return status but CANNOT due to either | |
196 | # the printer hardware configuration or it is on a unidirectional | |
197 | # and not bidirectional parallel printer port, then you must use | |
198 | # :model=...,status@ | |
199 | # to tell the IFHP filter not to expect status information. | |
200 | # | |
201 | # Example: | |
202 | # lp:tc=.common:server:lp=10.0.0.2%9100 | |
203 | # :filter=/usr/libexec/filters/ifhp | |
204 | # :ifhp=model=hp4simx,status@ | |
205 | # | |
206 | # Step 5: Queue creation and LPD restart | |
207 | # Run the following commands to create your spool queues and | |
208 | # then tell the LPD server that it should use them: | |
209 | # su | |
210 | # checkpc -f | |
211 | # lpc reread |