--- BasiliskII/README 2000/07/13 17:45:51 1.12 +++ BasiliskII/README 2001/07/12 19:48:24 1.22 @@ -1,9 +1,8 @@ - Basilisk II, Version 0.8 - A free, portable Mac II emulator + Basilisk II + A 68k Macintosh emulator - Copyright (C) 1997-2000 Christian Bauer et al. - Freely distributable + Copyright (C) 1997-2001 Christian Bauer et al. License @@ -16,9 +15,10 @@ See the file "COPYING" that is included Overview -------- -Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires -a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and -distributed under the GNU General Public License. +Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables +you to run 68k MacOS software on you computer, even if you are using a +different operating system. However, you still need a copy of MacOS and +a Macintosh ROM image to use Basilisk II. Basilisk II has currently been ported to the following systems: - BeOS R4 (PowerPC and x86) @@ -327,9 +327,10 @@ ether BeOS: It doesn't matter what you give as "ethernet card description", Basilisk II will always use the first Ethernet card it finds as long an an "ether" - line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net - net server add-on from SheepShaver, you can only use Ethernet on PowerPC - machines. + line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net" + Net Server add-on to be installed. The first time you start Basilisk II + with Ethernet enabled you will be asked whether it's OK to make the + necessary changes to your BeOS network configuration to enable sheep_net. Linux: The "ethernet card description" is the name of an Ethernet interface. @@ -351,7 +352,7 @@ ether configure your kernel to enable routing and the ethertap device: under "Networking options", enable "Kernel/User netlink socket" and "Netlink device emulation", under "Network device support", activate - "Ethertap network tap". You also have to modify devices/net/ethertap.c + "Ethertap network tap". You also have to modify drivers/net/ethertap.c a bit before compiling the new kernel: - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the @@ -381,6 +382,11 @@ ether your network administrator about the nets and zones you can use (instead of the ones given in the example above). + FreeBSD: + The "ethertap" method described above also works under FreeBSD, but since + no-one has found the time to write a section for this manual, you're on + your own here... + AmigaOS: You have to specify the name of the SANA-II Ethernet device and the device unit as "/" (e.g. "ariadne.device/0"). If the given @@ -388,6 +394,25 @@ ether not an Ethernet device, Basilisk II will display a warning message and disable Ethernet networking. + See the next item for an alternative way to do networking with Basilisk II. + +udptunnel <"true" or "false"> + + Setting this to "true" enables a special network mode in which all network + packets sent by MacOS are tunnelled over UDP using the host operating + system's native TCP/IP stack. This only works with AppleTalk and can only + be used to connect computers running Basilisk II (and not, for example, for + connecting to an AppleShare server running on a real Mac), but it is + probably the easiest way to set up a network between two instances of + Basilisk II because the UDP tunnelling doesn't require any special kernel + modules or network add-ons. It relies on IP broadcasting, however, so + its range is limited. + +udpport + + This item specifies the IP port number to use for the "AppleTalk over UDP" + tunnel mode. The default is 6066. + rom This item specifies the file name of the Mac ROM file to be used by @@ -502,6 +527,19 @@ AmigaOS: ahi/ + scsimemtype + + This item controls the type of memory to use for SCSI buffers. Possible + values are: + 0 Chip memory + 1 24-bit DMA capable memory + 2 Any memory + + Be warned that many SCSI host adapters will not work with the "Any memory" + setting. Basilisk II has no way of knowing which memory type is supported + by the host adapter and setting an unsupported type will result in data + corruption. + Windows: noscsi <"true" or "false"> @@ -597,9 +635,14 @@ Keyboard: On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows" key is the Mac "Option" key. +Mouse: + Under Unix, press Ctrl-F5 while the Basilisk II window is active will grab + the mouse. This is needed for compatibility with some MacOS programs, + especially games. Press Ctrl-F5 again to return to normal mouse operation. + Floppy: Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform, - flopyy disk changes might not be detected automatically. Under Linux, press + floppy disk changes might not be detected automatically. Under Unix, press Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11. @@ -658,20 +701,21 @@ Please see the included file "TECH" for Acknowledgements ---------------- -Contributions by: - - Bernd Schmidt : UAE 68k emulation - - Marc Hellwig : audio output, BeOS video code - and networking - - Lauri Pesonen : Windows NT port +Contributions by (in alphabetical order): - Orlando Bassotto : FreeBSD support - - Brian J. Johnson : IRIX support + - Gwenole Beauchesne : SPARC assembly optimizations and + fbdev video code - Marc Chabanas : Solaris sound support + - Marc Hellwig : audio output, BeOS video code + and networking - Bill Huey : 15/16 bit DGA and 15/16/32 bit X11 window support - - David Lawrence : incremental window refresh code + - Brian J. Johnson : IRIX support + - Jürgen Lachmann : AmigaOS CyberGraphX support - Samuel Lander : tile-based window refresh code - - Gwenole Beauchesne : SPARC assembly optimizations and - fbdev video code + - David Lawrence : incremental window refresh code + - Lauri Pesonen : Windows NT port + - Bernd Schmidt : UAE 68k emulation - and others... Special thanks to: