home *** CD-ROM | disk | FTP | other *** search
/ Software Recommendations - 1998 Season 1 / DNBCD4.iso / develop / tool / zip / CFIX200.ZIP / CFIX.TXT next >
Encoding:
Text File  |  1997-05-02  |  4.8 KB  |  125 lines
  1.                           ________  _______  ________
  2.                        --<__   __/-/  ____/-<__   __/--
  3.                       ---  /  /-- /  /_/~>- __/  /__ ---
  4.                        --_<__/_-_<______/_ <_______/_--
  5.                           Turtle Group Incorporated
  6.                            http://tgi.home.ml.org/
  7.  
  8.     CFiX - Compare and Fix
  9.     Copyright (c) 1996-97 John Pappas (DiskDude). All rights reserved.
  10.  
  11.     It is a crime to redistribute the contents of this package in a commercial
  12.     venture of any kind without permission or a licensing agreement. Contact
  13.     the Turtle Group Inc. via Internet email <tgi@iname.com> for more
  14.     information on licensing.
  15.  
  16.     The included code is freely distributable for non-commercial use, however
  17.     it is required that a) no modifications are made without written permission
  18.     and b) you acknowledge the following copyright information:
  19.  
  20.     Copyright (c) 1996-97 DiskDude. All rights reserved.
  21.  
  22.     If you have any questions or comments, please contact the author via
  23.     Internet email: diskdude@poboxes.com
  24.  
  25. Contents:
  26.  
  27. 1.0 Absract
  28. 2.0 How to use CFiX
  29. 3.0 Known bugs
  30. 4.0 CardWare information
  31.  
  32. 1.0 Absract
  33. -----------
  34.  
  35. Have you ever copied a file from a friend either over disk or modem and found
  36. that it was corrupt? You simply had to get a fresh copy, but when the file
  37. was 10-50 mbytes it took a while!
  38.  
  39. CFiX will create a checksum of a corrupt datafile which is VERY small - approx
  40. 2 kbytes for a 16 mbyte file! You then give this checksum file to your friend
  41. and he/she does a compare on the original file. A new "fix" file will be
  42. created which contains only the data which needs to be replaced in your
  43. corrupt file to make it an exact copy of the original. In most cases, the fix,
  44. or patch, file will be less than 100 kbytes.
  45.  
  46. It will then take only a minute to get the fix file and patch your corrupt
  47. file, saving you having to recopy/download the whole thing!
  48.  
  49. 2.0 How to use CFiX
  50. -------------------
  51.  
  52. Usage: CFiX [filename]
  53.  
  54. Depending on what is in the file you specify by [filename], CFiX will do one
  55. of the following:
  56.  
  57.   o Create a checksum file, with an extension of ".sum"
  58.   o Compare a file to the checksum file
  59.   o Create a fix file with an extension of ".fix"
  60.   o Patch a file based on a fix file
  61.  
  62. The best way of illustrating how CFiX works is by going through a step-by-step
  63. example. Consider a file HAPPY.ZIP which we got from a friend and is a few
  64. MBytes in size. When testing the ZIP file, we get a CRC error.
  65.  
  66. Firstly, we must make a checksum of the file, which basically makes a kind of
  67. "signature" of the file.
  68.  
  69. C:\ZIP>cfix happy.zip
  70.  
  71. You should have a new file called HAPPY.SUM in the same directory as the
  72. original file HAPPY.ZIP. The size of this file should be VERY small. Give this
  73. file to your friend whom you got the HAPPY.ZIP file in the first place.
  74.  
  75. Using CFiX, your friend will compare this checksum file (HAPPY.SUM) to the
  76. original undamaged HAPPY.ZIP like so:
  77.  
  78. D:\MYDIR>cfix happy.sum
  79.  
  80. Note that the original file HAPPY.ZIP *must* be in the same directory as the
  81. file HAPPY.SUM. If a mismatch between the checksum file ("signature") and the
  82. original file HAPPY.ZIP is found, then a new FIX FILE will be created, with
  83. extension "FIX". In our case, HAPPY.FIX
  84.  
  85. Get this FIX FILE from your friend. Again, this file should be very small,
  86. depending on how much of the file was damaged. Once you have this file, you
  87. can patch your corrupted file to make it the same as the undamaged original:
  88.  
  89. C:\ZIP>cfix happy.fix
  90.  
  91. Your original file HAPPY.ZIP should be fixed! Note that the original filename
  92. of the damaged file (when you typed "cfix happy.zip") is stored throughout the
  93. whole process so something doesn't stuff up.
  94.  
  95. You may think that the method CFiX uses is confusing, however when I originally
  96. wrote CFiX, it seemed like the best way at the time... I still think it was a
  97. good way to process the damaged file - you only need to supply one argument to
  98. the program, and CFiX does its stuff intelligently.
  99.  
  100. 3.0 Known bugs
  101. --------------
  102.  
  103.    o None
  104.  
  105. Please report any bugs you may find to DiskDude <diskdude@poboxes.com>.
  106.  
  107. 4.0 CardWare information
  108. ------------------------
  109.  
  110. If you like and/or use CFiX, then you are required to send the author a
  111. PostCard of your beautiful city/town/country, along with a little description
  112. of the weather on the back and your email address if you have one.
  113.  
  114. All PostCards which are received are digitally scanned and placed on the
  115. Internet for all to see. The URL is http://diskdude.home.ml.org/postcard.html
  116.  
  117. Please send your PostCard to:
  118.                               John Pappas
  119.                               PO BOX 48
  120.                               Coburg 3058
  121.                               VIC, AUSTRALIA
  122. Thanks!
  123.  
  124. [EOF]
  125.