home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / disk / misc / dcmp / dcmp.doc < prev    next >
Text File  |  1993-09-30  |  8KB  |  219 lines
  1.  
  2. NAME
  3.  
  4.   DCMP -- Disk CoMPare utility
  5.  
  6. DISTRIBUTION
  7.  
  8.   This version of DCMP is NOT in the PUBLIC DOMAIN.  You can however freely
  9.   distribute it as long as the following is observed:
  10.  
  11.   - The program and documentation must be distributed together and may not
  12.     be modified in any way.  The only exception is that the program and
  13.     documentation may be compressed into an archive for uploading to Bulletin
  14.     Boards or for other electronic transmission.
  15.  
  16.   - The program is not to be used commercially or included in a commercial
  17.     package for profit unless written authorisation from me is obtained first.
  18.     This version of DCMP may be freely included on public domain library
  19.     disks or compilation disks provided only a small fee is charged for the
  20.     service.
  21.  
  22. DESCRIPTION
  23.  
  24.   DCMP compares two disks block by block.  This is of great use if you want
  25.   to verify a copy of a disk that was copied in the same way (block by block)
  26.   It was mainly written to test the reliability of a Video-Backup-System.
  27.  
  28.   When started from Shell with option `?' or `.' DCMP will come up as
  29.   follows:
  30.  
  31.     1> dcmp ...
  32.  
  33.     $Id: dcmp.c,v 1.52 93/09/30 23:15:15 tf Exp $
  34.     -- compare two disks block by block
  35.     USAGE: dcmp [-<options>] <DF0..3> [DF0..3]
  36.  
  37.     Legal options are:
  38.  
  39.     -t              write transcript to `dcmp.log'
  40.     -l <LogFile>    write extended transcript to `LogFile'
  41.     -i              create project icon with logfile
  42.     -v              verify tracks after read (detect weak data)
  43.     -w              display information in a window
  44.     -a (-r)         set #of attempts to read (retries)
  45.     -b              break on (read) errors.
  46.     -sc <cylinder>  start with cylinder #<cylinder> sector #0
  47.     -st <track>     start with track #<track> sector #0
  48.     -ss <sector>    start with sector #<sector>
  49.     -sb <block>     start with block #<block>
  50.     -ec <cylinder>  end with last cylinder #<cylinder> sector #0
  51.     -et <track>     end with last track #<track> sector #0
  52.     -es <sector>    end with last sector #<sector>
  53.     -eb <block>     end with last block #<block>
  54.  
  55.   Where:
  56.  
  57.     <cylinder> should be in [0..79]
  58.     <track>    should be in [0..159]
  59.     <block>    should be in [0..1759]
  60.     <sector>   should be in [0..10]
  61.  
  62.     All these values are converted immediately into the corresponding
  63.     block numbers. The command line is parsed from left to right so that
  64.     options may override previous ones.
  65.  
  66.   Examples:
  67.  
  68.     Verify the disk in DF0: starting with the first cylinder (#0) and
  69.     ending with track #10 sector #4 may look like this:
  70.  
  71.     1> dcmp DF0: -sc0 -et 10 -es4
  72.  
  73.     Be careful: The sector number must come *AFTER* the track number,
  74.  
  75.     1> dcmp DF0: -es4 -et10 -sc 0
  76.  
  77.     would terminate on track #10 sector #0 !
  78.  
  79.     1> dcmp -st3 -ss5 -ec17 -es1 -es7 DF0: DF1:
  80.  
  81.     Will compare the disks in DF0: and DF1: starting on track #3 sector #5
  82.     and ending with cylinder #17 sector #7.
  83.  
  84.  
  85.   The `-w' option makes DCMP behave as if started from the Workbench via
  86.   the icon. In this case, DCMP will look for req(tools).library.  If none
  87.   of them is available, DCMP will not be able to display a file requester
  88.   but its main functionality will *NOT* be affected.
  89.  
  90.   The following ToolTypes configure DCMP when started from Workbench:
  91.  
  92.     FIRST CYL=<cylinder>   start with cylinder #<cylinder> first sector
  93.     LAST CYL=<cylinder>    end with last cylinder #<cylinder> last sector
  94.     ATTEMPTS=<attempts>    set #of attempts to read (retries)
  95.     IGNORE ERRORS=ON       don't break on (read) errors
  96.     DEEP READ=ON           verify tracks after read
  97.     LOGFILE=<name>         write extended transcript to <name>
  98.     LOGICON=ON             create a project icon with the logfile
  99.     DEFAULT TOOL=<name>    set default tool for the logfile icon
  100.     LANGUAGE=<language>    set dcmp <language> to one of these:
  101.                            ENGLISH
  102.                            GERMAN
  103.                            FRENCH    (incomplete!)
  104.                            ITALIEN
  105.   Note:
  106.  
  107.     Setting first and last cylinder in the ToolTypes works exactly the same
  108.     way it does when changing them interactively.  DCMP will always start
  109.     with the first sector of a cylinder and end up with the last. So if you
  110.     set first and last cylinder to the same value DCMP will compare it
  111.     entirely.
  112.  
  113.  
  114.   All functions in the window are available via gadgets and/or keyboard
  115.   shortcuts. I.e. you can for example select a logfile either via the
  116.   `Logfile' gadget or by pressing the underlined letter (in this case: `f')
  117.   on your keyboard.  Alternatively you may activate the string gadget to edit
  118.   the logfile name by pressing the `l' key or simply with a mouse click
  119.   into it.  (If the string gadget is not activated DCMP cuts off the path.)
  120.  
  121.   DCMP has also got a menu strip now.  If you like moving your mouse this
  122.   is the best way for you to make your selections.
  123.  
  124.   The `Verify tracks' option forces dcmp to read each track twice and compare
  125.   the results.  This makes it possible to detect weak data.
  126.  
  127.   Depending on the number of drives you specified (1 or 2) DCMP will either
  128.   verify this disk or compare them.  During the operation the menu strip will
  129.   be removed.  If a logfile was selected its contents may look somewhat like
  130.   this:
  131.  
  132.  
  133.     This is $Id: dcmp.c,v 1.43 92/09/13 20:15:21 tf Exp $
  134.     Compare drive DF0: with DF1: w/ deep read
  135.     > Start: Track #0, Sector #0, Block #0
  136.     > End: Track #159, Sector #10, Block #1759
  137.     3.5" Kickstart disk in DF0:
  138.     3.5" Normal DOS disk in DF1:
  139.     ** Bad sector preamble on DF0: track 137, 2 attempts failed.
  140.     ** Too few sectors on DF0: track 139, 2 attempts failed.
  141.     total: 76 tracks differ on 740 blocks, 2 errors, no weak tracks.
  142.     
  143.     Here is the complete list of differing blocks:
  144.     
  145.        0..0512: Track #000, Sector #00  --  Track #046, Sector #06
  146.      671..0673: Track #061, Sector #00  --  Track #061, Sector #02
  147.      679..0680: Track #061, Sector #08  --  Track #061, Sector #09
  148.      682..0889: Track #062, Sector #00  --  Track #080, Sector #09
  149.     1555..1556: Track #141, Sector #04  --  Track #141, Sector #05
  150.           1580: Track #143, Sector #07
  151.     1582..1583: Track #143, Sector #09  --  Track #143, Sector #10
  152.           1604: Track #145, Sector #09
  153.           1618: Track #147, Sector #01
  154.           1734: Track #157, Sector #07
  155.           1753: Track #159, Sector #04
  156.                       ....
  157.                       ....
  158.  
  159.  
  160.   This list can be of great use, if you want to edit the differing blocks
  161.   with a disk-monitor (e.g. DisKey by Angela Schmidt).
  162.  
  163.   The output of the next operation with the same logfile will not overwrite
  164.   the last. It will be appended, after a seperation line with date and time.
  165.  
  166.   If you like DCMP (or even if you do not) then write to me.  (I would be
  167.   happy to receive a postcard of your hometown ;)
  168.  
  169.  
  170.  
  171.                                                 -Tobi
  172.  
  173.  
  174. IDEAS FOR FUTURE REVISIONS
  175.  
  176.   - DCMP check-disk-until-defect-option to have absolutely trusty
  177.     results for the read/write reliability of a disk ;)
  178.  
  179.   - Differing blocks will be documented (BOOT, ROOT, ...) with the offset 
  180.     of the difference in the block.
  181.  
  182.   - Disk units will be allocated (BUSY) as soon as dcmp comes up. (howdo?)
  183.  
  184.   - The number of cylinders DCMP can access will no longer be fixed to 80
  185.     but will depend on the #of tracks the disk offers. (A4000 with HD drive!)
  186.  
  187.   - Reading sector labels will become an additive DCMP option.
  188.     DCMP is already able to read them, but I'm not so pleased with
  189.     my attempts to implement this option...
  190.  
  191.  
  192. AUTHOR
  193.  
  194.     Tobias Ferber, Goethestraße 32, 76135 Karlsruhe, Germany
  195.  
  196.     Earn:      ukjg@dkauni2.bitnet
  197.     InterNet:  ukjg@ibm3090.rz.uni-karlsruhe.de
  198.  
  199. THANKS
  200.  
  201.   Req.library is copyright 1989 Colin Fox (Pyramyd Designs) and Bruce
  202.   Dawson (of CygnusSoft Software).
  203.  
  204.   ReqTools.library is Copyright (c) Nico François.
  205.                                     Corbielaan 13
  206.                                     B-3060 Bertem
  207.                                     BELGIUM
  208.  
  209.  
  210.   DICE is copyright (c)1990 by Matthew Dillon
  211.                                891 Regal Rd.
  212.                                Berkeley, Ca. 94708
  213.