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 |
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) |
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 |
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. |
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 |
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 now seems to work. |
509 |
+ |
|
510 |
|
See the next item for an alternative way to do networking with Basilisk II. |
511 |
|
|
512 |
|
udptunnel <"true" or "false"> |