home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / Emulation / BasiliskII / INSTALL < prev    next >
Text File  |  2000-01-30  |  5KB  |  117 lines
  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            [or "gmake" if you have GNU make and "make" fails]
  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).
  117.