| 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 |
This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86" |
| 56 |
directory. Basilisk II cannot run concurrently with SheepShaver. Trying to |
| 57 |
do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system |
| 58 |
you must have installed the "sheep" driver that comes with SheepShaver. To |
| 59 |
use Ethernet, you must have installed the "sheep_net" add-on that also comes |
| 60 |
with SheepShaver |
| 61 |
|
| 62 |
Unix: |
| 63 |
To compile Basilisk II, do the following: |
| 64 |
|
| 65 |
cd src/Unix |
| 66 |
./configure |
| 67 |
make |
| 68 |
make install [optionally] |
| 69 |
|
| 70 |
To use Ethernet networking under Linux, you either have to configure your |
| 71 |
kernel for ethertap support or make and install the "sheep_net" driver: |
| 72 |
|
| 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 |
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. |
| 85 |
|
| 86 |
This is what Brian J. Johnson says about compiling for IRIX: |
| 87 |
"I recommend compiling with "-Ofast". This requires changing "-g" |
| 88 |
to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS. This |
| 89 |
turns on massive interprocedural optimization, and makes for much |
| 90 |
better performance." |
| 91 |
|
| 92 |
AmigaOS: |
| 93 |
If you have a binary distribution of Basilisk II for AmigaOS, there is an |
| 94 |
executable included. You must also have the "PrepareEmul" utility installed |
| 95 |
that comes with ShapeShifter (or any equivalent PrepareEmul substitute, |
| 96 |
see the ShapeShifter docs). If you have the source distribution, do the |
| 97 |
following: |
| 98 |
|
| 99 |
cd src/AmigaOS |
| 100 |
smake |
| 101 |
|
| 102 |
To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work. |
| 103 |
|
| 104 |
Windows NT: |
| 105 |
If you have a binary distribution of Basilisk II for Windows, there is a |
| 106 |
Windows NT binary included. To access CD-ROMs under Windows NT, the driver |
| 107 |
"cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory. |
| 108 |
To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied |
| 109 |
to the "\Windows\System" directory. To recompile Basilisk II, you need |
| 110 |
MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some |
| 111 |
modifications. See the "sysdeps.h" file in the "Windows" directory. |
| 112 |
|
| 113 |
The ROM file has to be named "ROM" and put in the same directory as the |
| 114 |
Basilisk II executable but you can specify a different location for the ROM |
| 115 |
file with the "rom" option in the preferences file (or with the preferences |
| 116 |
GUI). |
