home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / RASCN202.ZIP / RASCAN.DOC < prev    next >
Text File  |  1993-10-10  |  10KB  |  226 lines

  1.  
  2.  
  3.  
  4.                       RASCAN v2.02 DOCUMENTATION
  5.  
  6.                               10 OCT 1993
  7.  
  8.                            Current Features
  9.  
  10.    EASY setup.
  11.    A NO friles online/offline upload processor. Just what everybody wants.
  12.    Support for scanning program of your choice.
  13.    Support for importing FILE_ID.DIZ or DESC.SDN/SDI into FDB (File Data Base).
  14.    Support for batch file processing.
  15.    Support for processing complete FDB or file area with one command.
  16.    Support for upto 10 compression programs.
  17.    Support for unpacking/scanning imbedded archives.
  18.    Support for adding comments to archives.
  19.    Will NOT communicate with uploader now or in the future.
  20.    Will not expire for unregistered users. (Please register)
  21.    Logging of information for later review. (Great feature IMHO)
  22.  
  23.                            Future Features
  24.  
  25.    Support for file ReArchiving.
  26.    Will keep track of files already processed. (REGISTERED USERS ONLY)
  27.    Some requested features that you ask for.
  28.  
  29.                               Comments
  30.  
  31.    RASCN200.ZIP was a complete rewrite of RASCN100.ZIP.
  32.  
  33.    A bug was discovered the day after release or version 2.00 and version 2.01
  34.    was released about 2 days later. The improper setup of RASCAN unconvered a
  35.    destructive bug in the code. When the set command was not correct and
  36.    RASCAN could not find its' configuration file it would exit with an error
  37.    and delete all files in the directory where it resided. This bug has been
  38.    fixed but for you protection please place RASCAN in its' own directory. A
  39.    bug was also discovered when DIZ was not included in the command line for
  40.    RASCAN then the archives would not be unpacked. This bug is now fixed.
  41.  
  42.    With this release I hope to have corrected any bugs that could result in
  43.    harm to your system so that I can continue developement of the program to
  44.    just add needed functionality. I hope you like my idea of what an upload
  45.    scanner should do.
  46.  
  47.    RASCAN will keep track of files that have already been processed for
  48.    REGISTERED USERS ONLY.
  49.  
  50.    Any suggestions you may have please net mail me at 1:2320/190 or post in
  51.    the RA_UTIL echo.
  52.  
  53.                                         Thanks,
  54.                                         Dewayne
  55.  
  56.  
  57.                                 Setup
  58.  
  59.    1. Put all files into a directory of your choice. I recommend you create a
  60.       directory for RASCAN alone however. For your saftey DO NOT place RASCAN
  61.       in your RA directory. The program cleans up after itself and if setup
  62.       incorrectly could delete files in the directory where it resides. I hope
  63.       I have corrected this bug, but better to be safe.
  64.  
  65.    2. Set the enviroment for RASCAN by adding a SET command to your
  66.       autoexec.bat file. Example ( SET RASCAN=C:\RASCAN ). Replace C:\RASCAN
  67.       with the correct path to the directory where RASCAN can find all of its
  68.       files. You MUST USE ALL CAPS FOR THE SET COMMAND. This has been the
  69.       source of many setup errors and problems.
  70.  
  71.    3. Create a work directory for RASCAN. ALL files in this directory will be
  72.       deleted when RASCAN is run. This directory should ALLWAYS be EMPTY.
  73.  
  74.    4. Edit RASCAN.CFG for your scanning program and other features. This file
  75.       is very small and can be edited with any ascii editor. Case does not
  76.       matter.
  77.  
  78.    5. Uses settings in RACONFIG. Enter the settings for your compression
  79.       programs in RACONFIG. The extension MUST be included in the command line
  80.       for the archivers to execute. Example: D:\util\pkzip -ao @ will NOT work.
  81.       It MUST be D:\util\pkzip.exe -ao @ for the command line to execute.
  82.  
  83.    6. Command line for RASCAN in RACONFIG should be
  84.       example ( C:\RASCAN\RASCAN.EXE @ ). Add *M to swap out RA. See below for
  85.       additional options.
  86.  
  87.    7. That's all there is.
  88.  
  89.  
  90.                           Configuration File
  91.  
  92.    1. The configuration file MUST be named RASCAN.CFG and located in the
  93.       directory with RASCAN.EXE.
  94.  
  95.    2. KeyWords REQUIRED in configuration file:
  96.       (a) "SCANNER" The word scanner must be in RASCAN.CFG. It must begin in
  97.       column 1 followed by the commandline for your scanner. This is the only
  98.       requirement for RASCAN.CFG. 
  99.  
  100.       (b) "WORKDIR" followed by a space and the path.  THIS DIRECTORY SHOULD
  101.           BE EMPTY OF FILES AT ALL TIMES. ALL FILES IN THIS DIRECTORY WILL BE
  102.           DELETED WHEN RASCAN IS RUN. DO NOT HAVE THIS BE YOUR RA DIRECTORY.
  103.  
  104.       (c) "LOGFILE" followed by a space and the path. ONLY one allowed.
  105.  
  106.       (d) All other KeyWords are optional.
  107.  
  108.    3. KeyWords Optional in configuration file:
  109.       (a) "COMMENT" followed by a space, the archive type, a space, command
  110.           line for the compression program to add a comment. As many as you
  111.           need to cover all compression programs that support comments in
  112.           archives. Be sure to put the COMPLETE path for the compression
  113.           program (including the extension) in the command line.
  114.  
  115.       (b) SEE INCLUDED RASCAN.CFG FILE FOR EXAMPLES. Edit this file to your
  116.           needs. You should just need to change the paths and you will be ready
  117.           to run with it.
  118.  
  119.                           CommandLine Examples
  120.  
  121.    1. RASCAN C:\RA\RA_200.ARJ DIZ CMT
  122.       {this will unpack all files in RA_200.ARJ, scan files for virus, import
  123.       FILE_ID.DIZ or DESC.SDI into FDB if one is present in archive, add
  124.       comment to RA_200.ARJ.}
  125.  
  126.    2. RASCAN AREA 45 DIZ CMT
  127.       {this will do the same as above but to all files in area 45 that are
  128.       supported by your compression settings in RACONFIG.}
  129.  
  130.    3. C:\RASCAN\RASCAN.EXE @ DIZ *M
  131.       {place this in RACONFIG to import FILE_ID.DIZ file and swap RA out}
  132.  
  133.  
  134.                          Command Line requirements.
  135.  
  136.    1. The File or Area to be processed MUST be the FIRST parameter passed.
  137.    2. To process an AREA the word "AREA" must be followed by a space and the
  138.       area number to be processed. Putting a "0" after "AREA" will process the
  139.       entire FDB.
  140.    3. *M MUST the the last parameter if used.
  141.    4. Additional switches can follow the filename or area and may be in any
  142.       order.
  143.    5. Case does not matter.
  144.  
  145.  
  146.  
  147.                         LICENCE AGREEMENT
  148.  
  149.    1.  This is a licence agreement between you, the end user, and
  150.        Dewayne Cox. The RAScan v2.02 Shareware software
  151.        and information attached hereto, hereafter "RAScan", is the
  152.        property of Dewayne Cox. Read the terms and
  153.        conditions of this licence agreement carefully before using
  154.        the software. If you for any reason, whatsoever, cannot
  155.        accept the conditions in this agreement, you are not
  156.        permitted to use RAScan.
  157.  
  158.    2.  You acknowledge and agree that RAScan is a proprietary product
  159.        of Dewayne Cox, protected by applicable copyright laws
  160.        and international treaty provisions. You further acknowledge
  161.        and agree that all rights, title, and interest in and to RAScan
  162.        are and shall remain with Dewayne Cox.
  163.  
  164.    3.  RAScan may be used for a period of thirty (30) days on a trial
  165.        basis to allow you to determine its suitability for your
  166.        particular application. After this period you MUST register
  167.        each copy of RAScan that you run simultaneously.
  168.  
  169.    4.  Registration entitles you to use RAScan and any future versions
  170.        of RAScan for as long as you wish, subject to any special
  171.        licensing conditions and/or applicable upgrade fees attached
  172.        to future versions.
  173.  
  174.    5.  In the event that you are in violation of this licence
  175.        agreement, you agree and accept that Dewayne Cox may
  176.        cancel your registration and any rights to use RAScan that you
  177.        may have. In the case of a dispute over the licence
  178.        agreement, you further agree and accept to fully reimburse
  179.        Dewayne Cox for legal and other expenses resulting
  180.        from the dispute.
  181.  
  182.    6.  RAScan is provided "as is", without warranty of any kind or
  183.        fitness for a particular purpose, either expressed or
  184.        implied, all of are hereby explicitly disclaimed. Dewayne
  185.        Cox only guarantees that FrontDoor will occupy disk space.
  186.  
  187.        Dewayne Cox's liability resulting from your use or
  188.        inability to use RAScan is limited to the amount that the
  189.        affected party has paid for it, or in the event that RAScan was
  190.        registered with a third party for payment to Dewayne Cox,
  191.        liability is limited to the amount that was received by
  192.        Dewayne Cox from that third party.
  193.  
  194.    7.  Neither Dewayne Cox nor any of his employees,
  195.        agents, or other representatives are in any way obligated to
  196.        provide future versions of, or support for, RAScan.
  197.  
  198.  
  199.    8.  You may freely distribute and copy RAScan provided that no
  200.        fee is charged and the RAScan distribution archive contains
  201.        unmodified copies of the original files as produced by Dewayne
  202.        Cox. Pay Bulletin Board Systems may, however, charge
  203.        their normal fee provided that no additional charge for RAScan
  204.        is levied. No part of RAScan may be modified, altered, reverse
  205.        engineered, sold, or distributed in any form whatsoever which
  206.        would involve some sort of trade without prior written
  207.        permission from Dewayne Cox.
  208.  
  209.    9.  RAScan may not be used in any unlawful or illegal manner.
  210.  
  211.  
  212.    10. Sunny Side BBS is the official support site for RAScan.
  213.        All  future versions  of RAScan  will be  available on Sunny
  214.        Side BBS.
  215.  
  216.        RAScan may be requested by using  the magic name RASCAN or you
  217.        may log onto the BBS and download the latest version.
  218.  
  219.        Sunny Side BBS
  220.        1:2320/190
  221.        BBS:  (812)941-8335
  222.        PO Box 1292
  223.        New Albany, IN 47151-1292
  224.  
  225.  
  226.