home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / PMCHKSUM.ZIP / PMCHKSUM.DOC next >
Text File  |  1991-07-10  |  8KB  |  231 lines
  1.  
  2.     PMCHKSUM
  3.     ---------
  4.  
  5.     A PM File CRC checker
  6.  
  7.  
  8.  
  9.     INTRODUCTION
  10.     ------------
  11.  
  12.  
  13.     This program is a file CRC checker that runs under PM
  14.     (Presentation Manager) of OS/2.  It assigns a unique
  15.     number (a CRC) to each file of the extensions you specify
  16.     and stores it.  The next time you run PMCHKSUM, it calculates
  17.     the CRC and compares it the the stored CRC.  If they are
  18.     different, an error message is produced.  This may be a good
  19.     second line of defense against Virii infecting your system.
  20.     The first line of defense, of course, is practicing safe computing.
  21.     PMCHKSUM spins off low-priority idle-time threads to do the
  22.     calculations and comparisons.  As a result of this, PMCHKSUM
  23.     does not interfere with normal work.  PMCHKSUM also comes with
  24.     its' own timer, options that allow it to be run from a
  25.     CHRON-like utility, full on-line help and hardcopy reporting.
  26.  
  27.     DISCLAIMER
  28.     ----------
  29.     The Program is supplied "AS IS" without any warranty of any kind,
  30.     either expressed or  implied,  including, but not limited to, the
  31.     implied warranties of merchantability and fitness for a particular
  32.     purpose.
  33.  
  34.     In  no  event  shall Robert Mahoney be liable for any damages, either
  35.     direct or  consequential,  caused by the use, or inability to use,
  36.     this program, even  if Robert Mahoney has been advised of the
  37.     possibility of such damages.
  38.  
  39.  
  40.  
  41.     ACKNOWLEDGMENTS
  42.     ---------------
  43.     The logic for the calculating of the CRC is taken from an article
  44.     by David Schwaderer in the April 1985 issue of PC Tech Journal.
  45.  
  46.  
  47.  
  48.     NOTE
  49.     ----
  50.     This program has been tested with:
  51.       Software:
  52.         IBM OS/2 EE and SE v1.3  (does not run on v1.2)
  53.       Hardware:
  54.         IBM Model 70-121 with 6MB.
  55.         386 clone with 6MB.
  56.  
  57.  
  58.  
  59.  
  60.     PMCHKSUM - A PM File CRC Checker                       Page 2
  61.  
  62.  
  63.  
  64.     USAGE
  65.     -----
  66.     To use this program enter START PMCHKSUM at the OS/2 command prompt
  67.     or add it to a group.  The internal timer is initially disabled
  68.     so it will wait for user input.  The default extensions are
  69.     EXE,DLL, and SYS.  You can add to this list or change the list
  70.     (see the on-line help for more details).  Pressing START will
  71.     begin the scan.  The Status Message listbox will display status
  72.     messages, such as time of Scan starting and CRC entry added.
  73.     The Error messages listbox will issue messages such as a CRC
  74.     has changed or an CRC entry could not be added.  Pressing
  75.     CANCEL will cancel the scan, EXIT will prompt you for a confirmation
  76.     and exit the application, HELP will give you on-line help, and
  77.     OPTIONS will bring up the Options dialog.
  78.     For a more through explanation please see the on-line help.
  79.  
  80.  
  81.     START
  82.     -----
  83.  
  84.  
  85.     The program is started by simply typing "PMCHKSUM" on the
  86.     command line. Parameters are neither necessary nor recognized.
  87.  
  88.     The program can be inserted very easily into a group of the
  89.     PM program starter. It can be invoked from there with a
  90.     single "Double-Click".
  91.  
  92.     PMCHKSUM looks in the working directory for the file containing
  93.     the CRC's.  If it doesn't find it, it will create a new file
  94.     and store the current CRC's there.  If you start PMCHKSUM from
  95.     different subdirectories,  you will have multiple files named
  96.     PMCHKSUM.IDX and waste alot of space.  You also will not get
  97.     the benefit of the CRC checker.
  98.  
  99.  
  100.     PMCHKSUM - A PM File CRC Checker                       Page 3
  101.  
  102.  
  103.     PERFORMANCE HINTS
  104.     -----------------
  105.  
  106.  
  107.     1) Exit other applications that depend on low-priority threads
  108.        such as CPUMETER and DESKPIC.  Since PMCHKSUM uses low-priority
  109.        threads,  the contention for thread time between other programs
  110.        that primarily uses low-priority threads will cause PMCHKSUM and
  111.        the other programs run much slower.
  112.  
  113.     2) As mentioned before, start PMCHKSUM from the same directory
  114.        all the time.  This will avoid having multiple data files on
  115.        your disk.
  116.  
  117.     3) On a 120MB disk containing 32 .SYS's, 200 .DLL's and 358 .EXE's
  118.        the data file takes up 24K.
  119.  
  120.     4) Do not SHUTDOWN or CLOSE while PMCHKSUM is running a scan.
  121.        Press CANCEL first.  Although I've had no reported problems
  122.        with this, it's better to be safe than to have a corrupted
  123.        data file.
  124.  
  125.     REGISTRATION
  126.     ------------
  127.  
  128.  
  129.     This program is released as SHAREWARE. There is no difference
  130.     between the REGISTERED version and the SHAREWARE version.
  131.     I do not believe in CRIPPLE-WARE nor ANNOYING-WARE (the kind
  132.     of program that constantly reminds you via message box that you
  133.     still have not registered).  I believe that honest people will
  134.     register a program if they use it.  But, depending on the response,
  135.     I may change my policy.
  136.  
  137.     I will simply ask everybody who is willing to continue the
  138.     use of this program in the future to send the filled regist-
  139.     ration form back to me.  This will encourage me to continue
  140.     to write useful OS/2 PM programs.
  141.  
  142.     The registration cost of this program is only:
  143.             US  $15  for individuals.
  144.                 $25  per copy for companies with 25 or less employees.
  145.                 $40  per copy for companies with 26 or more employees.
  146.  
  147.     Yes, ----> $15 <----- will get you registered and you will be able
  148.     to sleep better at night.
  149.  
  150.  
  151.     PMCHKSUM, A PM File CRC Checker                 Page 4
  152.  
  153.  
  154.  
  155.     FUTURE ENHANCEMENTS
  156.     -------------------
  157.  
  158.  
  159.     To give you an idea of some potential future enhancements:
  160.  
  161.     1)  Search for files by Extended Attributes (EA's)
  162.         e.g. DYNAMIC LINK LIBRARY or EXECUTABLE
  163.  
  164.     2)  Sizeable dialog box with auto-adjusting child windows
  165.         and fonts.  This way you can make the window as big
  166.         or as small as you want and still see all of it.
  167.  
  168.     3)  Re-write the CRC calculation in assembler.  This
  169.         will speed up the calculation but value is questionable
  170.         in a low-priority thread.
  171.  
  172.     4)  Eliminate non-existent files from the data file.
  173.         Currently the data file does not get cleaned up.
  174.         e.g. if you delete a file from your disk, it will stay
  175.         in the datafile forever.
  176.  
  177.     5)  Remember where the window was placed and the size of it.
  178.  
  179.         I would love to hear any and all other suggestions.
  180.         I can be reached on:
  181.  
  182.                    Fidonet OS/2 echos
  183.                    BIX as RMAHONEY
  184.                    Prodigy as KBFN97A
  185.                    my address is on the next page
  186.                    (send me a letter with a check! <g> )
  187.  
  188.  
  189.     PMCHKSUM, A PM File CRC Checker                 Page 5
  190.  
  191.  
  192.       Date: __________  __ ,19__
  193.  
  194.  
  195.  
  196.         Robert Mahoney
  197.         27 East Jackson Ave
  198.         Babylon, New York 11702
  199.  
  200.  
  201.  
  202.  
  203.     Subject: Registration PMCHKSUM
  204.  
  205.  
  206.     Yes, I want to register PMCHKSUM. I know that this program is
  207.     released without any kind of guarantee.
  208.     Enclosed is the registration fee of
  209.  
  210.       _  Individual - $15
  211.       _  Company < 25 employees     __ copies at  $25/copy = $ ___
  212.       _  Company > 25 employees     __ copies at  $40/copy = $ ___
  213.  
  214.  
  215.     Name:       _______________________________
  216.  
  217.     Company
  218.     Name (opt): _______________________________
  219.  
  220.     Street:     _______________________________
  221.  
  222.     City:       _______________________________
  223.  
  224.     State:      _______________________________
  225.  
  226.     ZIP  :      _______________________________
  227.  
  228.  
  229.     __________________________________
  230.     (signature)
  231.