home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 563.lha / SCSIMounter_v1.1 / scsimounter.doc.pp / scsimounter.doc
Text File  |  1991-11-10  |  15KB  |  448 lines
  1. SCSIMounter 1.1
  2. ===============
  3. (Document Revision 0.6)
  4.  
  5. Removable media partition mounter for Kickstart 2.0 or higher.
  6.  
  7.  
  8. ------------------------------------------------------------------------
  9. Version
  10. -------
  11.  
  12. 1.10 - ReadArgs() CLI Interface added
  13. 1.04 - Now works with beta kickstarts (V 36)
  14.        Keyboard equivalents for everything (including Listview)
  15.        Layout bug fixed
  16.        No funtional changes.
  17. 1.03 - Made more tolerant :-)
  18. 1.02 - Fix for gvpscsi.device (GVP Series II) added.
  19.  
  20.  
  21. ------------------------------------------------------------------------
  22. Disclaimer
  23. ----------
  24.  
  25. SCSIMounter may be freely distributed for non-commercial purposes only. 
  26. The entire risk as to the quality and performance of this program is 
  27. with you. 
  28.  
  29. The author assumes no responsibility or liability whatsoever with
  30. respect to your use or inability to use of this software.
  31.  
  32.  
  33. ------------------------------------------------------------------------
  34. Purpose
  35. -------
  36.  
  37. Most owners of removable media SCSI drives are stuck with the problem
  38. that their software doesn't handle disk changes correctly.
  39. For example, the current Commodore implementation doesn't mount the 
  40. partitions on a removable media SCSI drive (e.g. SyQuest or Ricoh)
  41. when there was no cartridge in the drive at boot time. 
  42.  
  43. Even worse, after another cartridge with a different Rigid Disk Block 
  44. (i.e. a different partition table) has been inserted, the system
  45. gets totally confused and reports read/write errors when trying
  46. to access the device which can lead to loss of important data on 
  47. the cartridge.
  48.  
  49. Until now, the only possibility to work around this problem was to
  50. reboot the system every time a new cartridge has been inserted.
  51.  
  52. SCSIMounter allows you to mount and unmount partitions without rebooting 
  53. the machine. It sports a nice 2.0-style point-and-click user interface
  54. that makes handling removable media a piece of cake.
  55.  
  56.  
  57. ------------------------------------------------------------------------
  58. Secondary use
  59. -------------
  60.  
  61. SCSIMounter can also be used to mount partitions that have intentionally
  62. not been mounted (e.g. the wb_1.3: partition on an A3000 when running 
  63. under 2.0). You don't have to create a mountlist for it! 
  64.  
  65.  
  66. ------------------------------------------------------------------------
  67. Requirements
  68. ------------
  69.  
  70. · Any Amiga with a SCSI host adaptor that supports the Commodore
  71.   RDB (Rigid Disk Block) and 'SCSI Direct' standards.
  72. · Kickstart 2.0 or higher (version 37.175 preferred)
  73.  
  74. The program has been tested on an A3000 with Commodore's scsi.device
  75. and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
  76. I see no reason why it shouldn't work on any other host adaptor. 
  77.  
  78. ! Since there are so many different host adaptors with devices that behave
  79. ! totally different, I need to know your experiences. Please don't hesitate
  80. ! to contact me in case of a problem with your controller card. I'll be 
  81. ! glad to fix the problem and send you a revised version of SCSIMounter.
  82.  
  83. The program may be of no use for owners of certain GVP controllers 
  84. which support removable media correctly (Though not all GVP software 
  85. might do so).
  86.  
  87.  
  88. ------------------------------------------------------------------------
  89. Before you begin
  90. ----------------
  91.  
  92. First, determine the name of the device driver of your hard disk 
  93. controller card. 
  94.  
  95.     Examples of popular controllers and their devices:
  96.  
  97.     manufacturer/controller           device
  98.     --------------------------------------------------
  99.     Commodore A590/A2091/A3000        scsi.device
  100.     Old GVP                           scsidev.device
  101.     GVP Series II                     gvpscsi.device
  102.     Supra SupraDrive                  harddisk.device
  103.     Advanced Storage Systems Nexus    nexus.device
  104.     Microbotics HardFrame             HardFrame.device
  105.     ICD AdSCSI                        icddisk.device
  106.     IVS Trumpcard Professional        ivs_scsi.device
  107.     --------------------------------------------------
  108.  
  109. Click once one the SCSIMounter icon and select 'Information' from the
  110. 'Icons' menu.
  111.  
  112. Add or change the following tool type:
  113.  
  114.     DEVICE=Name_of_your_scsi_device_here
  115.  
  116. for example if you use a HardFrame controller write:
  117.  
  118.     DEVICE=HardFrame.device
  119.  
  120. Don't add path names here, only the name of the device is required.
  121. Take care to capitalize the device name correctly (exec device names 
  122. are case sensitive!)
  123.  
  124. NOTE
  125.  
  126. SCSIMounter will not work with the Commodore A2090(A) controller card
  127. because this product does not support Commodore's own 'SCSI direct' and
  128. 'RDB' standards properly.
  129.  
  130.  
  131. ------------------------------------------------------------------------
  132. Start SCSIMounter
  133. -----------------
  134.  
  135. SCSIMounter can be used either from Workbench or from the CLI.
  136.  
  137.  
  138. * Workbench use
  139.  
  140.   Double click on the SCSIMounter icon. After a short time, a window
  141.   with a listview and three buttons will appear. If the window doesn't
  142.   appear several things could have gone wrong:
  143.  
  144.   · Do you use Kickstart 2.0 or higher?
  145.   · Did you specify and spell the name of your device driver correctly?
  146.   · Does your host adaptor support RDB?
  147.   · Is there any memory left on your system?
  148.  
  149.   Requesters will try to tell you the cause if SCSIMounter fails to run.
  150.  
  151.  
  152. * CLI use
  153.  
  154.   Type 'SCSIMounter gui device Name_of_your_scsi_device'
  155.   example:
  156.  
  157.   1> SCSIMounter gui device HardFrame.device
  158.  
  159.   If the 'gui' argument is not given, SCSIMounter will be started
  160.   in command line mode as described later in this document.
  161.  
  162.  
  163. ------------------------------------------------------------------------
  164. Panels
  165. ------
  166.  
  167. 1) Main panel
  168.  
  169.    The main panels shows all devices connected to the SCSI port with
  170.    information about their capacity and current status. The currently 
  171.    selected unit is higlighted.
  172.  
  173.    UNIT - This is the unit number of a SCSI device.
  174.           Up to seven devices can be connected to the SCSI bus
  175.  
  176.    DRIVE TYPE - Manufacturer and product specification
  177.  
  178.    REV. - Revision of Hardware, Firmware and ROM of device
  179.  
  180.    CAP. - Device capacity in Megabytes or Kilobytes
  181.  
  182.    STATUS - Current Status of device. If the device is busy or
  183.             not accessable due to the lack of media (if it's a
  184.             removable media drive) the status will be set to
  185.             'not ready'
  186.  
  187.    There are three 'action buttons' present:
  188.  
  189.    QUIT - Quit SCSIMounter
  190.  
  191.    UPDATE - Re-scan SCSI bus and update display
  192.  
  193.    MOUNT - Mount partitions on selected drive
  194.  
  195.    For every action buttons there's also a menu item with identical
  196.    function. All buttons have keyboard equivalents (marked with an
  197.    underscore in the label text). The listview can be scrolled using
  198.    the arrow up and arrow down keys on your keyboard rather than using
  199.    the mouse.
  200.  
  201.  
  202. 2) 'Partition Selector' panel
  203.  
  204.    This panel shows all available partitions and allows you to 
  205.    individually mount them.
  206.  
  207.    CHECKGADGETS - Determine if the particular partition should 
  208.                   be mounted or not.
  209.  
  210.                   checked: mount corresponding partition
  211.                   not checked: don't mount specified partition
  212.  
  213.  
  214.    Other partition Information on the partition selector -
  215.  
  216.           Number of Partition == keyboard equivalent
  217.  
  218.           Device name of partitions
  219.  
  220.           Size of partitions
  221.  
  222.           Dostype (FileSystem) of partition
  223.  
  224.              Examples of dostypes:
  225.  
  226.              DOS0 - Old filesystem partition
  227.              DOS1 - FastFileSystem partition
  228.              UNI1 - Unix boot partition
  229.              RESV - Reserved partition
  230.  
  231.    CANCEL - Go back to main panel, don't mount anything
  232.  
  233.    MOUNT - Unmount all currently mounted partitions on the selected
  234.            device and mount the new partitions (if any).
  235.  
  236.    UNMOUNT ALL - If this gadget is checked, SCSIMounter will try
  237.                  to unmount all partitions currently mounted on the
  238.                  selected unit. If there are locks on this device
  239.                  there will be a 'BUSY' icon on your Workbench screen.
  240.  
  241.                  WARNING:
  242.  
  243.                  This option can be dangerous if used with non-removable
  244.                  devices because it will unmount all partitions 
  245.                  including your boot partition (SYS:) forcing you to 
  246.                  reboot your computer. Use it with care!
  247.  
  248.  
  249. ------------------------------------------------------------------------
  250. Operation
  251. ---------
  252.  
  253. SCSIMounter is pretty self-explanatory. Nevertheless, here are some 
  254. basic operation procedures.
  255.  
  256. * Mount a new cartridge
  257.  
  258.   · Click on the listview entry of the desired device. (Make sure its
  259.     status is 'ready')
  260.  
  261.   · Click on the 'Mount' button
  262.  
  263.     The 'select partitions' panel will ask you which partitions to mount
  264.  
  265.   · Chosse the partitions you would like to mount
  266.  
  267.   · Make sure that the 'Unmount all' gadget is checked
  268.  
  269.   · Click on 'Mount' button on the partition selector panel
  270.  
  271.     SCSIMounter will automatically unmount all existing partitions
  272.     on the device and mount the new partitions.
  273.  
  274.  
  275. * Add a SCSI drive that was not present at boot time
  276.  
  277.   · Click on the 'Update' button
  278.  
  279.     The new drive's name and other information should appear in the 
  280.     listview
  281.  
  282.   · Click on the corresponding entry
  283.   · Click on the 'Mount' button
  284.  
  285.     and so on...
  286.  
  287.  
  288. * Mount a partition that has the automount flag not set
  289.  
  290.   · Click on the listview entry of the desired device. (Make sure its
  291.     status is 'ready')
  292.  
  293.   · Click on the 'Mount' button
  294.  
  295.   · On the partition selector panel, make sure the 'unmount all' check
  296.     gadget is *not* checked
  297.  
  298.   · Select 'Unselect All' from the 'Edit' menu or press 'Rt. Amiga-U'
  299.  
  300.   · Click on the check gadget of the partition(s) to mount
  301.  
  302.   · Click on the 'Mount' gadget or press 'Rt. Amiga-M'
  303.  
  304.  
  305. WARNING !!!
  306.  
  307.     Don't unmount your boot partition (where you system files live) or
  308.     you'll soon be forced to reboot you machine...
  309.  
  310.  
  311. ------------------------------------------------------------------------
  312. Keyboard Equivalents
  313. --------------------
  314.  
  315. * Requesters
  316.  
  317.   gadget         keystroke activation     menu shortcut
  318.   -------------------------------------------------------
  319.   OK             O                        Rt. Amiga-O 
  320.   Cancel         C                        Rt. Amiga-C
  321.  
  322.  
  323. * Main window & Project menu
  324.  
  325.   gadget         keystroke activation     menu shortcut
  326.   -------------------------------------------------------
  327.   About          none                     Rt. Amiga-A
  328.   Mount          M                        Rt. Amiga-M
  329.   Update         U                        Rt. Amiga-U
  330.   Quit           Q                        Rt. Amiga-Q
  331.   Listview up    Arrowkey up              none
  332.   Listview dowm  Arrowkey down            none
  333.  
  334.  
  335. * Partition Selector
  336.  
  337.   gadget         keystroke activation     menu shortcut
  338.   -------------------------------------------------------
  339.   Mount          M                        Rt. Amiga-M
  340.   Cancel         C                        Rt. Amiga-C
  341.   Select All     none                     Rt. Amiga-A
  342.   Unselect All   none                     Rt. Amiga-U
  343.   Partitions     0-9                      none
  344.  
  345.  
  346. ------------------------------------------------------------------------
  347. Command Line Use
  348. ----------------
  349.  
  350. For the advanced user, SCSIMounter can be used in command line mode 
  351. by specifying all required arguments on the command line. In CLI mode, 
  352. it is not possible to individually select partitions. All partitions on 
  353. the particular unit will be mounted.
  354.  
  355. SCSIMounter supports 2.0-style ReadArgs() CLI options. The command 
  356. template looks like that:
  357.  
  358. D=DEVICE/K/A,U=UNIT/N,N=NOUNMOUNT/S,GUI/S,QUIET/S
  359.  
  360. DEVICE    - Specifies the device used for you hard drive controller
  361.             e.g. scsi.device.
  362.             This argument is always required.
  363.  
  364. UNIT      - Specifies the SCSI unit number of the drive to be mounted.
  365.             e.g. 6
  366.             This argument is not required if the 'gui' option is used.
  367.  
  368. NOUNMOUNT - If this switch is set, SCSIMounter will not unmount old
  369.             partitions. It basically works the same as the 'Unmount All'
  370.             checkgadget in the 'partition selector' panel. If you're
  371.             mounting removable cartridges, use this option with care!
  372.  
  373. GUI       - If this keyword is used, SCSIMounter will open its
  374.             'unit selector' panel as if it was started from Workbench.
  375.             
  376. QUIET     - Don't output information on selected unit and mounted
  377.             partition but output fatal error messages. Ideal for use 
  378.             in shell scripts
  379.  
  380. Examples:
  381.  
  382. 1> scsimounter device HardFrame.device unit 6 quiet
  383.  
  384. (mounts all partitions on SCSI unit 6 connected to a HardFrame 
  385. controller and is quiet about device and partitions)
  386.  
  387. 2> scsimounter d scsi.device u 3
  388. Unit Drive Type                  Rev.    Cap.  Status
  389. 3    SyQuest   SQ555             FGJ     43 M  ready
  390. Unmounting device: sq0                              
  391. Mounting device  : sq0
  392.  
  393. (mounts all partitions on SCSI unit 3 connected to a Commodore
  394. A590/A2091/A3091 controller and unmounts old partitions on the
  395. same unit. Outputs full device abd partition information)
  396.  
  397.  
  398. ------------------------------------------------------------------------
  399. Known Problems
  400. --------------
  401.  
  402. · The program only removes the dos entries for the volumes and devices.
  403.   It doesn't remove the filesystem process and associated memory 
  404.   allocations. Apparently the current FS doesn't support the ACTION_DIE
  405.   packet. I'm still looking for a legal way to solve this problem.
  406.  
  407.  
  408. ------------------------------------------------------------------------
  409. Credits
  410. -------
  411.  
  412. Author: Martin A. Blatter
  413.         Pfaffächerstr. 59
  414.         CH-8913 Ottenbach
  415.         Switzerland
  416.  
  417. Work address: Relog AG
  418.               Attn: Martin A. Blatter
  419.               Bruggerweg 2
  420.               CH-8037 Zurich
  421.               Switzerland
  422.  
  423.               (Relog AG develops high quality software for the
  424.               Amiga computer. Watch out for 'TopScan' and 
  425.               'FontDesigner'!)
  426.  
  427. E-Mail: blatter@ifi.unizh.ch
  428.         blatter@amiga.physik.unizh.ch
  429.         cbmvax!cbmehq!cbmswi!zethos!blatter
  430.  
  431. Bug reports or suggestions are welcome. If you find this program useful,
  432. feel free to send a donation to the above address.
  433.  
  434. This program uses Relog's ITools(tm), the object-oriented user interface 
  435. system (c) 1991 by Christian A. Weber and Relog AG.
  436.  
  437. Special thanks to  · Christian A. Weber
  438.                    · Peter Simeon for the SCSI inquiry code
  439.  
  440. ------------------------------------------------------------------------
  441. Trademarks
  442. ----------
  443.  
  444. All trademarked product and company names used herein are used for
  445. identification purposes only. No infringement of trademarks is intended.
  446. Trademarks remain property of the trademark holder.
  447.  
  448.