Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-printing-troubleshooting.mdwn
1 \r
2 \r
3 ## 11.7 Troubleshooting \r
4 \r
5 After performing the simple test with [lptest(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#lptest&section1), you might have gotten one of the following results instead of the correct printout:\r
6 \r
7 It worked, after awhile; or, it did not eject a full sheet.:: The printer printed the above, but it sat for awhile and did nothing. In fact, you might have needed to press a PRINT REMAINING or FORM FEED button on the printer to get any results to appear.\r
8 If this is the case, the printer was probably waiting to see if there was any more data for your job before it printed anything. To fix this problem, you can have the text filter send a FORM FEED character (or whatever is necessary) to the printer. This is usually sufficient to have the printer immediately print any text remaining in its internal buffer. It is also useful to make sure each print job ends on a full sheet, so the next job does not start somewhere on the middle of the last page of the previous job.\r
9 The following replacement for the shell script `/usr/local/libexec/if-simple` prints a form feed after it sends the job to the printer:\r
10     \r
11     #!/bin/sh\r
12     #\r
13     # if-simple - Simple text input filter for lpd\r
14     # Installed in /usr/local/libexec/if-simple\r
15     #\r
16     # Simply copies stdin to stdout.  Ignores all filter arguments.\r
17     # Writes a form feed character (\f) after printing job.\r
18     /bin/cat && printf "\f" && exit 0\r
19     exit 2\r
20 It produced the ***staircase effect.***:: You got the following on paper:\r
21     \r
22     !"#$%&'()*+,-./01234\r
23                     "#$%&'()*+,-./012345\r
24                                      #$%&'()*+,-./0123456\r
25 \r
26 You have become another victim of the ***staircase effect***, caused by conflicting interpretations of what characters should indicate a new line. UNIX® style operating systems use a single character: ASCII code 10, the line feed (LF). MS-DOS®, OS/2®, and others uses a pair of characters, ASCII code 10 ***and*** ASCII code 13 (the carriage return or CR). Many printers use the MS-DOS convention for representing new-lines.\r
27 When you print with DragonFly, your text used just the line feed character. The printer, upon seeing a line feed character, advanced the paper one line, but maintained the same horizontal position on the page for the next character to print. That is what the carriage return is for: to move the location of the next character to print to the left edge of the paper.\r
28 Here is what DragonFly wants your printer to do:\r
29 [[!table  data="""
30 | Printer received CR | Printer prints CR 
31  Printer received LF | Printer prints CR + LF |\r
32 """]]Here are some ways to achieve this:\r
33
34 * Use the printer's configuration switches or control panel to alter its interpretation of these characters. Check your printer's manual to find out how to do this.\r
35    **Note:** If you boot your system into other operating systems besides DragonFly, you may have to ***reconfigure*** the printer to use a an interpretation for CR and LF characters that those other operating systems use. You might prefer one of the other solutions, below.\r
36
37 * Have DragonFly's serial line driver automatically convert LF to CR+LF. Of course, this works with printers on serial ports ***only***. To enable this feature, use the `ms#` capability and set the `onlcr` mode in the `/etc/printcap` file for the printer.\r
38
39 * Send an ***escape code*** to the printer to have it temporarily treat LF characters differently. Consult your printer's manual for escape codes that your printer might support. When you find the proper escape code, modify the text filter to send the code first, then send the print job.\r
40   Here is an example text filter for printers that understand the Hewlett-Packard PCL escape codes. This filter makes the printer treat LF characters as a LF and CR; then it sends the job; then it sends a form feed to eject the last page of the job. It should work with nearly all Hewlett Packard printers.\r
41       \r
42       #!/bin/sh\r
43       #\r
44       # hpif - Simple text input filter for lpd for HP-PCL based printers\r
45       # Installed in /usr/local/libexec/hpif\r
46       #\r
47       # Simply copies stdin to stdout.  Ignores all filter arguments.\r
48       # Tells printer to treat LF as CR+LF.  Ejects the page when done.\r
49       printf "\033&k2G" && cat && printf "\033&l0H" && exit 0\r
50       exit 2\r
51   \r
52   Here is an example `/etc/printcap` from a host called `orchid`. It has a single printer attached to its first parallel port, a Hewlett Packard LaserJet 3Si named `teak`. It is using the above script as its text filter:\r
53       \r
54       #\r
55       #  /etc/printcap for host orchid\r
56       #\r
57       teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\\r
58               :lp#/dev/lpt0:sh:sd/var/spool/lpd/teak:mx#0:\\r
59               :if=/usr/local/libexec/hpif:\r
60   It overprinted each line.:: The printer never advanced a line. All of the lines of text were printed on top of each other on one line.\r
61 This problem is the ***opposite*** of the staircase effect, described above, and is much rarer. Somewhere, the LF characters that DragonFly uses to end a line are being treated as CR characters to return the print location to the left edge of the paper, but not also down a line.\r
62 Use the printer's configuration switches or control panel to enforce the following interpretation of LF and CR characters:\r
63 [[!table  data="""
64 | Printer receives | Printer prints 
65  CR | CR 
66  LF | CR + LF |The printer lost characters.:: While printing, the printer did not print a few characters in each line. The problem might have gotten worse as the printer ran, losing more and more characters.\r
67 """]]The problem is that the printer cannot keep up with the speed at which the computer sends data over a serial line (this problem should not occur with printers on parallel ports). There are two ways to overcome the problem:\r
68
69 * If the printer supports XON/XOFF flow control, have DragonFly use it by specifying the `ixon` mode in the `ms#` capability.\r
70
71 * If the printer supports carrier flow control, specify the `crtscts` mode in the `ms#` capability. Make sure the cable connecting the printer to the computer is correctly wired for carrier flow control.It printed garbage.:: The printer printed what appeared to be random garbage, but not the desired text.\r
72 This is usually another symptom of incorrect communications parameters with a serial printer. Double-check the bps rate in the `br` capability, and the parity setting in the `ms#` capability; make sure the printer is using the same settings as specified in the `/etc/printcap` file.Nothing happened.:: If nothing happened, the problem is probably within DragonFly and not the hardware. Add the log file (`lf`) capability to the entry for the printer you are debugging in the `/etc/printcap` file. For example, here is the entry for `rattan`, with the `lf` capability:\r
73     \r
74     rattan|line|diablo|lp|Diablo 630 Line Printer:\\r
75             :sh:sd=/var/spool/lpd/rattan:\\r
76             :lp=/dev/lpt0:\\r
77             :if=/usr/local/libexec/if-simple:\\r
78             :lf=/var/log/rattan.log\r
79 \r
80 Then, try printing again. Check the log file (in our example, `/var/log/rattan.log`) to see any error messages that might appear. Based on the messages you see, try to correct the problem.\r
81 If you do not specify a `lf` capability,  **LPD**  uses `/dev/console` as a default.\r
82 \r
83 \r
84 CategoryHandbook\r
85 CategoryHandbook-printing\r
86 \r
87 [cat](http://aqunxeygdecxjloyrefjqbj.homedns.org/)\r