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>