Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-printing-intro-setup.mdwn
1 \r
2 \r
3 ## 11.3 Basic Setup \r
4 \r
5 To use printers with the  **LPD**  spooling system, you will need to set up both your printer hardware and the  **LPD**  software. This document describes two levels of setup:\r
6 \r
8 * See section [printing-intro-setup.html#PRINTING-SIMPLE Simple Printer Setup] to learn how to connect a printer, tell  **LPD**  how to communicate with it, and print plain text files to the printer.\r
10 * See section [printing-advanced.html Advanced Printer Setup] to find out how to print a variety of special file formats, to print header pages, to print across a network, to control access to printers, and to do printer accounting.\r
11 \r
12 ### 11.3.1 Simple Printer Setup \r
13 \r
14 This section tells how to configure printer hardware and the  **LPD**  software to use the printer. It teaches the basics:\r
15 \r
17 * Section [printing-intro-setup.html#PRINTING-HARDWARE Hardware Setup] gives some hints on connecting the printer to a port on your computer.\r
19 * Section [printing-intro-setup.html#PRINTING-SOFTWARE Software Setup] shows how to set up the  **LPD**  spooler configuration file (`/etc/printcap`).\r
20 \r
21 If you are setting up a printer that uses a network protocol to accept data to print instead of a serial or parallel interface, see [printing-advanced.html#PRINTING-ADVANCED-NETWORK-NET-IF Printers With Networked Data Stream Interfaces].\r
22 \r
23 Although this section is called ***Simple Printer Setup***, it is actually fairly complex. Getting the printer to work with your computer and the  **LPD**  spooler is the hardest part. The advanced options like header pages and accounting are fairly easy once you get the printer working.\r
24 \r
25 #### Hardware Setup \r
26 \r
27 This section tells about the various ways you can connect a printer to your PC. It talks about the kinds of ports and cables, and also the kernel configuration you may need to enable DragonFly to speak to the printer.\r
28 \r
29 If you have already connected your printer and have successfully printed with it under another operating system, you can probably skip to section [printing-intro-setup.html#PRINTING-SOFTWARE Software Setup].\r
30 \r
31 ##### Ports and Cables \r
32 \r
33 Printers sold for use on PC's today generally come with one or more of the following three interfaces:\r
34 \r
36 * ***Serial*** interfaces, also known as RS232C or RS232D, or COM ports, use a serial port on your computer to send data to the printer. Serial interfaces are common in the computer industry and cables are readily available and also easy to construct. Serial interfaces sometimes need special cables and might require you to configure somewhat complex communications options. Most PC serial ports have a maximum transmission rate of 115200 bps, which makes printing large graphic print jobs with them impractical.\r
38 * ***Parallel*** interfaces use a parallel port on your computer to send data to the printer. Parallel interfaces are common in the PC market and are faster than RS232 serial. Cables are readily available but more difficult to construct by hand. There are usually no communications options with parallel interfaces, making their configuration exceedingly simple.\r
39   Parallel interfaces are sometimes known as ***Centronics*** interfaces, named after the connector type on the printer.\r
41 * USB interfaces, named for the Universal Serial Bus, can run at even faster speeds than parallel or RS232 serial interfaces. Cables are simple and cheap. USB is superior to RS232 Serial and to Parallel for printing, but it is not as well supported under UNIX systems. A way to avoid this problem is to purchase a printer that has both a USB interface and a Parallel interface, as many printers do.\r
42 \r
43 In general, Parallel interfaces usually offer just one-way communication (computer to printer) while serial and USB gives you two-way. Newer parallel ports (EPP and ECP) and printers can communicate in both directions under DragonFly when a IEEE1284 compliant cable is used.\r
44 \r
45 Two-way communication to the printer over a parallel port is generally done one of two ways. The first method uses a custom built printer driver for DragonFly that speaks the proprietary language used by the printer. This is common with inkjet printers and can be used for reporting ink levels and other status information. The second method is used when the printer supports PostScript®.\r
46 \r
47 PostScript jobs are actually programs sent to the printer; they need not produce paper at all and may return results directly to the computer. PostScript also uses two-way communication to tell the computer about problems, such as errors in the PostScript program or paper jams. Your users may be appreciative of such information. Furthermore, the best way to do effective accounting with a PostScript printer requires two-way communication: you ask the printer for its page count (how many pages it has printed in its lifetime), then send the user's job, then ask again for its page count. Subtract the two values and you know how much paper to charge the user.\r
48 \r
49 ##### Parallel Ports \r
50 \r
51 To hook up a printer using a parallel interface, connect the Centronics cable between the printer and the computer. The instructions that came with the printer, the computer, or both should give you complete guidance.\r
52 \r
53 Remember which parallel port you used on the computer. The first parallel port is `/dev/ppc0` to DragonFly; the second is `/dev/ppc1`, and so on. The printer device name uses the same scheme: `/dev/lpt0` for the printer on the first parallel ports etc.\r
54 \r
55 ##### Serial Ports \r
56 \r
57 To hook up a printer using a serial interface, connect the proper serial cable between the printer and the computer. The instructions that came with the printer, the computer, or both should give you complete guidance.\r
58 \r
59 If you are unsure what the ***proper serial cable*** is, you may wish to try one of the following alternatives:\r
60 \r
62 * A ***modem*** cable connects each pin of the connector on one end of the cable straight through to its corresponding pin of the connector on the other end. This type of cable is also known as a ***DTE-to-DCE*** cable.\r
64 * A ***null-modem*** cable connects some pins straight through, swaps others (send data to receive data, for example), and shorts some internally in each connector hood. This type of cable is also known as a ***DTE-to-DTE*** cable.\r
66 * A ***serial printer*** cable, required for some unusual printers, is like the null-modem cable, but sends some signals to their counterparts instead of being internally shorted.\r
67 \r
68 You should also set up the communications parameters for the printer, usually through front-panel controls or DIP switches on the printer. Choose the highest `bps` (bits per second, sometimes ***baud rate***) rate that both your computer and the printer can support. Choose 7 or 8 data bits; none, even, or odd parity; and 1 or 2 stop bits. Also choose a flow control protocol: either none, or XON/XOFF (also known as ***in-band*** or ***software***) flow control. Remember these settings for the software configuration that follows.\r
69 \r
70 #### Software Setup \r
71 \r
72 This section describes the software setup necessary to print with the  **LPD**  spooling system in DragonFly.\r
73 \r
74 Here is an outline of the steps involved:\r
75 \r
76   1. Configure your kernel, if necessary, for the port you are using for the printer; section [printing-intro-setup.html#PRINTING-KERNEL Kernel Configuration] tells you what you need to do.\r
77   1. Set the communications mode for the parallel port, if you are using a parallel port; section [printing-intro-setup.html#PRINTING-PARALLEL-PORT-MODE Setting the Communication Mode for the Parallel Port] gives details.\r
78   1. Test if the operating system can send data to the printer. Section [printing-intro-setup.html#PRINTING-TESTING Checking Printer Communications] gives some suggestions on how to do this.\r
79   1. Set up  **LPD**  for the printer by modifying the file `/etc/printcap`. You will find out how to do this later in this chapter.\r
80 \r
81 ##### Kernel Configuration \r
82 \r
83 The operating system kernel is compiled to work with a specific set of devices. The serial or parallel interface for your printer is a part of that set. Therefore, it might be necessary to add support for an additional serial or parallel port if your kernel is not already configured for one.\r
84 \r
85 To find out if the kernel you are currently using supports a serial interface, type:\r
86 \r
87     \r
88     # grep sio`***N***` /var/run/dmesg.boot\r
89 \r
90 \r
91 Where `***N***` is the number of the serial port, starting from zero. If you see output similar to the following:\r
92 \r
93     \r
94     sio2 at port 0x3e8-0x3ef irq 5 on isa\r
95     sio2: type 16550A\r
96 \r
97 \r
98 then the kernel supports the port.\r
99 \r
100 To find out if the kernel supports a parallel interface, type:\r
101 \r
102     \r
103     # grep ppc`***N***` /var/run/dmesg.boot\r
104 \r
105 \r
106 Where `***N***` is the number of the parallel port, starting from zero. If you see output similar to the following:\r
107 \r
108     \r
109     ppc0: <Parallel port> at port 0x378-0x37f irq 7 on isa0\r
110     ppc0: SMC-like chipset (ECP/EPP/PS2/NIBBLE) in COMPATIBLE mode\r
111     ppc0: FIFO with 16/16/8 bytes threshold\r
112 \r
113 \r
114 then the kernel supports the port.\r
115 \r
116 You might have to reconfigure your kernel in order for the operating system to recognize and use the parallel or serial port you are using for the printer.\r
117 \r
118 To add support for a serial port, see the section on kernel configuration. To add support for a parallel port, see that section ***and*** the section that follows.\r
119 \r
120 #### Adding `/dev` Entries for the Ports \r
121 \r
122 Even though the kernel may support communication along a serial or parallel port, you will still need a software interface through which programs running on the system can send and receive data. That is what entries in the `/dev` directory are for.\r
123 \r
124 ***To add a `/dev` entry for a port:***\r
125 \r
126   1. Become `root` with the [su(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#su&section1) command. Enter the `root` password when prompted.\r
127   1. Change to the `/dev` directory:\r
128       \r
129       # cd /dev\r
130   \r
131   1. Type:\r
132       \r
133       # ./MAKEDEV `***port***`\r
134   \r
135   Where `***port***` is the device entry for the port you want to make. Use `lpt0` for the printer on the first parallel port, `lpt1` for the printer on the second port, and so on; use `ttyd0` for the first serial port, `ttyd1` for the second, and so on.\r
136   1. Type:\r
137       \r
138       # ls -l `***port***`\r
139   \r
140   to make sure the device entry got created.\r
141 \r
142 ##### Setting the Communication Mode for the Parallel Port \r
143 \r
144 When you are using the parallel interface, you can choose whether DragonFly should use interrupt-driven or polled communication with the printer. The generic printer device driver ([lpt(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpt&section4)) on DragonFly uses the [ppbus(4)](http://leaf.dragonflybsd.org/cgi/web-man?command=ppbus&section=4) system, which controls the port chipset with the [ppc(4)](http://leaf.dragonflybsd.org/cgi/web-man?command=ppc&section=4) driver.\r
145 \r
147 * The ***interrupt-driven*** method is the default with the GENERIC kernel. With this method, the operating system uses an IRQ line to determine when the printer is ready for data.\r
149 * The ***polled*** method directs the operating system to repeatedly ask the printer if it is ready for more data. When it responds ready, the kernel sends more data.\r
150 \r
151 The interrupt-driven method is usually somewhat faster but uses up a precious IRQ line. Some newer HP printers are claimed not to work correctly in interrupt mode, apparently due to some (not yet exactly understood) timing problem. These printers need polled mode. You should use whichever one works. Some printers will work in both modes, but are painfully slow in interrupt mode.\r
152 \r
153 You can set the communications mode in two ways: by configuring the kernel or by using the [lptcontrol(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptcontrol&section8) program.\r
154 \r
155 ***To set the communications mode by configuring the kernel:***\r
156 \r
157   1. Edit your kernel configuration file. Look for an `ppc0` entry. If you are setting up the second parallel port, use `ppc1` instead. Use `ppc2` for the third port, and so on.\r
159 * If you want interrupt-driven mode, add the `irq` specifier:\r
160         \r
161         device ppc0 at isa? irq `***N***`\r
162     \r
163     Where `***N***` is the IRQ number for your computer's parallel port.\r
165 * If you want polled mode, do not add the `irq` specifier. Use the following line in your kernel configuration file:\r
166         \r
167         device ppc0 at isa?\r
168     \r
169   1. Save the file. Then configure, build, and install the kernel, then reboot. See [kernelconfig.html kernel configuration] for more details.\r
170 \r
171 ***To set the communications mode with*** [lptcontrol(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptcontrol&section8):\r
172 \r
173   1. Type:\r
174       \r
175       # lptcontrol -i -d /dev/lpt`***N***`\r
176   \r
177   to set interrupt-driven mode for `lpt`***N******.\r
178   1. Type:\r
179       \r
180       # lptcontrol -p -d /dev/lpt`***N***`\r
181   \r
182   to set polled-mode for `lpt`***N******.\r
183 \r
184 You could put these commands in your `/etc/rc.local` file to set the mode each time your system boots. See [lptcontrol(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptcontrol&section8) for more information.\r
185 \r
186 ##### Checking Printer Communications \r
187 \r
188 Before proceeding to configure the spooling system, you should make sure the operating system can successfully send data to your printer. It is a lot easier to debug printer communication and the spooling system separately.\r
189 \r
190 To test the printer, we will send some text to it. For printers that can immediately print characters sent to them, the program [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1) is perfect: it generates all 96 printable ASCII characters in 96 lines.\r
191 \r
192 For a PostScript (or other language-based) printer, we will need a more sophisticated test. A small PostScript program, such as the following, will suffice:\r
193 \r
194     \r
195     %!PS\r
196     100 100 moveto 300 300 lineto stroke\r
197     310 310 moveto /Helvetica findfont 12 scalefont setfont\r
198     (Is this thing working?) show\r
199     showpage\r
200 \r
201 \r
202 The above PostScript code can be placed into a file and used as shown in the examples appearing in the following sections.\r
203 \r
204  **Note:** When this document refers to a printer language, it is assuming a language like PostScript, and not Hewlett Packard's PCL. Although PCL has great functionality, you can intermingle plain text with its escape sequences. PostScript cannot directly print plain text, and that is the kind of printer language for which we must make special accommodations.\r
205 \r
206 ###### Checking a Parallel Printer \r
207 \r
208 This section tells you how to check if DragonFly can communicate with a printer connected to a parallel port.\r
209 \r
210 ***To test a printer on a parallel port:***\r
211 \r
212   1. Become `root` with [su(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#su&section1).\r
213   1. Send data to the printer.\r
215 * If the printer can print plain text, then use [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1). Type:\r
216         \r
217         # lptest > /dev/lpt`***N***`\r
218     \r
219     Where `***N***` is the number of the parallel port, starting from zero.\r
221 * If the printer understands PostScript or other printer language, then send a small program to the printer. Type:\r
222         \r
223         # cat > /dev/lpt`***N***`\r
224     \r
225     Then, line by line, type the program ***carefully*** as you cannot edit a line once you have pressed `RETURN` or `ENTER`. When you have finished entering the program, press `CONTROL+D`, or whatever your end of file key is.\r
226     Alternatively, you can put the program in a file and type:\r
227         \r
228         # cat `***file***` > /dev/lpt`***N***`\r
229     \r
230     Where `***file***` is the name of the file containing the program you want to send to the printer.\r
231 \r
232 You should see something print. Do not worry if the text does not look right; we will fix such things later.\r
233 \r
234 ###### Checking a Serial Printer \r
235 \r
236 This section tells you how to check if DragonFly can communicate with a printer on a serial port.\r
237 \r
238 ***To test a printer on a serial port:***\r
239 \r
240   1. Become `root` with [su(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#su&section1).\r
241   1. Edit the file `/etc/remote`. Add the following entry:\r
242       \r
243       printer:dv#/dev/`***port***`:br#`***bps-rate***`:pa`***parity***`\r
244   \r
245   Where `***port***` is the device entry for the serial port (`ttyd0`, `ttyd1`, etc.), `***bps-rate***` is the bits-per-second rate at which the printer communicates, and `***parity***` is the parity required by the printer (either `even`, `odd`, `none`, or `zero`).\r
246   Here is a sample entry for a printer connected via a serial line to the third serial port at 19200 bps with no parity:\r
247       \r
248       printer:dv#/dev/ttyd2:br#19200:panone\r
249   \r
250   1. Connect to the printer with [tip(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#tip&section1). Type:\r
251       \r
252       # tip printer\r
253   \r
254   If this step does not work, edit the file `/etc/remote` again and try using `/dev/cuaa`***N****** instead of `/dev/ttyd`***N******.\r
255   1. Send data to the printer.\r
257 * If the printer can print plain text, then use [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1). Type:\r
258         \r
259         % $lptest\r
260     \r
262 * If the printer understands PostScript or other printer language, then send a small program to the printer. Type the program, line by line, ***very carefully*** as backspacing or other editing keys may be significant to the printer. You may also need to type a special end-of-file key for the printer so it knows it received the whole program. For PostScript printers, press `CONTROL+D`.\r
263     Alternatively, you can put the program in a file and type:\r
264         \r
265         % >`***file***`\r
266     \r
267     Where `***file***` is the name of the file containing the program. After [tip(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#tip&section1) sends the file, press any required end-of-file key.\r
268 \r
269 You should see something print. Do not worry if the text does not look right; we will fix that later.\r
270 \r
271 #### Enabling the Spooler: the `/etc/printcap` File \r
272 \r
273 At this point, your printer should be hooked up, your kernel configured to communicate with it (if necessary), and you have been able to send some simple data to the printer. Now, we are ready to configure  **LPD**  to control access to your printer.\r
274 \r
275 You configure  **LPD**  by editing the file `/etc/printcap`. The  **LPD**  spooling system reads this file each time the spooler is used, so updates to the file take immediate effect.\r
276 \r
277 The format of the [printcap(5)](http://leaf.dragonflybsd.org/cgi/web-man?command#printcap&section5) file is straightforward. Use your favorite text editor to make changes to `/etc/printcap`. The format is identical to other capability files like `/usr/share/misc/termcap` and `/etc/remote`. For complete information about the format, see the [cgetent(3)](http://leaf.dragonflybsd.org/cgi/web-man?command=cgetent&section=3).\r
278 \r
279 The simple spooler configuration consists of the following steps:\r
280 \r
281   1. Pick a name (and a few convenient aliases) for the printer, and put them in the `/etc/printcap` file; see the [printing-intro-setup.html#PRINTING-NAMING Naming the Printer] section for more information on naming.\r
282   1. Turn off header pages (which are on by default) by inserting the `sh` capability; see the [printing-intro-setup.html#PRINTING-NO-HEADER-PAGES Suppressing Header Pages] section for more information.\r
283   1. Make a spooling directory, and specify its location with the `sd` capability; see the [printing-intro-setup.html#PRINTING-SPOOLDIR Making the Spooling Directory] section for more information.\r
284   1. Set the `/dev` entry to use for the printer, and note it in `/etc/printcap` with the `lp` capability; see the [printing-intro-setup.html#PRINTING-DEVICE Identifying the Printer Device] for more information. Also, if the printer is on a serial port, set up the communication parameters with the `ms#` capability which is discussed in the [printing-intro-setup.html#PRINTING-COMMPARAM Configuring Spooler Communications Parameters] section.\r
285   1. Install a plain text input filter; see the [printing-intro-setup.html#PRINTING-TEXTFILTER Installing the Text Filter] section for details.\r
286   1. Test the setup by printing something with the [lpr(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpr&section1) command. More details are available in the [printing-intro-setup.html#PRINTING-TRYING Trying It Out] and [printing-troubleshooting.html Troubleshooting] sections.\r
287 \r
288  **Note:** Language-based printers, such as PostScript printers, cannot directly print plain text. The simple setup outlined above and described in the following sections assumes that if you are installing such a printer you will print only files that the printer can understand.\r
289 \r
290 Users often expect that they can print plain text to any of the printers installed on your system. Programs that interface to  **LPD**  to do their printing usually make the same assumption. If you are installing such a printer and want to be able to print jobs in the printer language ***and*** print plain text jobs, you are strongly urged to add an additional step to the simple setup outlined above: install an automatic plain-text-to-PostScript (or other printer language) conversion program. The section entitled [printing-advanced.html#PRINTING-ADVANCED-IF-CONVERSION Accommodating Plain Text Jobs on PostScript Printers] tells how to do this.\r
291 \r
292 ##### Naming the Printer \r
293 \r
294 The first (easy) step is to pick a name for your printer It really does not matter whether you choose functional or whimsical names since you can also provide a number of aliases for the printer.\r
295 \r
296 At least one of the printers specified in the `/etc/printcap` should have the alias `lp`. This is the default printer's name. If users do not have the `PRINTER` environment variable nor specify a printer name on the command line of any of the  **LPD**  commands, then `lp` will be the default printer they get to use.\r
297 \r
298 Also, it is common practice to make the last alias for a printer be a full description of the printer, including make and model.\r
299 \r
300 Once you have picked a name and some common aliases, put them in the `/etc/printcap` file. The name of the printer should start in the leftmost column. Separate each alias with a vertical bar and put a colon after the last alias.\r
301 \r
302 In the following example, we start with a skeletal `/etc/printcap` that defines two printers (a Diablo 630 line printer and a Panasonic KX-P4455 PostScript laser printer):\r
303 \r
304     \r
305     #\r
306     #  /etc/printcap for host rose\r
307     #\r
308     rattan|line|diablo|lp|Diablo 630 Line Printer:\r
309     \r
310     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\r
311 \r
312 \r
313 In this example, the first printer is named `rattan` and has as aliases `line`, `diablo`, `lp`, and `Diablo 630 Line Printer`. Since it has the alias `lp`, it is also the default printer. The second is named `bamboo`, and has as aliases `ps`, `PS`, `S`, `panasonic`, and `Panasonic KX-P4455 PostScript v51.4`.\r
314 \r
315 ##### Suppressing Header Pages \r
316 \r
317 The  **LPD**  spooling system will by default print a ***header page*** for each job. The header page contains the user name who requested the job, the host from which the job came, and the name of the job, in nice large letters. Unfortunately, all this extra text gets in the way of debugging the simple printer setup, so we will suppress header pages.\r
318 \r
319 To suppress header pages, add the `sh` capability to the entry for the printer in `/etc/printcap`. Here is an example `/etc/printcap` with `sh` added:\r
320 \r
321     \r
322     #\r
323     #  /etc/printcap for host rose - no header pages anywhere\r
324     #\r
325     rattan|line|diablo|lp|Diablo 630 Line Printer:\\r
326             :sh:\r
327     \r
328     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\\r
329             :sh:\r
330 \r
331 \r
332 Note how we used the correct format: the first line starts in the leftmost column, and subsequent lines are indented with a single TAB. Every line in an entry except the last ends in a backslash character.\r
333 \r
334 ##### Making the Spooling Directory \r
335 \r
336 The next step in the simple spooler setup is to make a ***spooling directory***, a directory where print jobs reside until they are printed, and where a number of other spooler support files live.\r
337 \r
338 Because of the variable nature of spooling directories, it is customary to put these directories under `/var/spool`. It is not necessary to backup the contents of spooling directories, either. Recreating them is as simple as running [mkdir(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#mkdir&section1).\r
339 \r
340 It is also customary to make the directory with a name that is identical to the name of the printer, as shown below:\r
341 \r
342     \r
343     # mkdir /var/spool/`***printer-name***`\r
344 \r
345 \r
346 However, if you have a lot of printers on your network, you might want to put the spooling directories under a single directory that you reserve just for printing with  **LPD** . We will do this for our two example printers `rattan` and `bamboo`:\r
347 \r
348     \r
349     # mkdir /var/spool/lpd\r
350     # mkdir /var/spool/lpd/rattan\r
351     # mkdir /var/spool/lpd/bamboo\r
352 \r
353 \r
354  **Note:** If you are concerned about the privacy of jobs that users print, you might want to protect the spooling directory so it is not publicly accessible. Spooling directories should be owned and be readable, writable, and searchable by user daemon and group daemon, and no one else. We will do this for our example printers:\r
355 \r
356     \r
357     # chown daemon:daemon /var/spool/lpd/rattan\r
358     # chown daemon:daemon /var/spool/lpd/bamboo\r
359     # chmod 770 /var/spool/lpd/rattan\r
360     # chmod 770 /var/spool/lpd/bamboo\r
361 \r
362 \r
363 Finally, you need to tell  **LPD**  about these directories using the `/etc/printcap` file. You specify the pathname of the spooling directory with the `sd` capability:\r
364 \r
365     \r
366     #\r
367     #  /etc/printcap for host rose - added spooling directories\r
368     #\r
369     rattan|line|diablo|lp|Diablo 630 Line Printer:\\r
370             :sh:sd=/var/spool/lpd/rattan:\r
371     \r
372     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\\r
373             :sh:sd=/var/spool/lpd/bamboo:\r
374 \r
375 \r
376 Note that the name of the printer starts in the first column but all other entries describing the printer should be indented with a tab and each line escaped with a backslash.\r
377 \r
378 If you do not specify a spooling directory with `sd`, the spooling system will use `/var/spool/lpd` as a default.\r
379 \r
380 ##### Identifying the Printer Device \r
381 \r
382 In the [printing-intro-setup.html#PRINTING-DEV-PORTS Adding `/dev` Entries for the Ports] section, we identified which entry in the `/dev` directory DragonFly will use to communicate with the printer. Now, we tell  **LPD**  that information. When the spooling system has a job to print, it will open the specified device on behalf of the filter program (which is responsible for passing data to the printer).\r
383 \r
384 List the `/dev` entry pathname in the `/etc/printcap` file using the `lp` capability.\r
385 \r
386 In our running example, let us assume that `rattan` is on the first parallel port, and `bamboo` is on a sixth serial port; here are the additions to `/etc/printcap`:\r
387 \r
388     \r
389     #\r
390     #  /etc/printcap for host rose - identified what devices to use\r
391     #\r
392     rattan|line|diablo|lp|Diablo 630 Line Printer:\\r
393             :sh:sd=/var/spool/lpd/rattan:\\r
394             :lp=/dev/lpt0:\r
395     \r
396     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\\r
397             :sh:sd=/var/spool/lpd/bamboo:\\r
398             :lp=/dev/ttyd5:\r
399 \r
400 \r
401 If you do not specify the `lp` capability for a printer in your `/etc/printcap` file,  **LPD**  uses `/dev/lp` as a default. `/dev/lp` currently does not exist in DragonFly.\r
402 \r
403 If the printer you are installing is connected to a parallel port, skip to the section entitled, [printing-intro-setup.html#PRINTING-TEXTFILTER Installing the Text Filter]. Otherwise, be sure to follow the instructions in the next section.\r
404 \r
405 ##### Configuring Spooler Communication Parameters \r
406 \r
407 For printers on serial ports,  **LPD**  can set up the bps rate, parity, and other serial communication parameters on behalf of the filter program that sends data to the printer. This is advantageous since:\r
408 \r
410 * It lets you try different communication parameters by simply editing the `/etc/printcap` file; you do not have to recompile the filter program.\r
412 * It enables the spooling system to use the same filter program for multiple printers which may have different serial communication settings.\r
413 \r
414 The following `/etc/printcap` capabilities control serial communication parameters of the device listed in the `lp` capability:\r
415 \r
416 `br#`***bps-rate******:: Sets the communications speed of the device to `***bps-rate***`, where `***bps-rate***` can be 50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 57600, or 115200 bits-per-second.`ms#`***stty-mode******:: Sets the options for the terminal device after opening the device. [stty(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#stty&section1) explains the available options.\r
417 \r
418 When  **LPD**  opens the device specified by the `lp` capability, it sets the characteristics of the device to those specified with the `ms#` capability. Of particular interest will be the `parenb`, `parodd`, `cs5`, `cs6`, `cs7`, `cs8`, `cstopb`, `crtscts`, and `ixon` modes, which are explained in the [stty(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#stty&section1) manual page.\r
419 \r
420 Let us add to our example printer on the sixth serial port. We will set the bps rate to 38400. For the mode, we will set no parity with `-parenb`, 8-bit characters with `cs8`, no modem control with `clocal` and hardware flow control with `crtscts`:\r
421 \r
422     \r
423     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\\r
424             :sh:sd=/var/spool/lpd/bamboo:\\r
425             :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:\r
426 \r
427 \r
428 ##### Installing the Text Filter \r
429 \r
430 We are now ready to tell  **LPD**  what text filter to use to send jobs to the printer. A ***text filter***, also known as an ***input filter***, is a program that  **LPD**  runs when it has a job to print. When  **LPD**  runs the text filter for a printer, it sets the filter's standard input to the job to print, and its standard output to the printer device specified with the `lp` capability. The filter is expected to read the job from standard input, perform any necessary translation for the printer, and write the results to standard output, which will get printed. For more information on the text filter, see the [printing-advanced.html#PRINTING-ADVANCED-FILTERS Filters] section.\r
431 \r
432 For our simple printer setup, the text filter can be a small shell script that just executes `/bin/cat` to send the job to the printer. DragonFly comes with another filter called `lpf` that handles backspacing and underlining for printers that might not deal with such character streams well. And, of course, you can use any other filter program you want. The filter `lpf` is described in detail in section entitled [printing-advanced.html#PRINTING-ADVANCED-LPF lpf: a Text Filter].\r
433 \r
434 First, let us make the shell script `/usr/local/libexec/if-simple` be a simple text filter. Put the following text into that file with your favorite text editor:\r
435 \r
436     \r
437     #!/bin/sh\r
438     #\r
439     # if-simple - Simple text input filter for lpd\r
440     # Installed in /usr/local/libexec/if-simple\r
441     #\r
442     # Simply copies stdin to stdout.  Ignores all filter arguments.\r
443     \r
444     /bin/cat && exit 0\r
445     exit 2\r
446 \r
447 \r
448 Make the file executable:\r
449 \r
450     \r
451     # chmod 555 /usr/local/libexec/if-simple\r
452 \r
453 \r
454 And then tell LPD to use it by specifying it with the `if` capability in `/etc/printcap`. We will add it to the two printers we have so far in the example `/etc/printcap`:\r
455 \r
456     \r
457     #\r
458     #  /etc/printcap for host rose - added text filter\r
459     #\r
460     rattan|line|diablo|lp|Diablo 630 Line Printer:\\r
461             :sh:sd#/var/spool/lpd/rattan:\ :lp/dev/lpt0:\\r
462             :if=/usr/local/libexec/if-simple:\r
463     \r
464     bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\\r
465             :sh:sd=/var/spool/lpd/bamboo:\\r
466             :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:\\r
467             :if=/usr/local/libexec/if-simple:\r
468 \r
469 \r
470 ##### Turn on  **LPD**  \r
471 \r
472 [lpd(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpd&section8) is run from `/etc/rc`, controlled by the `lpd_enable` variable. This variable defaults to `NO`. If you have not done so already, add the line:\r
473 \r
474     \r
475     lpd_enable="YES"\r
476 \r
477 \r
478 to `/etc/rc.conf`, and then either restart your machine, or just run [lpd(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpd&section8).\r
479 \r
480     \r
481     # lpd\r
482 \r
483 \r
484 ##### Trying It Out \r
485 \r
486 You have reached the end of the simple  **LPD**  setup. Unfortunately, congratulations are not quite yet in order, since we still have to test the setup and correct any problems. To test the setup, try printing something. To print with the  **LPD**  system, you use the command [lpr(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpr&section1), which submits a job for printing.\r
487 \r
488 You can combine [lpr(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpr&section1) with the [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=lptest&section=1) program, introduced in section [printing-intro-setup.html#PRINTING-TESTING Checking Printer Communications] to generate some test text.\r
489 \r
490 ***To test the simple  **LPD**  setup:***\r
491 \r
492 Type:\r
493 \r
494     \r
495     # lptest 20 5 | lpr -P`***printer-name***`\r
496 \r
497 \r
498 Where `***printer-name***` is a the name of a printer (or an alias) specified in `/etc/printcap`. To test the default printer, type [lpr(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lpr&section1) without any `-P` argument. Again, if you are testing a printer that expects PostScript, send a PostScript program in that language instead of using [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=lptest&section=1). You can do so by putting the program in a file and typing `lpr `***file******.\r
499 \r
500 For a PostScript printer, you should get the results of the program. If you are using [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1), then your results should look like the following:\r
501 \r
502     \r
503     !"#$%&'()*+,-./01234\r
504     "#$%&'()*+,-./012345\r
505     #$%&'()*+,-./0123456\r
506     $%&'()*+,-./01234567\r
507     %&'()*+,-./012345678\r
508 \r
509 \r
510 To further test the printer, try downloading larger programs (for language-based printers) or running [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1) with different arguments. For example, `lptest 80 60` will produce 60 lines of 80 characters each.\r
511 \r
512 If the printer did not work, see the [printing-troubleshooting.html Troubleshooting] section.\r
513 \r
514 \r
515 \r
516 CategoryHandbook\r
517 CategoryHandbook-printing\r