home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast.iso / starter / crc.doc < prev    next >
Text File  |  1994-03-07  |  4KB  |  95 lines
  1.                 CRC for MSDOS & Concurrent PC-DOS
  2.                by Howard Vigorita,  NYACC CP/M SIG
  3.     upload comments, etc. to: (718) 539-3338  (BBS)
  4.  
  5.      This is a MSDOS generic program derived from the CP/M-86 
  6. version by Bill Bolton found on SIG/M Volume #210. MSDOS 2.0 or
  7. higher is required for operation. This is a disk file CRC 
  8. checking and generating utility originally written for CP/M-80,
  9. CP/M-86, MP/M-86 and Concurrent PCDOS, now available for MSDOS.
  10. Version 6.7 of CRC has also been tested on Concurrent PC-DOS 4.1.
  11.  
  12.     This is a companion utility to CRCBUILD which builds
  13. -CATALOG files. This utility uses those -CATALOG files as an
  14. interactive look up table and displays *MATCH* on your screen 
  15. next to each line whose embedded CRC agrees with disk contents.
  16.  
  17.     This utility will optionally create an output file on 
  18. the default drive, listing the CRC's of all files checked in a
  19. single session. That output file can also serve as the look up.
  20.  
  21.  
  22. COMMANDS:
  23.  
  24.         CRC [drive:]<filename.filetype> [F]
  25.  
  26.         Examples:
  27.  
  28.     CRC            Will attempt to find CRCKLIST.???,
  29.                   or CRCKFILE.??? or -CATALOG.???    
  30.                   and try to match recorded CRC values
  31.                   in that file with values calculated
  32.                   on the fly for files on the disk. 
  33.  
  34.     CRC MYFILE.ASM        Check only MYFILE.ASM
  35.  
  36.     CRC B:*.ASM        Check all .ASM files ON B: drive
  37.  
  38.     CRC *.* F        Check all files, writing output to a file
  39.  
  40.  
  41.      Hidden files as well as files with the '$$$' extention are 
  42. ignored.
  43.  
  44.      Path names as part of the file specification are not 
  45. supported in this version. To check the CRC of files in a 
  46. sub-directory, first log in that sub-directory, then run CRC
  47. from a different drive with the drive designation of the sub-
  48. directory as part of the file specification. To run CRC from
  49. the root directory of the A: drive and CRC all files on the 
  50. \user\progs\asm sub-directory of the B: drive, do the following:
  51.  
  52.     A>cd B:\user\progs\asm
  53.     A>CRC B:*.*
  54.  
  55.  
  56. ALGORITHM NOTES
  57.  
  58.     The CYCLIC-REDUNDANCY-CHECK number used in this program 
  59. is based on the following CCITT standard polynominal:
  60.  
  61.    X^16 + X^15 + X^13 + X^7 + X^4 + X^2 + X + 1
  62.  
  63.     Special attention in this implementation has been given 
  64. to insure that it generates CRC's which are not only compatable 
  65. with SIG/M -CATALOG files and XMODEM CRC's, but which are also 
  66. communication chanel insensitive. Generated CRC's will remain 
  67. unchanged when files are moved from MSDOS or UNIX through 
  68. communication's chanels which pad byte resolution to standard 
  69. block boundaries. It is thus useful for checking the accuracy of 
  70. such file transfers. It is significantly more accurate than a 
  71. simple checksum with virtually no speed penalty as well as faster 
  72. and less memory intensive than any table lookup technique.
  73.  
  74.  
  75. SPECIAL MSDOS NOTE
  76.  
  77.     This CRCK version fixes a bug in some MSDOS versions whereby
  78. partial sectors of files were not being processed. Such versions
  79. generate "00 00" CRC values for files less than 128 bytes in length
  80. and incorrect values for files not an exact multiple of 128 bytes
  81. long. Use this version of CRC with CRCBUILD version 1.1 or greater
  82. which also fixes this bug.
  83.  
  84.  
  85. CREDITS
  86.  
  87.     The 8 bit version of the program was originally conceived 
  88. by Keith Petersen, W8SDZ, to whom all glory and honour. Due to 
  89. the scarcity of source code in the MSDOS public domain, the MSDOS 
  90. version of this program has been derived from the CP/M-86 version 
  91. by Bill Bolton, Software Tools BBS, Australia. Many thanks to 
  92. Bill Bolton and the many other CP/M-86 programmers who continue 
  93. enable the rest of us to learn from their examples in the best
  94. spirt of the public domain.
  95.