| 2 |
|
Basilisk II |
| 3 |
|
A 68k Macintosh emulator |
| 4 |
|
|
| 5 |
< |
Copyright (C) 1997-2002 Christian Bauer et al. |
| 5 |
> |
Copyright (C) 1997-2004 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 |
| 29 |
> |
- Mac OS X 10.1, 10.2 |
| 30 |
|
|
| 31 |
|
Some features of Basilisk II: |
| 32 |
|
- Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5) |
| 289 |
|
The "video mode" is one of the following: |
| 290 |
|
win/<width>/<height> |
| 291 |
|
win/<width>/<height>/<bits per pixel> |
| 292 |
< |
A refreshed (and buffered) [and very slow] Quartz window. |
| 293 |
< |
The default <bits> is 32, which is the only depth currently supported. |
| 292 |
> |
A refreshed (and buffered) Quartz window. |
| 293 |
|
full/<width>/<height> |
| 294 |
|
full/<width>/<height>/<bits per pixel> |
| 295 |
|
A CGDirectDisplay full screen mode. <bits> can currently be 8, 16 or 32. |
| 296 |
|
If not specified, the default is 32. There is currently no way to switch |
| 297 |
|
between the Mac OS X and Basilisk II display, but Apple-Option-Escape |
| 298 |
|
instantly and safely terminates the Basilisk II program. |
| 300 |
– |
opengl/<width>/<height> |
| 301 |
– |
opengl/<width>/<height>/<bits per pixel> |
| 302 |
– |
Currently unimplemented, will be a fast windowed mode. |
| 299 |
|
|
| 300 |
|
seriala <serial port description> |
| 301 |
|
|
| 362 |
|
|
| 363 |
|
Linux: |
| 364 |
|
The "ethernet card description" is the name of an Ethernet interface. |
| 365 |
< |
There are two approaches to networking with Basilisk II: |
| 365 |
> |
There are three 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 |
| 432 |
|
your network administrator about the nets and zones you can use |
| 433 |
|
(instead of the ones given in the example above). |
| 434 |
|
|
| 435 |
+ |
3. Access the network through a "tuntap" interface. |
| 436 |
+ |
The "ethernet card description" must be set to "tun". |
| 437 |
+ |
|
| 438 |
+ |
TUN/TAP provides packet reception and transmission for user |
| 439 |
+ |
space programs. It can be viewed as a simple Point-to-Point |
| 440 |
+ |
or Ethernet device, which instead of receiving packets from a |
| 441 |
+ |
physical media, receives them from user space program and |
| 442 |
+ |
instead of sending packets via physical media writes them to |
| 443 |
+ |
the user space program. |
| 444 |
+ |
|
| 445 |
+ |
A virtual network configuration script is required and the |
| 446 |
+ |
default is /usr/local/BasiliskII/tunconfig unless you specify |
| 447 |
+ |
a different file with the "etherconfig" item. |
| 448 |
+ |
|
| 449 |
+ |
This script requires you that "sudo" is properly configured |
| 450 |
+ |
so that "/sbin/ifconfig" and "/sbin/iptables" can be executed |
| 451 |
+ |
as root. Otherwise, you can still write a helper script which |
| 452 |
+ |
invokes your favorite program to enhance a user priviledges. |
| 453 |
+ |
e.g. in a KDE environment, kdesu can be used as follows: |
| 454 |
+ |
|
| 455 |
+ |
#!/bin/sh |
| 456 |
+ |
exec /usr/bin/kdesu -c /path/to/tunconfig $1 $2 |
| 457 |
+ |
|
| 458 |
|
FreeBSD: |
| 459 |
|
The "ethertap" method described above also works under FreeBSD, but since |
| 460 |
|
no-one has found the time to write a section for this manual, you're on |
| 547 |
|
error alerts. All errors will then be reported to stdout. The default |
| 548 |
|
is "false". |
| 549 |
|
|
| 550 |
+ |
keyboardtype <keyboard-id> |
| 551 |
+ |
|
| 552 |
+ |
Specifies the keyboard type that BasiliskII should report to the MacOS. |
| 553 |
+ |
The default is "5" which is a "Apple Extended Keyboard II (ISO)", |
| 554 |
+ |
but many other numbers are understood by most versions of the MacOS |
| 555 |
+ |
(e.g. 11 is a "Macintosh Plus Keyboard with keypad", |
| 556 |
+ |
13 is a "Apple PowerBook Keyboard (ISO)" ) |
| 557 |
+ |
|
| 558 |
|
For additional information, consult the source. |
| 559 |
|
|
| 560 |
|
|
| 861 |
|
- Nigel Pearson <nigel@ind.tansu.com.au>: Mac OS X port |
| 862 |
|
- Lauri Pesonen <lpesonen@nic.fi>: Windows NT port |
| 863 |
|
- Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation |
| 864 |
+ |
- Michael Z. Sliczniak <msliczniak@comcast.net>: Mach memory fault recovery |
| 865 |
|
- and others... |
| 866 |
|
|
| 867 |
|
Special thanks to: |
