/[cebix]/BasiliskII/README

Diff of /BasiliskII/README

Parent Directory | Revision Log | View Patch Patch

-revision 1.22 by cebix,
Thu Jul 12 19:48:24 2001 UTC
+revision 1.23 by cebix,
Sun Jul 15 02:15:48 2001 UTC
 Line 22 
 a Macintosh ROM image to use Basilisk II
  Basilisk II has currently been ported to the following systems:
    - BeOS R4 (PowerPC and x86)
-   - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x, NetBSD 1.4.2 and
+   - Unix (tested under Linux, Solaris 2.x, FreeBSD 3.x, NetBSD 1.4.x and
      IRIX 6.5)
    - AmigaOS 3.x
    - Windows NT 4.0 (mostly works under Windows 95/98, too)
 Line 94 
 disk
    This item describes one MacOS volume to be mounted by Basilisk II.
    There can be multiple "disk" lines in the preferences file. Basilisk II
    can handle hardfiles (byte-per-byte images of HFS volumes in a file on
-   the host system) as well as HFS partitions on hard disks etc. (but Basilisk
+   the host system), HFS partitions on hard disks etc., and MacOS-partitioned
-   II doesn't know about MacOS partition tables; it relies on the host OS to
+   disks (it can only access the first partition, though). The "volume
-   handle this). The "volume description" is either the pathname of a hardfile
+   description" is either the pathname of a hardfile or a platform-dependant
-   or a platform-dependant description of an HFS partition or drive. If the
+   description of an HFS partition or drive. If the volume description is
-   volume description starts with an asterisk ("*"), the volume is write
+   prefixed by an asterisk ("*"), the volume is write protected for MacOS.
-   protected for MacOS (and the "*" is discarded).
+   Basilisk II can also handle some types of Mac "disk image" files directly,
+   as long as they are uncompressed and unencoded.
    BeOS:
      To specify an HFS partition, simply specify its path (e.g.
-     "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volume, Basilisk II
+     "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volumes, Basilisk II
      will search for and use all available HFS partitions.
    Unix:
-     To specify an HFS partition, simply specify its path (e.g.
+     To specify an HFS partition, simply specify its path (e.g. "/dev/sda5").
-     "/dev/sda5").
+     If you want to access a MacOS-partitioned hard disk or removable volume
+     (Jaz, Zip etc.) and your operating system doesn't understand MacOS
+     partition tables, you can specify the block device name (e.g. "/dev/sda")
+     to access the first HFS partition on the device. Under Linux, if you
+     don't specify any volumes, Basilisk II will search /etc/fstab for
+     unmounted HFS partitions and use these.
    AmigaOS:
      Partitions/drives are specified in the following format:
-Line 146 
 extfs
+Line 153 
 extfs
    This item specifies the root directory for the "Host Directory Tree"
    file system (the "Unix/BeOS/Amiga/..." icon on the Finder desktop).
    All objects contained in that directory are accessible by Mac applications.
    This feature is only available when File System Manager V1.2 or later
    is installed on the Mac side. FSM 1.2 is built-in beginning with MacOS 7.6
    and can be installed as a system extension (downloadable from Apple, look
-Line 185 
 scsi0  ... scsi6
+Line 193 
 scsi0  ... scsi6
  screen <video mode>
-   This item describes the type of video display to be used by Basilisk II.
+   This item describes the type of video display to be used by default for
-   If you are using a Mac Classic ROM, the display is always 1-bit 512x342
+   Basilisk II. If you are using a Mac Classic ROM, the display is always
-   and this item is ignored. The format of the "video mode" is platform
+-bit 512x342 and this item is ignored. The format of the "video mode" is
-   specific.
+   platform specific.
    BeOS:
      The "video mode" is one of the following:
-Line 208 
 screen
+Line 216 
 screen
    Unix:
      The "video mode" is one of the following:
        win/<width>/<height>
-         Color display in an X11 window of the given size. The color depth
+         Color display in an X11 window of the given size. There are several
-         (8/15/24 bit) depends on the depth of the underlying X11 screen.
+         resolutions and color depths available. The set of color depths
-         This is the default.
+         depends on the capabilities of the X11 server, the operating system,
+         and Basilisk II compile-time options, but 1 bit and the default depth
+         of the X11 screen should always be available.
        dga/<width>/<height>
          [if Basilisk II was configured with --enable-xf86-dga]
          Full-screen display using the XFree86 DGA extension. The color depth
-Line 324 
 ether
+Line 334 
 ether
    is not available and this setting is ignored. The "ethernet card description"
    is a platform-dependant description of an ethernet card.
+   General note: To use TCP/IP from MacOS, you should assign a different IP
+   address to the MacOS (entered into the MacOS TCP/IP (or MacTCP) control
+   panel). Otherwise there will be confusion about which operating system will
+   handle incoming packets.
    BeOS:
      It doesn't matter what you give as "ethernet card description", Basilisk II
      will always use the first Ethernet card it finds as long an an "ether"
-Line 336 
 ether
+Line 351 
 ether
      The "ethernet card description" is the name of an Ethernet interface.
      There are two approaches to networking with Basilisk II:
-. Direct access to an Ethernet card via the "sheep_net" driver.
+. Direct access to an Ethernet card via the "sheep_net" kernel module.
-          In this case, the "ethernet card description" must be the name
+          The "ethernet card description" must be the name of a real Ethernet
-          of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
+          card, e.g. "eth0".
-          driver to be installed and accessible. This approach will allow you
-          to run all networking protocols under MacOS (TCP/IP, AppleTalk, IPX
+          The sheep_net module is included in the Basilisk II source
-          etc.) but there is no connection between Linux networking and MacOS
+          distribution in the directory "src/Unix/Linux/NetDriver". You have
-          networking. MacOS will only be able to talk to other machines on
+          to compile and install the module yourself:
-          the Ethernet, but not to other networks that your Linux box routes
-          (e.g. a second Ethernet or a PPP connection to the Internet).
+            $ su
+            [enter root password]
+            # make
+            # make dev
+            [this will create a /dev/sheep_net device node; you should give
+             appropriate access rights to the user(s) running Basilisk II]
+            # insmod sheep_net.o
+          If you copy the sheep_net.o module to a place where it can be found
+          by the kernel module loader ("/lib/modules/<version>/kernel/drivers/net"
+          for 2.4 kernels) and add the line
+            alias char-major-10-198 sheep_net
+          to "/etc/modules.conf", the kernel should be able to load the module
+          automatically when Basilisk II is started.
+          The sheep_net module will allow you to run all networking protocols
+          under MacOS (TCP/IP, AppleTalk, IPX etc.) but there is no connection
+          between Linux networking and MacOS networking. MacOS will only be
+          able to talk to other machines on the Ethernet, but not to other
+          networks that your Linux box routes (e.g. a second Ethernet or a PPP
+          connection to the Internet).
 . Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
           In this case, the "ethernet card description" must be the name
           of an ethertap interface, e.g. "tap0". It also requires that you
-          configure your kernel to enable routing and the ethertap device:
+          configure your kernel to enable routing and ethertap support:
           under "Networking options", enable "Kernel/User netlink socket" and
           "Netlink device emulation", under "Network device support", activate
           "Ethertap network tap". You also have to modify drivers/net/ethertap.c
-Line 400 
 udptunnel <"true" or "false">
+Line 437 
 udptunnel <"true" or "false">
    Setting this to "true" enables a special network mode in which all network
    packets sent by MacOS are tunnelled over UDP using the host operating
-   system's native TCP/IP stack. This only works with AppleTalk and can only
+   system's native TCP/IP stack. This can only be used to connect computers
-   be used to connect computers running Basilisk II (and not, for example, for
+   running Basilisk II (and not, for example, for connecting to the Internet
-   connecting to an AppleShare server running on a real Mac), but it is
+   or an AppleShare server running on a real Mac), but it is probably the
-   probably the easiest way to set up a network between two instances of
+   easiest way to set up a network between two instances of Basilisk II
-   Basilisk II because the UDP tunnelling doesn't require any special kernel
+   because the UDP tunnelling doesn't require any special kernel modules or
-   modules or network add-ons. It relies on IP broadcasting, however, so
+   network add-ons. It relies on IP broadcasting, however, so its range is
-   its range is limited.
+   limited. It should be fine though for doing a little file sharing or
+   playing Spectre.
  udpport <IP port number>
-   This item specifies the IP port number to use for the "AppleTalk over UDP"
+   This item specifies the IP port number to use for the "UDP Tunnel" mode.
-   tunnel mode. The default is 6066.
+   The default is 6066.
  rom <ROM file path>
-Line 447 
 frameskip
+Line 485 
 frameskip
  modelid <MacOS model ID>
-   Specifies the Model ID that Basilisk II should report to MacOS.
+   Specifies the Macintosh model ID that Basilisk II should report to MacOS.
-   The default is "5" which corresponds to a Mac IIci. If you want to
+   The default is "5" which corresponds to a Mac IIci. If you want to run
-   run MacOS 8, you have to set this to "14" (Quadra 900). Other values
+   MacOS 8, you have to set this to "14" (Quadra 900). Other values are not
-   are not officially supported and may result in crashes. MacOS versions
+   officially supported and may result in crashes. MacOS versions earlier
-   earlier than 7.5 may only run with the Model ID set to "5". If you are
+   than 7.5 may only run with the Model ID set to "5". If you are using a Mac
-   using a Mac Classic ROM, the model is always "Mac Classic" and this
+   Classic ROM, the model is always "Mac Classic" and this setting is
-   setting is ignored.
+   ignored.
  nosound <"true" or "false">
-Line 550 
 Windows:
+Line 588 
 Windows:
      means is that the control is not returned to the application until the
      command is completely finished. Normally this is not an issue, but when a
      CDR/CDRW is closed or erased the burner program typically wants to wait in
-     some progress dialog The result may be that the application reports a
+     some progress dialog the result may be that the application reports a
      time-out error, but the operation completes all right anyway.
    nofloppyboot <"true" or "false">
-Line 601 
 Windows:
+Line 639 
 Windows:
    stickymenu <true/false>
-     If true, the main menu bar is kept open even after the mouse button is released,
+     If true, the main menu bar is kept open even after the mouse button is
-     under all OS versions (OS 8 has this feature already). There are extensions to do
+     released, under all OS versions (OS 8 has this feature already). There
-     the same thing, but it's faster to handle this in native code.
+     are extensions to do the same thing, but it's faster to handle this in
-     Default is "true".
+     native code. Default is "true".
    ntdx5hack <"true" or "false">
-     You may need this on NT if your display adapter driver has a bug in DirectX
+     You may need this on NT if your display adapter driver has a bug in
-     palette support. Black and white are reversed. It fixes the palette issue
+     DirectX palette support. Black and white are reversed. It fixes the
-     by using GDI palette instead of D3D palette. Default is false.
+     palette issue by using GDI palette instead of D3D palette. Default is
+     false.
  Usage
-Line 636 
 Keyboard:
+Line 675 
 Keyboard:
    key is the Mac "Option" key.
  Mouse:
-   Under Unix, press Ctrl-F5 while the Basilisk II window is active will grab
+   Under Unix, pressing Ctrl-F5 while the Basilisk II window is active will
-   the mouse. This is needed for compatibility with some MacOS programs,
+   grab the mouse. This is needed for compatibility with some MacOS programs,
-   especially games. Press Ctrl-F5 again to return to normal mouse operation.
+   especially games such as flight simulators. Press Ctrl-F5 again to return
+   to normal mouse operation.
  Floppy:
    Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
-Line 649 
 Floppy:
+Line 689 
 Floppy:
  HFS partitions:
    Having HFS partitions mounted for read-write access under Basilisk II while
    they are also mounted on the host OS will most likely result in volume
-   corruption and data losses. Unmount your HFS volumes before starting
+   corruption and data loss. Unmount your HFS volumes before starting
    Basilisk II.
  ZIP drives:
-Line 668 
 Mac Classic emulation:
+Line 708 
 Mac Classic emulation:
    ROM. Also, the video display is fixed to 512x342 in monochrome. The AmigaOS
    and BeOS/PPC versions of Basilisk II cannot do Mac Classic emulation.
+ Video resolution switching:
+   Run-time switching of video resolutions requires the Display Manager. This
+   is included in MacOS versions 7.6 and above, and available as a system
+   extension for earlier MacOS versions as a free download from ftp.apple.com
+   (look for "Display Software 2.x"). Click on "Options..." in the "Monitors"
+   control panel to select the resolution.
  Sound output:
    Sound output under Basilisk II requires Sound Manager 3.0 or later. This
-   is included starting with MacOS 7.5 and available as a system extension
+   is included in MacOS versions 7.5 and above, and available as a system
-   for earlier MacOS versions. Sample rate, bit resolution and mono/stereo
+   extension for earlier MacOS versions as a free download from ftp.apple.com.
-   can be selected in the Sound control panel (section "Sound Out").
+   Sample rate, bit resolution and mono/stereo can be selected in the Sound
+   control panel (section "Sound Out").
  Ethernet:
    Basilisk II supports all Ethernet protocols. Running a protocol under
    Basilisk II that already runs within the host operating system on the same
    network card (e.g. running MacTCP under Basilisk II on a BeOS machine) may
    or may not work (generally, it should work, but some specific things like
-   "ping" may not). If you have problems with FTP, try setting your FTP client
+   "ping" may not). If you have problems with FTP, try setting the FTP client
    to passive mode.
  LocalTalk:
-Line 689 
 LocalTalk:
+Line 737 
 LocalTalk:
  Serial:
    You can use the serial ports in Basilisk II to connect to the Internet
-   with a modem and "MacPPP".
+   with a modem and the "MacPPP" or "Open Transport/PPP" software.
  Technical Documentation
-Line 703 
 Acknowledgements
+Line 751 
 Acknowledgements
  Contributions by (in alphabetical order):
   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
-  - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
+  - Gwenol� Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations,
-    fbdev video code
+    lots of work on the Unix video code
   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
   - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
     and networking
-Line 733 
 You found a bug? Well, use the source, f
+Line 781 
 You found a bug? Well, use the source, f
    <Christian.Bauer@uni-mainz.de>
  for inclusion in the next release of Basilisk II.
+ If you don't have a fix, you should post a bug report using the Source Forge
+ bug tracker, supplying as much information as possible (operating system and
+ versions of Basilisk II and MacOS being used, relevant hardware information,
+ the exact steps to reproduce the bug, etc.):
+   http://sourceforge.net/tracker/?group_id=2123&atid=102123
  Author
  ------
-Line 740 
 Author
+Line 794 
 Author
  You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug
  reports, send fixes. Ports to other platforms are also very welcome.
  Please contact me before you intend to make major changes to the source.
- You might be working on something that I have already done or I may have
+ You might be working on something that I have already done, or I may have
  different ideas about the Right Way to do it.
  Questions about ROM files will not be answered. There is also no point in
-Line 755 
 Support
+Line 809 
 Support
  The official Basilisk II home page is at
    http://www.uni-mainz.de/~bauec002/B2Main.html
- There is no user-level support for Basilisk II at the moment.
+ The Basilisk II project page on SourceForge is at
+   http://sourceforge.net/projects/basilisk/
+ If you have problems, you may want to visit the Basilisk II forums:
+   http://sourceforge.net/forum/?group_id=2123
+ There is also a mailing list for Basilisk II users:
+   http://lists.sourceforge.net/lists/listinfo/basilisk-user
+ And another mailing list for Basilisk II developers:
+   http://lists.sourceforge.net/lists/listinfo/basilisk-devel
  History

 Legend:



Removed from v.1.22
 


changed lines


 
Added in v.1.23
 Legend:



Removed from v.1.22
 


changed lines


 
Added in v.1.23
-Removed from v.1.22
+Added in v.1.23

Christian Bauer">Christian Bauer	ViewVC Help
Powered by ViewVC 1.1.15