home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / VIRUS / AUTOSN32.ZIP / AUTOSCAN.DOC < prev    next >
Encoding:
Text File  |  1991-06-10  |  14.9 KB  |  348 lines

  1.  
  2.                ╓──╖
  3.                ║  ║
  4.                ║  ║  ╥   ╥ ╓─╥─╖ ╓───╖ ╓───  ╓───╖  ╓──╖  ╥┐   ╥
  5.               ╓╨──╨╖ ║   ║   ║   ║   ║ ║     ║      ║  ║  ║└┐  ║
  6.               ║    ║ ║   ║   ║   ║   ║ ╙───╖ ║     ╓╨──╨╖ ║ └┐ ║
  7.               ║    ║ ║   ║   ║   ║   ║     ║ ║     ║    ║ ║  └┐║
  8.               ╨    ╨ ╨───╨   ╨   ╙───╜ ────╜ ╙───╜ ╨    ╨ ╨   └╨
  9.                      v   e   r   s   i   o   n     3  .  2
  10.                 Copyright (C) 1991, /\/\ountainTop Technologies
  11.                   All Rights Reserved. Written by Nick Tucker.
  12.  
  13.  
  14.  Why the need for such a complicated algorithm?
  15.  ──────────────────────────────────────────────
  16.  There was a need for a quick and easy way checking files for viruses
  17.  on BBS systems (Recent Uploads can always be a hazard, especially when
  18.  left unattended). There are many "shells" that are available, but they
  19.  are either too slow or don't work correctly. AUTOSCAN was written to 
  20.  work with the McAffee SCAN program and various archiving programs.
  21.  
  22.  Required Files
  23.  ──────────────
  24.  PKUNZIP.EXE
  25.  PAK.EXE
  26.  PKUNPAK.EXE (or PKXARC.EXE and/or XARC.EXE)
  27.  LHARC.EXE (or ICE.EXE)
  28.  ARJ.EXE
  29.  SCAN.EXE
  30.  
  31.  (All of the current versions can be obtained from my board or the support
  32.  boards).
  33.  
  34.  How does it work?
  35.  ─────────────────
  36.  The way it works is very simple, all it does is un-archive any ZIP, ARC,
  37.  ICE, LZH, PAK, or ARJ file into a work directory (\AUTOSCAN.30), then
  38.  use McAffee's SCAN.EXE to scan it for any virus (Since SCAN is updated
  39.  regularly, you don't have to worry about AutoScan becoming outdated or
  40.  missing any recent viruses.) If all goes well and no viruses are found,
  41.  it deletes all the "work" files and then moves onto the next file and
  42.  repeats the process.
  43.  
  44.  To get going is real simple, copy AUTOSCAN.EXE into a directory in your
  45.  path ( example in AUTOEXEC.BAT:
  46.  
  47.  PATH = C:\;C:\UTIL;
  48.  
  49.  when AUTOSCAN.EXE is in C:\UTIL ).  Change to the directory you wish to
  50.  scan, and type "AUTOSCAN". 
  51.  AutoScan will then look through the Current Directory for ZIP, ARC, 
  52.  ICE, PAK, LZH, ARJ and SDN files, un-archive them and scan them, if all
  53.  goes well it will proceed onto the next file. In order for everything to
  54.  work all the un-archivers should be within reach upon the currect path,
  55.  PKUNPAK.EXE, PKUNZIP.EXE, LHARC.EXE, ICE.EXE, PAK.EXE, ARJ.EXE and, most
  56.  importantly, SCAN.EXE.  If any of the un-archivers are not found that 
  57.  section will not execute, you don't need them all to run AUTOSCAN, 
  58.  however if SCAN.EXE is not located the program will halt.
  59.  
  60.  AutoScan will keep a detailed log of it's activities in the same
  61.  directory that contains AUTOSCAN.EXE appropriately named AUTOSCAN.LOG. 
  62.  If it already exists, new information will be appended to it.
  63.  
  64.  "What if?" he said
  65.  ──────────────────
  66.  What if there is an archive within an archive? AutoScan will detect if there
  67.  are any archives within archives - to any level and any combination of
  68.  archive types. If an error is located in a "sub archive" that name is placed
  69.  in the log along with the main archive name and what the error was - Virus
  70.  or bad archive.  
  71.  
  72.  About ARC
  73.  ─────────
  74.  AutoScan supports most major ARC type archivers, PKPAK, PKARC and the SEA
  75.  ARC7, it can tell the difference between the three and will use the 
  76.  appropriate archiver to un-archive the file. If AutoScan detects a file
  77.  generated by the ARC7 archiver and XARC is not available that file will be 
  78.  skipped, however if XARC is found and PkPak or PkArc isn't, AutoScan will 
  79.  attempt to use ARC7 for the Arc type unarchiver.
  80.  
  81.  About PAK
  82.  ─────────
  83.  AutoScan, when examining a PAK archive, will only un-archive the type 10
  84.  compression (Crushed) and the type 11 compression (Distilled).
  85.  
  86.  SETTING THE ENVIRONMENT
  87.  ───────────────────────
  88.  Some DOS versions don't report the drive name when asked to...If you see
  89.  "  ■ FOUND \DOS\PKUNZIP.EXE " (note the missing "C:") and then AutoScan 
  90.  exits on an error then you have this problem.  Starting with this version
  91.  the ability to use an Environmental Variable has been added.  Somewhere in
  92.  your AutoExec.Bat add a line that reads
  93.  " SET AUTOSCAN={drive\path} " to where AutoScan.Exe can be found.  Consult
  94.  your DOS manual on further help with setting the environment.
  95.  
  96.  COMMAND LINE OPTIONS
  97.  ────────────────────
  98.  AUTOSCAN /S
  99.  If you wish to have your Hardrive scanned as well put a /S on the command
  100.  line.  Drives C: through H: will be scanned if they exist.  The setting
  101.  in AutoScan.Cfg (if it exists) with the /P option will be used with SCAN.EXE
  102.  
  103.  AUTOSCAN /Q 
  104.  When AutoScan finishes it sounds a two tone bell a few times, or in the
  105.  case of a VIRUS, many times! If you wish to run it in the QUIET MODE put
  106.  a /Q on the command line.
  107.  
  108.  AUTOSCAN /C 
  109.  This will trick AutoScan into thinking that there is a virus, and will do
  110.  the following:
  111.  1. Rename the archive to .BAD
  112.  2. Exit at an errorlevel of 1
  113.  3. Beep it's ass off if you're unregistered or not working in "Quiet" mode
  114.  You must have an archive in the current directory (ALONG WITH CHECK.EXE)
  115.  to use this.  You may use no other command line options.
  116.  
  117.  AUTOSCAN /R
  118.  AutoScan will rescan all files archives. This option is as if you had 
  119.  deleted AutoScan.Dat, which is exactly what AutoScan does.
  120.  
  121.  AUTOSCAN /M
  122.  AutoScan will instruct Scan.exe not to scan RAM at all. Without this option
  123.  RAM will be scanned only on the first pass or if a virus was found RAM will
  124.  be scanned again.
  125.  
  126.  AUTOSCAN /O
  127.  To scan a single file. This will not enter the name into AUTOSCAN.DAT, or
  128.  even check to see if it has been processed before. Just a quick and dirty
  129.  scan. IE: AUTOSCAN /OTEST.ZIP 
  130.  A path and file name can be specified, sorry no wildcards.
  131.  
  132.  AUTOSCAN /F
  133.  This will instruct AutoScan to reboot the machine once all operations have
  134.  been completed, a five (5) second count down can be aborted by pressing any
  135.  key. This feature is usefull if you are doing an entire drive scan and don't
  136.  want to sit around watching it run, when it's done it will reboot and bring 
  137.  up your BBS or Menu system if you have one. 
  138.  
  139.  AUTOSCAN /U
  140.  This will instruct AutoScan to uses a specific drive to unarchive files
  141.  to.  /UC will cause AutoScan to create the work directory \AUTOSN on the
  142.  C drive ( C:\AUTOSN ) reguardless of what drive AutoScan is on.  
  143.  The use of a RAMDISK will greatly increase the speed of AutoScan, however
  144.  be aware of the size of the RamDisk and the size of the archive you wish
  145.  to scan! 
  146.  
  147.  AUTOSCAN /N  * - Registered Version.
  148.  This will instruct AutoScan to check for Bad Archives ONLY, only use this
  149.  option if you are sure the file is free of Virus's. 
  150.  
  151.  AUTOSCAN /A  * - Registered Version.
  152.  AUTOSCAN will search the ENTIRE DRIVE for archives and scan them. AUTOSCAN
  153.  will not update the AUTOSCAN.DAT or check to see if the file has been
  154.  processed. IE: AUTOSCAN /AC: If no drive is specified the default is used.
  155.  
  156.  AUTOSCAN /T  * - Registered Version.
  157.  This will instruct AutoScan to check the size, time and date of the archive.
  158.  If it has changed, the archive will be rescanned. If you run AutoScan from a
  159.  BBS to check any recent uploads you might not want to use this option. If you
  160.  add ZIP comments to a file, it will obviously change the file size and cause
  161.  AutoScan to rescan it.
  162.  
  163.  AUTOSCAN /D  * - Registered Version.
  164.  With this option you can specify the directory to scan on the command line.
  165.  IE: AutoScan /DF:\WORK . Any files in the F:\WORK directory will be scanned.
  166.  
  167.  AUTOSCAN /I  * - Registered Version.
  168.  All this does is supress the blue or red box upon completion, the same info
  169.  is written to the screen in a "normal manner".
  170.  
  171.  AUTOSCAN /B  * - Registered Version.
  172.  To direct AutoScan to place any .BAD files in a specified directory.
  173.  IE: AUTOSCAN /BC:\BADFILES  where C:\BADFILES is the directory.
  174.  
  175.  All command line options must be seperated by a space and they may be in 
  176.  any order you wish. 
  177.             AUTOSCAN /Q /R /BC:\BADFILES /I /DE:\RECENT
  178.  This would cause AUTOSCAN to run in Quiet Mode (/Q), rescan all files (/R),
  179.  copy all .BAD files to C:\BADFILES (/B), supress the ending screen (/I), 
  180.  and examine the directory E:\RECENT (/D). The Command line is limited to 
  181.  80 characters so keep those paths small!!
  182.  
  183.  AUTOSCAN.CFG
  184.  ────────────
  185.  Included in the Archive is a file called AutoScan.Cfg. In this file you can
  186.  set certain default settings for AutoScan. Edit this file with an ASCII editor
  187.  to suit your liking. If you wish to use different config files you can specify
  188.  the name on the command line with the /K option.
  189.  AUTOSCAN /KC:\AUTOCFG.CFG would cause AutoScan to use the Autocfg.Cfg file
  190.  in the root directory of drive C:. This option MUST BE THE FIRST OPTION 
  191.  otherwise it will be ignored. You can add further options on the command line
  192.  after the /k option, IE: AutoScan /KC:\AUTOCFG.CFG /R /I .
  193.  To set the command line parameters for SCAN.EXE use the /P option within the
  194.  current config file.  As many parameters can be used as long it is limited to
  195.  100 characters.  /P /A /FR will cause Scan to scan all files and display all
  196.  messages in french.
  197.  
  198.  HELP and SCAN.EXE
  199.  ─────────────────
  200.  For help on the fly type AUTOSCAN ? and it will display some information
  201.  about itself.
  202.  
  203.  In order for AutoScan to detect all known virus's you must keep your
  204.  version of SCAN.EXE as current as possible. AutoScan is only as good
  205.  as the Scanner it uses. SCAN.EXE can be found on most good bulletin 
  206.  boards in your area. 
  207.  
  208.  *.BAD
  209.  ─────
  210.  If AutoScan comes across a bad archive or a virus that file will be
  211.  renamed to "filename".BAD and make a note in the log indicating which
  212.  file is SUSPECT of being bad. If a file is flagged as being bad you 
  213.  might want to examine it manually to see why. If the /B option was used
  214.  that file would be copied to the specified directory.
  215.  
  216.  NEWLIST.TXT
  217.  ───────────
  218.  As AutoScan runs it generates a file called NEWLIST.TXT. In this file it
  219.  will place the names of any new files that it has just processed. If you
  220.  have an archive commenter that can use this file then please do. I am in
  221.  the process of writing one for ZIP files and it should be released soon.
  222.  
  223.  F10 - ABORT 
  224.  ───────────
  225.  While AutoScan is running pressing  F10 will cause AutoScan to abort the
  226.  current session.  AutoScan will only stop once the current file has been
  227.  finished and the work files have all been deleted. AutoScan will report on
  228.  the current status of it's operation and further runnings of AutoScan will
  229.  just pick up where it left off.  AutoScan will exit on an ERRORLEVEL of 0
  230.  in this case.
  231.  
  232.  AUTOSCAN.DAT
  233.  ────────────
  234.  Once AutoScan has completed its operations it will update a file called
  235.  AUTOSCAN.DAT, this file contains a list of files that have already been
  236.  scanned.  For sysops, this makes it possible to run AutoScan after users
  237.  have logged off the BBS, and if any new files were uploaded, they get
  238.  scanned right away and removed from circulation if needed. 
  239.  
  240.  The Naughty Bits
  241.  ────────────────
  242.  Each time AutoScan starts up it checks it's own size and CRC, and if it
  243.  has changed, it will terminate with a nasty message. AutoScan will also
  244.  check disk space each time it starts up. If the amount of disk space left
  245.  is less than 150% of the archive size AutoScan will exit on a ErrorLevel 1.
  246.  
  247.  Errorlevels
  248.  ───────────
  249.  AutoScan will exit on one of 5 DOS ErrorLevels..
  250.  
  251.            ErrorLevel 0 - New Files found and processed.
  252.            ErrorLevel 1 - SCAN.EXE missing / No Disk Space /
  253.                           AUTOSCAN.EXE infected / File Error.
  254.            Errorlevel 2 - No New Files. 
  255.            ErrorLevel 3 - Bad Archive, Renamed to .BAD.
  256.            ErrorLevel 4 - VIRUS, Renamed to .BAD.
  257.  
  258.  What In?
  259.  ────────
  260.  AUTOSCAN is written in Turbo Pascal 6.0 and some routines are from
  261.  the TechnoJock Turbo Toolkit V5.02 (excellent package if your a TP 4/5/6
  262.  programmer).
  263.  
  264.  AUTOSCAN uses many "outside" programs, without which AUTOSCAN would not
  265.  function. Please show your appreciation and register these fine programs.
  266.  
  267.  What If?
  268.  ────────
  269.  If AUTOSCAN does report that SCAN.EXE found a virus, what do I do?  Either
  270.  contact McAffee Associates, and they can guide you through getting rid of
  271.  the virus, or you can run SCAN.EXE manually with a /D on the command line.
  272.  SCAN /D will delete any file found with a virus.  Also Mace Utilities 1990
  273.  and CLEANPxx.ZIP will get rid of any viruses after they are detected.
  274.  
  275.  The key to virus protection is that ugly word "BACKUP"!  Always backup any
  276.  critical files that you may have.  
  277.  
  278.  The Best
  279.  ────────
  280.  This program would not be possible without the creation of these fine
  281.  programs:
  282.  
  283.  PKZip / PKPak  -  PKWare / Phil Katz             -  PKZ110.EXE
  284.  
  285.  PAK            -  NoGate Programming             -  PAK251.EXE
  286.  
  287.  ARC,XARC       -  System Enhancement Associates  -  N/A
  288.  
  289.  Lharc (LZH)    -  Yoshi                          -  LH114B.EXE
  290.  
  291.  Turbo Pascal   -  Borland Corporation            -  N/A
  292.  5.5 / 6.0
  293.  
  294.  TechnoJock     -  TechonoJock Software           -  TTT502.ZIP
  295.  5.02 
  296.  
  297.  SCAN           -  McAffee Associates             -  SCANV72.ZIP
  298.  
  299.  
  300.  The Rest  
  301.  ────────
  302.  AutoScan is distributed under the Shareware concept, and you are given a
  303.  LIMITED contract to use AutoScan.   You may use it free of charge for a
  304.  period of THIRTY (30) DAYS, and then you must register it. There is a
  305.  registration fee of $10.00 US dollars ($15.00 Canadian) which will entitle
  306.  you to the next version of AutoScan. See REGISTER.NOW for more details. A
  307.  lot of work has gone into creating this program, and if you would like to
  308.  see it continue, please contribute.  
  309.  
  310.  The author shall not be held responsible for any hardware or software damage
  311.  associated.  You are using this program at your own risk.
  312.  
  313.  You are NOT allowed to distribute this program for any money, but are able
  314.  to distribute it for fee but only for the amount of the disk and/or the 
  315.  price of postage.
  316.  
  317.  Final Word
  318.  ──────────
  319.  Thank you to everyone who helped out with the nasty task of debugging
  320.  this thing...THANKS! THANKS! THANKS!...
  321.  
  322.  Thanks to Eric Boehm for putting the seed to this program in my head and
  323.  testing many different versions in the same day! 
  324.  Thanks to all those in the Pascal Echo who help me with some of the
  325.  stranger points in this program. You can always find me in there! 
  326.  Thanks to Josh for help with these docs..
  327.  
  328.  My Beta testers:
  329.   Josh Linder, Rich Lowenburg, Bob Moravsik (The infamous!!!) and Eric
  330.   Boehm and all the others who moaned about the Runtime Error 5 and 6
  331.   of Version 2.0!.
  332.   
  333.  Where to find me
  334.  ────────────────
  335.  Somewhere in the FidoNet Pascal Echo, Virus Echo and the Virus Info Echo.
  336.  or at:
  337.  
  338.                    /\/\ountainTop Technologies
  339.                    91 Sage Ct.
  340.                    Bedminster, NJ 07921 USA
  341.                    ATTN:Nick Tucker
  342.  
  343.  If you have access to FidoNet Mail I can be reached at 1:269/583.1
  344.  
  345.  Thanks for using AutoScan and /\/\ountainTop Technologies   !!
  346.  
  347.  
  348.