****************************************************************
* WARNING: This file contains partially outdated information.
* More current information is available in the /etc/molrc file.
****************************************************************

==================================
How to use your IDE disk with MOL.
==================================

In order to use an IDE disk with MOL, an image of a SCSI driver is 
required. The following procedure will construct such an image
(unfortunately it would be a violation of Apple's software license 
to bundle it directly with MOL).

Note 1: For an alternative to the procedure below,
refer to the SCSI-driver document.

Note 2: The information in this document also applies
to SCSI disks (Some SCSI drivers are incompatible with MOL
but can be used if the driver below is constructed).


Step 1. 
=======

Download the following files from Apple's software update archive
(preferably in MacOS):

	"Disk Tools PPC.img" 
	"Disk Copy 6.3.3" 

FTP links to the files:

	<ftp://ftp.info.apple.com/Apple_Support_Area/Apple_Software_Updates/English-North_American/Macintosh/System/Mac_OS_8.1_Update/Disk_Tools_PPC.img.bin>

	<ftp://ftp.info.apple.com/Apple_Support_Area/Apple_Software_Updates/English-North_American/Macintosh/Utilities/Disk_Copy/Disk_Copy_6.3.3.smi.bin>


Step 2.
=======

Convert (the unpacked) disk tools image with Disk Copy
(by selecting "Convert Image..." from the Image menu). You'll be 
prompted for the target format. Specify "Read-only" and "1.4 MB floppy".
Note that there is an 1.4 MB option lacking "floppy". This format 
will NOT work.


Step 3:
=======

Copy the converted floppy image to linux. Make sure
it is transfered as a binary. Place it in the
the images/ folder (normally /usr/lib/mol/images) 
named "disk_tools.floppy".


Step 4:
=======

Give the following shell command:

	bash$ dd if=/dev/zero of=scsi_driver bs=1024 count=400

This command creates a 400K file "scsi_driver". Place
this file in the drivers/ folder.


Step 5:
=======

Edit the molrc as follows:

1. Comment out all "scsi_disk" entries EXCEPT the line.

	scsi_disk:      0  -hw -nodrvr -empty

2. Add the line

	scsi_disk:	4  drivers/scsi_driver -nopar -rwall -hw
	floppy1:	images/disk_tools.floppy


Step 6:
=======

Start MOL. System 8.1DT should now boot from floppy.
Launch "Drive Setup Lite". You should now see the following:

	<not mounted>		... id 0
	<not initialized>	... id 4

Select the id 4 entry and press the initialize button.
Choose "Custom Setup...". Change partition scheme from 
"Current Partition" to "1 Partition". Alter the volume type
from "MacOS standard" to "Unallocated". Press OK and finally
initialize the disk.

Drive Setup will report that the initialization failed. This
can be safely ignored (it is the mounting that fails since
we partitioned without a HFS volumes).

Shutdown MacOS.


Step 7
======

Make the following changes to the molrc file:

Change the line

	scsi_disk:	4  drivers/scsi_driver -nopar -rwall -hw
to
	scsi_driver:	drivers/scsi_driver

Export the volumes you wish to use with mol. For example

scsi_disk:	1   /dev/hda6	-rw
scsi_disk:	2   /dev/hda7	-rw
scsi_disk:	3   /dev/hdb5	-rw

The above example tells MOL to mount the HFS partitions
/dev/hda6, /dev/hda7 and /dev/hdb5. It is also possible
to export all HFS partitions on /dev/hda by adding a line 
like

scsi_disk:	4   /dev/hda	-rw

This will export all partitions (including linux partitions!).
Only HFS volumes will be read/write though. If linux has
mounted any of the HFS volumes on /dev/hda, then MOL will
force read-only access on ALL partitions.
