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.29 by gbeauche, 2002-05-20T17:50:39Z vs.
Revision 1.38 by gbeauche, 2004-05-09T16:15:36Z

# Line 2 | Line 2
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
# 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
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)
# Line 285 | Line 285 | screen <video mode>
285      application via Alt-Tab, Basilisk II is put in "snooze" mode (i.e. MacOS
286      is frozen).
287  
288
288    Mac OS X:
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.
294 <        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.
301      opengl/<width>/<height>
302      opengl/<width>/<height>/<bits per pixel>
303        Currently unimplemented, will be a fast windowed mode.
304
299  
300   seriala <serial port description>
301  
# Line 368 | Line 362 | ether <ethernet card description>
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
# Line 438 | Line 432 | ether <ethernet card description>
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
# Line 530 | Line 547 | nogui <"true" or "false">
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  
# Line 578 | Line 603 | Unix:
603  
604      Set this to "true" to ignore illegal memory accesses. The default
605      is "false". This feature is only implemented on the following
606 <    platforms: Linux/x86, Linux/ppc, Darwin/ppc, FreeBSD/x86.
606 >    platforms: Linux/x86, Linux/ppc, Darwin/ppc.
607 >
608 >  dsp <device name>
609 >  mixer <device name>
610 >
611 >    Under Linux and FreeBSD, this specifies the devices to be used for sound
612 >    output and volume control, respectively. The defaults are "/dev/dsp" and
613 >    "/dev/mixer".
614  
615   AmigaOS:
616  
# Line 677 | Line 709 | Windows:
709      false.
710  
711  
712 + JIT-specific configuration
713 + --------------------------
714 +
715 + A Just-In-Time (JIT) translation engine is available for x86. This is
716 + aimed at translating 68040 instructions to native equivalent code
717 + sequences, thus providing faster emulation speeds.
718 +
719 +  jit <"true" or "false">
720 +
721 +    Set this to "true" to enable the JIT compiler. Default value is
722 +    "true" if the JIT compiler was compiled in. Besides, this is
723 +    effective only if Basilisk II is configured to emulate a 68040.
724 +
725 +  jitfpu <"true" or "false">
726 +
727 +    Set this to "true" to enable translation of floating-point (FPU)
728 +    instructions. Default is "true".
729 +
730 +  jitcachesize <size>
731 +
732 +    Allocate "size" kilobytes of RAM for the translation cache. The
733 +    value given will be rounded down to the nearest multiple of a page
734 +    size. Minimal value is "2048" (2MB). Default value is "8192" (8MB).
735 +
736 +  jitlazyflush <"true" or "false">
737 +
738 +    Set this to "true" to enable lazy invalidation of the translation
739 +    cache. This is always recommended as it usually makes the system
740 +    more responsive and faster, especially while running MacOS
741 +    8.X. Default value is "true".
742 +
743 +  jitdebug <"true" or "false">
744 +
745 +    Set this to "true" to enable the JIT debugger. This requires a
746 +    build of Basilisk II with the cxmon debugger. Default is "false".
747 +
748 +
749   Usage
750   -----
751  
# Line 777 | Line 846 | Acknowledgements
846   Contributions by (in alphabetical order):
847   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
848   - Gwenolé Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations,
849 <   lots of work on the Unix video code
849 >   lots of work on the Unix video code, fixes and improvements to the
850 >   JIT compiler
851   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
852   - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
853     and networking
# Line 787 | Line 857 | Contributions by (in alphabetical order)
857   - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
858   - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
859   - David Lawrence <davidl@jlab.org>: incremental window refresh code
860 + - Bernie Meyer <bmeyer@csse.monash.edu.au>: original UAE-JIT code
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:

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines