home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / zip / zvtest11.arc / ZVTEST11.TXT < prev   
Text File  |  1989-12-26  |  14KB  |  403 lines
  1.  
  2.  
  3.  
  4.         ZVTST.DOC 11 / 23 / 89
  5.  
  6. The programs described herein, excepting SCAN (Copyright McAfee
  7. associates) and PKUNZIP (Copyright PKware) are released into the
  8. public domain as of 11/23/89.  They may be freely distributed as
  9. long as no fee over $5.00 US is charged for duplication services.
  10.  
  11.  
  12. What is the Z/V test Kit?
  13. -------------------------
  14. ZVtest is a set of modular programs designed for the BBS SysOp
  15. and the average computer user.  ZVtest allows you to automatical-
  16. ly test ZIP files damage and the files contained in the ZIP file
  17. for viruses.
  18.  
  19.  
  20. Caveats (Warnings)
  21. ------------------
  22. SysOps Please note: The SysOp components are written for PCBoard
  23.                     BBSs.  This is the ONLY type of BBS that I am
  24.                     SURE will be able to use the SysOp componants
  25.                     of the ZVtest kit, try others at your own
  26.                     risk.
  27.  
  28. In order to make use of the ZVtest kit, you will need a version
  29. of McAfee Associates virus tester "SCAN".  I recommend version
  30. 1.7V49 or higher, since this is the version that I used to test
  31. ZVTEST.   You will also need the PKZIP/PKUNZIP utility from
  32. PKware Inc.   The latest version available at this time is 1.02
  33. Both of these utilities should be in your path or in the current
  34. directory (the one you'll be running ZVtest from).  PLEASE NOTE
  35. that both of these utilities are shareware, and should be regis-
  36. tered with their respective authors if you plan on using them
  37. regularly.
  38.  
  39. You will also need plenty of free disk space, aproximately enough
  40. to hold the unzipped contents of your largest ZIP file plus about
  41. 60 K.
  42.  
  43. Please also note that there are NO provisions in the ZVtest kit
  44. for the use of ARC-type files.  Anyone still using ARC format
  45. files deserves what he gets.
  46.  
  47.  
  48.  
  49. Files Contained in ZVtest. (approximately in order of use)
  50. and projected user.
  51. ----------------------------------------------------------
  52. ZVTST.TXT (all)
  53. DFFIX.EXE (SysOp)
  54. FLIST.EXE (all)
  55. BATBLD.EXE (all)
  56. DFUPD.EXE (SysOp)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Thumbnail descriptions:
  66. -----------------------
  67.  
  68.      ZVTST.TXT
  69.           you're currently reading it.
  70.  
  71.      DFFIX.EXE
  72.           'Synchronize' the file dates in your directory list
  73.           file with the date & time stamps of the files described
  74.           therein.  Also rewrites the description information in
  75.           proper case.
  76.  
  77.      FLIST.EXE
  78.           Builds the list of files to be tested.
  79.  
  80.      BATBLD.EXE
  81.           Creates a DOS batch file to test all of the selected
  82.           files for the presence of viruses, as well as for
  83.           damaged ZIP files.
  84.  
  85.      DFUPD.EXE
  86.           Updates your directory list file to reflect any prob-
  87.           lems found.
  88.  
  89.  
  90. Using ZVtest
  91. ------------
  92. I'll go thru this twice, once for SysOps and once for normal
  93. users - You may want to skip whichever section doesn't apply to
  94. you.
  95.  
  96.  
  97.  
  98.                              SysOps
  99.                              ------
  100.  
  101.      For reasons of preserving my sanity, we'll start with some
  102.      basic terminology: 
  103.      DIR - the DOS drive & path where the files are actually
  104.      located.
  105.      DIRLIST - the text files that your BBS uses to hold the
  106.      associated file name & description.
  107.      TMPDIR - an empty subdirecory that can be located on any
  108.      drive that will be used as temporary work space.  ZVtest
  109.      will NOT create this.
  110.  
  111.      Okay, having gotten that out of the way.  I use a batch file
  112.      to run ZVtest, you'll probably want to also.  The batch file
  113.      that I use is included in the ZVtest release file as
  114.      "SYSTST.BAT".
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126. DFFIX.EXE
  127. ---------
  128. Purpose:
  129.           DFFIX does 2 things;  it reconciles the time & date
  130.           stamp of the file with the date contained in your dir
  131.           list.  (some transfer protocols keep the originating
  132.           file creation date, and the file date is what FLIST
  133.           uses to determine if the file needs to be tested.) and
  134.           re-writes the dir file description information in
  135.           proper upper/lower case convention. 
  136.  
  137. Usage:
  138.           DFFIX requires 3 command line parameters.  They are;
  139.  
  140.           Parameter 1 is the drive, path and name of your DIRLIST
  141.           file.
  142.  
  143.           Parameter 2 is the drive & path of your DIR.
  144.  
  145.           Parameter 3 is the drive, path and filename of the new
  146.           DIRLIST file that dffix is about to create.
  147.  
  148. FLIST.EXE
  149. ---------
  150. Purpose:
  151.           FLIST creates a file named TESTFILS.LST  that contains
  152.           the drive, path and filename of all files to be tested. 
  153.           This file will be located in the current directory.
  154.  
  155. Usage:
  156.           FLIST requires 1 command line parameter and has an
  157.           optional second parameter.  The first argument is the
  158.           drive and path of the directory containing the files to
  159.           be tested.  The optional second argument is the word
  160.           ALL , which will instruct FLIST not to do the normal
  161.           date testing.  This option will simple produce a list
  162.           of the files in the directory to be tested.
  163.  
  164. BATBLD.EXE
  165. ----------
  166. Purpose:
  167.           BATBLD reads the list of files produced by FLIST and
  168.           creates a BAT file containing the DOS commands neces-
  169.           sary to extract the file, detect any errors with the
  170.           extract process, scan the files contained in the ZIP
  171.           file for the presence of virus infections, detect any
  172.           virus found information, and create a list of any
  173.           'problem' files.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181. Usage:
  182.           BATBLD requires 1 command line parameter, the directory
  183.           to be used as temporary storage space for the tests. 
  184.           This directory MUST exist (nothing in the ZVTEST kit
  185.           creates or deletes directories), and should be empty. 
  186.           If you supply the name of a directory that contains
  187.           files, it won't contain them for long....
  188.  
  189. TESTFILS.BAT
  190. ------------
  191. Purpose:
  192.           BATBLD.EXE creates this file.  If one existed before,
  193.           it was overwritten.  This is the DOS BAT file that
  194.           performs all of the tests and captures the results.
  195. Usage:
  196.           TESTFILS.BAT requires and accepts no parameters or
  197.           configuration files.  Any problems that the testing
  198.           procedure finds will be in a file named PROBLEMS.LST,
  199.           which will be located in the current directory. The
  200.           files are listed one file per line of the file.  The
  201.           type of problem will also be in this file - if the last
  202.           character on the line is a 'Z', it was unextractable. 
  203.           If the last character on the line is a 'V', a virus was
  204.           detected.
  205.  
  206.  
  207. DFUPD.EXE
  208. ---------
  209. Purpose:
  210.           DFUPD.EXE reads the list of files that had problems and
  211.           updates your dirlist file, as well as deleting the file
  212.           in question.  If the file was damaged, the first de-
  213.           scription line for that file will be rewritten to say"
  214.           DAMAGED UPLOAD: DELETED ".  If the file had a virus "
  215.           infection, the first description line will be rewritten
  216.           to say "VIRUS DETECTED: DELETED".  Each line will start
  217.           with three (3) ascii code 240 (decimal)s.  I did NOT
  218.           make the file delete an option, if you want me to, drop
  219.           me a comment and I'll hook it up.  Personally, I didn't
  220.           see the point.
  221.  
  222.  
  223.  
  224. Usage:
  225.           DFUPD requires 3 command line parameters.  They are;
  226.  
  227.           Parameter 1 is the drive, path and name of your DIRLIST
  228.           file.
  229.  
  230.           Parameter 2 is the drive & path of your DIR.
  231.  
  232.           Parameter 3 is the drive, path and filename of the new
  233.           DIRLIST file that dffix is about to create.
  234.  
  235.  
  236.  
  237.  
  238.  
  239. SysOp usage comments, etc.
  240. --------------------------
  241. The following is the section of my event that runs the ZVtest
  242. routines;
  243.  
  244.  
  245. dffix q:\pcb\gen\dir21 r:\pcb\dir21 q:\pcb\gen\newupdr.tmp
  246.  
  247.                                         Reconcile the file dates
  248.                                         with when they were
  249.                                         uploaded, and clean up
  250.                                         after the upper case
  251.                                         typists of the world.
  252.  
  253.  
  254. flist e:\pcb\dir21                      Check the files located
  255.                                         in my recent uploads
  256.                                         directory & list all of
  257.                                         the ones that have been
  258.                                         uploaded in the last 2
  259.                                         days.
  260.  
  261.  
  262. batbld e:\pcb\dir21\testwrk             Build the BAT file to
  263.                                         perform all of the tests,
  264.                                         and use the directory
  265.                                         '\pcb\dir21\testwrk' on
  266.                                         drive e: for the tempo-
  267.                                         rary workspace.
  268.  
  269. call testfils                           Call the BAT file you
  270.                                         just built.  Don't forget
  271.                                         to CALL it, or control
  272.                                         will never return to the
  273.                                         event BAT!  (If you're
  274.                                         using a DOS version pre
  275.                                         3.3, use the command/c
  276.                                         construct.)
  277.  
  278. if not exist problems.lst goto noprob   If the file PROBLEMS.LST
  279.                                         doesn't exist bypass the
  280.                                         next step or you'll get a
  281.                                         'file not found' error,
  282.                                         and the system will sit &
  283.                                         wait for you to hit
  284.                                         <ENTER>.
  285.  
  286.  
  287. dfupd q:\pcb\gen\dir21 r:\pcb\dir21 q:\pcb\gen\newupdr.tmp
  288.                                        
  289.                                         Update the dir list file
  290.                                         to reflect any problems
  291.                                         found and delete the
  292.                                         problem files.
  293.  
  294. :noprob                                 No problems were found in
  295.                                         any of the files to be
  296.                                         tested.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.                          Standard Users
  305.                          --------------
  306.  
  307.  
  308. FLIST.EXE
  309. ---------
  310. Purpose:
  311.           FLIST creates a file named TESTFILS.LST  that contains
  312.           the drive, path and filename of all files to be tested. 
  313.           This file will be located in the current directory.
  314.  
  315. Usage:
  316.           FLIST requires 1 command line paramater and has an
  317.           optional second parameter.  The first argument is the
  318.           drive and path of the directory containing the files to
  319.           be tested.  The optional second argument is the word
  320.           ALL , which will instruct FLIST not to do the normal
  321.           date testing.  This option will simple produce a list
  322.           of the files in the directory to be tested.
  323.  
  324. BATBLD.EXE
  325. ----------
  326. Purpose:
  327.           BATBLD reads the list of files produced by FLIST and
  328.           creates a BAT file containing the DOS commands neces-
  329.           sary to extract the file, detect any errors with the
  330.           extract process, scan the files contained in the ZIP
  331.           file for the presence of virus infections, detect any
  332.           virus found information, and create a list of any
  333.           'problem' files.
  334.  
  335. Usage:
  336.           BATBLD requires 1 command line parameter, the directory
  337.           to be used as temporary storage space for the tests. 
  338.           This directory MUST exist (nothing in the ZVTEST kit
  339.           creates or deletes directories), and should be empty. 
  340.           If you supply the name of a directory that contains
  341.           files, it won't contain them for long....
  342.  
  343. TESTFILS.BAT
  344. ------------
  345. Purpose:
  346.           BATBLD.EXE creates this file.  If one existed before,
  347.           it was overwritten.  This is the DOS BAT file that
  348.           performs all of the tests and captures the results.
  349. Usage:
  350.           TESTFILS.BAT requires and accepts no parameters or
  351.           configuration files.  Any problems that the testing
  352.           procedure finds will be in a file named PROBLEMS.LST,
  353.           which will be located in the current directory. The
  354.           files are listed one file per line of the file.  The
  355.           type of problem will also be in this file - if the last
  356.           character on the line is a 'Z', it was unextractable. 
  357.           If the last character on the line is a 'V', a virus was
  358.           detected.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. General Comments on ZVTEST
  366. --------------------------
  367.  
  368. I made little effort to make these programs 'pretty' since I was
  369. in a hurry and simply needed them to WORK.  They do indeed work,
  370. I have been using them on my BBS for about 8 weeks with no prob-
  371. lems at all.  If you have questions or problems with the ZVtest
  372. kit, this is where to reach me.
  373.  
  374.  
  375. The Hacker Central BBS   |  201-334-2555  |  300/1200/2400   8N1
  376.  
  377.  
  378.  
  379. Since the ZVtest kit makes use of PKwares' PKZIP utility and
  380. McAfee Associates SCAN  I want to urge you to register them if
  381. you plan on using the ZVtest kit regularly.
  382.  
  383.  
  384.  
  385. I ask for no registration fees for ZVtest because I basically
  386. wrote them for my own BBS.  If they do something that will help
  387. you,  I'm glad I was able to be of help.  If you want to send
  388. some money, I'd appreciate a donation to the Red Cross or the
  389. American Cancer Society.  Better yet  - donate some blood at your
  390. local hospital.
  391.  
  392.  
  393. If you want to call my BBS and drop a comment (or a scream) I'll
  394. be pleased to hear from you.
  395.  
  396.  
  397.  
  398.                                   Michael W. Cocke
  399.                                   12/2/89
  400.  
  401.  
  402.  
  403.