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.12 by cebix, 2000-07-13T17:45:51Z vs.
Revision 1.22 by cebix, 2001-07-12T19:48:24Z

# Line 1 | Line 1
1  
2 <        Basilisk II, Version 0.8
3 <        A free, portable Mac II emulator
2 >  Basilisk II
3 >  A 68k Macintosh emulator
4  
5 <        Copyright (C) 1997-2000 Christian Bauer et al.
6 <        Freely distributable
5 >  Copyright (C) 1997-2001 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)
# Line 327 | Line 327 | ether <ethernet card description>
327    BeOS:
328      It doesn't matter what you give as "ethernet card description", Basilisk II
329      will always use the first Ethernet card it finds as long an an "ether"
330 <    line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net
331 <    net server add-on from SheepShaver, you can only use Ethernet on PowerPC
332 <    machines.
330 >    line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net"
331 >    Net Server add-on to be installed. The first time you start Basilisk II
332 >    with Ethernet enabled you will be asked whether it's OK to make the
333 >    necessary changes to your BeOS network configuration to enable sheep_net.
334  
335    Linux:
336      The "ethernet card description" is the name of an Ethernet interface.
# Line 351 | Line 352 | ether <ethernet card description>
352           configure your kernel to enable routing and the ethertap device:
353           under "Networking options", enable "Kernel/User netlink socket" and
354           "Netlink device emulation", under "Network device support", activate
355 <         "Ethertap network tap". You also have to modify devices/net/ethertap.c
355 >         "Ethertap network tap". You also have to modify drivers/net/ethertap.c
356           a bit before compiling the new kernel:
357  
358            - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the
# Line 381 | Line 382 | ether <ethernet card description>
382           your network administrator about the nets and zones you can use
383           (instead of the ones given in the example above).
384  
385 +  FreeBSD:
386 +    The "ethertap" method described above also works under FreeBSD, but since
387 +    no-one has found the time to write a section for this manual, you're on
388 +    your own here...
389 +
390    AmigaOS:
391      You have to specify the name of the SANA-II Ethernet device and the device
392      unit as "<device name>/<unit>" (e.g. "ariadne.device/0"). If the given
# Line 388 | Line 394 | ether <ethernet card description>
394      not an Ethernet device, Basilisk II will display a warning message and
395      disable Ethernet networking.
396  
397 +  See the next item for an alternative way to do networking with Basilisk II.
398 +
399 + udptunnel <"true" or "false">
400 +
401 +  Setting this to "true" enables a special network mode in which all network
402 +  packets sent by MacOS are tunnelled over UDP using the host operating
403 +  system's native TCP/IP stack. This only works with AppleTalk and can only
404 +  be used to connect computers running Basilisk II (and not, for example, for
405 +  connecting to an AppleShare server running on a real Mac), but it is
406 +  probably the easiest way to set up a network between two instances of
407 +  Basilisk II because the UDP tunnelling doesn't require any special kernel
408 +  modules or network add-ons. It relies on IP broadcasting, however, so
409 +  its range is limited.
410 +
411 + udpport <IP port number>
412 +
413 +  This item specifies the IP port number to use for the "AppleTalk over UDP"
414 +  tunnel mode. The default is 6066.
415 +
416   rom <ROM file path>
417  
418    This item specifies the file name of the Mac ROM file to be used by
# Line 502 | Line 527 | AmigaOS:
527  
528        ahi/<hexadecimal mode ID>
529  
530 +  scsimemtype <type>
531 +
532 +    This item controls the type of memory to use for SCSI buffers. Possible
533 +    values are:
534 +      0 Chip memory
535 +      1 24-bit DMA capable memory
536 +      2 Any memory
537 +
538 +    Be warned that many SCSI host adapters will not work with the "Any memory"
539 +    setting. Basilisk II has no way of knowing which memory type is supported
540 +    by the host adapter and setting an unsupported type will result in data
541 +    corruption.
542 +
543   Windows:
544  
545    noscsi <"true" or "false">
# Line 597 | Line 635 | Keyboard:
635    On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
636    key is the Mac "Option" key.
637  
638 + Mouse:
639 +  Under Unix, press Ctrl-F5 while the Basilisk II window is active will grab
640 +  the mouse. This is needed for compatibility with some MacOS programs,
641 +  especially games. Press Ctrl-F5 again to return to normal mouse operation.
642 +
643   Floppy:
644    Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
645 <  flopyy disk changes might not be detected automatically. Under Linux, press
645 >  floppy disk changes might not be detected automatically. Under Unix, press
646    Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
647    item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
648  
# Line 658 | Line 701 | Please see the included file "TECH" for
701   Acknowledgements
702   ----------------
703  
704 < Contributions by:
662 < - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
663 < - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
664 <   and networking
665 < - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
704 > Contributions by (in alphabetical order):
705   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
706 < - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
706 > - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
707 >   fbdev video code
708   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
709 + - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
710 +   and networking
711   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
712     window support
713 < - David Lawrence <davidl@jlab.org>: incremental window refresh code
713 > - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
714 > - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
715   - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
716 < - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
717 <   fbdev video code
716 > - David Lawrence <davidl@jlab.org>: incremental window refresh code
717 > - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
718 > - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
719   - and others...
720  
721   Special thanks to:

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines