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.4 by cebix, 1999-10-15T14:47:49Z vs.
Revision 1.8 by nigel, 2003-08-02T08:48:38Z

# 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 later versions.
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 40 | Line 38 | Windows:
38    somewhat reduced set of features. Basilisk II supports DirectX version 5 or
39    later, but version 3 may also work, depending on your graphics card.
40  
41 + Mac OS X:
42 +  Versions 10.0 thru 10.2 can be used, and 10.3 will probably be no problem.
43 +  (OS X public beta is not supported by the current executable or source code,
44 +   but if you really need to use it, I can provide versions that will work)
45  
46   Installation
47   ------------
48  
49   BeOS:
50    If you have a binary distribution of Basilisk II for BeOS, there are
51 <  executables for BeOS/PPC and/or BeOS/x86 included. If you have the source
52 <  distribution, do the following:
51 >  executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run
52 >  concurrently with SheepShaver. Trying to do so will crash Basilisk II, or
53 >  SheepShaver, or both.
54 >
55 >  If you have the source distribution, do the following:
56  
57      cd src/BeOS
58      make
59  
60    This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
61 <  directory. Basilisk II cannot run concurrently with SheepShaver. Trying to
62 <  do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system
63 <  you must have installed the "sheep" driver that comes with SheepShaver. To
64 <  use Ethernet, you must have installed the "sheep_net" add-on that also comes
65 <  with SheepShaver
61 >  directory. To use Ethernet, you also have to do:
62 >
63 >    cd SheepNet
64 >    make install
65 >
66 >  On a PowerPC system, you also have to do:
67 >
68 >    cd SheepDriver
69 >    make install
70  
71   Unix:
72    To compile Basilisk II, do the following:
# Line 68 | Line 77 | Unix:
77      make install    [optionally]
78  
79    To use Ethernet networking under Linux, you either have to configure your
80 <  kernel for ethertap support or make and install the "sheep_net" driver:
81 <
82 <    make modules
74 <
75 <  This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver"
76 <  directory. Now su root and say
77 <
78 <    cd Linux/NetDriver
79 <    make dev
80 <    /sbin/insmod sheep_net.o
81 <
82 <  This will install the device node "/dev/sheep_net" and load the driver.
83 <  You should give appropriate access rights to /dev/sheep_net if you don't
84 <  want to have to run Basilisk II as root.
80 >  kernel for ethertap support or make and install the "sheep_net" driver
81 >  (this is explained in the README file, at the description of the "ether"
82 >  preferences item).
83  
84    This is what Brian J. Johnson says about compiling for IRIX:
85     "I recommend compiling with "-Ofast".  This requires changing "-g"
# Line 89 | Line 87 | Unix:
87      turns on massive interprocedural optimization, and makes for much
88      better performance."
89  
90 +  ATTENTION NetBSD/m68k USERS:
91 +  If you want to run Basilisk II natively (i.e. without CPU emulation), you
92 +  must NOT use a pthreads library. User-level threads libraries such as PTL
93 +  interfere with the signal handlers installed by Basilisk II and kernel-
94 +  level threads are not supported by NetBSD, so you will have to live without
95 +  pthreads, and thus without serial/ethernet/audio support (but the "UDP
96 +  tunnelling" network should work).
97 +
98 +  ATTENTION NetBSD/mac68k USERS:
99 +  Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug
100 +  that not only prevents Basilisk II from running properly but seems to even
101 +  cause kernel panics under certain conditions! Apply the following patch to
102 +  /sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel
103 +  and reboot before using Basilisk II:
104 +
105 +    --- macromasm.s.orig    Wed Jul  5 19:29:01 2000
106 +    +++ macromasm.s Wed Jul  5 19:12:34 2000
107 +    @@ -37,6 +37,8 @@
108 +
109 +     #include "opt_adb.h"
110 +     #include "assym.h"
111 +    +#include <machine/asm.h>
112 +    +#include <machine/trap.h>
113 +
114 +
115 +            /* Define this symbol as global with (v) value */
116 +    @@ -437,8 +439,9 @@
117 +            movw    sp@(FR_HW + 4), d0      | retrieve status register
118 +            andw    #PSL_S, d0      | supervisor state?
119 +            bne     Lalnosup        | branch if supervisor
120 +    -       jbsr    _mrg_aline_user | user a-line trap
121 +    -       bra     Lalrts
122 +    +       addql   #4, sp          | pop frame ptr
123 +    +       movql   #T_ILLINST, d0  | user-mode fault
124 +    +       jra     _ASM_LABEL(fault)
125 +     Lalnosup:
126 +     #define FR_PC (FR_HW+2)
127 +            movl    sp@(FR_PC + 4), a0      | retrieve PC
128 +
129   AmigaOS:
130    If you have a binary distribution of Basilisk II for AmigaOS, there is an
131    executable included. You must also have the "PrepareEmul" utility installed
# Line 97 | Line 134 | AmigaOS:
134    following:
135  
136      cd src/AmigaOS
137 <    smake
137 >    make
138  
139 <  To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work.
139 >  To recompile Basilisk II, you need the GeekGadgets development suite and
140 >  PhxAss (which can be found on Aminet).
141  
142   Windows NT:
143    If you have a binary distribution of Basilisk II for Windows, there is a
# Line 110 | Line 148 | Windows NT:
148    MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some
149    modifications. See the "sysdeps.h" file in the "Windows" directory.
150  
151 + Mac OS X:
152 +  If you have the prebuilt application, there is nothing to do.
153 +  If you have the developer tools installed, and want to built it yourself,
154 +  look in the file src/MacOSX/0_HOW_TO_BUILD.txt
155 +
156 +
157   The ROM file has to be named "ROM" and put in the same directory as the
158   Basilisk II executable but you can specify a different location for the ROM
159   file with the "rom" option in the preferences file (or with the preferences

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines