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.3 by cebix, 1999-10-03T17:11:52Z vs.
Revision 1.43 by nigel, 2005-12-29T13:06:12Z

# Line 1 | Line 1
1  
2 <        Basilisk II, Version 0.7
3 <        A free, portable Mac II emulator
2 >  Basilisk II
3 >  A 68k Macintosh emulator
4  
5 <        Copyright (C) 1997-1999 Christian Bauer et al.
6 <        Freely distributable
5 >  Copyright (C) 1997-2005 Christian Bauer et al.
6  
7  
8   License
# Line 16 | Line 15 | See the file "COPYING" that is included
15   Overview
16   --------
17  
18 < Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires
19 < a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and
20 < distributed under the GNU General Public License.
18 > Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables
19 > you to run 68k MacOS software on you computer, even if you are using a
20 > different operating system. However, you still need a copy of MacOS and
21 > a Macintosh ROM image to use Basilisk II.
22  
23   Basilisk II has currently been ported to the following systems:
24    - BeOS R4 (PowerPC and x86)
25 <  - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x and IRIX 6.5)
25 >  - Unix (tested under Linux, Solaris 2.x, FreeBSD 3.x, NetBSD 1.4.x and
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, 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 35 | Line 37 | Some features of Basilisk II:
37    - Floppy disk driver (only 1.44MB disks supported)
38    - Driver for HFS partitions and hardfiles
39    - CD-ROM driver with basic audio functions
40 +  - Easy file exchange with the host OS via a "Host Directory Tree" icon
41 +    on the Mac desktop
42    - Ethernet driver
43    - Serial drivers
44    - SCSI Manager (old-style) emulation
45    - Emulates extended ADB keyboard and 3-button mouse
46 <  - Uses UAE 68k emulation or (under AmigaOS) real 68k processor
46 >  - Uses UAE 68k emulation or (under AmigaOS and NetBSD/m68k) real 68k
47 >    processor
48  
49   The emulator is not yet complete. See the file "TODO" for a list of
50   unimplemented stuff.
# Line 64 | Line 69 | The settings are stored in a text file:
69   BeOS:
70    /boot/home/config/settings/BasiliskII_prefs
71  
72 < Unix:
72 > Unix, Mac OS X:
73    ~/.basilisk_ii_prefs
74  
75   AmigaOS:
# Line 90 | Line 95 | disk <volume description>
95    This item describes one MacOS volume to be mounted by Basilisk II.
96    There can be multiple "disk" lines in the preferences file. Basilisk II
97    can handle hardfiles (byte-per-byte images of HFS volumes in a file on
98 <  the host system) as well as HFS partitions on hard disks etc. (but Basilisk
99 <  II doesn't know about MacOS partition tables; it relies on the host OS to
100 <  handle this). The "volume description" is either the pathname of a hardfile
101 <  or a platform-dependant description of an HFS partition or drive. If the
102 <  volume description starts with an asterisk ("*"), the volume is write
103 <  protected for MacOS (and the "*" is discarded).
98 >  the host system), HFS partitions on hard disks etc., and MacOS-partitioned
99 >  disks (it can only access the first partition, though). The "volume
100 >  description" is either the pathname of a hardfile or a platform-dependant
101 >  description of an HFS partition or drive. If the volume description is
102 >  prefixed by an asterisk ("*"), the volume is write protected for MacOS.
103 >
104 >  Basilisk II can also handle some types of Mac "disk image" files directly,
105 >  as long as they are uncompressed and unencoded.
106  
107    BeOS:
108      To specify an HFS partition, simply specify its path (e.g.
109 <    "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volume, Basilisk II
109 >    "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volumes, Basilisk II
110      will search for and use all available HFS partitions.
111  
112    Unix:
113 <    To specify an HFS partition, simply specify its path (e.g.
114 <    "/dev/sda5").
113 >    To specify an HFS partition, simply specify its path (e.g. "/dev/sda5").
114 >    If you want to access a MacOS-partitioned hard disk or removable volume
115 >    (Jaz, Zip etc.) and your operating system doesn't understand MacOS
116 >    partition tables, you can specify the block device name (e.g. "/dev/sda")
117 >    to access the first HFS partition on the device. Under Linux, if you
118 >    don't specify any volumes, Basilisk II will search /etc/fstab for
119 >    unmounted HFS partitions and use these.
120  
121    AmigaOS:
122      Partitions/drives are specified in the following format:
# Line 137 | Line 149 | cdrom <CD-ROM drive description>
149    installed CD-ROM drives. The format of the "CD-ROM drive description"
150    is the same as that of "disk" lines.
151  
152 + extfs <direcory path>
153 +
154 +  This item specifies the root directory for the "Host Directory Tree"
155 +  file system (the "Unix/BeOS/Amiga/..." icon on the Finder desktop).
156 +  All objects contained in that directory are accessible by Mac applications.
157 +
158 +  This feature is only available when File System Manager V1.2 or later
159 +  is installed on the Mac side. FSM 1.2 is built-in beginning with MacOS 7.6
160 +  and can be installed as a system extension (downloadable from Apple, look
161 +  for the FSM SDK in the developer section) for earlier MacOS versions.
162 +
163   scsi0 <SCSI target> ... scsi6 <SCSI target>
164  
165    These items describe the SCSI target to be used for a given Mac SCSI
# Line 166 | Line 189 | scsi0 <SCSI target> ... scsi6 <SCSI targ
189      "scsi.device/2").
190  
191    Windows:
192 <    Ignored. Basilisk II scans for all SCSI devices and the first 6 found
193 <    devices are made visible to the MacOS. You cannot explicitly enable a
171 <    device, but you can disable a device (see the "disablescsi" command).
192 >    The "SCSI target" has the format <"Vendor"> <"Model"> (e.g.
193 >    scsi0 "HP" "CD-Writer+ 7100"). Note the use of quotes.
194  
195   screen <video mode>
196  
197 <  This item describes the type of video display to be used by Basilisk II.
198 <  If you are using a Mac Classic ROM, the display is always 1-bit 512x342
199 <  and this item is ignored. The format of the "video mode" is platform
200 <  specific.
197 >  This item describes the type of video display to be used by default for
198 >  Basilisk II. If you are using a Mac Classic ROM, the display is always
199 >  1-bit 512x342 and this item is ignored. The format of the "video mode" is
200 >  platform specific.
201  
202    BeOS:
203      The "video mode" is one of the following:
# Line 195 | Line 217 | screen <video mode>
217    Unix:
218      The "video mode" is one of the following:
219        win/<width>/<height>
220 <        Color display in an X11 window of the given size. The color depth
221 <        (8/15/24 bit) depends on the depth of the underlying X11 screen.
222 <        This is the default.
223 <      dga
224 <        Full-screen display using the X11 DGA extensions. The color depth
220 >        Color display in an X11 window of the given size. There are several
221 >        resolutions and color depths available. The set of color depths
222 >        depends on the capabilities of the X11 server, the operating system,
223 >        and Basilisk II compile-time options, but 1 bit and the default depth
224 >        of the X11 screen should always be available.
225 >      dga/<width>/<height>
226 >        [if Basilisk II was configured with --enable-xf86-dga]
227 >        Full-screen display using the XFree86 DGA extension. The color depth
228          (8/15/24 bit) depends on the depth of the underlying X11 screen.
229 <        For DGA to work, Basilisk II must be compiled with DGA support
230 <        enabled (selectable in the configure script).
229 >        "width" and "height" specify the maximum width/height to use.
230 >        Saying "dga/0/0" means "complete screen".
231 >      dga/<frame buffer name>
232 >        [if Basilisk II was configured with --enable-fbdev-dga]
233 >        Full-screen display using the frame buffer device /dev/fb. The color
234 >        depth (8/15/24 bit) depends on the depth of the underlying X11 screen.
235 >        The "frame buffer name" is looked up in the "fbdevices" file (whose
236 >        path can be specified with the "fbdevicefile" prefs item) to determine
237 >        certain characteristics of the device (doing a "ls -l /dev/fb" should
238 >        tell you what your frame buffer name is).
239  
240    AmigaOS:
241      The "video mode" is one of the following:
# Line 214 | Line 247 | screen <video mode>
247          15-bit truecolor display in a Picasso96 PIP. This requires
248          Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV).
249        scr/<hexadecimal mode ID>
250 <        8/15/24-bit fullscreen display on a Picasso96 screen with the given
251 <        mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer
252 <        format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or
253 <        xRGB 8:8:8:8). The screen size will be the default size for that
254 <        mode ID.
250 >        8/15/24-bit fullscreen display on a Picasso96/CyberGraphX screen with
251 >        the given mode ID. This requires Picasso96 or CyberGraphX. For 15 and
252 >        24 bit, the frame buffer format must be QuickDraw-compatible
253 >        (big-endian, xRGB 1:5:5:5 or xRGB 8:8:8:8). The screen size will be
254 >        the default size for that mode ID.
255  
256    Windows:
257      The "video mode" is one of the following:
# Line 252 | 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 +  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) 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.
299 +
300   seriala <serial port description>
301  
302    This item describes the serial port to be used as Port A (Modem Port)
# Line 302 | Line 347 | ether <ethernet card description>
347    is not available and this setting is ignored. The "ethernet card description"
348    is a platform-dependant description of an ethernet card.
349  
350 +  General note: To use TCP/IP from MacOS, you should assign a different IP
351 +  address to the MacOS (entered into the MacOS TCP/IP (or MacTCP) control
352 +  panel). Otherwise there will be confusion about which operating system will
353 +  handle incoming packets.
354 +
355    BeOS:
356      It doesn't matter what you give as "ethernet card description", Basilisk II
357      will always use the first Ethernet card it finds as long an an "ether"
358 <    line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net
359 <    net server add-on from SheepShaver, you can only use Ethernet on PowerPC
360 <    machines.
358 >    line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net"
359 >    Net Server add-on to be installed. The first time you start Basilisk II
360 >    with Ethernet enabled you will be asked whether it's OK to make the
361 >    necessary changes to your BeOS network configuration to enable sheep_net.
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:
366 <      1. Direct access to an Ethernet card via the "sheep_net" driver.
367 <         In this case, the "ethernet card description" must be the name
368 <         of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
369 <         driver to be installed and accessible. This approach will allow you
370 <         to run all networking protocols under MacOS (TCP/IP, AppleTalk, IPX
371 <         etc.) but there is no connection between Linux networking and MacOS
372 <         networking. MacOS will only be able to talk to other machines on
373 <         the Ethernet, but not to other networks that your Linux box routes
374 <         (e.g. a second Ethernet or a PPP connection to the Internet).
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
369 >         card, e.g. "eth0".
370 >
371 >         The sheep_net module is included in the Basilisk II source
372 >         distribution in the directory "src/Unix/Linux/NetDriver". You have
373 >         to compile and install the module yourself:
374 >
375 >           $ su
376 >           [enter root password]
377 >           # make
378 >           # make dev
379 >           [this will create a /dev/sheep_net device node; you should give
380 >            appropriate access rights to the user(s) running Basilisk II]
381 >           # insmod sheep_net.o
382 >
383 >         If you copy the sheep_net.o module to a place where it can be found
384 >         by the kernel module loader ("/lib/modules/<version>/kernel/drivers/net"
385 >         for 2.4 kernels) and add the line
386 >
387 >           alias char-major-10-198 sheep_net
388 >
389 >         to "/etc/modules.conf", the kernel should be able to load the module
390 >         automatically when Basilisk II is started.
391 >
392 >         The sheep_net module will allow you to run all networking protocols
393 >         under MacOS (TCP/IP, AppleTalk, IPX etc.) but there is no connection
394 >         between Linux networking and MacOS networking. MacOS will only be
395 >         able to talk to other machines on the Ethernet, but not to other
396 >         networks that your Linux box routes (e.g. a second Ethernet or a PPP
397 >         connection to the Internet).
398 >
399        2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
400           In this case, the "ethernet card description" must be the name
401           of an ethertap interface, e.g. "tap0". It also requires that you
402 <         configure your kernel to enable routing and the ethertap device:
402 >         configure your kernel to enable routing and ethertap support:
403           under "Networking options", enable "Kernel/User netlink socket" and
404           "Netlink device emulation", under "Network device support", activate
405 <         "Ethertap network tap". Next, see /usr/src/linux/Documentation/
406 <         networking/ethertap.txt for information on how to set up /dev/tap*
407 <         device nodes and activate the ethertap interface. Under MacOS,
408 <         select an IP address that is on the virtual network and set the
409 <         default gateway to the IP address of the ethertap interface. This
410 <         approach will let you access all networks that your Linux box has
411 <         access to (especially, if your Linux box has a dial-up Internet
412 <         connection and is configured for IP masquerading, you can access
413 <         the Internet from MacOS). The drawback is that you can only use
414 <         network protocols that Linux can route, so you have to install and
415 <         configure netatalk if you want to use AppleTalk.
405 >         "Ethertap network tap". You also have to modify drivers/net/ethertap.c
406 >         a bit before compiling the new kernel:
407 >
408 >          - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the
409 >            #include lines)
410 >          - comment out the line "dev->flags|=IFF_NOARP;" in ethertap_probe()
411 >
412 >         Next, see /usr/src/linux/Documentation/networking/ethertap.txt for
413 >         information on how to set up /dev/tap* device nodes and activate the
414 >         ethertap interface. Under MacOS, select an IP address that is on the
415 >         virtual network and set the default gateway to the IP address of the
416 >         ethertap interface. This approach will let you access all networks
417 >         that your Linux box has access to (especially, if your Linux box has
418 >         a dial-up Internet connection and is configured for IP masquerading,
419 >         you can access the Internet from MacOS). The drawback is that you
420 >         can only use network protocols that Linux can route, so you have to
421 >         install and configure netatalk if you want to use AppleTalk. Here is
422 >         an example /etc/atalk/atalkd.conf for a LAN:
423 >
424 >           eth0 -seed -phase 2 -net 1 -addr 1.47 -zone "Ethernet"
425 >           tap0 -seed -phase 2 -net 2 -addr 2.47 -zone "Basilisknet"
426 >
427 >         (the "47" is an arbitrary node number). This will set up a zone
428 >         "Ethernet" (net 1) for the Ethernet and a zone "Basilisknet" (net 2)
429 >         for the internal network connection of the ethertap interface.
430 >         MacOS should automatically recognize the nets and zones upon startup.
431 >         If you are in an existing AppleTalk network, you should contact
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 >         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.
454 >
455 >         This script requires you that "sudo" is properly configured
456 >         so that "/sbin/ifconfig" and "/sbin/iptables" can be executed
457 >         as root. Otherwise, you can still write a helper script which
458 >         invokes your favorite program to enhance a user priviledges.
459 >         e.g. in a KDE environment, kdesu can be used as follows:
460 >
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
498 >    your own here...
499  
500    AmigaOS:
501      You have to specify the name of the SANA-II Ethernet device and the device
# Line 346 | 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 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">
513 +
514 +  Setting this to "true" enables a special network mode in which all network
515 +  packets sent by MacOS are tunnelled over UDP using the host operating
516 +  system's native TCP/IP stack. This can only be used to connect computers
517 +  running Basilisk II (and not, for example, for connecting to the Internet
518 +  or an AppleShare server running on a real Mac), but it is probably the
519 +  easiest way to set up a network between two instances of Basilisk II
520 +  because the UDP tunnelling doesn't require any special kernel modules or
521 +  network add-ons. It relies on IP broadcasting, however, so its range is
522 +  limited. It should be fine though for doing a little file sharing or
523 +  playing Spectre.
524 +
525 + udpport <IP port number>
526 +
527 +  This item specifies the IP port number to use for the "UDP Tunnel" mode.
528 +  The default is 6066.
529 +
530   rom <ROM file path>
531  
532    This item specifies the file name of the Mac ROM file to be used by
# Line 374 | Line 555 | frameskip <frames to skip>
555    For refreshed graphics modes (usually window modes), this specifies
556    how many frames to skip after drawing one frame. Higher values make
557    the video display more responsive but require more processing power.
558 <  The default is "8".
558 >  The default is "8". Under Unix/X11, a value of "0" selects a "dynamic"
559 >  update mode that cuts the display into rectangles and updates each
560 >  rectangle individually, depending on display changes.
561  
562   modelid <MacOS model ID>
563  
564 <  Specifies the Model ID that Basilisk II should report to MacOS.
565 <  The default is "5" which corresponds to a Mac IIci. If you want to
566 <  run MacOS 8, you have to set this to "14" (Quadra 900). Other values
567 <  are not officially supported and may result in crashes. MacOS versions
568 <  earlier than 7.5 may only run with the Model ID set to "5". If you are
569 <  using a Mac Classic ROM, the model is always "Mac Classic" and this
570 <  setting is ignored.
564 >  Specifies the Macintosh model ID that Basilisk II should report to MacOS.
565 >  The default is "5" which corresponds to a Mac IIci. If you want to run
566 >  MacOS 8, you have to set this to "14" (Quadra 900). Other values are not
567 >  officially supported and may result in crashes. MacOS versions earlier
568 >  than 7.5 may only run with the Model ID set to "5". If you are using a Mac
569 >  Classic ROM, the model is always "Mac Classic" and this setting is
570 >  ignored.
571  
572   nosound <"true" or "false">
573  
# Line 404 | Line 587 | nogui <"true" or "false">
587    error alerts. All errors will then be reported to stdout. The default
588    is "false".
589  
590 + keyboardtype <keyboard-id>
591 +
592 +  Specifies the keyboard type that BasiliskII should report to the MacOS.
593 +  The default is "5" which is a "Apple Extended Keyboard II (ISO)",
594 +  but many other numbers are understood by most versions of the MacOS
595 +  (e.g. 11 is a "Macintosh Plus Keyboard with keypad",
596 +        13 is a "Apple PowerBook Keyboard (ISO)" )
597 +
598   For additional information, consult the source.
599  
600  
# Line 413 | Line 604 | System-specific configuration
604   Unix:
605  
606    keycodes <"true" or "false">
607 <  keycodefile <Keycode file path>
607 >  keycodefile <keycodes file path>
608  
609      By default, the X11 event handler in Basilisk II uses KeySyms to
610      translate keyboard event to Mac keycodes. While this method is very
# Line 424 | Line 615 | Unix:
615      not on the selected keymap. Unfortunately it depends on the X server
616      being used and possibly also on the type of keyboard attached. So
617      Basilisk II needs a table to translate X keycodes to Mac keycodes.
618 <    This table is read by default from /usr/local/lib/basilisk_ii_keycodes
618 >    This table is read by default from /usr/local/share/BasiliskII/keycodes
619      unless you specify a different file with the "keycodefile" item.
620 <    A sample keycode file ("basilisk_ii_keycodes") is included with
621 <    Basilisk II.
620 >    A sample keycode file is included with Basilisk II.
621 >
622 >  fbdevicefile <fbdevices file path>
623 >
624 >    This option specifies the file that contains frame buffer device
625 >    specifications for the fbdev-DGA video mode (when Basilisk II was
626 >    configured with --enable-fbdev-dga). The default location of the file
627 >    is /usr/local/share/BasiliskII/fbdevices. A sample file is included
628 >    with Basilisk II.
629 >
630 >  mousewheelmode <mode>
631 >
632 >    If you have a mouse with a wheel, this option specifies whether moving
633 >    the wheel will be reported to the MacOS as "Page up/down" (mode 0) or
634 >    "Cursor up/down" (mode 1) keys.
635 >
636 >  mousewheellines <number of lines>
637 >
638 >    If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets
639 >    the number of key events sent to MacOS for each wheel movement (the
640 >    number of lines to scroll).
641 >
642 >  ignoresegv <"true" or "false">
643 >
644 >    Set this to "true" to ignore illegal memory accesses. The default
645 >    is "false". This feature is only implemented on the following
646 >    platforms: Linux/x86, Linux/ppc, Darwin/ppc.
647 >
648 >  dsp <device name>
649 >  mixer <device name>
650 >
651 >    Under Linux and FreeBSD, this specifies the devices to be used for sound
652 >    output and volume control, respectively. The defaults are "/dev/dsp" and
653 >    "/dev/mixer".
654  
655   AmigaOS:
656  
# Line 439 | Line 662 | AmigaOS:
662  
663        ahi/<hexadecimal mode ID>
664  
665 +  scsimemtype <type>
666 +
667 +    This item controls the type of memory to use for SCSI buffers. Possible
668 +    values are:
669 +      0 Chip memory
670 +      1 24-bit DMA capable memory
671 +      2 Any memory
672 +
673 +    Be warned that many SCSI host adapters will not work with the "Any memory"
674 +    setting. Basilisk II has no way of knowing which memory type is supported
675 +    by the host adapter and setting an unsupported type will result in data
676 +    corruption.
677 +
678   Windows:
679  
680    noscsi <"true" or "false">
# Line 449 | Line 685 | Windows:
685      means is that the control is not returned to the application until the
686      command is completely finished. Normally this is not an issue, but when a
687      CDR/CDRW is closed or erased the burner program typically wants to wait in
688 <    some progress dialog The result may be that the application reports a
688 >    some progress dialog the result may be that the application reports a
689      time-out error, but the operation completes all right anyway.
690  
691    nofloppyboot <"true" or "false">
# Line 463 | Line 699 | Windows:
699      This is very useful since many devices have almost identical ATAPI and SCSI
700      versions of their hardware, and MacOS applications usually support the SCSI
701      version only. The example below is typical:
702 <  
702 >
703        replacescsi "HP" "CD-Writer+ 7100" "PHILIPS" "CDD3600"
704 <  
704 >
705      Note the use of quotes.
706  
707 <  disablescsi <"Vendor"> <"Model">
707 >  rightmouse <0/1>
708 >
709 >    Defines what the right mouse button is used for. The default values of 0
710 >    means that it is used to move windowed mode BasiliskII screen.
711 >    Value 1 sends a combination Control and mouse click to the MacOS.
712 >    This may be useful under OS versions 8 and above.
713  
714 <    Disables this vendor/model combination. You may need this simply because
715 <    you have more than 6 SCSI devices, or the particular device has problems
716 <    under BasiliskII. E.g.
717 <
718 <      disablescsi "HP" "CD-Writer+ 7100"
719 <  
720 <    Again, note the use of quotes.
714 >  keyboardfile <path>
715 >
716 >    Defines the path of the customized keyboard code file.
717 >
718 >  pollmedia <"true" or "false">
719 >
720 >    If true (default), tries to automatically detect new media.
721 >    Applies to all "floppy", "cd" or "disk" removable media except
722 >    1.44 MB floppies. May cause modest slow down. If unchecked,
723 >    use Ctrl-Shift-F11 to manually mount new media.
724 >    If you have auto-insert notification (AIN) enabled, you may turn this
725 >    option off. Note that some CD related software require AIN,
726 >    and some other need it to be turned off. Consult the documentation
727 >    of your CD software to learn which one is optimal for you.
728 >
729 >  framesleepticks <milliseconds>
730 >
731 >    The amount of time between video frames.
732 >
733 >  showfps <true/false>
734 >
735 >    If true, the real frame rate is displayed.
736 >
737 >  stickymenu <true/false>
738 >
739 >    If true, the main menu bar is kept open even after the mouse button is
740 >    released, under all OS versions (OS 8 has this feature already). There
741 >    are extensions to do the same thing, but it's faster to handle this in
742 >    native code. Default is "true".
743  
744    ntdx5hack <"true" or "false">
745  
746 <    You may need this on NT if your display adapter driver has a bug in DirectX
747 <    palette support. Black and white are reversed. It fixes the palette issue
748 <    by using GDI palette instead of D3D palette. Default is false.
746 >    You may need this on NT if your display adapter driver has a bug in
747 >    DirectX palette support. Black and white are reversed. It fixes the
748 >    palette issue by using GDI palette instead of D3D palette. Default is
749 >    false.
750 >
751 >
752 > JIT-specific configuration
753 > --------------------------
754 >
755 > A Just-In-Time (JIT) translation engine is available for x86. This is
756 > aimed at translating 68040 instructions to native equivalent code
757 > sequences, thus providing faster emulation speeds.
758 >
759 >  jit <"true" or "false">
760 >
761 >    Set this to "true" to enable the JIT compiler. Default value is
762 >    "true" if the JIT compiler was compiled in. Besides, this is
763 >    effective only if Basilisk II is configured to emulate a 68040.
764 >
765 >  jitfpu <"true" or "false">
766 >
767 >    Set this to "true" to enable translation of floating-point (FPU)
768 >    instructions. Default is "true".
769 >
770 >  jitcachesize <size>
771 >
772 >    Allocate "size" kilobytes of RAM for the translation cache. The
773 >    value given will be rounded down to the nearest multiple of a page
774 >    size. Minimal value is "2048" (2MB). Default value is "8192" (8MB).
775 >
776 >  jitlazyflush <"true" or "false">
777 >
778 >    Set this to "true" to enable lazy invalidation of the translation
779 >    cache. This is always recommended as it usually makes the system
780 >    more responsive and faster, especially while running MacOS
781 >    8.X. Default value is "true".
782 >
783 >  jitdebug <"true" or "false">
784 >
785 >    Set this to "true" to enable the JIT debugger. This requires a
786 >    build of Basilisk II with the cxmon debugger. Default is "false".
787  
788  
789   Usage
# Line 507 | Line 808 | Keyboard:
808    On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
809    key is the Mac "Option" key.
810  
811 + Mouse:
812 +  Under Unix, pressing Ctrl-F5 while the Basilisk II window is active will
813 +  grab the mouse. This is needed for compatibility with some MacOS programs,
814 +  especially games such as flight simulators. Press Ctrl-F5 again to return
815 +  to normal mouse operation.
816 +
817   Floppy:
818    Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
819 <  flopyy disk changes might not be detected automatically. Under Linux, press
819 >  floppy disk changes might not be detected automatically. Under Unix, press
820    Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
821    item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
822  
823   HFS partitions:
824    Having HFS partitions mounted for read-write access under Basilisk II while
825    they are also mounted on the host OS will most likely result in volume
826 <  corruption and data losses. Unmount your HFS volumes before starting
826 >  corruption and data loss. Unmount your HFS volumes before starting
827    Basilisk II.
828  
829   ZIP drives:
# Line 535 | Line 842 | Mac Classic emulation:
842    ROM. Also, the video display is fixed to 512x342 in monochrome. The AmigaOS
843    and BeOS/PPC versions of Basilisk II cannot do Mac Classic emulation.
844  
845 + Video resolution switching:
846 +  Run-time switching of video resolutions requires the Display Manager. This
847 +  is included in MacOS versions 7.6 and above, and available as a system
848 +  extension for earlier MacOS versions as a free download from ftp.apple.com
849 +  (look for "Display Software 2.x"). Click on "Options..." in the "Monitors"
850 +  control panel to select the resolution.
851 +
852   Sound output:
853    Sound output under Basilisk II requires Sound Manager 3.0 or later. This
854 <  is included starting with MacOS 7.5 and available as a system extension
855 <  for earlier MacOS versions. Sample rate, bit resolution and mono/stereo
856 <  can be selected in the Sound control panel (section "Sound Out").
854 >  is included in MacOS versions 7.5 and above, and available as a system
855 >  extension for earlier MacOS versions as a free download from ftp.apple.com.
856 >  Sample rate, bit resolution and mono/stereo can be selected in the Sound
857 >  control panel (section "Sound Out").
858  
859   Ethernet:
860    Basilisk II supports all Ethernet protocols. Running a protocol under
861    Basilisk II that already runs within the host operating system on the same
862    network card (e.g. running MacTCP under Basilisk II on a BeOS machine) may
863    or may not work (generally, it should work, but some specific things like
864 <  "ping" may not). If you have problems with FTP, try setting your FTP client
864 >  "ping" may not). If you have problems with FTP, try setting the FTP client
865    to passive mode.
866  
867   LocalTalk:
# Line 556 | Line 871 | LocalTalk:
871  
872   Serial:
873    You can use the serial ports in Basilisk II to connect to the Internet
874 <  with a modem and "MacPPP".
874 >  with a modem and the "MacPPP" or "Open Transport/PPP" software.
875  
876  
877   Technical Documentation
# Line 568 | Line 883 | Please see the included file "TECH" for
883   Acknowledgements
884   ----------------
885  
886 < Contributions by:
572 < - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
573 < - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
574 <   and networking
575 < - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
886 > Contributions by (in alphabetical order):
887   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
888 < - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
888 > - Gwenolé Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations,
889 >   lots of work on the Unix video code, fixes and improvements to the
890 >   JIT compiler
891   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
892 + - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
893 +   and networking
894   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
895     window support
896 + - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
897 + - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
898 + - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
899   - David Lawrence <davidl@jlab.org>: incremental window refresh code
900 + - Bernie Meyer <bmeyer@csse.monash.edu.au>: original UAE-JIT code
901 + - Nigel Pearson <nigel@ind.tansu.com.au>: Mac OS X port
902 + - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
903 + - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
904 + - Michael Z. Sliczniak <msliczniak@comcast.net>: Mach memory fault recovery
905 + - and others...
906  
907   Special thanks to:
908   - Bernd Schmidt for letting me use his UAE 68k emulation
# Line 595 | Line 919 | You found a bug? Well, use the source, f
919    <Christian.Bauer@uni-mainz.de>
920   for inclusion in the next release of Basilisk II.
921  
922 + If you don't have a fix, you should post a bug report using the Source Forge
923 + bug tracker, supplying as much information as possible (operating system and
924 + versions of Basilisk II and MacOS being used, relevant hardware information,
925 + the exact steps to reproduce the bug, etc.):
926 +  http://sourceforge.net/tracker/?group_id=2123&atid=102123
927 +
928 + I also strongly suggest reading this before posting a bug report:
929 +  http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
930 +
931  
932   Author
933   ------
934  
935 < You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug
936 < reports, send fixes. Ports to other platforms are also very welcome.
937 < Please contact me before you intend to make major changes to the source.
938 < You might be working on something that I have already done or I may have
939 < different ideas about the Right Way to do it.
940 <
941 < Questions about ROM files will not be answered. There is also no point in
942 < sending me questions etc. that are specific to the Windows port of
943 < Basilisk II. I don't have Windows and can't say anything about that.
944 < Ask Lauri Pesonen instead.
935 > You can contact me at <Christian.Bauer@uni-mainz.de>, but please don't do
936 > so unless absolutely necessary. I'm maintaining Basilisk II in my spare
937 > time and am not able to provide technical support for everyone. If you have
938 > questions, consider posting them to one of the support forums mentioned
939 > below.
940 >
941 > You are encouraged to contact me personally when
942 > - you have bug fixes or small enhancements for the code
943 > - you want to port Basilisk II to another platform
944 > - you want to discuss technical issues
945 > - you intend to make major changes to the source; you might be working on
946 >   something that I have already done, or I may have different ideas about
947 >   the Right Way to do it
948 >
949 > There is no point in sending me questions about
950 > - ROM files and how/where to get them
951 > - versions of Basilisk II that run on operating systems other than Unix,
952 >   BeOS and AmigaOS. If you are using any other operating system, there's
953 >   no point in asking me how to to X or why Y doesn't work because I won't
954 >   know either. Instead, you should look in the "Acknowledgements" section
955 >   of this manual to find the person responsible. For example, if your
956 >   question is specific to the Windows operating system, ask Lauri Pesonen.
957 >   I don't have Windows and can't answer your questions and I'm too lazy to
958 >   forward mail to Lauri myself. In any case, it would probably be better
959 >   to post your questions to a public forum as it will get a much wider
960 >   audience there.
961  
962  
963   Support
# Line 617 | Line 966 | Support
966   The official Basilisk II home page is at
967    http://www.uni-mainz.de/~bauec002/B2Main.html
968  
969 < There is no user-level support for Basilisk II at the moment.
969 > The Basilisk II project page on SourceForge is at
970 >  http://sourceforge.net/projects/basilisk/
971 >
972 > If you have problems, you may want to visit the Basilisk II forums:
973 >  http://sourceforge.net/forum/?group_id=2123
974 >
975 > There is also a mailing list for Basilisk II users:
976 >  http://lists.sourceforge.net/lists/listinfo/basilisk-user
977 >
978 > And another mailing list for Basilisk II developers:
979 >  http://lists.sourceforge.net/lists/listinfo/basilisk-devel
980 >
981 > Some general advice about asking technical support questions can be found at
982 >  http://www.tuxedo.org/~esr/faqs/smart-questions.html
983 >
984 > Keeping this in mind will greatly increase your chances of getting a useful
985 > answer.
986  
987  
988   History

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines