home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / bbs_oth / vkill200.zip / VKILL.DOC < prev   
Text File  |  1992-06-25  |  9KB  |  205 lines
  1.  
  2.                    ┌───────────────────────────────────────┐
  3.                ████│               V K i l l               │▓███
  4.                    │              Version 2.0a             │
  5.                ████│          Release Date 06/25/92        │▓███
  6.            └───────────────────────────────────────┘
  7.  
  8.                         (C) 1991, 1992 Cairo Research Labs
  9.                                ALL RIGHTS RESERVED
  10.  
  11. ─────────────────────────────────────────────────────────────────────────────
  12. ■ INTRODUCTION ■
  13. ─────────────────────────────────────────────────────────────────────────────
  14.  
  15. VKill is an automated Virus/Archive scanner designed for use with Scott
  16. Dudley's Maximus CBCS.  It's features include:
  17.  
  18.         * Capability of handling an unlimited amount of nested archives
  19.         * Fully configureable to facilitate archiver/scanner updates
  20.         * Test archives and/or contents of archives against a date stamp
  21.           to provide a method of preventing users from getting credit by
  22.           by uploading out-of-date or old archives.
  23.         * Will not accept archives other than the types you specify!
  24.         * Special Extension handling (i.e. GIF, PCX, MOD, VOC, etc).
  25.         * Eye-pleasing graphics for your users to view as VKill works!
  26.  
  27. ─────────────────────────────────────────────────────────────────────────────
  28. ■ WORD FROM THE AUTHOR ■
  29. ─────────────────────────────────────────────────────────────────────────────
  30.  
  31. Computer virus infections are on the rise.  We'd be kidding ourselves if we
  32. stated otherwise.  I was one of those folks who held the high opinion that
  33. it would never happen to me.  It did.  Living through those several hours of
  34. data recovery did quite a few wonders on my opinions of viruses.  VKill was
  35. written as a Maximus CBCS plug-in to offer another preventive step for us
  36. Sysops.  No one wants to see a horde of angry users pounding at your door,
  37. because they nabbed an infected file off of your system! ;-)
  38.  
  39. Please folks, keep in mind that I am a programmer, not an author!  These
  40. docs really suck the "cosmic muffin", but they are getting better.  I do not
  41. claim in any way that VKill will work for you!  The only thing I can claim is
  42. that it works flawlessly on my system.  Due to the fact that VKill is
  43. FreeWare, and I am not charging for it's use, then I cannot promise to what
  44. degree tech support will be given.  I can be found in the MUFFIN echo for you
  45. fido dogs, and am also active now in IntlNet and SBNet.  I will be more than
  46. happy to answer any netmails or echomail directed to me referencing VKill.
  47.  
  48. Or, if you wish, you may call my system direct:
  49.  
  50.         Cairo Research Labs
  51.         Under the Nile!
  52.         (706) 596-8126 9600v.32
  53.         1:3613/12@fidonet
  54.  
  55. ─────────────────────────────────────────────────────────────────────────────
  56. ■ OPERATION NOTES ■
  57. ─────────────────────────────────────────────────────────────────────────────
  58.  
  59. Operating VKill is a cinch.  When a user completes an upload session, Maximus
  60. will call a batch file called VIRCHECK.BAT.  Simply place VKill in this batch
  61. file and let her go.  A sample VIRCHECK.BAT file should be included with this
  62. archive.
  63.  
  64. VKill processes the uploaded file based upon the extension of the file.  All
  65. you have to do is ensure that the popular archivers are available in your
  66. path, (i.e. PKZIP, LHARC, ARJ, PAK, etc).  It will handle multiple nested
  67. archives of DIFFERENT types as well!
  68.  
  69. VKill will exit on the following errorlevels:
  70.  
  71.         1 - Infected File was uploaded
  72.         2 - Bad Archive was uploaded
  73.         3 - Invalid Command line parameters
  74.         4 - General error - Invalid dir, etc.
  75.     5 - Archive(files) older than check date stamp
  76.         6 - Special File Extension encountered
  77.        99 - Suspicious File Extension
  78.  
  79. If VKill detects an infected file, a bad archive, or a suspicious file
  80. extension, the file is moved to a holding directory, and will remain there
  81. until you delete it.  This ensures that infected files and the like will not
  82. remain online for your users!
  83.  
  84. ***NOTE*** A Suspicious file extension is one that ends something that has
  85. not been defined in your configuration file.  (i.e. not a valid archive or a
  86. special extension type).
  87.  
  88. A sample DORINFO1.DEF file has been included to allow you to test in local
  89. mode operation.
  90.  
  91. ─────────────────────────────────────────────────────────────────────────────
  92. ■ CONFIGURATION ■
  93. ─────────────────────────────────────────────────────────────────────────────
  94.  
  95. The configuration file is where everything comes together.
  96.  
  97. PATH1, PATH2 = These options simply specify which two directories to use in
  98.                case VKill encounters an archive within an archive.  VKill
  99.                will essentially use these two directories to "bounce" back
  100.                and forth until there are no more remaining multiple archives.
  101.  
  102. BADPATH = This is the path of your holding directory for infected files, bad
  103.           archives, or files with suspicious extensions.
  104.  
  105. LOGPATH = This is the FULL PATH and FILENAME of the logfile generated and
  106.           maintained by VKill.  It is possible to run VKill on multinode
  107.           systems, by specifying a different configuration file per node.
  108.           If you are running a multinode BBS, just make each logfile unique.
  109.  
  110. DATECHECK = This option will allow you to provide a check for old or
  111.             out-of-date archives.  There are two methods of configuring the
  112.             datecheck system.  See the sample config file for more info.
  113.  
  114. ARCDEF = Signifies an ARChiver DEFinition.  See the config file for more info
  115.          on defining archivers.
  116.  
  117. SCANDEF = Signifies the Virus Scanner Definition.  See the config file for
  118.           more info on defining your scanner.
  119.  
  120. The remainder of the config file is pretty much self-explanatory.
  121.  
  122. ─────────────────────────────────────────────────────────────────────────────
  123. ■ COMMAND LINE ■
  124. ─────────────────────────────────────────────────────────────────────────────
  125.  
  126. VKill accepts the following parameters, in THIS order:
  127.  
  128.         [UPLOAD PATH] - Path to uploaded file
  129.         [FILENAME]    - Name of uploaded file
  130.         [EXTENSION]   - Extension of uploaded file
  131.         [DORINFO]     - Path of DORINFOx.DEF file....
  132.         [CONFIG]      - Path and filename of configuration file
  133.  
  134. When called from a VIRCHECK.BAT, it should look something like:
  135.  
  136.         VKILL.EXE %1 %2 %3 c:\max c:\max\vkill.cfg
  137.  
  138. since Maximus will pass the first 3 to VIRCHECK.BAT automatically.  Actually,
  139. Maximus will also pass as a fourth parameter the path to the MISC directory.
  140. Since VKill doesn't use it in any way, there's no since in passing it.
  141.  
  142. A sample DORINFO1.DEF file has been included to allow you to test in local
  143. mode operation.
  144.  
  145. In order for VKILL to obtain the information he needs on the current user's
  146. baud rate, your COM port settings, etc, you must create a DORINFOx.DEF file
  147. prior to calling VKill.
  148.  
  149. Here at Under the Nile, in my MENUS.CTL, under the FILE menu, I use:
  150.  
  151.   NoDsp Display_File    Misc\uploads           Disgrace "Upload (send)"
  152.         Upload                                 Disgrace "Upload (send)"
  153.  
  154. In my C:\MAX\MISC directory, I have a MECCA file called UPLOADS.BBS, which
  155. looks like this:
  156.  
  157. -------------[ cut here ]---------------
  158.  
  159. [cls]
  160. [LIghtred]Upload Policy!
  161. [Cyan]
  162. Please do not upload GIFS, games, or any other file not pertaining to the
  163. format of this BBS!  The file should fall into one of the following
  164. categories:
  165.  
  166. [yellow]Programming  -[white] C, BASIC, Pascal, Assembler, etc.
  167. [yellow]Video        -[white] Graphics (NO GIFS), Animation files, CAD, etc.
  168. [yellow]Audio        -[white] SoundBlaster, AdLib, .MOD, .VOC, .SND, etc.
  169. [yellow]Multitasking -[white] Windows Applications, Desqview, Desqview/X, etc
  170. [yellow]General Util -[white] Archivers, System Utilities, etc.
  171. [lightgreen]
  172. [enter]
  173. [link]c:\max\misc\dorinfo
  174.  
  175. -------------[ cut here ]---------------
  176.  
  177. This will create a DORINFO1.DEF file for the current user.  See the Max docs
  178. for more info on this one.
  179.  
  180. ─────────────────────────────────────────────────────────────────────────────
  181. ■ REGISTRATION ■
  182. ─────────────────────────────────────────────────────────────────────────────
  183. Currently, there is no registration fee for using VKill.  We have quite a bit
  184. in store for VKill in the future, so that may change.
  185.  
  186. For the latest version of VKill, or for tech support by BBS, call:
  187.  
  188. Under The Nile!                 BackWoods BBS
  189. (706) 596-8126 9600 v.32        (706) 561-6106 9600 USR DS
  190. 1:3613/12@fidonet               1:3613/10@fidonet
  191.  
  192.  
  193. Magic Name VKILL will get you the latest version!
  194.  
  195.  
  196. Coming soon to VKill!
  197. ─────────────────────
  198.  
  199. o  Archive conversion?!
  200. o  GIF Integrity Testing!
  201. o  Remove BBS Advertisements!
  202. o  Replace Archive Comments!
  203. o  Much more!!
  204.  
  205.