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

Comparing BasiliskII/README (file contents):
Revision 1.38 by gbeauche, 2004-05-09T16:15:36Z vs.
Revision 1.42 by nigel, 2005-10-15T10:21:40Z

# Line 2 | Line 2
2    Basilisk II
3    A 68k Macintosh emulator
4  
5 <  Copyright (C) 1997-2004 Christian Bauer et al.
5 >  Copyright (C) 1997-2005 Christian Bauer et al.
6  
7  
8   License
# Line 26 | Line 26 | Basilisk II has currently been ported to
26      IRIX 6.5)
27    - AmigaOS 3.x
28    - Windows NT 4.0 (mostly works under Windows 95/98, too)
29 <  - Mac OS X 10.1, 10.2
29 >  - Mac OS X 10.1, 10.2, 10.3 (native windowing port has UI bugs with 10.4)
30  
31   Some features of Basilisk II:
32    - Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5)
# Line 362 | Line 362 | ether <ethernet card description>
362  
363    Linux:
364      The "ethernet card description" is the name of an Ethernet interface.
365 <    There are three approaches to networking with Basilisk II:
365 >    There are four approaches to networking with Basilisk II:
366  
367        1. Direct access to an Ethernet card via the "sheep_net" kernel module.
368           The "ethernet card description" must be the name of a real Ethernet
# Line 442 | Line 442 | ether <ethernet card description>
442           instead of sending packets via physical media writes them to
443           the user space program.
444  
445 +         Prerequesties:
446 +         - Make sure the "tun" kernel module is loaded
447 +           # modprobe tun
448 +         - Make sure IP Fordwarding is enabled on your system
449 +           # echo 1 >/proc/sys/net/ipv4/ip_forward
450 +
451           A virtual network configuration script is required and the
452           default is /usr/local/BasiliskII/tunconfig unless you specify
453           a different file with the "etherconfig" item.
# Line 455 | Line 461 | ether <ethernet card description>
461             #!/bin/sh
462             exec /usr/bin/kdesu -c /path/to/tunconfig $1 $2
463  
464 +      4. Access the network through the user mode network stack.
465 +         (the code and this documentation come from QEMU)
466 +
467 +         By setting the "ethernet card description" to "slirp",
468 +         Basilisk II uses a completely user mode network stack (you
469 +         don't need root priviledges to use the virtual network). The
470 +         virtual network configuration is the following:
471 +
472 +           Basilisk II <------> Firewall/DHCP server <-----> Internet
473 +           (10.0.2.x)      |         (10.0.2.2)
474 +                           |
475 +                           ----> DNS server (10.0.2.3)
476 +                           |
477 +                           ----> SMB server (10.0.2.4)
478 +
479 +         Basilisk II behaves as if it was behind a firewall which
480 +         blocks all incoming connections. You can use a DHCP client to
481 +         automatically configure the network in Basilisk II.
482 +
483 +         In order to check that the user mode network is working, you
484 +         can ping the address 10.0.2.2 and verify that you got an
485 +         address in the range 10.0.2.x from the Basilisk II virtual
486 +         DHCP server.
487 +
488 +         Note that ping is not supported reliably to the internet as
489 +         it would require root priviledges. It means you can only ping
490 +         the local router (10.0.2.2).
491 +
492 +         When using the built-in TFTP server, the router is also the
493 +         TFTP server.
494 +
495    FreeBSD:
496      The "ethertap" method described above also works under FreeBSD, but since
497      no-one has found the time to write a section for this manual, you're on
# Line 467 | Line 504 | ether <ethernet card description>
504      not an Ethernet device, Basilisk II will display a warning message and
505      disable Ethernet networking.
506  
507 +  Mac OS X:
508 +    The "slirp" method described above nearly works.
509 +
510    See the next item for an alternative way to do networking with Basilisk II.
511  
512   udptunnel <"true" or "false">

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines