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