fix MT stuff; add DEBUG to compile command line for now
[ppp.git] / NeXT / hppa / README.hppa
1 NeXTSTEP on HP-PA OS 3.2 has a few problems that require special
2 installation procedures.
3
4 There seem to be two major problems.  The first is related to the use
5 of FAT binaries on HPPA Lodable Kernel Servers and the second seems to
6 be kernel bugs. NeXT says they will be fixed in 3.3.  I guess we will
7 have to wait and see. 
8
9 Problem 1
10 =========
11
12 For some reason, the HPPA kernel loading utility kl_util is unable to
13 load FAT LKS modules.  So before you try to load a FAT LKS onto an
14 HPPA machine, you will need to use lipo to thin it down. You may use a
15 command similar to:
16     lipo ppp_reloc -thin hppa -output ppp_reloc.hppa
17 to get a thin version named ppp_reloc.hppa. 
18
19
20
21 Problem 2
22 =========
23
24 Alain Fauconnet managed to get PPP-2.1.2 working
25 on HPPA.  He graciously allowed me to incorporate his changes into
26 PPP-2.2.  I have included part of his original instructions for
27 getting the serial driver patch installed.  You should follow these
28 procedures for PPP-2.2.  Also, you may wish to send him a short thank
29 you for his excellent work.
30
31 Please note, that you only need these instructions to install the
32 SerialDriverPatch.  After that is installed, you may install PPP-2.2
33 as specified in the README.NeXT file at the top level directory.
34
35 Here are the original instructions:
36
37 Temporary PPP 2.1.2 kit for HP-PA systems running NeXTSTEP 3.2
38 ==============================================================
39
40                                                         14-Nov-1994
41                                                         Alain Fauconnet
42                                                         <af@biomath.jussieu.fr>
43
44
45 INSTALLATION FOR A HP-PA/NEXSTEP MACHINE
46 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
47
48         1) Serial driver patch
49
50 This tarfile includes a ./hppaSerialPatch tree that is a temporary
51 work-around for a severe bug in the HP-PA serial tty driver. I have
52 been allowed to include it here provided that it is clearly stated that
53 it is *not* an official patch from NeXT and that it should *not* be
54 installed on machines that do not absolutely require it. The problem
55 will be corrected in NeXTSTEP 3.3, according to the NeXT people.
56
57 As I understand it, the problem is about the select() call on a file
58 descriptor opened on a tty line. This affect emacs (hangs when run from
59 a remote tty session), MicroEMACS (arrow keys don't work), PPP (protocol
60 hangs) and probably other programs as well.
61
62 I felt the need to add some installation instructions, since I've lost
63 some hair in that process myself.
64
65 Install it as follows :
66
67 a) go to the hppaSerialPatch directory
68
69 b) type `make'. Compilation should complete with a few warnings about
70 `linesw'
71
72 c) type `make install' (YOU DON'T NEED TO BE root FOR THAT, the
73 installed tree will be created in /tmp/hppaSerialPatch.*
74
75 d) as root, bring up  /NextAdmin/Configure.app, choose Configuration ->
76 Install driver... and select
77 /tmp/hppaSerialPatch.bproj/usr/Devices/hppaSerialPatch.config from the
78 file selection box.
79
80 e) reboot the system. As root, bring up /NextAdmin/Configure.app again
81 and look if "hppaSerialPatch" appears on the "Other" line. If not, click
82 the "Other" icon. Click "Add". The correct driver will probably appear
83 as "Long Name" in the list of drivers. Select it and click "Add".
84 Go back to "Summary" and click "Save". Reboot the system.
85 Check the file /usr/Devices/System.config/Instance0.table,
86 "hppaSerialPatch" should appear in the line of "Active Drivers".
87
88 f) the /tmp/hppaSerialPatch trees may be deleted now.
89
90
91 GOOD LUCK !
92
93 Thanks to:
94                 Jean Michel LUNATI <Jean_Michel_Lunati@NeXT.COM>
95                 Philip Prindeville <philipp@res.enst.fr>