[ViewVC] Annotation of: cebix/BasiliskII/INSTALL

BASILISK II INSTALLATION INSTRUCTIONS
=====================================

System Requirements
-------------------

To use Basilisk II, you need either a 512K Mac Classic ROM image or a
512K or 1MB 32-bit clean Macintosh ROM image. You also need a copy of MacOS
(0.x thru 7.5 for Classic emulation, 7.x or 8.0/8.1 for Mac II emulation).
For copyright reasons, none of these items are included with Basilisk II.
MacOS 7.5.3 and earlier versions can be downloaded from Apple and various
other Internet sites. Mac ROM files are not freely available. You have to
own a real Mac and read out its ROM. No, I don't know where you can download
ROM files. No, I won't send you one.

Depending on the platform you use, Basilisk II has additional requirements:

BeOS:
  You need BeOS R4 or better. On a PowerPC system you also need the
  "sheep" driver that comes with SheepShaver. To use Ethernet, you need
  the "sheep_net" add-on that also comes with SheepShaver (both items
  are included in the SheepShaver Trial Versions). The PowerPC version of
  Basilisk II cannot do Mac Classic emulation.

Unix:
  You need X11R6, pthreads support and GNU make. To use the GUI preferences
  editor, you also need GTK+ version 1.2 or better. On Linux, you need
  glibc 2.0 or better.

AmigaOS:
  You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
  preferences editor, you need gtlayout.library V39 or later. To get sound
  output, you need AHI V2 or later. Both items can be found on Aminet. You
  also need the "PrepareEmul" utility that somes with ShapeShifter (or any
  equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II
  cannot do Mac Classic emulation.

Windows:
  You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a
  somewhat reduced set of features. Basilisk II supports DirectX version 5 or
  later, but version 3 may also work, depending on your graphics card.


Installation
------------

BeOS:
  If you have a binary distribution of Basilisk II for BeOS, there are
  executables for BeOS/PPC and/or BeOS/x86 included. If you have the source
  distribution, do the following:

    cd src/BeOS
    make

  This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
  directory. Basilisk II cannot run concurrently with SheepShaver. Trying to
  do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system
  you must have installed the "sheep" driver that comes with SheepShaver. To
  use Ethernet, you must have installed the "sheep_net" add-on that also comes
  with SheepShaver 

Unix:
  To compile Basilisk II, do the following:

    cd src/Unix
    ./configure
    make            [or "gmake" if you have GNU make and "make" fails]
    make install    [optionally]

  To use Ethernet networking under Linux, you either have to configure your
  kernel for ethertap support or make and install the "sheep_net" driver:

    make modules

  This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver"
  directory. Now su root and say

    cd Linux/NetDriver
    make dev
    /sbin/insmod sheep_net.o

  This will install the device node "/dev/sheep_net" and load the driver.
  You should give appropriate access rights to /dev/sheep_net if you don't
  want to have to run Basilisk II as root.

  This is what Brian J. Johnson says about compiling for IRIX:
   "I recommend compiling with "-Ofast".  This requires changing "-g"
    to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS.  This
    turns on massive interprocedural optimization, and makes for much
    better performance."

AmigaOS:
  If you have a binary distribution of Basilisk II for AmigaOS, there is an
  executable included. You must also have the "PrepareEmul" utility installed
  that comes with ShapeShifter (or any equivalent PrepareEmul substitute,
  see the ShapeShifter docs). If you have the source distribution, do the
  following:

    cd src/AmigaOS
    smake

  To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work.

Windows NT:
  If you have a binary distribution of Basilisk II for Windows, there is a
  Windows NT binary included. To access CD-ROMs under Windows NT, the driver
  "cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory.
  To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied
  to the "\Windows\System" directory. To recompile Basilisk II, you need
  MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some
  modifications. See the "sysdeps.h" file in the "Windows" directory.

The ROM file has to be named "ROM" and put in the same directory as the
Basilisk II executable but you can specify a different location for the ROM
file with the "rom" option in the preferences file (or with the preferences
GUI).
Revision:	1.4
Committed:	1999-10-15T14:47:49Z (25 years, 1 month ago) by cebix
Branch:	MAIN
CVS Tags:	snapshot-21101999, snapshot-22121999, release-0_8-1, snapshot-02111999
Changes since 1.3:	+1 -1 lines
Log Message:	- added reference to "gmake"
#	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			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	cebix	1.3	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	cebix	1.1	with SheepShaver
61
62			Unix:
63			To compile Basilisk II, do the following:
64
65			cd src/Unix
66			./configure
67	cebix	1.4	make [or "gmake" if you have GNU make and "make" fails]
68	cebix	1.1	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	cebix	1.2	cd Linux/NetDriver
79			make dev
80	cebix	1.1	/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).