home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / disk / RDBFlags-1.3.lha / RDBFlags.doc < prev    next >
Text File  |  1995-04-07  |  9KB  |  247 lines
  1.  
  2.  
  3.                             Welcome to RDBFlags!
  4.                            ======================
  5.  
  6.  
  7.                 Copyright ⌐ 1994,1995 by Andreas M. Kirchwitz
  8.                              Seesener Stra▀e 69
  9.                            D-10709 Berlin, Germany
  10.                    UUCP/Internet: amk@zikzak.in-berlin.de
  11.  
  12.  
  13.            Thanks to Ralph Babel (author of "The Amiga Guru Book")
  14.                             and Matthias Scheler.
  15.  
  16.  
  17.                This program is freely distributable giftware.
  18.                        Send me a gift if you like it.
  19.  
  20.  
  21.  
  22. This program lets you modify various flags in the RDB (Rigid Disk Block) of
  23. your harddisk drives. It has no GUI and it doesn't restrict you in making
  24. your harddisk a "totally useless piece of shit". So be careful!
  25.  
  26. It's absolutely harmless to call "RDBFlags" without any arguments or just
  27. with an alternative device name or unit number: the program will only read
  28. your RDB (if existing) and show its flags. Nothing will be modified.
  29.  
  30. Read this manual carefully! Most of this program's options change flags in
  31. the RDB of your harddisk. Some options are dangerous because you can make
  32. your drive inaccessable (at least with your current driver software). Then it
  33. may help to set some jumpers on the harddisk to ignore the RDB settings, but
  34. better don't count on that. Other options are less dangerous because they can
  35. be set back easily if something won't work.
  36.  
  37. Your harddisk driver software may not support all flags you can set in the
  38. RDB. So, don't despair if nothing special happens after a reboot ;-)
  39.  
  40. "RDBFlags" validates the RDB checksum as well as the sector size (also know
  41. as block size) in various ways. If your RDB doesn't pass the validity checks
  42. successfully, "RDBFlags" does nothing.
  43.  
  44. "RDBFlags" is pure (p-Flag set), thus it can be made resident. It requires
  45. AmigaOS 2.0 (or higher).
  46.  
  47.  
  48.  
  49. Options? Ah... options! Call "RDBFlags ?" for a list of available options.
  50. These are the harmless options. Nothing will be changed. "RDBFlags" will just
  51. show you the current settings stored in the RDB.
  52.  
  53.  
  54.     Device=<device>
  55.     ---------------
  56.  
  57.         Specify the driver software (device) for the harddisk.
  58.         The default is "scsi.device", eg, for A2091 and A3000's
  59.         internal controller.
  60.  
  61.         You're not limited to SCSI. IDE and other controllers
  62.         will work as well if they support Commodore's RDB standard.
  63.  
  64.  
  65.     Unit=<number>
  66.     -------------
  67.  
  68.         Specify the unit number of the harddisk you want to access.
  69.         The default is unit "0".
  70.  
  71.  
  72.     SectorSize=<number>
  73.     -------------------
  74.  
  75.         If your old driver software doesn't support the command
  76.         TD_GETGEOMETRY to read the actual sector size (also known
  77.         as block size) from the drive, this option let's you specify
  78.         the sector size in bytes. The default is 512 bytes.
  79.  
  80.         In case that TD_GETGEOMETRY fails, RDBFlags outputs a
  81.         warning message (with error condition) but continues to
  82.         work. Use this option to set the sector size manually.
  83.  
  84.         This option is ignored if TD_GETGEOMETRY succeeds.
  85.  
  86.  
  87.  
  88. The following options may change your RDB but it should be possible to
  89. restore the old settings (eg, with "RDBFlags" on a bootable floppy disk) if
  90. something goes wrong.
  91.  
  92.  
  93.     LastDisk or NoLastDisk
  94.     --------    ----------
  95.  
  96.         Maybe the most useful option of this program. This flag
  97.         signals the driver software to abort the scanning of further
  98.         units and to boot now.
  99.  
  100.         Though this program is not limited to SCSI host adapters
  101.         (it also works with IDE controllers if they support RDB)
  102.         this is a typical SCSI scenario:
  103.  
  104.         When the Amiga boots, the driver checks all SCSI addresses
  105.         (from 0 to 7) for drives. Some drivers will "hang" for
  106.         a remarkable period of time when scanning drives that
  107.         support removable media and no medium is currently present
  108.         (eg, SyQuest and CD-ROM drives).
  109.  
  110.         For example, on the A3000's internal host adapter, the trick
  111.         is quite simple (to avoid waiting):
  112.  
  113.         Assign the lower SCSI addresses to the drives that respond
  114.         very quicky (eg, harddisks) and the higher numbers to the
  115.         drives that may be very slow (eg, SyQuest, CD-ROM).  Then
  116.         set the "LastDisk" flag on the last "quick" drive you have.
  117.         This way all SCSI targets AFTER this drive (with a higher
  118.         SCSI address) will not be mounted automatically at boot-time.
  119.         You can add these drives later (when you need them) with
  120.         "Mount" (eg, CD-ROM) or programs like "SCSIMounter" (eg,
  121.         SyQuest) by Martin A. Blatter.
  122.  
  123.         BTW: From AmigaOS 3.1 on the internal host adapter of the
  124.         A3000 doesn't really need "LastDisk" anymore because CBM's
  125.         scsi.device will skip those "slow" drives very quickly.
  126.  
  127.         Some SCSI host adapters (or their driver software) don't
  128.         scan SCSI addresses sequentially, so "LastDisk" will have
  129.         a somewhat different meaning.  It's not guaranteed that
  130.         all drives will be mounted which have a smaller address
  131.         than the drive with "LastDisk" set in its RDB.
  132.  
  133.         Recapitulating, the "LastDisk" flag just means:
  134.  
  135.         When scanning (and trying to automount) drives at boot-time,
  136.         then stop scanning and boot immediately if the "LastDisk"
  137.         flag is found in a disk's RDB.  In general, no assumptions
  138.         can be made about the state of the other drives (but this
  139.         depends on your driver software).
  140.  
  141.         So you might want to experiment a little bit with this
  142.         flag to fit your needs.  Some driver software treats
  143.         "LastDisk" and "LastTarget" as equal (although they are
  144.         not), so think about it when experimenting ;-)
  145.  
  146.  
  147.     LastTarget or NoLastTarget
  148.     ----------    ------------
  149.  
  150.         If the "LastTarget" flag is set on a drive, no further
  151.         SCSI targets will be scanned. The meaning of this flag
  152.         is not absolutely clear; at first sight it looks similar
  153.         to the "LastDisk" flag, but it isn't.
  154.  
  155.         Some people say this flag is for buggy drives that
  156.         respond to all SCSI addresses. It's obvious that you
  157.         can only use exactly one such drive on the SCSI bus.
  158.  
  159.         Maybe it's a good idea to don't use it at all ;-)
  160.  
  161.  
  162.  
  163. Other useful utilities (not only in case of problems or failure) are
  164. "SetBatt" (modify battery memory in A3000, by Andreas M. Kirchwitz) and
  165. "SCSIMounter" (mount/update devices after boot-time, by Martin A. Blatter).
  166.  
  167. Okay, and now for some more options ...
  168.  
  169. The following options may change your RDB and are VERY DANGEROUS because they
  170. could make your harddisk unusable. Use only if you know for sure that your
  171. harddisk supports it.
  172.  
  173.  
  174.     LastLun or NoLastLun
  175.     -------    ---------
  176.  
  177.         Each SCSI target (0-7, except for the host adapter) is
  178.         subdivided into logical unit numbers (LUN 0-7).
  179.  
  180.         If the "LastLun" flag is found on a disk, the driver
  181.         software will not search for LUNs (logical unit numbers)
  182.         greater then the current one (on this SCSI target).
  183.  
  184.         For drives with only one logical unit the "LastLun" flag is
  185.         typically set in the RDB of the disk with LUN 0.
  186.  
  187.         This flag is similar to "LastDisk", except that "LastLun"
  188.         marks the last LUN on one SCSI target (and not the last
  189.         SCSI target on the SCSI bus).
  190.  
  191.  
  192.     Reselect or NoReselect
  193.     --------    ----------
  194.  
  195.         Reselection is useful for slow drives or actions that will
  196.         take a long time to execute (eg, CD-ROMs). It allows the
  197.         drive to disconnect from the bus, do its job and finally
  198.         reconnect to the bus when its done. In the meantime the bus
  199.         is free for other tasks.
  200.  
  201.         If your driver software or your drive doesn't support
  202.         Reselection (disconnect/reconnect) correctly, then set
  203.         the "NoReselect" flag so that the driver software doesn't
  204.         ask for Reselection when talking to this drive.
  205.  
  206.  
  207.     Sync or NoSync
  208.     ----    ------
  209.  
  210.         Maybe the most dangerous option of this program. With this
  211.         flag you can set for each drive individually if it supports
  212.         synchronous transfer or not. If "NoSync" is set, the "slow"
  213.         (but by all drives supported) asynchronous transfer is used.
  214.  
  215.         "So why is it dangerous", you may ask.  Now, some drives
  216.         that don't support sync transfer will not just say, "hey,
  217.         I don't support sync, let's talk async." They'll just hang.
  218.         Totally inaccessable until next reboot. But with the "Sync"
  219.         flag set in the RDB the driver software will ALWAYS ask for
  220.         sync at boot-time, so the drive will always hang. You will
  221.         NEVER reach a state to clear the "Sync" flag in the RDB,
  222.         if you don't have a host adapter that allows you to ignore
  223.         the RDB settings temporarily.
  224.  
  225.         Set "Sync" only if you KNOW FOR SURE that the drive supports
  226.         synchronous transfer. Elsewhere, you may lose the contents
  227.         of your drive.
  228.  
  229.         This is not supported by all drives and driver software,
  230.         so you may not notice any difference.  Some host adapters
  231.         only allow to toggle synchronous/asynchronous transfer
  232.         globally for all drives (eg, A3000 with its internal
  233.         battery memory).
  234.  
  235.  
  236.  
  237. History
  238. -------
  239.  
  240. 1.2    initial release
  241. 1.3    option "SectorSize" overrides dg_SectorSize from TD_GETGEOMETRY
  242.     (even if TD_GETGEOMETRY returns no error) because some drivers
  243.     don't set dg_SectorSize correctly
  244.  
  245.  ___________________________________________________________________________
  246. |___________________________________________________END_TRANSMISSION________)
  247.