ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/README
Revision: 1.6
Committed: 1999-10-21T13:19:11Z (25 years ago) by cebix
Branch: MAIN
Changes since 1.5: +3 -0 lines
Log Message:
- added fbdev video code and SPARC assembly optimizations

File Contents

# User Rev Content
1 cebix 1.1
2     Basilisk II, Version 0.7
3     A free, portable Mac II emulator
4    
5     Copyright (C) 1997-1999 Christian Bauer et al.
6     Freely distributable
7    
8    
9     License
10     -------
11    
12     Basilisk II is available under the terms of the GNU General Public License.
13 cebix 1.3 See the file "COPYING" that is included in the distribution for details.
14 cebix 1.1
15    
16     Overview
17     --------
18    
19     Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires
20     a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and
21     distributed under the GNU General Public License.
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)
26     - AmigaOS 3.x
27     - Windows NT 4.0 (mostly works under Windows 95/98, too)
28    
29     Some features of Basilisk II:
30     - Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5)
31     or a Mac II series machine (which runs MacOS 7.x, 8.0 and 8.1),
32     depending on the ROM being used
33     - Color video display
34     - CD quality sound output
35     - Floppy disk driver (only 1.44MB disks supported)
36     - Driver for HFS partitions and hardfiles
37     - CD-ROM driver with basic audio functions
38     - Ethernet driver
39     - Serial drivers
40     - SCSI Manager (old-style) emulation
41     - Emulates extended ADB keyboard and 3-button mouse
42     - Uses UAE 68k emulation or (under AmigaOS) real 68k processor
43    
44     The emulator is not yet complete. See the file "TODO" for a list of
45     unimplemented stuff.
46    
47    
48 cebix 1.3 Requirements and Installation
49     -----------------------------
50 cebix 1.1
51 cebix 1.3 Please consult the file "INSTALL" for a list of system requirements and
52     installation instructions.
53 cebix 1.1
54    
55     Configuration
56     -------------
57    
58     Basilisk II is configured via the preferences editor that appears on startup.
59     If you have a version without preferences editor (e.g. because of missing GTK+
60     under Unix), you have to edit the preferences file manually.
61    
62     The settings are stored in a text file:
63    
64     BeOS:
65     /boot/home/config/settings/BasiliskII_prefs
66    
67     Unix:
68     ~/.basilisk_ii_prefs
69    
70     AmigaOS:
71     ENV:BasiliskII_prefs
72    
73     Windows:
74     BasiliskII_prefs (in the same directory as the executable)
75    
76     If no preferences file is present, Basilisk II will create one with the
77     default settings upon startup.
78    
79    
80     Preferences File Format
81     -----------------------
82    
83     The preferences file is a text file editable with any text editor.
84     Each line in this file has the format "keyword value" and describes
85     one preferences item. For each keyword, the meaning of the "value"
86     string may vary across platforms. The following keywords exist:
87    
88     disk <volume description>
89    
90     This item describes one MacOS volume to be mounted by Basilisk II.
91     There can be multiple "disk" lines in the preferences file. Basilisk II
92     can handle hardfiles (byte-per-byte images of HFS volumes in a file on
93     the host system) as well as HFS partitions on hard disks etc. (but Basilisk
94     II doesn't know about MacOS partition tables; it relies on the host OS to
95     handle this). The "volume description" is either the pathname of a hardfile
96     or a platform-dependant description of an HFS partition or drive. If the
97     volume description starts with an asterisk ("*"), the volume is write
98     protected for MacOS (and the "*" is discarded).
99    
100     BeOS:
101     To specify an HFS partition, simply specify its path (e.g.
102     "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volume, Basilisk II
103     will search for and use all available HFS partitions.
104    
105     Unix:
106     To specify an HFS partition, simply specify its path (e.g.
107     "/dev/sda5").
108    
109     AmigaOS:
110     Partitions/drives are specified in the following format:
111     /dev/<device name>/<unit>/<open flags>/<start block>/<size>/<block size>
112     "start block" and "size" are given in blocks, "block size" is given in
113     bytes.
114    
115     Windows:
116     To define a logical volume (Windows NT only), specify its path (e.g. "c:\").
117     To define a physical volume (NT and 9x), additionally give the "physical"
118     keyword (E.g. "physical c:\"). For safety reasons, volumes are mounted as
119     read-only. This is due to the bugs in PC Exchange. If you don't specify
120     any volume, the files *.hfv and *.dsk are searched from the current
121     directory. Note that in this case, Basilisk II tries to boot from the first
122     volume file found, which is random and may not be what you want.
123    
124     floppy <floppy drive description>
125    
126     This item describes one floppy drive to be used by Basilisk II. There
127     can be multiple "floppy" lines in the preferences file. If no "floppy"
128     line is given, Basilisk II will try to automatically detect and use
129     installed floppy drives. The format of the "floppy drive description"
130     is the same as that of "disk" lines.
131    
132     cdrom <CD-ROM drive description>
133    
134     This item describes one CD-ROM drive to be used by Basilisk II. There
135     can be multiple "cdrom" lines in the preferences file. If no "cdrom"
136     line is given, Basilisk II will try to automatically detect and use
137     installed CD-ROM drives. The format of the "CD-ROM drive description"
138     is the same as that of "disk" lines.
139    
140     scsi0 <SCSI target> ... scsi6 <SCSI target>
141    
142     These items describe the SCSI target to be used for a given Mac SCSI
143     ID by Basilisk II. Basilisk II emulates the old SCSI Manager and allows
144     to assign a different SCSI target (they don't even have to be on the
145     same SCSI bus) for each SCSI ID (0..6) as seen by the MacOS. "scsi0"
146     describes the target for ID 0, "scsi1" the target for ID 1 etc.
147     The format of the "SCSI target" is platform specific.
148    
149     BeOS:
150     The "SCSI target" has the format "<bus>/<unit>" (e.g. "0/2").
151     Due to a bug in BeOS, using SCSI with Basilisk II may cause the
152     SCSI bus to hang. Use with caution.
153    
154     Linux:
155     The "SCSI target" has to be the name of a device that complies to
156     the Generic SCSI driver API. On a standard Linux installation, these
157     devices are "/dev/sg0", "/dev/sg1" etc. Note that you must have
158     appropriate access rights to these devices and that Generic SCSI
159     support has to be compiled into the kernel.
160    
161     FreeBSD:
162     The "SCSI target" has the format "<id>/<lun>" (e.g. "2/0").
163    
164     AmigaOS:
165     The "SCSI target" has the format "<device name>/<unit>" (e.g.
166     "scsi.device/2").
167    
168     Windows:
169 cebix 1.5 The "SCSI target" has the format <"Vendor"> <"Model"> (e.g.
170     scsi0 "HP" "CD-Writer+ 7100"). Note the use of quotes.
171 cebix 1.1
172     screen <video mode>
173    
174     This item describes the type of video display to be used by Basilisk II.
175     If you are using a Mac Classic ROM, the display is always 1-bit 512x342
176     and this item is ignored. The format of the "video mode" is platform
177     specific.
178    
179     BeOS:
180     The "video mode" is one of the following:
181     win/<width>/<height>
182     8-bit color display in a window of the given size. This is the
183     default.
184     scr/<mode>
185     Full-screen display in BWindowScreen. <mode> is the bit number of
186     the video mode to use (see headers/be/interface/GraphicsDefs.h).
187     E.g. 0 = 640x480x8, 1 = 800x600x8 etc., 10 = 640x480x24,
188     11 = 800x600x24 etc., 18 = 640x480x15, 19 = 800x600x15 etc.
189     15 bit modes are preferable to 16 bit modes (which may show false
190     colors on PowerPC machines).
191     When you run in full-screen mode and switch to another Workspace,
192     Basilisk II is put in "suspend" mode (i.e. MacOS will be frozen).
193    
194     Unix:
195     The "video mode" is one of the following:
196     win/<width>/<height>
197     Color display in an X11 window of the given size. The color depth
198     (8/15/24 bit) depends on the depth of the underlying X11 screen.
199     This is the default.
200 cebix 1.4 dga/<width>/<height>
201 cebix 1.1 Full-screen display using the X11 DGA extensions. The color depth
202     (8/15/24 bit) depends on the depth of the underlying X11 screen.
203 cebix 1.4 "width" and "height" specify the maximum width/height to use.
204     Saying "dga/0/0" means "complete screen". For DGA to work, Basilisk II
205     must be compiled with DGA support enabled (selectable in the configure
206     script).
207 cebix 1.1
208     AmigaOS:
209     The "video mode" is one of the following:
210     win/<width>/<height>
211     Black-and-white display in a window of the given size on the
212     Workbench screen. This is the default and will also be used when
213     one of the other options (PIP/screen) fails to open.
214     pip/<width>/<height>
215     15-bit truecolor display in a Picasso96 PIP. This requires
216     Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV).
217     scr/<hexadecimal mode ID>
218     8/15/24-bit fullscreen display on a Picasso96 screen with the given
219     mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer
220     format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or
221     xRGB 8:8:8:8). The screen size will be the default size for that
222     mode ID.
223    
224     Windows:
225     The "video mode" is one of the following:
226     win/<width>/<height>/<bits per pixel>
227     A refreshed screen mode that uses Windows GDI calls to write to the
228     screen. You may have other windows on top of Basilisk II.
229     dx/<width>/<height>/<bits per pixel>
230     A refreshed DirectX mode (minimum version 5.0). There are ways to
231     install DirectX 5 on NT 4. Some new display adapters work fine even
232     with DirectX 3.
233     fb/<width>/<height>/<bits per pixel>
234     A non-refreshed video mode that works only on NT. It accesses the
235     linear frame buffer directly (best performance of all three modes).
236     Use the hotkey Control-Shift-F12 to switch between Windows and Mac
237     displays. Fast task switch (Alt-Tab) and Explorer start menu
238     (Control-Esc) are disabled, Control-Alt-Del is enabled.
239     <width> and <height> can be either zeroes (uses current screen values),
240     or something else. "win" mode can use almost anything, for other modes
241     there must be a corresponding DirectX mode.
242     <bits> is ignored for mode "win" (uses current screen values).
243     If the mode is "win" and the dimensions are different than the desktop
244     dimensions, windowed mode is used. The window can be moved around by
245     dragging with the right mouse button. This mode remembers window positions
246     separately for different dimensions.
247     The supported values are 8,15,16,24,32. It is possible that some of them
248     do not work for you. In particular, it may be that only one of the
249     two modes, 15 and 16, is suitable for your card. You need to find out
250     the best solution by experimenting.
251     Basilisk II checks what display mode you are currently running and uses
252     that mode. The screen is always full screen. When you switch to another
253     application via Alt-Tab, Basilisk II is put in "snooze" mode (i.e. MacOS
254     is frozen).
255    
256     seriala <serial port description>
257    
258     This item describes the serial port to be used as Port A (Modem Port)
259     by Basilisk II. If no "seriala" line is given, Basilisk II will try to
260     automatically detect and use installed serial ports. The "serial port
261     description" is a platform-dependant description of a serial port.
262    
263     BeOS:
264     Either specify the name of a serial port (e.g. "serial1") or one of
265     "parallel1", "parallel2" or "parallel3". See below for more information
266     about parallel ports.
267    
268     Unix:
269     Specify the device name of a serial port (e.g. "/dev/ttyS0") or a
270     parallel "lp" port (e.g. "/dev/lp1"; this only works under Linux and
271     FreeBSD). See below for more information about parallel ports.
272    
273     AmigaOS:
274     You have to specify the name of the serial device and the device unit
275     as "<device name>/<unit>" (e.g. "serial.device/0"). If the given device
276     is not compatible to serial.device, Basilisk II will crash. If the
277     device name starts with an asterisk (e.g. "*parallel.device/0"), the
278     device is treated as a parallel.device compatible device. See below for
279     more information about parallel ports.
280    
281     Windows:
282     Specify "COM1" or "COM2" for com port 1 or 2, respectively.
283    
284     Parallel ports: If you select a parallel port it will look like a serial
285     port to MacOS but Basilisk II will only allow data output and ignore baud
286     rate settings etc. You should be able to get some printers to work with
287     this method (provided that you have the right printer driver, like
288     "Power Print" (see www.gdt.com)).
289    
290     serialb <serial port description>
291    
292     This item describes the serial port to be used as Port B (Printer Port)
293     by Basilisk II. If no "serialb" line is given, Basilisk II will try to
294     automatically detect and use installed serial ports. The format of the
295     "serial port description" is the same as that of the "seriala" option.
296    
297     ether <ethernet card description>
298    
299     This item describes the Ethernet card to be used for Ethernet networking
300     by Basilisk II. If no "ether" line is given, Ethernet networking is disabled
301     (although the Ethernet driver of Basilisk II will behave like a "dummy"
302     Ethernet card in this case). If you are using a Mac Classic ROM, Ethernet
303     is not available and this setting is ignored. The "ethernet card description"
304     is a platform-dependant description of an ethernet card.
305    
306     BeOS:
307     It doesn't matter what you give as "ethernet card description", Basilisk II
308     will always use the first Ethernet card it finds as long an an "ether"
309     line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net
310     net server add-on from SheepShaver, you can only use Ethernet on PowerPC
311     machines.
312    
313     Linux:
314     The "ethernet card description" is the name of an Ethernet interface.
315     There are two approaches to networking with Basilisk II:
316     1. Direct access to an Ethernet card via the "sheep_net" driver.
317     In this case, the "ethernet card description" must be the name
318     of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
319     driver to be installed and accessible. This approach will allow you
320     to run all networking protocols under MacOS (TCP/IP, AppleTalk, IPX
321     etc.) but there is no connection between Linux networking and MacOS
322     networking. MacOS will only be able to talk to other machines on
323     the Ethernet, but not to other networks that your Linux box routes
324     (e.g. a second Ethernet or a PPP connection to the Internet).
325     2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
326     In this case, the "ethernet card description" must be the name
327     of an ethertap interface, e.g. "tap0". It also requires that you
328     configure your kernel to enable routing and the ethertap device:
329     under "Networking options", enable "Kernel/User netlink socket" and
330     "Netlink device emulation", under "Network device support", activate
331     "Ethertap network tap". Next, see /usr/src/linux/Documentation/
332     networking/ethertap.txt for information on how to set up /dev/tap*
333     device nodes and activate the ethertap interface. Under MacOS,
334     select an IP address that is on the virtual network and set the
335     default gateway to the IP address of the ethertap interface. This
336     approach will let you access all networks that your Linux box has
337     access to (especially, if your Linux box has a dial-up Internet
338     connection and is configured for IP masquerading, you can access
339     the Internet from MacOS). The drawback is that you can only use
340     network protocols that Linux can route, so you have to install and
341     configure netatalk if you want to use AppleTalk.
342    
343     AmigaOS:
344     You have to specify the name of the SANA-II Ethernet device and the device
345     unit as "<device name>/<unit>" (e.g. "ariadne.device/0"). If the given
346     device is not a SANA-II device, Basilisk II will crash. If the device is
347     not an Ethernet device, Basilisk II will display a warning message and
348     disable Ethernet networking.
349    
350     rom <ROM file path>
351    
352     This item specifies the file name of the Mac ROM file to be used by
353     Basilisk II. If no "rom" line is given, the ROM file has to be named
354     "ROM" and put in the same directory as the Basilisk II executable.
355    
356     bootdrive <drive number>
357    
358     Specify MacOS drive number of boot volume. "0" (the default) means
359     "boot from first bootable volume".
360    
361     bootdriver <driver number>
362    
363     Specify MacOS driver number of boot volume. "0" (the default) means
364     "boot from first bootable volume". Use "-62" to boot from CD-ROM.
365    
366     ramsize <bytes>
367    
368     Allocate "bytes" bytes of RAM for MacOS system and application memory.
369     The value given will be rounded down to the nearest multiple of 1MB.
370     If you are using a Mac Classic ROM, the maximum available value is 4MB
371     and higher values will be ignored. The default is 8MB.
372    
373     frameskip <frames to skip>
374    
375     For refreshed graphics modes (usually window modes), this specifies
376     how many frames to skip after drawing one frame. Higher values make
377     the video display more responsive but require more processing power.
378     The default is "8".
379    
380     modelid <MacOS model ID>
381    
382     Specifies the Model ID that Basilisk II should report to MacOS.
383     The default is "5" which corresponds to a Mac IIci. If you want to
384     run MacOS 8, you have to set this to "14" (Quadra 900). Other values
385     are not officially supported and may result in crashes. MacOS versions
386     earlier than 7.5 may only run with the Model ID set to "5". If you are
387     using a Mac Classic ROM, the model is always "Mac Classic" and this
388     setting is ignored.
389    
390     nosound <"true" or "false">
391    
392     Set this to "true" to disable all sound output. This is useful if the
393     sound takes too much CPU time on your machine or to get rid of warning
394     messages if Basilisk II can't use your audio hardware.
395    
396     nocdrom <"true" or "false">
397    
398     Set this to "true" to disable Basilisk's built-in CD-ROM driver.
399     The only reason to do this is if you want to use a third-party CD-ROM
400     driver that uses the SCSI Manager. The default is "false".
401    
402     nogui <"true" or "false">
403    
404     Set this to "true" to disable the GUI preferences editor and GUI
405     error alerts. All errors will then be reported to stdout. The default
406     is "false".
407    
408     For additional information, consult the source.
409    
410    
411     System-specific configuration
412     -----------------------------
413    
414     Unix:
415    
416     keycodes <"true" or "false">
417     keycodefile <Keycode file path>
418    
419     By default, the X11 event handler in Basilisk II uses KeySyms to
420     translate keyboard event to Mac keycodes. While this method is very
421     compatible and ought to work with all X servers, it only works well
422     if your keyboard has a US layout. If you set "keycodes" to "true",
423     Basilisk II will use raw keycodes instead of KeySyms. The keycode
424     depends only on the physical location of a key on the keyboard and
425     not on the selected keymap. Unfortunately it depends on the X server
426     being used and possibly also on the type of keyboard attached. So
427     Basilisk II needs a table to translate X keycodes to Mac keycodes.
428     This table is read by default from /usr/local/lib/basilisk_ii_keycodes
429     unless you specify a different file with the "keycodefile" item.
430     A sample keycode file ("basilisk_ii_keycodes") is included with
431     Basilisk II.
432    
433     AmigaOS:
434    
435     sound <sound output description>
436    
437     This item specifies what method to use for sound output. The only choice
438     is currently AHI, but you can specify the AHI mode ID to be used. The
439     "sound output description" looks like this:
440    
441     ahi/<hexadecimal mode ID>
442    
443     Windows:
444    
445     noscsi <"true" or "false">
446    
447     Completely disables SCSI Manager support when set to "true".
448     Note that currently all SCSI operations are executed synchronously,
449     even if Mac application has requested asynchronous operation. What this
450     means is that the control is not returned to the application until the
451     command is completely finished. Normally this is not an issue, but when a
452     CDR/CDRW is closed or erased the burner program typically wants to wait in
453     some progress dialog The result may be that the application reports a
454     time-out error, but the operation completes all right anyway.
455    
456     nofloppyboot <"true" or "false">
457    
458     Set this to "true" to disable booting from a floppy.
459    
460     replacescsi <"Vendor1"> <"Model1"> <"Vendor2"> <"Model2">
461    
462     This command tricks the Mac to believe that you have a SCSI device Model2
463     from vendor Vendor2, although your real hardware is Model1 from Vendor1.
464     This is very useful since many devices have almost identical ATAPI and SCSI
465     versions of their hardware, and MacOS applications usually support the SCSI
466     version only. The example below is typical:
467    
468     replacescsi "HP" "CD-Writer+ 7100" "PHILIPS" "CDD3600"
469    
470     Note the use of quotes.
471    
472 cebix 1.5 rightmouse <0/1>
473 cebix 1.1
474 cebix 1.5 Defines what the right mouse button is used for. The default values of 0
475     means that it is used to move windowed mode BasiliskII screen.
476     Value 1 sends a combination Control and mouse click to the MacOS.
477     This may be useful under OS versions 8 and above.
478 cebix 1.1
479 cebix 1.5 keyboardfile <path>
480    
481     Defines the path of the customized keyboard code file.
482    
483     pollmedia <"true" or "false">
484    
485     If true (default), tries to automatically detect new media.
486     Applies to all "floppy", "cd" or "disk" removable media except
487     1.44 MB floppies. May cause modest slow down. If unchecked,
488     use Ctrl-Shift-F11 to manually mount new media.
489     If you have auto-insert notification (AIN) enabled, you may turn this
490     option off. Note that some CD related software require AIN,
491     and some other need it to be turned off. Consult the documentation
492     of your CD software to learn which one is optimal for you.
493    
494     framesleepticks <milliseconds>
495    
496     The amount of time between video frames.
497    
498     showfps <true/false>
499    
500     If true, the real frame rate is displayed.
501    
502     stickymenu <true/false>
503    
504     If true, the main menu bar is kept open even after the mouse button is released,
505     under all OS versions (OS 8 has this feature already). There are extensions to do
506     the same thing, but it's faster to handle this in native code.
507     Default is "true".
508 cebix 1.1
509     ntdx5hack <"true" or "false">
510    
511     You may need this on NT if your display adapter driver has a bug in DirectX
512     palette support. Black and white are reversed. It fixes the palette issue
513     by using GDI palette instead of D3D palette. Default is false.
514    
515    
516     Usage
517     -----
518    
519     Quitting:
520     The right way to quit Basilisk II is to select the "Shut Down" menu item
521     from the Finder's "Special" menu. You should not kill it from the shell
522     unless it hangs. Under Unix, pressing "Esc" while holding the Ctrl key will
523     also quit Basilisk II (in case you are using it in DGA mode and it crashed).
524     Under Windows, try Alt-F4 (or Control-Alt-Del to log off and back on again
525     if it crashes really badly).
526    
527     Suspending:
528     The Unix version of Basilisk II can be suspended while running in DGA mode
529     by pressing "Tab" while holding the Ctrl key. Pressing "Space" in the
530     "suspended" window will resume the emulation. Under BeOS, switching to
531     a different Workspace when BasiliskII is in full-screen mode will also
532     suspend the emulation.
533    
534     Keyboard:
535     On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
536     key is the Mac "Option" key.
537    
538     Floppy:
539     Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
540     flopyy disk changes might not be detected automatically. Under Linux, press
541     Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
542     item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
543    
544     HFS partitions:
545     Having HFS partitions mounted for read-write access under Basilisk II while
546     they are also mounted on the host OS will most likely result in volume
547     corruption and data losses. Unmount your HFS volumes before starting
548     Basilisk II.
549    
550     ZIP drives:
551     Iomega ZIP disks can be mounted either with the "disk" prefs item or (on
552     platforms that support the SCSI Manager emulation of Basilisk II) by
553     installing the IomegaWare on the Mac side. Do not use both ways
554     simultaneously!
555    
556     Hardfiles:
557     In addition to plain images of HFS volumes, Basilisk II can also handle
558     some types of Mac "disk image" files, as long as they are uncompressed
559     and unencoded.
560    
561     Mac Classic emulation:
562     Sound output and Ethernet are not supported if you are using a Mac Classic
563     ROM. Also, the video display is fixed to 512x342 in monochrome. The AmigaOS
564     and BeOS/PPC versions of Basilisk II cannot do Mac Classic emulation.
565    
566     Sound output:
567     Sound output under Basilisk II requires Sound Manager 3.0 or later. This
568     is included starting with MacOS 7.5 and available as a system extension
569     for earlier MacOS versions. Sample rate, bit resolution and mono/stereo
570     can be selected in the Sound control panel (section "Sound Out").
571    
572     Ethernet:
573     Basilisk II supports all Ethernet protocols. Running a protocol under
574     Basilisk II that already runs within the host operating system on the same
575     network card (e.g. running MacTCP under Basilisk II on a BeOS machine) may
576     or may not work (generally, it should work, but some specific things like
577     "ping" may not). If you have problems with FTP, try setting your FTP client
578     to passive mode.
579    
580     LocalTalk:
581     LocalTalk is not supported by Basilisk II. There is no way of getting
582     LocalTalk to work with the serial drivers of Basilisk II. Any attempt to
583     activate LocalTalk will either result in a crash or revert to Ethernet.
584    
585     Serial:
586     You can use the serial ports in Basilisk II to connect to the Internet
587     with a modem and "MacPPP".
588    
589    
590     Technical Documentation
591     -----------------------
592    
593     Please see the included file "TECH" for a technical overview of the emulator.
594    
595    
596     Acknowledgements
597     ----------------
598    
599     Contributions by:
600     - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
601     - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
602     and networking
603     - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
604     - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
605     - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
606     - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
607     - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
608     window support
609     - David Lawrence <davidl@jlab.org>: incremental window refresh code
610 cebix 1.6 - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
611     fbdev video code
612     - and others...
613 cebix 1.1
614     Special thanks to:
615     - Bernd Schmidt for letting me use his UAE 68k emulation
616     - Daniel Bobbert who printed dozens of pages from the THINK Reference for
617     me years ago
618     - All ShapeShifter and SheepShaver users and beta testers
619     - Apple Computer Inc., who made writing a Macintosh emulator a child's play
620    
621    
622     Bug reports
623     -----------
624    
625     You found a bug? Well, use the source, fix it and send the fix to
626     <Christian.Bauer@uni-mainz.de>
627     for inclusion in the next release of Basilisk II.
628    
629    
630     Author
631     ------
632    
633     You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug
634     reports, send fixes. Ports to other platforms are also very welcome.
635     Please contact me before you intend to make major changes to the source.
636     You might be working on something that I have already done or I may have
637     different ideas about the Right Way to do it.
638    
639     Questions about ROM files will not be answered. There is also no point in
640     sending me questions etc. that are specific to the Windows port of
641     Basilisk II. I don't have Windows and can't say anything about that.
642     Ask Lauri Pesonen instead.
643    
644    
645     Support
646     -------
647    
648     The official Basilisk II home page is at
649     http://www.uni-mainz.de/~bauec002/B2Main.html
650    
651     There is no user-level support for Basilisk II at the moment.
652    
653    
654     History
655     -------
656    
657 cebix 1.2 Please consult the file "ChangeLog" for the release history.
658 cebix 1.1
659    
660     Christian Bauer
661     <Christian.Bauer@uni-mainz.de>