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 |
|
|
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. |
29 |
|
|
|
30 |
|
|
AmigaOS: |
31 |
|
|
You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI |
32 |
|
|
preferences editor, you need gtlayout.library V39 or later. To get sound |
33 |
|
|
output, you need AHI V2 or later. Both items can be found on Aminet. You |
34 |
|
|
also need the "PrepareEmul" utility that somes with ShapeShifter (or any |
35 |
|
|
equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II |
36 |
|
|
cannot do Mac Classic emulation. |
37 |
|
|
|
38 |
|
|
Windows: |
39 |
|
|
You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a |
40 |
|
|
somewhat reduced set of features. Basilisk II supports DirectX version 5 or |
41 |
|
|
later, but version 3 may also work, depending on your graphics card. |
42 |
|
|
|
43 |
|
|
|
44 |
|
|
Installation |
45 |
|
|
------------ |
46 |
|
|
|
47 |
|
|
BeOS: |
48 |
|
|
If you have a binary distribution of Basilisk II for BeOS, there are |
49 |
|
|
executables for BeOS/PPC and/or BeOS/x86 included. If you have the source |
50 |
|
|
distribution, do the following: |
51 |
|
|
|
52 |
|
|
cd src/BeOS |
53 |
|
|
make |
54 |
|
|
|
55 |
|
|
Basilisk II cannot run concurrently with SheepShaver. Trying to do so will |
56 |
|
|
crash Basilisk II, or SheepShaver, or both. On a PowerPC system you must |
57 |
|
|
have installed the "sheep" driver that comes with SheepShaver. To use |
58 |
|
|
Ethernet, you must have installed the "sheep_net" add-on that also comes |
59 |
|
|
with SheepShaver |
60 |
|
|
|
61 |
|
|
Unix: |
62 |
|
|
To compile Basilisk II, do the following: |
63 |
|
|
|
64 |
|
|
cd src/Unix |
65 |
|
|
./configure |
66 |
|
|
make |
67 |
|
|
make install [optionally] |
68 |
|
|
|
69 |
|
|
To use Ethernet networking under Linux, you either have to configure your |
70 |
|
|
kernel for ethertap support or make and install the "sheep_net" driver: |
71 |
|
|
|
72 |
|
|
cd src/Unix |
73 |
|
|
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 |
|
|
./MAKEDEV |
79 |
|
|
/sbin/insmod sheep_net.o |
80 |
|
|
|
81 |
|
|
This will install the device node "/dev/sheep_net" and load the driver. |
82 |
|
|
You should give appropriate access rights to /dev/sheep_net if you don't |
83 |
|
|
want to have to run Basilisk II as root. |
84 |
|
|
|
85 |
|
|
This is what Brian J. Johnson says about compiling for IRIX: |
86 |
|
|
"I recommend compiling with "-Ofast". This requires changing "-g" |
87 |
|
|
to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS. This |
88 |
|
|
turns on massive interprocedural optimization, and makes for much |
89 |
|
|
better performance." |
90 |
|
|
|
91 |
|
|
AmigaOS: |
92 |
|
|
If you have a binary distribution of Basilisk II for AmigaOS, there is an |
93 |
|
|
executable included. You must also have the "PrepareEmul" utility installed |
94 |
|
|
that comes with ShapeShifter (or any equivalent PrepareEmul substitute, |
95 |
|
|
see the ShapeShifter docs). If you have the source distribution, do the |
96 |
|
|
following: |
97 |
|
|
|
98 |
|
|
cd src/AmigaOS |
99 |
|
|
smake |
100 |
|
|
|
101 |
|
|
To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work. |
102 |
|
|
|
103 |
|
|
Windows NT: |
104 |
|
|
If you have a binary distribution of Basilisk II for Windows, there is a |
105 |
|
|
Windows NT binary included. To access CD-ROMs under Windows NT, the driver |
106 |
|
|
"cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory. |
107 |
|
|
To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied |
108 |
|
|
to the "\Windows\System" directory. To recompile Basilisk II, you need |
109 |
|
|
MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some |
110 |
|
|
modifications. See the "sysdeps.h" file in the "Windows" directory. |
111 |
|
|
|
112 |
|
|
The ROM file has to be named "ROM" and put in the same directory as the |
113 |
|
|
Basilisk II executable but you can specify a different location for the ROM |
114 |
|
|
file with the "rom" option in the preferences file (or with the preferences |
115 |
|
|
GUI). |