ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/INSTALL
Revision: 1.8
Committed: 2003-08-02T08:48:38Z (21 years, 3 months ago) by nigel
Branch: MAIN
CVS Tags: nigel-build-19, nigel-build-16, nigel-build-17, nigel-build-15, HEAD
Changes since 1.7: +10 -0 lines
Log Message:
Added OS X sections

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 cebix 1.7 You need BeOS R4 or later versions.
20 cebix 1.1 Basilisk II cannot do Mac Classic emulation.
21    
22     Unix:
23 cebix 1.5 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 cebix 1.1
28     AmigaOS:
29     You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
30     preferences editor, you need gtlayout.library V39 or later. To get sound
31     output, you need AHI V2 or later. Both items can be found on Aminet. You
32     also need the "PrepareEmul" utility that somes with ShapeShifter (or any
33     equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II
34     cannot do Mac Classic emulation.
35    
36     Windows:
37     You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a
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 nigel 1.8 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 cebix 1.1
46     Installation
47     ------------
48    
49     BeOS:
50     If you have a binary distribution of Basilisk II for BeOS, there are
51 cebix 1.6 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 cebix 1.1
57     cd src/BeOS
58     make
59    
60 cebix 1.3 This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
61 cebix 1.6 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 cebix 1.1
71     Unix:
72     To compile Basilisk II, do the following:
73    
74     cd src/Unix
75     ./configure
76 cebix 1.4 make [or "gmake" if you have GNU make and "make" fails]
77 cebix 1.1 make install [optionally]
78    
79     To use Ethernet networking under Linux, you either have to configure your
80 cebix 1.7 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 cebix 1.1
84     This is what Brian J. Johnson says about compiling for IRIX:
85     "I recommend compiling with "-Ofast". This requires changing "-g"
86     to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS. This
87     turns on massive interprocedural optimization, and makes for much
88     better performance."
89 cebix 1.5
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 cebix 1.7 pthreads, and thus without serial/ethernet/audio support (but the "UDP
96     tunnelling" network should work).
97 cebix 1.5
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 cebix 1.1
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
132     that comes with ShapeShifter (or any equivalent PrepareEmul substitute,
133     see the ShapeShifter docs). If you have the source distribution, do the
134     following:
135    
136     cd src/AmigaOS
137 cebix 1.6 make
138 cebix 1.1
139 cebix 1.6 To recompile Basilisk II, you need the GeekGadgets development suite and
140     PhxAss (which can be found on Aminet).
141 cebix 1.1
142     Windows NT:
143     If you have a binary distribution of Basilisk II for Windows, there is a
144     Windows NT binary included. To access CD-ROMs under Windows NT, the driver
145     "cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory.
146     To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied
147     to the "\Windows\System" directory. To recompile Basilisk II, you need
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 nigel 1.8
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 cebix 1.1
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
160     GUI).