Provisional ReadMe for CDFaker (CDFSSoftFakerAW)
================================================

This is a beta release of CDFaker, a small module capable of
simulating a CD drive by providing a softloadable CDFS driver.

Only single session Data CDs with 2048 bytes/sector can be
simulated.

Originally, this module was written by Andy Armstrong. It was
converted to 26/32bit neutral code by Steffen Huber of
hubersn Software. The module is freeware. During beta status,
source is only available on request.

The new release is also capable of mounting image files - this
might be interesting for people using CDFS and CDROMFS side
by side. CDROMFS automatically registers an image filing system
for files of type &DF6 - whenever CDROMFS was running, it was
impossible to mount an image with CDFaker because it only
accepted plain files and identified any image file as a directory.

Usage
-----

Just run the module (you need an unused CDFS drive for that - configure
it either via the CDFSFiler icon (old RISC OS versions) or via
*configure CDROMDrives x or via !Configure) and double click on an
ISO9660 file which is filetyped &DF6. CDFaker keeps the file open all
the time - do a
*cdfaker_dismount 0
to correctly dismount the image file.

You can also mount "by hand" using
*cdfaker_mount 0 <filename>

If things go wrong, you can always reinitialize CDFS from the command
line - it is only important to do it in the right order:
- reinitialize all CDFSSoft modules you need
- reinitialize CDFSdriver
- reinitialize CDFS

Via
*cdfaker_drives n
you can configure more than one drive for CDFaker to simulate. Remember
to keep enough "empty" CDFS drives ready for CDFaker to take over. After
issuing cdfaker_drives, you need to reinititialze CDFS (see above).

The speed emulation stuff has not been tested at all.

Have fun,
Steffen Huber, hubersn Software
Send feedback to: steffen@hubersn-software.com
