ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/INSTALL
Revision: 1.5
Committed: 2000-07-13T17:45:50Z (24 years, 4 months ago) by cebix
Branch: MAIN
CVS Tags: snapshot-13072000
Changes since 1.4: +42 -3 lines
Log Message:
- updated doc files

File Contents

# User Rev Content
1 cebix 1.1 BASILISK II INSTALLATION INSTRUCTIONS
2     =====================================
3    
4     System Requirements
5     -------------------
6    
7     To use Basilisk II, you need either a 512K Mac Classic ROM image or a
8     512K or 1MB 32-bit clean Macintosh ROM image. You also need a copy of MacOS
9     (0.x thru 7.5 for Classic emulation, 7.x or 8.0/8.1 for Mac II emulation).
10     For copyright reasons, none of these items are included with Basilisk II.
11     MacOS 7.5.3 and earlier versions can be downloaded from Apple and various
12     other Internet sites. Mac ROM files are not freely available. You have to
13     own a real Mac and read out its ROM. No, I don't know where you can download
14     ROM files. No, I won't send you one.
15    
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
23     Basilisk II cannot do Mac Classic emulation.
24    
25     Unix:
26 cebix 1.5 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 cebix 1.1
31     AmigaOS:
32     You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
33     preferences editor, you need gtlayout.library V39 or later. To get sound
34     output, you need AHI V2 or later. Both items can be found on Aminet. You
35     also need the "PrepareEmul" utility that somes with ShapeShifter (or any
36     equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II
37     cannot do Mac Classic emulation.
38    
39     Windows:
40     You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a
41     somewhat reduced set of features. Basilisk II supports DirectX version 5 or
42     later, but version 3 may also work, depending on your graphics card.
43    
44    
45     Installation
46     ------------
47    
48     BeOS:
49     If you have a binary distribution of Basilisk II for BeOS, there are
50     executables for BeOS/PPC and/or BeOS/x86 included. If you have the source
51     distribution, do the following:
52    
53     cd src/BeOS
54     make
55    
56 cebix 1.3 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 cebix 1.1 with SheepShaver
62    
63     Unix:
64     To compile Basilisk II, do the following:
65    
66     cd src/Unix
67     ./configure
68 cebix 1.4 make [or "gmake" if you have GNU make and "make" fails]
69 cebix 1.1 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    
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 cebix 1.2 cd Linux/NetDriver
80     make dev
81 cebix 1.1 /sbin/insmod sheep_net.o
82    
83     This will install the device node "/dev/sheep_net" and load the driver.
84     You should give appropriate access rights to /dev/sheep_net if you don't
85     want to have to run Basilisk II as root.
86    
87     This is what Brian J. Johnson says about compiling for IRIX:
88     "I recommend compiling with "-Ofast". This requires changing "-g"
89     to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS. This
90     turns on massive interprocedural optimization, and makes for much
91     better performance."
92 cebix 1.5
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 cebix 1.1
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
134     that comes with ShapeShifter (or any equivalent PrepareEmul substitute,
135     see the ShapeShifter docs). If you have the source distribution, do the
136     following:
137    
138     cd src/AmigaOS
139     smake
140    
141     To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work.
142    
143     Windows NT:
144     If you have a binary distribution of Basilisk II for Windows, there is a
145     Windows NT binary included. To access CD-ROMs under Windows NT, the driver
146     "cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory.
147     To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied
148     to the "\Windows\System" directory. To recompile Basilisk II, you need
149     MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some
150     modifications. See the "sysdeps.h" file in the "Windows" directory.
151    
152     The ROM file has to be named "ROM" and put in the same directory as the
153     Basilisk II executable but you can specify a different location for the ROM
154     file with the "rom" option in the preferences file (or with the preferences
155     GUI).