ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/INSTALL
(Generate patch)

Comparing BasiliskII/INSTALL (file contents):
Revision 1.1 by cebix, 1999-10-03T17:11:52Z vs.
Revision 1.5 by cebix, 2000-07-13T17:45:50Z

# Line 23 | Line 23 | BeOS:
23    Basilisk II cannot do Mac Classic emulation.
24  
25   Unix:
26 <  You need X11R6, pthreads support and GNU make. To use the GUI preferences
27 <  editor, you also need GTK+ version 1.2 or better. On Linux, you need
28 <  glibc 2.0 or better.
26 >  You need X11R6 and a "make" utility with the VPATH feature (e.g. GNU make).
27 >  For serial, ethernet and audio support, you need pthreads. To use the GUI
28 >  preferences editor, you also need GTK+ version 1.2 or better. On Linux, you
29 >  need glibc 2.0 or better.
30  
31   AmigaOS:
32    You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
# Line 52 | Line 53 | BeOS:
53      cd src/BeOS
54      make
55  
56 <  Basilisk II cannot run concurrently with SheepShaver. Trying to do so will
57 <  crash Basilisk II, or SheepShaver, or both. On a PowerPC system you must
58 <  have installed the "sheep" driver that comes with SheepShaver. To use
59 <  Ethernet, you must have installed the "sheep_net" add-on that also comes
56 >  This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
57 >  directory. Basilisk II cannot run concurrently with SheepShaver. Trying to
58 >  do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system
59 >  you must have installed the "sheep" driver that comes with SheepShaver. To
60 >  use Ethernet, you must have installed the "sheep_net" add-on that also comes
61    with SheepShaver
62  
63   Unix:
# Line 63 | Line 65 | Unix:
65  
66      cd src/Unix
67      ./configure
68 <    make
68 >    make            [or "gmake" if you have GNU make and "make" fails]
69      make install    [optionally]
70  
71    To use Ethernet networking under Linux, you either have to configure your
72    kernel for ethertap support or make and install the "sheep_net" driver:
73  
72    cd src/Unix
74      make modules
75  
76    This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver"
77    directory. Now su root and say
78  
79 <    ./MAKEDEV
79 >    cd Linux/NetDriver
80 >    make dev
81      /sbin/insmod sheep_net.o
82  
83    This will install the device node "/dev/sheep_net" and load the driver.
# Line 88 | Line 90 | Unix:
90      turns on massive interprocedural optimization, and makes for much
91      better performance."
92  
93 +  ATTENTION NetBSD/m68k USERS:
94 +  If you want to run Basilisk II natively (i.e. without CPU emulation), you
95 +  must NOT use a pthreads library. User-level threads libraries such as PTL
96 +  interfere with the signal handlers installed by Basilisk II and kernel-
97 +  level threads are not supported by NetBSD, so you will have to live without
98 +  pthreads (and thus, without serial/ethernet/audio support).
99 +
100 +  ATTENTION NetBSD/mac68k USERS:
101 +  Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug
102 +  that not only prevents Basilisk II from running properly but seems to even
103 +  cause kernel panics under certain conditions! Apply the following patch to
104 +  /sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel
105 +  and reboot before using Basilisk II:
106 +
107 +    --- macromasm.s.orig    Wed Jul  5 19:29:01 2000
108 +    +++ macromasm.s Wed Jul  5 19:12:34 2000
109 +    @@ -37,6 +37,8 @@
110 +
111 +     #include "opt_adb.h"
112 +     #include "assym.h"
113 +    +#include <machine/asm.h>
114 +    +#include <machine/trap.h>
115 +
116 +
117 +            /* Define this symbol as global with (v) value */
118 +    @@ -437,8 +439,9 @@
119 +            movw    sp@(FR_HW + 4), d0      | retrieve status register
120 +            andw    #PSL_S, d0      | supervisor state?
121 +            bne     Lalnosup        | branch if supervisor
122 +    -       jbsr    _mrg_aline_user | user a-line trap
123 +    -       bra     Lalrts
124 +    +       addql   #4, sp          | pop frame ptr
125 +    +       movql   #T_ILLINST, d0  | user-mode fault
126 +    +       jra     _ASM_LABEL(fault)
127 +     Lalnosup:
128 +     #define FR_PC (FR_HW+2)
129 +            movl    sp@(FR_PC + 4), a0      | retrieve PC
130 +
131   AmigaOS:
132    If you have a binary distribution of Basilisk II for AmigaOS, there is an
133    executable included. You must also have the "PrepareEmul" utility installed

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines