--- BasiliskII/README 2003/03/21 09:14:34 1.34 +++ BasiliskII/README 2005/10/15 10:21:40 1.42 @@ -2,7 +2,7 @@ Basilisk II A 68k Macintosh emulator - Copyright (C) 1997-2003 Christian Bauer et al. + Copyright (C) 1997-2005 Christian Bauer et al. License @@ -26,7 +26,7 @@ Basilisk II has currently been ported to IRIX 6.5) - AmigaOS 3.x - Windows NT 4.0 (mostly works under Windows 95/98, too) - - Mac OS X 10.1, 10.2 + - Mac OS X 10.1, 10.2, 10.3 (native windowing port has UI bugs with 10.4) Some features of Basilisk II: - Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5) @@ -362,7 +362,7 @@ ether Linux: The "ethernet card description" is the name of an Ethernet interface. - There are two approaches to networking with Basilisk II: + There are four approaches to networking with Basilisk II: 1. Direct access to an Ethernet card via the "sheep_net" kernel module. The "ethernet card description" must be the name of a real Ethernet @@ -432,6 +432,66 @@ ether your network administrator about the nets and zones you can use (instead of the ones given in the example above). + 3. Access the network through a "tuntap" interface. + The "ethernet card description" must be set to "tun". + + TUN/TAP provides packet reception and transmission for user + space programs. It can be viewed as a simple Point-to-Point + or Ethernet device, which instead of receiving packets from a + physical media, receives them from user space program and + instead of sending packets via physical media writes them to + the user space program. + + Prerequesties: + - Make sure the "tun" kernel module is loaded + # modprobe tun + - Make sure IP Fordwarding is enabled on your system + # echo 1 >/proc/sys/net/ipv4/ip_forward + + A virtual network configuration script is required and the + default is /usr/local/BasiliskII/tunconfig unless you specify + a different file with the "etherconfig" item. + + This script requires you that "sudo" is properly configured + so that "/sbin/ifconfig" and "/sbin/iptables" can be executed + as root. Otherwise, you can still write a helper script which + invokes your favorite program to enhance a user priviledges. + e.g. in a KDE environment, kdesu can be used as follows: + + #!/bin/sh + exec /usr/bin/kdesu -c /path/to/tunconfig $1 $2 + + 4. Access the network through the user mode network stack. + (the code and this documentation come from QEMU) + + By setting the "ethernet card description" to "slirp", + Basilisk II uses a completely user mode network stack (you + don't need root priviledges to use the virtual network). The + virtual network configuration is the following: + + Basilisk II <------> Firewall/DHCP server <-----> Internet + (10.0.2.x) | (10.0.2.2) + | + ----> DNS server (10.0.2.3) + | + ----> SMB server (10.0.2.4) + + Basilisk II behaves as if it was behind a firewall which + blocks all incoming connections. You can use a DHCP client to + automatically configure the network in Basilisk II. + + In order to check that the user mode network is working, you + can ping the address 10.0.2.2 and verify that you got an + address in the range 10.0.2.x from the Basilisk II virtual + DHCP server. + + Note that ping is not supported reliably to the internet as + it would require root priviledges. It means you can only ping + the local router (10.0.2.2). + + When using the built-in TFTP server, the router is also the + TFTP server. + 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 @@ -444,6 +504,9 @@ ether not an Ethernet device, Basilisk II will display a warning message and disable Ethernet networking. + Mac OS X: + The "slirp" method described above nearly works. + See the next item for an alternative way to do networking with Basilisk II. udptunnel <"true" or "false"> @@ -524,6 +587,14 @@ nogui <"true" or "false"> error alerts. All errors will then be reported to stdout. The default is "false". +keyboardtype + + Specifies the keyboard type that BasiliskII should report to the MacOS. + The default is "5" which is a "Apple Extended Keyboard II (ISO)", + but many other numbers are understood by most versions of the MacOS + (e.g. 11 is a "Macintosh Plus Keyboard with keypad", + 13 is a "Apple PowerBook Keyboard (ISO)" ) + For additional information, consult the source. @@ -830,6 +901,7 @@ Contributions by (in alphabetical order) - Nigel Pearson : Mac OS X port - Lauri Pesonen : Windows NT port - Bernd Schmidt : UAE 68k emulation + - Michael Z. Sliczniak : Mach memory fault recovery - and others... Special thanks to: