ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/INSTALL
(Generate patch)

Comparing BasiliskII/INSTALL (file contents):
Revision 1.3 by cebix, 1999-10-04T21:07:12Z vs.
Revision 1.7 by cebix, 2001-07-15T02:15:48Z

# Line 16 | Line 16 | ROM files. No, I won't send you one.
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
19 >  You need BeOS R4 or later versions.
20    Basilisk II cannot do Mac Classic emulation.
21  
22   Unix:
23 <  You need X11R6, pthreads support and GNU make. To use the GUI preferences
24 <  editor, you also need GTK+ version 1.2 or better. On Linux, you need
25 <  glibc 2.0 or better.
23 >  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  
28   AmigaOS:
29    You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
# Line 46 | Line 44 | Installation
44  
45   BeOS:
46    If you have a binary distribution of Basilisk II for BeOS, there are
47 <  executables for BeOS/PPC and/or BeOS/x86 included. If you have the source
48 <  distribution, do the following:
47 >  executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run
48 >  concurrently with SheepShaver. Trying to do so will crash Basilisk II, or
49 >  SheepShaver, or both.
50 >
51 >  If you have the source distribution, do the following:
52  
53      cd src/BeOS
54      make
55  
56    This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
57 <  directory. Basilisk II cannot run concurrently with SheepShaver. Trying to
58 <  do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system
59 <  you must have installed the "sheep" driver that comes with SheepShaver. To
60 <  use Ethernet, you must have installed the "sheep_net" add-on that also comes
61 <  with SheepShaver
57 >  directory. To use Ethernet, you also have to do:
58 >
59 >    cd SheepNet
60 >    make install
61 >
62 >  On a PowerPC system, you also have to do:
63 >
64 >    cd SheepDriver
65 >    make install
66  
67   Unix:
68    To compile Basilisk II, do the following:
69  
70      cd src/Unix
71      ./configure
72 <    make
72 >    make            [or "gmake" if you have GNU make and "make" fails]
73      make install    [optionally]
74  
75    To use Ethernet networking under Linux, you either have to configure your
76 <  kernel for ethertap support or make and install the "sheep_net" driver:
77 <
78 <    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.
76 >  kernel for ethertap support or make and install the "sheep_net" driver
77 >  (this is explained in the README file, at the description of the "ether"
78 >  preferences item).
79  
80    This is what Brian J. Johnson says about compiling for IRIX:
81     "I recommend compiling with "-Ofast".  This requires changing "-g"
# Line 89 | Line 83 | Unix:
83      turns on massive interprocedural optimization, and makes for much
84      better performance."
85  
86 +  ATTENTION NetBSD/m68k USERS:
87 +  If you want to run Basilisk II natively (i.e. without CPU emulation), you
88 +  must NOT use a pthreads library. User-level threads libraries such as PTL
89 +  interfere with the signal handlers installed by Basilisk II and kernel-
90 +  level threads are not supported by NetBSD, so you will have to live without
91 +  pthreads, and thus without serial/ethernet/audio support (but the "UDP
92 +  tunnelling" network should work).
93 +
94 +  ATTENTION NetBSD/mac68k USERS:
95 +  Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug
96 +  that not only prevents Basilisk II from running properly but seems to even
97 +  cause kernel panics under certain conditions! Apply the following patch to
98 +  /sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel
99 +  and reboot before using Basilisk II:
100 +
101 +    --- macromasm.s.orig    Wed Jul  5 19:29:01 2000
102 +    +++ macromasm.s Wed Jul  5 19:12:34 2000
103 +    @@ -37,6 +37,8 @@
104 +
105 +     #include "opt_adb.h"
106 +     #include "assym.h"
107 +    +#include <machine/asm.h>
108 +    +#include <machine/trap.h>
109 +
110 +
111 +            /* Define this symbol as global with (v) value */
112 +    @@ -437,8 +439,9 @@
113 +            movw    sp@(FR_HW + 4), d0      | retrieve status register
114 +            andw    #PSL_S, d0      | supervisor state?
115 +            bne     Lalnosup        | branch if supervisor
116 +    -       jbsr    _mrg_aline_user | user a-line trap
117 +    -       bra     Lalrts
118 +    +       addql   #4, sp          | pop frame ptr
119 +    +       movql   #T_ILLINST, d0  | user-mode fault
120 +    +       jra     _ASM_LABEL(fault)
121 +     Lalnosup:
122 +     #define FR_PC (FR_HW+2)
123 +            movl    sp@(FR_PC + 4), a0      | retrieve PC
124 +
125   AmigaOS:
126    If you have a binary distribution of Basilisk II for AmigaOS, there is an
127    executable included. You must also have the "PrepareEmul" utility installed
# Line 97 | Line 130 | AmigaOS:
130    following:
131  
132      cd src/AmigaOS
133 <    smake
133 >    make
134  
135 <  To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work.
135 >  To recompile Basilisk II, you need the GeekGadgets development suite and
136 >  PhxAss (which can be found on Aminet).
137  
138   Windows NT:
139    If you have a binary distribution of Basilisk II for Windows, there is a

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines