home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / virus / virchk2a.zip / README.DOC < prev    next >
Text File  |  1993-07-27  |  12KB  |  243 lines
  1. ╔═══════════════════════════════════════════════════════════════════════════╗                               
  2. ║ ▀\      ▀\ ▀\ ▀▀▀▀\  ▀\   ▀\  ▀▀▀▀▀\                                      ║
  3. ║  ▀\    ▀\  ▀\ ▀\  ▀\ ▀\   ▀\ ▀▀\                                          ║
  4. ║   ▀\  ▀\   ▀\ ▀▀▀\   ▀    ▀\  ▀▀▀▀\                                       ║
  5. ║    ▀\▀\    ▀\ ▀\  ▀\ ▀\   ▀\     ▀▀\                                      ║
  6. ║     ▀\     ▀\ ▀\   ▀\ ▀▀▀▀\  ▀▀▀▀▀\                                       ║
  7. ║                                  ▀▀▀▀▀\ ▀\    ▀\ ▀▀▀▀▀\   ▀▀▀▀▀\  ▀\  ▀\  ║
  8. ║                                 ▀▀\     ▀\    ▀\ ▀\      ▀▀\      ▀\ ▀\   ║
  9. ║                                ▀▀\      ▀\▀▀▀\▀\ ▀▀▀▀\  ▀▀\       ▀▀\     ║
  10. ║                                 ▀▀\     ▀\    ▀\ ▀\      ▀▀\      ▀\ ▀\   ║
  11. ║ v2.0a                            ▀▀▀▀▀\ ▀\    ▀\ ▀▀▀▀▀\   ▀▀▀▀▀\  ▀\  ▀\  ║
  12. ╚═══════════════════════════════════════════════════════════════════════════╝
  13.  VIRUS-CHECK v2.0a
  14.  
  15.  Validates archives, performs virus check and comments ZIP and ARJ files 
  16.  automatically!  Jointly developed by --
  17.  
  18.           Gary Gilmore (1:2410/400) and Gary Weinfurther (1:120/301)
  19.  
  20. ╓────────────────────────────────────────╖                                
  21. ║ ░░░▒▒▒▓▓▓███ What it does ███▓▓▓▒▒▒░░░ ║
  22. ╙────────────────────────────────────────╜
  23.  
  24. VirusCheck (Called VIRCHECK from herein), when called from Maximus, will
  25. determine what archive type an upload is, unpack it, scan it for virus
  26. infection, then add your personal BBS comment to the archive.  (If it's
  27. a ARJ or ZIP archive.)  Should an upload fail due to SCAN error or
  28. infection, VIRCHECK will notify the sysop via netmail/localmail, and
  29. move the file into a private directory for later review by the sysop.
  30. (See SAMPLE.MSG for an example of the warning letter sent to the sysop.)
  31.  
  32. ╓──────────────────────────────────────╖                                
  33. ║ ░░░▒▒▒▓▓▓███ What it is ███▓▓▓▒▒▒░░░ ║
  34. ╙──────────────────────────────────────╜
  35.                                 
  36. A batch file.  That's it.  No "hocus-pocus" involved.  You can even change
  37. it around if you like.  (You might have to, different paths, etc.)
  38. The BTM files are for 4DOS users.  BTM files run faster than BAT files,                                
  39. as BAT files are executed one line at a time, while BTMs are run "all at
  40. once".
  41.  
  42. ╓────────────────────────────────────────╖                                
  43. ║ ░░░▒▒▒▓▓▓███ Installation ███▓▓▓▒▒▒░░░ ║
  44. ╙────────────────────────────────────────╜
  45.  
  46. In this archive, you should have the following files:
  47.  
  48. README   DOC    11750  This file you're reading
  49. VIRCHECK BAT     5237  DOS version
  50. VIRCHECK BTM     4423  4DOS version, part 1
  51. ZC       BTM      612  4DOS version, part 2
  52. VIRUSMSG CFG     3682  CFG file for MakeMsg - Needs editing!
  53. REGISTER ME!      877  Info about registration <g>
  54. SAMPLE   MSG     1357  Example of virus notification msg
  55. COMMENT  ZH       364  Comment file added to uploads
  56. MECFILES ZIP     3832  MEC/BBS files shown to users after upload
  57. MKMSG231 ZIP    41495  MakeMsg, sends notices to you net/local mail
  58. ZC210    ZIP    16376  Commenting program.  Faster than calling PKZip!
  59. FILE_ID  DIZ      198  Useless...delete it.  <g>
  60.  
  61. If you don't, file request VIRCHECK from 1:2410/400.
  62.  
  63. You WILL need McAfee's SCAN.EXE program to complete this program.
  64. Download the latest version from a BBS near you.
  65.  
  66. First off, decide which version you're running.  For 4DOS users, you'll
  67. use VIRCHECK.BTM.  For COMMAND.COM users (MS-DOS), you'll use the 
  68. VIRCHECK.BAT file.  Knowing this, edit your MAX.CTL file like this:
  69.         
  70.         ====================================================
  71.         % Max will call this batch file once for each file uploaded.  For
  72.         % more information on this keyword, please see MAX_REF.PRN.
  73.  
  74.                 Upload Check Virus      Vircheck.BTM
  75.         ====================================================
  76.  
  77. If you fail to do this, Max will NEVER call VIRCHECK, or may call some
  78. other program that you previously defined in here.  Now SILT MAX!
  79.  
  80. Unpack the MECFILES.ZIP into your C:\MAX\MISC directory.
  81. (You may wish to edit these as you see fit later. For now, leave them
  82. alone.)
  83.  
  84. Unpack ZCP.ZIP.  Copy the ZCP.EXE file into C:\MAX.
  85.  
  86. Unpack MKMSG231.ZIP.  Copy MKMSG.EXE into C:\MAX.
  87.  
  88. Copy the VIRUSMSG.CFG file into C:\MAX.  MAKE SURE you edit it to suit
  89. your system, or your virus notification will go God knows where!
  90. There's really nothing to do but "fill in the blanks", but I suggest you
  91. read the MakeMsg docs to understand what the program does, and how it
  92. does it.  NOTE:  If you change the name of this CFG file, you WILL have
  93. to change it in VIRCHECK also!
  94.  
  95. Copy COMMENT.ZH into your C:\MAX dir.  EDIT THIS!  Unless you want a real
  96. goofy comment, you will need to edit this for your system.
  97.  
  98. 4DOS USERS:  Copy VIRCHECK.BTM -AND- ZC.BTM into C:\MAX.
  99. DOS Users:  Copy VIRCHECK.BAT into C:\MAX.
  100.  
  101. ╓─────────────────────────────────────╖                                
  102. ║ ░░░▒▒▒▓▓▓███ Operation ███▓▓▓▒▒▒░░░ ║
  103. ╙─────────────────────────────────────╜
  104.  
  105. The first time a user uploads to your system after installing this, you'll
  106. notice a new DIR on your C:\ drive, called \VIRUS.  Don't panic.  This is
  107. where VIRCHECK does it's work.  Normally, you should hear nothing from
  108. VIRCHECK, unless you get an infected upload.  Commenting will be done
  109. automatically to ZIP and ARJ files.  (Check it if you like.)  That's all
  110. there is to it!  You now have a nice, fast, FREE virus checker on your
  111. BBS.  No drop files to mess with, no charges, easy to change if needed.  
  112. Nice, eh? <g>  We think so.
  113.  
  114. ╓───────────────────────────────────────────────────────╖                                
  115. ║ ░░░▒▒▒▓▓▓███ Warnings and Considerations ███▓▓▓▒▒▒░░░ ║
  116. ╙───────────────────────────────────────────────────────╜
  117.  
  118. Things you might have to change:
  119.  
  120. All the archivers mentioned in VIRCHECK, as well as the SCAN program, 
  121. _MUST_ be in your path so VIRCHECK can find them.  THIS WILL FAIL if
  122. you do not have them in your path.  ('nuff said!)
  123.  
  124. The "C:\MAX" directory must also be in your path.  (If it's not, I don't
  125. know how you can run the BBS!)
  126.  
  127. Some systems will gag if you do a "ECHO Hello World>COM1".  Vircheck
  128. makes these calls.  If your system hangs on this, simply remove any
  129. ">COM1" redirects.  It won't affect VIRCHECK's operation.
  130.  
  131. Also, if you run a multiline system, you don't really want the user on
  132. COM2 seeing "Scanning FILENAME.EXT..." while he's reading messages. <g>
  133. (Though, with a little imagination, you can fix that up easily.)
  134.  
  135. VIRCHECK, as supplied, will refuse uploads with an extention of .ARC, 
  136. .PAK, and .BAT.  You may add or subtract from this list as you see fit.
  137. It also looks for Macintosh uploads, via the .SEA, .CPT, and .SIT
  138. extentions.  Uploads determined to be Mac are passed straight through
  139. the file, and the uploader given a "Mac files checked later"-type message.
  140. (Until they come up with a DOS-based Mac virus checker, this will have to 
  141. do.)  If you don't allow Mac uploads, you can remove this code, or, you
  142. can leave it in, as it won't make any real difference.
  143.  
  144. Should you want to treat other uploads like this (i.e. Apple II .SHK files),
  145. simply copy the code in the Mac portion of the file.  Adjust accordingly.
  146.  
  147. Don't be afraid to read the VIRCHECK files.  They're easy to follow, and
  148. may give you ideas on things you want to change, or add to it.
  149.  
  150. ╓─────────────────────────────────────────────────────╖                                
  151. ║ ░░░▒▒▒▓▓▓███ SCAN & Memory Constraints ███▓▓▓▒▒▒░░░ ║
  152. ╙─────────────────────────────────────────────────────╜
  153.                                 
  154. Both Gary and I had trouble with SCAN in a DV window, running Maximus.
  155. Seems v1.06 of SCAN kept wanting 390k (!) more memory, which was NOT
  156. available.  To bypass this, we use a program called SHELLROOM.
  157. This will shell Maximus completely out, giving SCAN tons of room.
  158. (My system reports 510k available after shelling!)
  159.  
  160. If you need this, freq SHROM*.* from my system (1:2410/400).
  161. (SHROM20A.ZIP was the current version as of this writing.)
  162.  
  163. If you usually call Max like this:
  164.  
  165. max %1 %2 %3 %4 %5
  166.  
  167. Run Shroom from the RUNMAX.BAT like so:
  168.  
  169. shroom -tSCAN.EXE max %1 %2 %3 %4 %5
  170.  
  171. This will cause Shroom to shell out Max ONLY when running SCAN.
  172.  
  173.                ╓──────────────────────────────────────────╖                                
  174.                ║ ░░░▒▒▒▓▓▓███ GENERAL NOTICE ███▓▓▓▒▒▒░░░ ║
  175.                ╙──────────────────────────────────────────╜
  176.  
  177.    This computer archive is being distributed under the HELPWARE concept.
  178.    This means that you are granted license to evaluate this software for
  179.    a period of THIRTY YEARS. Should you continue to use it beyond this 
  180.    time, we'll be amazed!  HELPWARE means -we- put this out to help YOU.
  181.    If this program does, then we accomplished our goal.
  182.  
  183.    If you should decide to pass this file along, be SURE to only pass
  184.    out the ORIGINAL archive.  DO NOT PASS OUT ANY PASS OUT ANY PART OF
  185.    THIS PACKAGE INDIVIDUALLY!  Doing so could mess someone up down the 
  186.    line.  If you want to share it (please do!), give out only the complete
  187.    archive.  Also, don't be a weenie and take our names off these files.
  188.    They're there so folks can contact us with suggestions or compliments.
  189.    (Compliments?  Hmmm...  Now THERE'S a concept!)  :-)
  190.  
  191.           ╓────────────────────────────────────────────────────╖                                
  192.           ║ ░░░▒▒▒▓▓▓███ BENEFITS OF REGISTRATION ███▓▓▓▒▒▒░░░ ║
  193.           ╙────────────────────────────────────────────────────╜
  194.  
  195.    See the included file REGISTER.ME! for complete details on registration.
  196.  
  197.                   ╓────────────────────────────────────╖                                
  198.                   ║ ░░░▒▒▒▓▓▓███ WARRANTY ███▓▓▓▒▒▒░░░ ║
  199.                   ╙────────────────────────────────────╜
  200.  
  201.    We guarantee that you'll need a computer running MS-DOS (command.com)
  202.    or 4DOS, as well as Maximus CBCS, to use these files.  That's about it.
  203.    The authors make absolutely no warranties on this software. This software
  204.    is not even warranted to take up space on your disk!  USE THIS SOFTWARE
  205.    AT YOUR OWN RISK!  The authors are not responsible for any damages what 
  206.    so ever.
  207. ╓───────────────────────────────────────╖                                
  208. ║ ░░░▒▒▒▓▓▓███ Thank You's ███▓▓▓▒▒▒░░░ ║
  209. ╙───────────────────────────────────────╜
  210.  
  211. Thanks to Jeff Galbraith for MakeMsg.  What a GREAT program!
  212. Thanks to Jeff Garzik for ZCP, the Zip Commenter.
  213. Thanks to Merrill Guice for turning me and Gary on to SHROOM.
  214. Thanks to Mark Woolworth, who's forever hatching things for me in SDSMAX.
  215. Most of all, thanks to Scott Dudley, for writing Maximus!
  216.  
  217. ..and I'd like to thank Gary Weinfurther, for telling me to run Maximus
  218.  in the first place, and for being my mentor when I was switching from
  219.  an Apple IIgs to my first DOS PC. I'd still be staring at the "C:\>" 
  220.  prompt without all his help!
  221.  
  222.       This file is dedicated to my late father, Thomas L. Gilmore.
  223.  
  224. MakeMsg (c) Jeff Galbraith
  225. ZCP (c) Jeff Garzik
  226. ShellRoom (c) Davis Augustine
  227. ViruScan (c) McAfee Associates
  228. Maximus-CBCS (c) Scott Dudley
  229.  
  230. This documentation written (poorly) by Gary Gilmore, very late at night.
  231.  
  232. If you have further questions about this package, feel free to contact us:
  233.  
  234. Gary Weinfurther
  235. The Flying Circus BBS - Royal Oak, MI
  236. FidoNet 1:120/301  (313) 549-4214
  237.  
  238. Gary Gilmore
  239. The Bloom County BBS - Dearborn, MI
  240. FidoNet 1:2410/400  (313) 582-0888
  241. InterNet: afcgaryg@aol.com
  242. America Online: AFC GaryG
  243.