home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d4xx / d461 / dfrags.lha / DFrags / dfrags.docs < prev    next >
Text File  |  1991-03-08  |  11KB  |  255 lines
  1.  
  2.           Disk Fragmentation Report Version 2.00
  3.                  ©1990 Custom Services
  4.  
  5. General:
  6.  
  7.   This utility will read all the disk devices on your system and analyze the
  8. BitMap for each partition(this is default).  If the options are selected
  9. It will also analyze the file system on each partition.  The result for 
  10. the analysis will be the number of fragments on the disk(BitMap), and 
  11. file system(if selected).  Several options exist to control how much is
  12. reported.  This is a CLI only utility.  
  13.  
  14.   This utility is released into the public domain as shareware.  If you
  15. find it useful, please send the basic registration fee to Custom Services.
  16. The Options for registration are:
  17.  
  18.  Amount |   Fee    |   Service
  19.  -------+----------+-------------------------------------------------------
  20.    $5   |  Basic   | Basic Registration fee, everyone must send this!
  21.  -------+----------+------------------------------------------------------
  22.    $5   |  Updates | Update fee for future version if I supply disk
  23.  -------+----------+------------------------------------------------------
  24.    $3   |  Updates | Update fee for future version if you send a disk 
  25.  -------+----------+------------------------------------------------------
  26.  Send $5 for the basic registration plus $5 for updates will get you a
  27. copy of the next version of this program.  I will supply the disk.  Sending
  28. $5 plus $3 will get you notification of updates.  I include all my shareware
  29. utilities on the disk.
  30.  
  31.  Please send all registration and update fees of your choice to:
  32.  
  33.     Custom Services
  34.     P. O. Box 254
  35.     Moorestown, NJ 08057
  36.  
  37. Compatibility:
  38.  
  39.   This program is compatible with 1.3 and 2.xx versions of the operating
  40. system.  It has been tested with both operating systems.  It should work
  41. with any disk drive(either hard drive or floppy).
  42.  
  43. Now and the Future:
  44.  
  45.   The future plans are to include additional file system/BitMap validity
  46. checks.  The bitmap may have blocks flagged as used when they are not or
  47. blocks used but not flagged.  These checks will catch these situations.
  48. Currently, the root block is partially validated and the file system is
  49. only checked for a few sanity checks.  The Version 2.0 release includes
  50. a complete file system verify that will check file data, hash indeces, and
  51. parent pointers.  This version is a CLI only.
  52.  
  53. Command:
  54.  
  55.             DFRAGS   <Options> <Single device>
  56.  
  57. Single device is an optional device/partition specification.  If you give
  58. DFRAGS a device, it will only check that device.  If this is not present,
  59. all devices will be checked.  The device may have a colon ":" on the end
  60. as in "DF0:", or it can be left out as in "DH0".  
  61.  
  62.  
  63. Options:
  64.  
  65.   By default all the options are off.  There are the following command
  66. options:
  67.  
  68.   -D     Verbose Debug option.  Every I/O will include the block(key)
  69.          number and the buffer address for example.  Every memory
  70.          allocation will display the size, buffer address and what
  71.          memory available after the allocation.  This information is
  72.          mostly for my purposes.  If you should have a problem, this
  73.          option may help you locate bad blocks.
  74.  
  75.   -R     Report file allocation information.  This option will display the
  76.          block numbers used for the root, directories and the files.  The
  77.          sector information that is not zero is printed.  It will print the
  78.          BitMap data also.  It is important to note, that in a BitMap block
  79.          all the data is not used(in the last block).  The file system does
  80.          not zero out those unused bits, they will generally be garbage.
  81.  
  82.   -Z     Report file allocation and zeros.  This option is the same as the
  83.          "-R" option except that zeros are printed.  The data is printed
  84.          exactly as in the sector.
  85.  
  86.   -F     Check File Fragmentation.  This option will cause the file system
  87.          to be traversed.  Each file is checked for contiguous disk blocks.
  88.          This option will cause the tested devices to have the file
  89.          fragmentation totaled and reported.  -O, -I, or -V imply -F.
  90.  
  91.   -I     Display individual files.  This option requests the file
  92.          fragmentation be reported on a file by file basis.  This option 
  93.          implies the "-F" option.
  94.  
  95.   -O     Assume the 1.3 file system.  There is a difference in the way that
  96.          the 1.3 file systems allocate files versus the 2.xx file system.
  97.          The 1.3 file system will allocate the first block of a file in one
  98.          area and the rest in another.  This option will remove one
  99.          fragment from the file total.  Under 2.xx the file system is a bit
  100.          better, attempting to allocate a file in one contiguous area. This
  101.          option implies the "-F" option.
  102.  
  103.   -V     This option causes additional checks to occur.  This implies the
  104.          "-F" option for file system checking.  The datablocks of all files
  105.          are read to ensure readability.  This option will slow things down
  106.          because it creates a lot of additional I/O operations.  With this
  107.          option on, every file is read from beginning to end as they are 
  108.          found on the disk.  This will verify that everything is current.
  109.  
  110.   These options are all off by default.  This means that just typing in
  111. the command "DFRAGS" will give you all devices/partitions bitmap 
  112. fragmentation without file data checks.  To get the maximum information
  113. use: DFRAGS -Z -V -D.  The "-D" should not be used for "normal" situations,
  114. I recommend the command: DFRAGS -O -V for 1.3, and DFRAGS -V for 2.xx.              
  115. This will give you a report on file fragmentation with the most integraty
  116. checks.  To see the individual files that are fragmented, just add the -I
  117. option.
  118.  
  119. Error Messages:
  120.  
  121.      ^C - ***Break***   
  122.  
  123.      You entered a ^C and can abort or continue.
  124.  
  125.  
  126.      No Memory available for disk buffers
  127.  
  128.      A memory allocation failed while trying to get buffers for the
  129.      disk.  You will have to shutdown some of you other tasks and try
  130.      again.     
  131.  
  132.      Unable to get a Port from CreatePort
  133.      Unable to get pointer from CreateExtIO
  134.      Unable to Open device 
  135.  
  136.      These are messages that indicate that you have a very messed up
  137.      system!  Your device tables are probably corrupt.  A re-boot is
  138.      in order!
  139.  
  140.      Error Reading Block Zero, error = nnn
  141.     
  142.      A read was done on the BootBlock of the current device.  It failed 
  143.      with the indicated error code.  This could indicate a bad spot on the
  144.      device or even a possible viral infection in your system.  
  145.  
  146.      Boot Block for device/partition is invalid or non-dos
  147.  
  148.      The data in the first four bytes of the Boot Block was not an
  149.      indicator for either type of file system(DOS^@(SFS) or DOS^A(FFS)).  
  150.      This disk is either corrupt, damaged, or contains a special boot
  151.      block.  It is also a possible viral infection.
  152.  
  153.      disk read error on Root block
  154.  
  155.      The Root block was either not found or generated a disk error when
  156.      read from the disk.
  157.  
  158.      Root Block may be corrupt.... skipping
  159.  
  160.      The Root Block failed several sanity checks.  It may work ok, but is
  161.      corrupt.  A backup, format and restore are probably indicated for this
  162.      partition or floppy.
  163.  
  164.      Bit Map shows as invalid(nnn)
  165.  
  166.      The Root Block indicator says that the current bit map may be in the
  167.      process of being updated.  nnn is the current value which should be
  168.      either 0(if invalid), or -1(if valid).  If other values show up, your
  169.      root block is corrupt.
  170.  
  171.      CheckSum Error in Root Block, may be corrupt... skipping
  172.  
  173.      The checksum for the Root block of the current device is non-zero.  
  174.      This indicates a corrupt Root directory.
  175.  
  176.      I/O error reading BitMap block:nnnn
  177.  
  178.      An I/O error occurred during the bit map processing.  The error will
  179.      prevent an accurate count of the fragmentation.
  180.  
  181.      BitMap Checksum error: Block nnn may be invalid or corrupt
  182.    
  183.      The checksum of a BitMap block is invalid, the BitMap may be corrupt.
  184.  
  185.      No Memory available for file/dir buffers at <name>
  186.  
  187.      An Allocation of memory failed due to not enough memory.  Shutting down 
  188.      some other tasks will increase the memory available.
  189.  
  190.      I/O error reading Dir/File block: nnnnn from <name>
  191.  
  192.      A read error occurred while reading directory or file header
  193.      information.
  194.  
  195.      Dir: <name> parent hash index (nn) not same as file hash index(nn)
  196.      File:<name> parent hash index (nn) not same as file hash index(nn)
  197.  
  198.      The directory or file name hashes to a value that does not match the
  199.      location in the parent hash table.  This probably indicates a corrupt
  200.      parent directory or the directory/file name is corrupted.
  201.  
  202.      Dir: <name> parent (nnnn) not parent(mmmm) block
  203.      File:<name> parent (nnnn) not parent(mmmm) block
  204.  
  205.      The block number of the parent directory(mmmm) does not match the
  206.      parent field in the directory or file header data.  This indicates a
  207.      possible linkage problem or a corrupt disk.
  208.  
  209.      Dir: <name> OwnKey (nnnn) not block number(mmmm)
  210.      File:<name> OwnKey (nnnn) not block number(mmmm)
  211.  
  212.      The block number of the current file or directory does not match the
  213.      block number in the header data.  This indicates a possible linkage
  214.      problem or corrupt disk.
  215.  
  216.      Dir: <name> may be corrupt(spare words not zero)
  217.      Dir: <name> may be corrupt(checksum not zero)
  218.      File:<name> may be corrupt(spare words not zero)
  219.      File:<name> may be corrupt(checksum not zero)
  220.     
  221.      The file header or directory block has failed one of the sanity checks
  222.      or the checksum is non-zero.   This could indicate a corrupt disk.
  223.  
  224.      Invalid block type in key nnnn for directory <name>  
  225.  
  226.      The directory has an entry for a sub-directory or file that is not
  227.      either.  This is an indication of a corrupt disk.
  228.  
  229.  
  230.  
  231. ShareWare:
  232.   This program, the documentation and all files in the archive are
  233. copyrighted by Custom Services ©1990,91.  All rights are reserved.  No
  234. commercial use or financial gain may be made using this product without
  235. the consent of Custom Services.  This archive may be redistributed in
  236. any public domain collection or on any BBS provided all files are left
  237. intact.  Support Shareware.  Amazing Computing has permission to distribute
  238. this archive.
  239.  
  240. History:
  241.   1.00  -- initial version.
  242.   1.01  -- fixed several small bugs
  243.   1.06  -- re-created all the 1.01 bug fixes to a pre 1.00 version due to
  244.            HD crash/source loss.  Added several new features.
  245.            fixed a divide by zero error if no fragments on a device!  
  246.   1.07  -- fixed a bug in the BitMap analysis.  Fixed a debug output that
  247.            was not printing the whole bitmap(last word missing).
  248.   2.00  -- Added many sanity checks.  Improved the BitMap fragmentation 
  249.            removing several minor bugs.  Fixed a bug that prevented the
  250.            processing of larger disk devices/partitions(53 meg limit).
  251.            Added error documentation.  Added file data validation option.
  252.            Documentation updated, error information and new options added.
  253.   2.02  -- Corrected a couple of debug printouts to show the correct
  254.            information and updated the documentation.
  255.