home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 264b.lha / butils / sum.doc < prev    next >
Encoding:
Text File  |  1989-07-09  |  1.7 KB  |  54 lines
  1. SUM 1.1   by Bill Dimm
  2.  
  3. USAGE:
  4.     sum [options] file1 [file2]
  5.  
  6. DESCRIPTION:
  7.  
  8.     Sum generates checksums for a file, and will find the number
  9. of readable bytes in the file.  This information can be stored in a
  10. chksum file so that the integrity of a file can be determined at a
  11. later date.  This is especially useful when you want to verify that a
  12. disk crash recovery was successful.  A chksum file will be 9 to 13 bytes
  13. long depending on the number of checksums generated.  Sum does
  14. everything the Unix version does, and more, but the checksums that it
  15. generates are not intended to be compatible with those generated by Unix.
  16. Options:
  17.  
  18.     -r    Use the alternate checksum method instead of the default.
  19.  
  20.     -b    Use both checksum methods.
  21.  
  22.     -s    Show the contents of a chksum file (chksum files are compressed)
  23.         The checksum methods to use will be determined from the
  24.         chksum file file1.
  25.  
  26.     -o    Output to a chksum file (in addition to the screen).  File2
  27.         will be the chksum file.
  28.  
  29.     -v    Verify that the checksums (and size) of file1 match those
  30.         stored in the chksum file file2.  The checksum methods to use
  31.         will be determined by the contents of file2.
  32.  
  33.     The options -s -o and -v are mutually exclusive, and cannot be
  34. specified together.
  35.  
  36. IMPROVEMENTS:
  37.  
  38.     Since version 1.0, sum has been recompiled with Lattice 5.02
  39. to make it smaller.
  40.  
  41. EXAMPLES:
  42.  
  43. Print both chksums for the file sample.doc:
  44.     sum -b df0:sample.doc
  45.  
  46. Create a chksum file for sample.doc (using both checksum methods):
  47.     sum -o -b df0:sample.doc df1:chksums/sample.doc.chk
  48.  
  49. Later verify that the file sample.doc file is still in tact:
  50.     sum -v df0:sample.doc df1:chksums/sample.doc.chk
  51.  
  52. Diskplay contents of chksum file:
  53.     sum -s df1:chksums/sample.doc.chk
  54.