home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / PCHASH2.ZIP / PCHASH2.DOC < prev    next >
Text File  |  1992-07-25  |  5KB  |  156 lines
  1. ══════════════════════════════════════════════════════════════════════════
  2.  
  3.                                  PCHASH
  4.                           ver 2.0 July 25, 1992
  5.  
  6. ══════════════════════════════════════════════════════════════════════════
  7.  
  8. WHAT'S NEW
  9.  
  10. PCHASH2 version 2.0 is essentially the same as version 1.0 except that the
  11. OS/2 version has been compiled for 32-bit operation, resulting in faster
  12. processing.
  13.  
  14. ══════════════════════════════════════════════════════════════════════════
  15.  
  16.  
  17. PCHASH and PCHASH2 are programs to display both 16- and 32-bit Cylic
  18. Redundancy (CRC) values (Hash totals) of files specified on the command line.
  19. See description at bottom if you are unfamiliar with CRC's.
  20.  
  21.  
  22. DESCRIPTION
  23.  
  24. PCHASH.EXE (DOS version) and PCHASH2.EXE (OS/2 version) are run from the
  25. command line.  They display file name, size, date, time, 16-bit and 32-bit
  26. CRC for all files matching the input file specification(s).  The 16-bit
  27. CRCs should be the same as for files archived with ARC, LZH, LZS, PAK and
  28. ZOO.  32-bit CRC should be the same as files archived/compressed with PKZIP.
  29.  
  30. PCHASH was designed to be incorportated into DOS batch or OS/2 command files
  31. easily by allowing multiple file specifications with wildcards, I/O redirection,
  32. and simple (i.e. non-GUI) output.  Note that seconds are also displayed as part
  33. of the time for greater file-verification.
  34.  
  35.  
  36.  
  37. INPUT
  38.  
  39. Valid DOS or OS/2 filename[s].
  40. Wildcards (*,?) and multiple filespecs are supported.
  41. Examples of valid command lines:
  42.    PCHASH *.DOC
  43.    PCHASH FILE??.OBJ
  44.    PCHASH C:\*.COM  D:\UTIL\*.COM
  45.    PCHASH *.WP  C:\DOCS\*.TXT  D:\PROGS\F*.PAS  A:*.DOC
  46.  
  47.  
  48.  
  49. OUTPUT
  50.  
  51. Complete file name including path
  52. Number of bytes processed (should match file size)
  53. File size, date, time (including seconds), 16-bit CRC 32-bit CRC
  54.  
  55. The output can be redirected with the DOS or OS/2 redirection symbols >, or >>.
  56. For example, the command:    PCHASH *.OBJ > ALL.OBJ
  57.   will write the output to the file ALL.OBJ instead of to the screen,
  58.   erasing the existing ALL.OBJ file.
  59. The command:    PCHASH *.OBJ >> ALL.OBJ
  60.   will append the output to the file ALL.OBJ instead of to the screen,
  61.   adding the results to end of the ALL.OBJ file.
  62.  
  63. The message "Can't open the file...<filename>" is displayed if PCHASH cannot
  64. access a file.  This usually means another application has the file open for
  65. exclusive access.  If a file cannot be accessed, PCHASH will display the
  66. message, bypass the file, and continue with the next file.  PCHASH opens files
  67. for read only.
  68.  
  69.  
  70.  
  71. Sample output:
  72.  
  73. PCHASH2 - Cyclic Redundancy Checker     Version 2.0,dmc   7/25/92
  74. Command line entered:
  75. *.OBJ
  76.  
  77. E:\DIR1\FILE1.OBJ
  78. 3603 Bytes Processed
  79.       3603 12-13-90 10:07:05p     16-bit CRC = 7645   32-bit CRC = AA3420F4
  80.  
  81. E:\DIR1\FILE2.OBJ
  82. 4865 Bytes Processed
  83.       4865 12-17-90 11:04:14p     16-bit CRC = E71F   32-bit CRC = C6D444C2
  84.  
  85.  
  86.  
  87.  
  88. Note:
  89. The date will always start in column 12.
  90. The time will always start in column 21.
  91. The 16-bit CRC will always start in column 48.
  92. The 32-bit CRC will always start in column 68.
  93.  
  94.  
  95.  
  96.  
  97.  
  98. CRC's
  99.  
  100. For those unfamiliar with a Cyclic Redundancy Check (CRC) value, it is a
  101. unique number calculated based on the contents of a file (text or binary).
  102. If the file is changed even by one byte, the CRC value will also change.
  103. CRC's are useful for version control, or for verifying that important files
  104. have not been altered, corrupted, or infected with viruses.
  105.  
  106. For example, the following lines in AUTOEXEC.BAT can help provide verification
  107. that COMMAND.COM has not been altered in any way.
  108.  
  109. c:\util\pchash c:\dos\command.com
  110. echo      47845  4-09-91  5:00:00a     16-bit CRC = 77B1   32-bit CRC = 5E5AA032
  111.  
  112. The first line runs PCHASH on the COMMAND.COM file, and the second line
  113. displays the output from PCHASH which was previously run on an original
  114. version of COMMAND.COM.
  115.  
  116.  
  117.  
  118.   
  119. REVISION HISTORY & REGISTRATION
  120.  
  121.    *  version 2.0   July, 1992
  122.       PCHASH  - ver 2.0     July 25, 1992
  123.       PCHASH2 - ver 2.0     July 25, 1992
  124.  
  125.       OS/2 version updated for OS/2 version 2.0
  126.  
  127.  
  128.    *  version 1.0   January, 1991
  129.       PC-HASH  - ver 1.0    January 25, 1991
  130.       PC-HASH2 - ver 1.0    January 25, 1991
  131.  
  132.  
  133.    I would be most greatful for any comments, suggestions, and/or bug
  134.    reports.  PCHASH and PCHASH2 are distributed as-is, with no warranties
  135.    involved.
  136.  
  137.    You may give individual copies of the unregistered version PCHASH/PCHASH2
  138.    to friends, associates, collegues, etc. for evaluation purposes, however,
  139.    please include the files PCHASH.EXE, PCHASH2.EXE, and PCHASH2.DOC without
  140.    any modification.
  141.  
  142.  
  143.    If you use PCHASH2 (OS/2) and/or PCHASH (DOS), please send a small
  144.    donation of $10.00 each ($20.00 for both) so that I can prove to my
  145.    husband that all the long hours I spend with my PC instead of with him
  146.    are really worth something.   Thank you.
  147.  
  148.  
  149.    Donna Campanella
  150.    508 Natalie Lane
  151.    Norristown, PA 19401
  152.  
  153.    CompuServe 72010,2305
  154.    Prodigy    KCTW07A
  155.  
  156.