SCSIMounter 0.9
===============

Removable media partition mounter for Kickstart 2.0 or higher.


------------------------------------------------------------------------
Disclaimer
----------

SCSIMounter is Public Domain. It may be freely distributed for non-
commercial purposes only. The entire risk as to the quality and 
performance of this program is with you. 

The author assumes no responsibility or liability whatsoever with
respect to your use or inability to use of this software.


------------------------------------------------------------------------
Purpose
-------

Most owners of removable media SCSI drives are stuck with the problem
that their SCSI software doesn't handle disk changes correctly.
For example, the current Commodore implementation doesn't mount the 
partitions on a removable media SCSI drive when there was no cartridge 
in the drive at boot time. 

Even worse, after another cartridge with a different Rigid Disk Block 
(i.e. a different partition table) has been installed, the system
gets totally confused and reports read/write errors when trying
to access the device which can lead to loss of important data on 
the cartridge.

Until now, the only possibility to work around this problem was to
reboot the system every time a new cartridge has been inserted.

These times are gone now - thanks to SCSIMounter.

SCSIMounter allows you to mount and unmount partitions without rebooting 
the machine. It sports a nice 2.0-style point-and-click user interface
that makes handling removable media a piece of cake.


------------------------------------------------------------------------
Requirements
------------

- Any Amiga with a SCSI host adaptor that supports the Commodore
  RDB (Rigid Disk Block) standard.
- Kickstart 2.0 or higher

The program has been tested on an A3000 with Commodore's scsi.device
and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
I see no reason why it shouldn't work on any other host adaptor (let
me know your experiences, please).

The program may be of no use for owners of a GVP Series II controller
board because of its much smarter software.


------------------------------------------------------------------------
Before you begin
----------------

First, determine the name of the device driver of your hard disk 
controller card. 

    Examples of popular controllers and their devices:

    manufacturer/controller           device
    --------------------------------------------------
    Commodore A590/A2091/A3000        scsi.device
    Old GVP                           scsidev.device
    Supra SupraDrive                  harddisk.device
    Advanced Storage Systems Nexus    nexus.device
    Microbotics HardFrame             HardFrame.device
    ICD AdSCSI                        icddisk.device
    IVS Trumpcard Professional        ivs_scsi.device
    Silicon Peace extam               scsi.device

Click once one the SCSIMounter icon and select 'Information' from the
'Icons' menu.

Add or change the following tool type:

    DEVICE=Name_of_your_scsi_device_here

for example if you use a HardFrame controller write:

    DEVICE=HardFrame.device

Don't add path names here, only the name of the device is required.
Take care to capitalize the device name correctly (exec device names 
are case sensitive!)


------------------------------------------------------------------------
Start SCSIMounter
-----------------

SCSIMounter can be used either from Workbench or from the CLI.


* Workbench use

  Double click on the SCSIMounter icon. After a short time, a window
  with a listview and three buttons will appear. If the window doesn't
  appear several things can be wrong:

  - Do you use Kickstart 2.0?
  - Did you specify and spell the name of your device driver correctly?
  - Does your host adaptor support RDB?
  - Is there any memory left on your system?

  Requesters will tell you the cause if SCSIMounter fails to run.


* CLI use

  Type 'SCSIMounter Name_of_your_scsi_device'
  example:

  1> SCSIMounter HardFrame.device

  If no argument is given, SCSIMounter uses the default device driver
  (scsi.device)


------------------------------------------------------------------------
Operation
---------

SCSIMounter is pretty self-explanatory. Nevertheless, here are some 
basic operation procedures.

* Mount a drive

  - Click on the listview entry of the desired device.
  - Click on the 'Mount' button

    A requester will ask you if you want to continue.

  - Click 'Ok'

    SCSIMounter will automatically unmount all existing partitions
    on the device and mount the new partitions.


* Add a drive

  - Click on the 'Update' button

    The new drive's RDB should appear in the listview

  - Click on the corresponding entry
  - Click on the 'Mount' button


------------------------------------------------------------------------
Keyboard Equivalents
--------------------

* Requesters

  OK             Rt. Amiga-O
  Cancel         Rt. Amiga-C


* Main window & Project menu

  About          Rt. Amiga-A
  Mount          Rt. Amiga-M
  Update         Rt. Amiga-U
  Quit           Rt. Amiga-Q


------------------------------------------------------------------------
Known Bugs
----------

- The program only removes the dos entries for the volumes and devices.
  It doesn't remove the filesystem process and associated memory 
  allocations. I'm still looking for a legal way to solve this problem
  for the 1.0 release.

- The program requires at least 8k stack.


------------------------------------------------------------------------
Credits
-------

Author: Martin A. Blatter
        Pfaffächertsr. 59
        CH-8913 Ottenbach
        Switzerland

E-Mail: blatter@ifi.unizh.ch
        blatter%zethos@cbmswi.commodore.com

Phone:  ++41 1 761 20 02

Bug reports, suggestions or contributions are welcome.

This program uses ITools, the object-oriented user interface system
(c) 1991 by Christian A. Weber.

Special thanks to: Christian A. Weber, Claudio Nieder, Peter Simeon
                   and Urban Dominik Mueller.


------------------------------------------------------------------------
Trademarks
----------

All trademarked product and company names used herein are used for
identification purposes only. No infringement of trademarks is intended.
Trademarks remain property of the trademark holder.

