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.3 by cebix, 1999-10-04T21:07:12Z vs.
Revision 1.6 by cebix, 2001-02-10T20:04:17Z

# Line 16 | Line 16 | ROM files. No, I won't send you one.
16   Depending on the platform you use, Basilisk II has additional requirements:
17  
18   BeOS:
19 <  You need BeOS R4 or better. On a PowerPC system you also need the
20 <  "sheep" driver that comes with SheepShaver. To use Ethernet, you need
21 <  the "sheep_net" add-on that also comes with SheepShaver (both items
22 <  are included in the SheepShaver Trial Versions). The PowerPC version of
19 >  You need BeOS R4 or better.
20    Basilisk II cannot do Mac Classic emulation.
21  
22   Unix:
23 <  You need X11R6, pthreads support and GNU make. To use the GUI preferences
24 <  editor, you also need GTK+ version 1.2 or better. On Linux, you need
25 <  glibc 2.0 or better.
23 >  You need X11R6 and a "make" utility with the VPATH feature (e.g. GNU make).
24 >  For serial, ethernet and audio support, you need pthreads. To use the GUI
25 >  preferences editor, you also need GTK+ version 1.2 or better. On Linux, you
26 >  need glibc 2.0 or better.
27  
28   AmigaOS:
29    You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
# Line 46 | Line 44 | Installation
44  
45   BeOS:
46    If you have a binary distribution of Basilisk II for BeOS, there are
47 <  executables for BeOS/PPC and/or BeOS/x86 included. If you have the source
48 <  distribution, do the following:
47 >  executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run
48 >  concurrently with SheepShaver. Trying to do so will crash Basilisk II, or
49 >  SheepShaver, or both.
50 >
51 >  If you have the source distribution, do the following:
52  
53      cd src/BeOS
54      make
55  
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
57 >  directory. To use Ethernet, you also have to do:
58 >
59 >    cd SheepNet
60 >    make install
61 >
62 >  On a PowerPC system, you also have to do:
63 >
64 >    cd SheepDriver
65 >    make install
66  
67   Unix:
68    To compile Basilisk II, do the following:
69  
70      cd src/Unix
71      ./configure
72 <    make
72 >    make            [or "gmake" if you have GNU make and "make" fails]
73      make install    [optionally]
74  
75    To use Ethernet networking under Linux, you either have to configure your
# Line 89 | Line 94 | Unix:
94      turns on massive interprocedural optimization, and makes for much
95      better performance."
96  
97 +  ATTENTION NetBSD/m68k USERS:
98 +  If you want to run Basilisk II natively (i.e. without CPU emulation), you
99 +  must NOT use a pthreads library. User-level threads libraries such as PTL
100 +  interfere with the signal handlers installed by Basilisk II and kernel-
101 +  level threads are not supported by NetBSD, so you will have to live without
102 +  pthreads (and thus, without serial/ethernet/audio support).
103 +
104 +  ATTENTION NetBSD/mac68k USERS:
105 +  Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug
106 +  that not only prevents Basilisk II from running properly but seems to even
107 +  cause kernel panics under certain conditions! Apply the following patch to
108 +  /sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel
109 +  and reboot before using Basilisk II:
110 +
111 +    --- macromasm.s.orig    Wed Jul  5 19:29:01 2000
112 +    +++ macromasm.s Wed Jul  5 19:12:34 2000
113 +    @@ -37,6 +37,8 @@
114 +
115 +     #include "opt_adb.h"
116 +     #include "assym.h"
117 +    +#include <machine/asm.h>
118 +    +#include <machine/trap.h>
119 +
120 +
121 +            /* Define this symbol as global with (v) value */
122 +    @@ -437,8 +439,9 @@
123 +            movw    sp@(FR_HW + 4), d0      | retrieve status register
124 +            andw    #PSL_S, d0      | supervisor state?
125 +            bne     Lalnosup        | branch if supervisor
126 +    -       jbsr    _mrg_aline_user | user a-line trap
127 +    -       bra     Lalrts
128 +    +       addql   #4, sp          | pop frame ptr
129 +    +       movql   #T_ILLINST, d0  | user-mode fault
130 +    +       jra     _ASM_LABEL(fault)
131 +     Lalnosup:
132 +     #define FR_PC (FR_HW+2)
133 +            movl    sp@(FR_PC + 4), a0      | retrieve PC
134 +
135   AmigaOS:
136    If you have a binary distribution of Basilisk II for AmigaOS, there is an
137    executable included. You must also have the "PrepareEmul" utility installed
# Line 97 | Line 140 | AmigaOS:
140    following:
141  
142      cd src/AmigaOS
143 <    smake
143 >    make
144  
145 <  To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work.
145 >  To recompile Basilisk II, you need the GeekGadgets development suite and
146 >  PhxAss (which can be found on Aminet).
147  
148   Windows NT:
149    If you have a binary distribution of Basilisk II for Windows, there is a

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines