home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LBTST25C.ZIP / LABTEST.DOC < prev    next >
Text File  |  1993-09-17  |  38KB  |  703 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.            ┌─┐  ┌──────┌──────┌─────┌─────┌─────┌─────┐  ┌─────┐   ┌────┐
  17.            │ │  │ ┌──┐ └┐ ┌─┐ ├─┐ ┌─│ ┌───│ ┌───└─┐ ┌─┘  └───┐ │   │ ┌──┘
  18.            │ │  │ └──┘  │ └─┘ │ │ │ │ └─┐ │ └───┐ │ │    ┌───┘ │   │ └───┐
  19.            │ │  │ ┌──┐  │ ┌─┐ │ │ │ │ ┌─┘ └───┐ │ │ │    │ ┌───┘   └───┐ │
  20.            │ └──│ │  │ ┌┘ └─┘ │ │ │ │ └───┌───┘ │ │ │    │ └───┬──┐┌───┘ │
  21.            └────└─┘  └─└──────┘ └─┘ └─────└─────┘ └─┘    └─────└──┘└─────┘
  22.  
  23.                       Copyright (c) 1993 by Mark Williamson
  24.  
  25.            I would like to begin by thanking the following people for their
  26.            contributions to the development of Labtest. Without their help,
  27.            this program wouldn't be possible!
  28.  
  29.            Brian Pirie for writing an awesome door writing library
  30.  
  31.            Steve  Joselson for  his patience  while beta  testing (and  for
  32.            seeing it through!)
  33.  
  34.            Mike Ehlert  for his insight with  RemoteAccess and his patience
  35.            for testing the program without actually being asked to do so.
  36.  
  37.            Bob  Henderson for  giving me  a really  easy dos  shell routine
  38.            (Spawn.c)
  39.  
  40.            Bob Lopinski for some great ideas!
  41.  
  42.            Bill Hull (author of CZip) for some tech-help!
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.            ╒══════════════════════════════════════════════════════════════╕
  57.            │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  58.            ╘══════════════════════════════════════════════════════════════╛
  59.  
  60.            This program is  not Freeware. This is SHAREWARE  which means it
  61.            is  user-supported software.  If you  use this  program for more
  62.            than 30  days, you are  required to register  or remove it  from
  63.            your system.
  64.  
  65.            The concept works  only with your support. If  you find that you
  66.            can  use this  program, then  a registration  fee of $10.00 U.S.
  67.            funds will  help defray the  development cost and  encourage the
  68.            authorship  of other  programs that  might be  useful to  you. A
  69.            Registration  Form  for  this   purpose  is  included  with  the
  70.            distribution archive and is called REGISTER.DOC.
  71.  
  72.            Labtest  is  Copyrighted  (c)  1993  by  Mark Williamson and all
  73.            rights are reserved. You may copy this program and documentation
  74.            for  backup purposes.  You also  may copy  and share  UNMODIFIED
  75.            copies  of the  program  package,  providing that  the copyright
  76.            notice is reproduced and included on all copies.
  77.  
  78.            You may  not sell the  product for a  fee and/or distribute  the
  79.            product  along  with  other  products  without expressed written
  80.            permission from Software Solutions, nor may you modify or remove
  81.            the Copyright Notice from the program or the documentation.
  82.  
  83.            Those who register  this program within one year  of its release
  84.            by the author, will receive a  registration key. The key will be
  85.            delivered either by personal  upload, netmail or postal service.
  86.            Allow up to 6 weeks for delivery.
  87.  
  88.            This  program is  not guaranteed  to do  anything except take up
  89.            hard  disk space.  This program  was written  with the intent to
  90.            support as many BBS systems as possible.
  91.  
  92.            Comments, suggestions  and bug reports are  welcome. If you have
  93.            any, you should contact Mark Williamson at Fidonet 1:214/54.
  94.  
  95.            If  you're  reporting  a  bug,  please  give  as  much detail as
  96.            possible about the  problem you are experiencing so  that it can
  97.            be duplicated and fixed.
  98.  
  99.            ╒══════════════════════════════════════════════════════════════╕
  100.            │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  101.            ╘══════════════════════════════════════════════════════════════╛
  102.  
  103.            With  the popularity  of computer  Bulletin Board  Systems (BBS)
  104.            comes  the  risk  of  intrusion  by  computer  viruses which lay
  105.            dormant and normally undected  within a compressed archive file.
  106.            These  archive  files  are  usually  created  using some sort of
  107.            compression program, like PKZIP or  ARJ. With the advent of file
  108.            compression  programs  comes  the  increased  likelihood  that a
  109.            computer virus may  be lurking within the files  of the archive,
  110.            undectable  by  any  virus   scanning  program  unless  actually
  111.            uncompressed.
  112.  
  113.            Labtest was  designed as a  RemoteAccess 2.00 utility  to aid in
  114.            the fight  against viral intrusion. Labtest  will uncompress the
  115.            archived file,  run a Sysop definable  virus scanner, and report
  116.            the results to  the user online and the  Sysop. However, Labtest
  117.            will do  much more than  this simple little  chore. Labtest will
  118.            also check .GIF files  for minimum desirable resolution factors;
  119.            update RemoteAccess 2.00 file database  system with the  correct
  120.            filename,    size   and    description   (as    read   from    a
  121.            FILE_ID.DIZ/DESC.SDI file if one exists), remove unwanted 'junk'
  122.            files from the archive file,  add any Sysop defined 'junk' files
  123.            to  the archive,  and add  the Sysop's  own archive comment text
  124.            (.ZIP/ARJ files).
  125.  
  126.            The  author feels  that the  Sysop should  have complete control
  127.            over the files that are  placed on his system, therefore Labtest
  128.            now has the ability to reject  files based on age, in years. For
  129.            example, if a  file is more than 3 years  old, Labtest will fail
  130.            the file.
  131.  
  132.            Hint: If a  user starts a file description  with a forward slash
  133.            '/',  this tells  RemoteAccess that  the file  is for  the Sysop
  134.            only.  Labtest  will  honor  this  even  if  a  FILE_ID.DIZ  was
  135.            imported.
  136.  
  137.            ╒══════════════════════════════════════════════════════════════╕
  138.            │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  139.            ╘══════════════════════════════════════════════════════════════╛
  140.  
  141.            Installation of  Labtest is relatively simple.  You may create a
  142.            directory especially  for Labtest or  you may wish  to place the
  143.            program and support files in your RemoteAccess system directory.
  144.            The location  of Labtest is unimportant.  Since Labtest may also
  145.            be used as a maintenance utility,  you may wish to place Labtest
  146.            and it's  support files in your  system Path so you  may execute
  147.            the  program  from  any  directory  on  your  system. To install
  148.            Labtest,  unpack  the  distribution  archive  into  your desired
  149.            directory. At  a minimum, you should  have the files LABTEST.EXE
  150.            and  LABTEST.CFG  in  your  DOS  path.  You  may use the LABTEST
  151.            environment  variable   to  tell  Labtest  where   to  find  the
  152.            configuration  file.  Insert  the   following  command  in  your
  153.            AUTOEXEC.BAT file  to set the LABTEST  environment variable: SET
  154.            LABTEST=C:\LABTEST  (specify  your  own  directory). The Labtest
  155.            environment  variable is  NOT optional!  If you  don't set  this
  156.            variable, Labtest will NOT RUN.  Using your favorit text editor,
  157.            load the file LABTEST.CFG and  set up your system settings.
  158.  
  159.            Labtest configuration options are discussed below:
  160.  
  161.            Messages to User/Sysop
  162.            ────────────────────────────────────────────────────────────────
  163.  
  164.            In the distribution archive you should find several *.MSG files.
  165.            These files contain text which  will be imported by Labtest into
  166.            the message  base. These messages  may be totally  customized by
  167.            you to give your system a personal touch. There are a few macros
  168.            which will be expanded by  Labtest during reading of the message
  169.            file.  These are explained below:
  170.  
  171.                @SYSOP@        Sysop name (as defined in RACONFIG)
  172.                @BBS@          BBS system name (RACONFIG)
  173.                @USERFIRST@    First name of the user
  174.                @UPLOADS@      Total number of uploads the user has posted
  175.                @UPLOADK@      Uploads (in K) the user has posted
  176.  
  177.            Keep  in mind  the with  of each  of these  macros when they are
  178.            expanded. Labtest  will not word wrap  the text and it  may look
  179.            choppy if your text lines are too long.
  180.  
  181.            The  messages written  to the  Sysop are  coded into Labtest and
  182.            cannot be changed.
  183.  
  184.            Some  settings which  are read  from the  RemoteAccess CONFIG.RA
  185.            file are discussed below:
  186.  
  187.            CONFIG.RA Path:
  188.  
  189.                Labtest  will  get  this   path  from  your  RA  environment
  190.                variable.  You must  ensure that  you have  SET RA=C:\RA (or
  191.                whatever) in your AUTOEXEC.BAT file.
  192.  
  193.            Message Base Directory:
  194.  
  195.                Obtained  from RACONFIG.PATHS.MSG_BASE_DIRECTORY,  this path
  196.                name  is where  your Hudson  message base  files are placed.
  197.                Labtest will use the information contained in LABTEST.CFG to
  198.                determine where to  post messages to the user  and the sysop
  199.                concerning the  uploaded file. Labtest will  check to see if
  200.                it is  a JAM message  base and post  the message in  the JAM
  201.                message base vice the Hudson message base.
  202.  
  203.            File Base Directory:
  204.  
  205.                Obtained from  RACONFIG.PATHS.FILE_BASE_DIRECTORY, this path
  206.                is the  base directory of your  file databases. Usually this
  207.                is something like C:\RA\FDB
  208.  
  209.            System Name:
  210.  
  211.                Obtained from  RACONFIG.SITE_INFO, this is the  name of your
  212.                BBS system.
  213.  
  214.            Sysop Name:
  215.  
  216.                Obtained from  RACONFIG.SITE_INFO, this is  the name of  the
  217.                System Operator.
  218.  
  219.            Compression utilities:
  220.  
  221.                Labtest   will   utilize   the   information  obtained  from
  222.                RACONFIG.FILES.ARCHIVERS    for    the   compress/uncompress
  223.                utilities. See below for details  on setting up archivers in
  224.                RACONFIG.
  225.  
  226.            You  must ensure  that each  of your  file areas  are configured
  227.            properly for scanning. Each file area  must have the UL Scan set
  228.            to YES,  and an archive type.  If you want all  of your files in
  229.            the same format,  then leave all the Archive  Type fields blank,
  230.            and Labtest will use the format indicated in LABTEST.CFG.
  231.  
  232.            In RACONFIG, under Files > Upload > Scanner, enter the following:
  233.  
  234.            C:\RA\LABTEST.EXE @ /O *M
  235.               ^^ Labtest directory.
  236.  
  237.            For clarity, here  is some screen captures from  RACONFIG on the
  238.            author's system to aid you in setting up RA and Labtest:
  239.  
  240.            To setup the archivers, ensure  that each Pack/Unpack line has a
  241.            @ in  the line  to represent  the filename.  The full path names
  242.            have  been omitted  here so  you could  see the  entired command
  243.            line. On your  system, you must specify the  entire path to each
  244.            archive utility.
  245.  
  246.                     File        System        Options        Modem
  247.            ═╒════════ File options ╕═════════╒══════════════╕══════════════
  248.            ▒│                      │▒▒▒▒▒▒▒▒▒│ Messages     │▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  249.            ▒│ Upload credit  120   │▒▒▒▒▒▒▒▒▒│ Files        │▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  250.            ▒│ Payback credit 60    │▒▒▒▒▒▒▒▒▒│ Restrictions │▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  251.            ▒│ Touch dates    Yes   │▒▒▒▒▒▒▒▒▒│ Errorlevels  │▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  252.            ▒│ Show missing   No    │▒▒▒▒▒▒▒▒▒│ Display      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  253.            ▒│ Upload spa╒══════════════════════════════════════════ Archivers ╕
  254.            ▒│ Logon.Newf│                                                     │
  255.            ▒│ Newfiles.T│ Arc 1 ZIP C:\PKUNZIP.EXE -E @  C:\PKZIP.EXE -A @    │
  256.            ▒│ Download s│ Arc 2 ARJ C:\ARJ.EXE x -y @    C:\ARJ.EXE a -r -jm @│
  257.            ▒│ Download e│ Arc 3 LZH C:\LHA.EXE e @       C:\LHA.EXE a @       │
  258.            ▒│ Download s│ Arc 4 PAK C:\PAK.EXE e @       C:\PAK.EXE a @       │
  259.            ▒│ No dupe ex│ Arc 5 SDN C:\PAK.EXE e @       C:\PAK.EXE a @       │
  260.            ▒│ DL descrip│ Arc 6 ZOO C:\ZOO.EXE e @       C:\ZOO.EXE a @       │
  261.            ▒│ List forma│ Arc 7 SQZ C:\SQZ.EXE X @       C:\SQZ.EXE A /SP1 @  │
  262.            ▒│ Missing fo│ Arc 8                                               │
  263.  
  264.            Archive format definition
  265.  
  266.            Below is  a screen snapshot of  the Upload Scanner menu  to show
  267.            you  how to  setup Labtest  in your  Upload Scan utility command
  268.            line. Labtest will not move or delete files that fail any of the
  269.            tests, thus it is important to set up RA to handle it.
  270.  
  271.             File        System        Options        Modem        Manager
  272.            ═╒════════ File options ╕═════════╒══════════════╕═════════════
  273.            ▒│                      │▒▒▒▒▒▒▒▒▒│ Messages     │▒▒▒▒▒▒▒▒▒▒▒▒▒
  274.            ▒│ Upload credit  120   │▒▒▒▒▒▒▒▒▒│ Files        │▒▒▒▒▒▒▒▒▒▒▒▒▒
  275.            ▒│ Payback credit 60    │▒▒▒▒▒▒▒▒▒│ Restrictions │▒▒▒▒▒▒▒▒▒▒▒▒▒
  276.            ▒│ Touch dates    Yes   │▒▒▒▒▒▒▒▒▒│ Errorlevels  │▒▒▒▒▒▒▒▒▒▒▒▒▒
  277.            ▒│ Show missing   No    │▒▒▒▒▒▒▒▒▒│ Display      │▒▒▒▒▒▒▒▒▒▒▒▒▒
  278.            ▒╒══════════════════════════════════════════════ Upload Scanner ┐
  279.            ▒│                                                              │
  280.            ▒│ Scan online  Yes                                             │
  281.            ▒│ Failed scan  /unavailable                                    │
  282.            ▒│ Scan utility C:\RA\LABTEST.EXE @ /O *M                       │
  283.            ▒│                                                              │
  284.            ▒╘═════════════════════════════════════════════════════════════─┘
  285.            ▒│ DL description Ask   │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒╒═══ Fail action ╕▒▒
  286.            ▒│ List format          │▒▒▒▒ All Rights Rese▒│                │▒▒
  287.            ▒│ Missing format       │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ Delete   No    │▒▒
  288.            ▒│ Upload scan          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ Unlisted No    │▒▒
  289.            ▒│ RAMGR FnKeys         │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ Notavail Yes   │▒▒
  290.            ▒│ Ext arcview          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ Move to  0     │▒▒
  291.            ▒│ Archivers            │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│                │▒▒
  292.            ▒│                      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒╘════════════════╛▒▒
  293.            ▒╘══════════════════════╛▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  294.            ──────────────────────────────────────────────────────────────────
  295.  
  296.            You must make  sure the file areas are  setup correctly. Labtest
  297.            will  look  in  FILES.RA  for  your  preferred  archive type. If
  298.            nothing is defined  there, Labtest will default to  the type set
  299.            in LABTEST.CFG. The two important pieces of information here are
  300.            the UL Scan and ArcType fields. The rest is arbitrary.
  301.  
  302.            Labtest has the ability to change a user's security level and/or
  303.            flags  if the  uploaded file   fails the  virus scan  portion of
  304.            Labtest.  Note that  other test  failures have  no effect on the
  305.            security level or flags, only  the virus scan portion does. This
  306.            is an extremely powerful option as you can prevent the user from
  307.            uploading another file until you  contact him about the problem.
  308.            Described below are sample menu settings which you can impliment
  309.            an upload security system.
  310.  
  311.            Fire up RACONFIG  and go into the menu  manager section. Here we
  312.            will add another upload option to  your menu. Below is two lines
  313.            from  the author's  system which  handle an  upload attempt by a
  314.            user. The first  is the actual upload command  line which almost
  315.            everybody has one in their menu. Your actual display may be much
  316.            different than this, that's ok. Notice directly below the actual
  317.            upload, is another  menu item with the same  hot key. You should
  318.            have these  menu items next  to each other  because only one  of
  319.            them  will be  displayed depending  on the  flag setting. If you
  320.            don't have them  next to each other, it may  throw off your menu
  321.            display. (If you  use textfiles to display your  menus, then the
  322.            actual order of  doesn't matter). Move the highlight  bar to the
  323.            actual  upload menu  item. Hit  return to  edit the  your upload
  324.            command.
  325.  
  326.  
  327.            Text display               Key  Action      Optional data
  328.  
  329.            Actual:  (U)pload                  │'U'│ Upload     │ /FG=205 /L
  330.            Fake:    (U)pload                  │'U'│ Disp CR    │ VIRUS
  331.  
  332.            Make sure the  flag setting which you defined  in LABTEST.CFG is
  333.            set to  a 'O' in your  menu. For example, on  Software Solutions
  334.            BBS, we use the C1 flag for this feature. In our menu:
  335.  
  336.            │ A flags  --------           Age      0
  337.            │ B flags  --------           MinSpeed 0
  338.            │ C flags  O-------           MaxSpeed 0
  339.            │ D flags  --------           Credit   0
  340.            │
  341.  
  342.            Notice the C1 flag is 'O'. This  tells RA that this flag MUST be
  343.            set to OFF in order for the user to select this menu item.
  344.  
  345.            Now, go  back to the menu  item list and move  the highlight bar
  346.            directly below  the actual upload  command. Hit insert  to add a
  347.            new item. Here, we will define  a whole new upload command. View
  348.            the next screen snapshot for an idea of what we're doing here:
  349.  
  350.  
  351.             ╒════════════════════════════════════════════ Edit Menu Item ╕
  352.             │                                                            │
  353.             │          1         2         3         4         5         │
  354.             │ 1234567890123456789012345678901234567890123456789012345678 │
  355.             │ (U)pload << make it look the same as the real thing!       │
  356.             │                                                            │
  357.             │ VIRUS << enter filename to display to 'virus-users'        │
  358.             │                                                            │
  359.             │ Action   Display .ANS/.ASC with CR pause at end (Type 45)  │
  360.             │ Display                                                    │
  361.             │ OptData                                                    │
  362.             │ HotKey   U << same as your 'real' upload command!          │
  363.             │ AutoExec No                                                │
  364.             │ Colour   Colour example                                    │
  365.             │                                                            │
  366.             │ MinSec   0                  TimeUsed 0                     │
  367.             │ MaxSec   0                  TimeLeft 0                     │
  368.             │ A flags  --------           Age      0                     │
  369.             │ B flags  --------           MinSpeed 0                     │
  370.             │ C flags  X-------           MaxSpeed 0                     │
  371.             │ D flags  --------           Credit   0                     │
  372.             │                                                            │
  373.             │                                                            │
  374.             ╘════════════════════════════════════════════════════════════╛
  375.  
  376.            Notice the optional data line has  a file name VIRUS in it. This
  377.            is  an .ANS/ASC  file which  you will  create in  your text file
  378.            directory to display to a user  who has uploaded a file infected
  379.            by a virus. This file should explain why they can't upload, what
  380.            they should do (leave a message to you) and can even remind them
  381.            of  your upload/download  ratios. Hence,  if you  have ratios in
  382.            effect, the  user may not be  able to download since  they can't
  383.            upload anything! Real attention getter!
  384.  
  385.            Now, in the  above screen, set the Action  command to display an
  386.            .ANS/ASC  file.   In  the  above  example,   VIRUS  is  actually
  387.            VIRUS.ASC, a simple text file in the text file directory, and RA
  388.            will display the  file and wait for the user  to hit ENTER after
  389.            it is displayed.
  390.  
  391.            Notice that the C1  flag is set to X. This means  that if the C1
  392.            flag  is SET  (Labtest will  set  it),  then this  menu item  is
  393.            'selectable'. Remember, our real  upload command requires the C1
  394.            flag to  be OFF or  NOT SET in  order to be  selectable. Get the
  395.            picture? If  the user has  uploaded a virus  infected file, when
  396.            they  attempt  to  upload  again,  they  will  be denied and our
  397.            nasty-gram will tell them why.
  398.  
  399.            You may do the same thing with security levels instead of flags,
  400.            but we'll leave the rest up to you.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.            ╒══════════════════════════════════════════════════════════════╕
  409.            │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  410.            ╘══════════════════════════════════════════════════════════════╛
  411.  
  412.            The following  is a list  of files related  to the operation  of
  413.            this program. It is noted whether  or not the file is absolutely
  414.            required in order for the program to run.
  415.  
  416.            Filename        Required     Description
  417.            ------------    --------    --------------------------------------
  418.            LABTEST.EXE       Yes       The main executable.
  419.            DOSWIN.EXE        Yes       Required for use of Dos Window
  420.            LABTEST.CFG       Yes       Configuration file - ascii text file
  421.            LABTEST.ANS       Yes       Screen displayed to users
  422.            SCREEN.CTL        Yes       Control file for output screen
  423.            COMMENT.CTL       Yes       Used when inserting archive comments
  424.            ORDER.FRM         No        The program registration form.
  425.            LABTEST.DOC       No        The User's Manual
  426.            *.MSG             No        Message text files to be written to
  427.                                        the user
  428.  
  429.            You  will also  need to  have the  various archive  programs and
  430.            virus scanning program in your DOS path.
  431.  
  432.            Customization
  433.            ────────────────────────────────────────────────────────────────
  434.  
  435.            Included with the distribution archive is a sample LABTEST.ANS,
  436.            LABTEST.ASC and accompanying SCREEN.CTL files. You may use these
  437.            stock screens without modification. But most sysops like to give
  438.            their BBS a personal touch. In  depth information on how to tell
  439.            Labtest where to display text on  the screen is contained in the
  440.            control  file SCREEN.CTL.  You can  use a  drawing program  like
  441.            THEDRAW to change the .ANS screen. You can also have a different
  442.            screen for each node that you  run, by using the /G command line
  443.            switch and  specifying a different  configuration file for  each
  444.            node. During  the processing, provided you  have enabled the Dos
  445.            Window feature, Labtest will use  the screen region beginning at
  446.            line 15 and  ending at line 23. This will  not effect the user's
  447.            screen, only the sysop screen.
  448.  
  449.            If you customize your LABTEST.ANS  screen, please send us a copy
  450.            so we  can include it in  the archive as a  sample for others to
  451.            use.
  452.  
  453.            You  may name  the screens  and control  file anything you wish,
  454.            just be sure to put the correct name and path in the LABTEST.CFG
  455.            file.
  456.  
  457.            ╒══════════════════════════════════════════════════════════════╕
  458.            │░░░░░░ USING LABTEST ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  459.            ╘══════════════════════════════════════════════════════════════╛
  460.  
  461.            To run Labtest, you must have  a fossil driver installed. If you
  462.            want to run Labtest in local  mode, you will still need a fossil
  463.            driver, but you should use the /L switch to override the reading
  464.            of the door information file.
  465.  
  466.            Labtest will read the commandline to  fetch the file names to be
  467.            processed. Valid filenames include:
  468.  
  469.            Wildcards  (*.*,  *.ZIP,  etc..)
  470.            One or more filenames (ie C:\BBS\UPLOADS\NEWFILE.ZIP)
  471.  
  472.            You  can mix  and match  any  of  the above.  You can  even have
  473.            multiple    wildcards,   like    C:\BBS\*.*   C:\BBS\UPLOADS\*.*
  474.            C:\MODEM\DOWNLOAD\*.ARJ, etc..
  475.  
  476.            Note: When using wildcards Labtest will only process those files
  477.            that  were not  previously processed  by Labtest.  Labtest keeps
  478.            track of which files have  been already processed. You may force
  479.            Labtest to process all files  by using the /O (Override) command
  480.            line  switch.  Using  the  /O   switch  is  not  recommended  in
  481.            conjunction with a wildcard. Override is useful when rearchiving
  482.            is  not enabled  or on  single files.  Override should always be
  483.            enabled when  running Labtest on  the BBS to  gaurantee that the
  484.            file will be properly handled.
  485.  
  486.            Please  note that  Labtest will  search the  FILES.RA file for a
  487.            path matching  the path specified  on the command  line. Labtest
  488.            will expand  wildcards to a path  and wildcard. If there  was no
  489.            matching  path found  in the  FILES.RA file,  no updates will be
  490.            made  to  the  file  database.  Additionally,  if the file being
  491.            processed is not found in the  database, Labtest will not add it
  492.            to the database.
  493.  
  494.            To run Labtest  as a nightly event in  your BBS, install Labtest
  495.            in your system's event handler:
  496.  
  497.                                           \/==Local Mode!
  498.            C:\LABTEST\LABTEST.EXE C:\BBS\UPLOADS\*.* /L
  499.  
  500.            The above line would cause Labtest to process any 'new' files in
  501.            the upload directory.
  502.  
  503.            The above method is useful if your system recieves files through
  504.            a "front door" program.
  505.  
  506.            Running Labtest in a Multi-Node Environment
  507.            ────────────────────────────────────────────────────────────────
  508.  
  509.            In RACONFIG, use the following commandline:
  510.  
  511.            C:\RA\LABTEST.EXE @ /N*N *M
  512.  
  513.            For Multi-node systems, specify the node number which Labtest is
  514.            running under by utilizing the  /N switch. The proper format for
  515.            this switch  is /N*N. This  will prevent Labtest  from unpacking
  516.            the archive file in a directory already in use by another node.
  517.  
  518.            Command Line Options
  519.            ─────────────────────────────────────────────────────────────────
  520.  
  521.            The follow is a description  of valid command line options which
  522.            you can better control Labtest's performance:
  523.  
  524.            /L           Causes  Labtest to  run in  'local' mode.  In Local
  525.                         Mode,  Labtest  will  not  attempt  to  read a door
  526.                         information file  nor will it post  messages to the
  527.                         sysop or the user.
  528.  
  529.            /O           This is the Override command. Labtest will normally
  530.                         process only those  files not previously proceseed.
  531.                         Using  this  command,  you  will  force  Labtest to
  532.                         ignore it's own time  stamp feature. This is highly
  533.                         recommended while running under  the BBS system. An
  534.                         industrious person  may determine the  special file
  535.                         stamping  and attempt  to trick  Labtest. This will
  536.                         ensure that this will never happen.
  537.  
  538.            /C           This switch forces Labtest to look in the specified
  539.                         directory  for  the   EXITINFO.BBS  file.  Example:
  540.                         /CC:\RA\NODE1. Note that this is only a path, not a
  541.                         full  filename! Proper  format for  this switch  is
  542.                         /CC:\RA\NODE*N (specify whatever path you like, use
  543.                         of the *N is optional)
  544.  
  545.            /N           Specifies   the  node   number  which   Labtest  is
  546.                         operating on.  This is extremely  important to keep
  547.                         one user's files from getting mixed up with another
  548.                         user's files. The proper  format for this switch is
  549.                         /N*N on the Labtest command line in RACONFIG.
  550.  
  551.            /G           This  switch tells Labtest to  use an alternate cfg
  552.                         file. Specify  the full path  and file name  of the
  553.                         configuration  file  with   this  switch.  Example:
  554.                         /GC:\RA\LABTEST\LABTEST.CFG.  This  is particularly
  555.                         useful if you have a multi node system and have the
  556.                         nodes  configured significantly  different that you
  557.                         would like to post a  different style of message to
  558.                         the user's  or perhaps disable  certain features of
  559.                         Labtest but  want them to  be enabled on  the other
  560.                         nodes.
  561.  
  562.            /D           Starts  Labtest  in  Debug  mode,  where additional
  563.                         helpful information  is written to the  log file in
  564.                         case  you  are  having  problems.  This information
  565.                         should be  forwarded to Software  Solutions in case
  566.                         you are having problems.
  567.  
  568.  
  569.            /NOSCAN      When this  command is  given, Labtest  will not run
  570.            /NS          the virus scanner on any file  during  the  current
  571.                         session.  Note this  is only  useful when  you just
  572.                         want   to  convert   your  files   to  one  format.
  573.                         Otherwise, this is not recommended.
  574.  
  575.            /NOREARC     Prevents Labtest from rearchiving files.
  576.            /NR
  577.  
  578.            /NOCOMMENT   Prevents Labtest from adding an archive comment.
  579.            /NC
  580.  
  581.            Running Labtest from RAMGR
  582.            ───────────────────────────────────────────────────────────────
  583.  
  584.            You may wish to setup one of the RAMGR function keys in RACONFIG
  585.            to run Labtest  from the File Manager. Specify  the same command
  586.            line  in RACONFIG.RAMGR.Fkeys  as you  did in  RACONFIG.SCANNER.
  587.            Then, when you are browsing through RAMGR, hit the ALT+(Fkey) to
  588.            run Labtest.  When Labtest returns to  RAMGR, the results should
  589.            be obvious!
  590.  
  591.            ╒══════════════════════════════════════════════════════════════╕
  592.            │░░░░░░ THE CONFIGURATION FILE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  593.            ╘══════════════════════════════════════════════════════════════╛
  594.  
  595.            Beginning with  version 2.2, Labtest  no longer uses  a separate
  596.            program to  write the configuration  file. A simpler,  easier to
  597.            use  text file  based configuration  system will  be utilized by
  598.            Labtest to establish its environment. You may have more than one
  599.            configuration file.  You may optionally specify  the path to the
  600.            configuration  file by  using the  /G command  line switch.  The
  601.            proper format of this command line is:
  602.  
  603.            /GC:\RA\LABTEST\LABTEST.CFG
  604.  
  605.            LABTEST.CFG may reside in any  directory. It is recommended that
  606.            you place Labtest and all of  its accompanying files in your DOS
  607.            path so Labtest will be able  to find the required files without
  608.            trouble.  There  is  three  ways   to  tell  Labtest  where  the
  609.            configuration file is located, by  your dos path, by the LABTEST
  610.            environment variable  (SET LABTEST=C:\RA\LABTEST) or  via the /G
  611.            switch.
  612.  
  613.            ╒══════════════════════════════════════════════════════════════╕
  614.            │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  615.            ╘══════════════════════════════════════════════════════════════╛
  616.  
  617.            Labtest is distributed  "AS IS" and no warranty  or gaurantee is
  618.            supplied. The end user accepts all responsibility for the proper
  619.            use  and  operation  of  Labtest.  Under  no  circumstances will
  620.            Software  Solutions be  held liable  for any  damages or loss of
  621.            resources either  directly or indirectly resulting  from the use
  622.            or misuse of this software.
  623.  
  624.            Technical notes
  625.            ────────────────────────────────────────────────────────────────
  626.  
  627.            Labtest  was written  entirely in  Turbo C++  version 3.0.  Door
  628.            interface routines provided by OpenDoors 4.2 by Brian Pirie (all
  629.            rights reserved).
  630.  
  631.            Labtest  detects   the  following  archivers   (SFX  where  self
  632.            extracting   files   are   supported)   and   their   associated
  633.            de-archivers: (Note: ??? means not thoroughly tested)
  634.  
  635.            Archiver     Version
  636.  
  637.            PKZIP/SFX    1.11 through 2.04g
  638.            ARJ/SFX      2.20 through 2.41
  639.            LHA/SFX      2.13
  640.            PKPAK/SFX    3.61
  641.            PKARC        3.5
  642.            LHARC        ???
  643.            ARC          ???
  644.  
  645.            Labtest  operates by  shelling to  the user  defined archive and
  646.            scanning programs. If the  archive programs return an errorlevel
  647.            of 0, Labtest assumes the operation was successful. If any other
  648.            errorlevel  is returned  by the  software, then  the archive  is
  649.            tagged  as 'bad'.  Note however  that utilities  like PKZIP will
  650.            return  an errorlevel  of non-zero  if you  did not  have enough
  651.            memory or disk space to  unpack the archive. Labtest will always
  652.            log the errorlevel  reported by an archive utility  and the scan
  653.            utility. Consult  the documentation on the  utilities you decide
  654.            to use  with Labtest for specifics  on errorlevels. Labtest will
  655.            run  the virus  scanning utility  once for  each executable file
  656.            extracted from the archive. This method was chosen over shelling
  657.            once and scanning a whole directory  so we could inform the user
  658.            and the sysop of which file  failed the scan. Also, Labtest will
  659.            log the specific filename which failed the scan.
  660.  
  661.            After  a file  is successfully  unpacked, scanned  and repacked,
  662.            Labtest  will  throw  in  your  ZIP/ARJ  comment  (if defined in
  663.            LABTEST.CFG).  Last but  not at  all least,  Labtest will update
  664.            RemoteAccess  2.00  file  database  system  to  reflect  the new
  665.            changes.
  666.  
  667.            Labtest initially  renames the archive file.  If an error occurs
  668.            during  processing,  the  file  will  be  renamed  again  to its
  669.            original name for further inspection by the Sysop.
  670.  
  671.            Notes on Secured Archives
  672.            ────────────────────────────────────────────────────────────────
  673.  
  674.            PKZip  and ARJ  archive utilities  have the  ability to stamp an
  675.            archive  file  with  a  special  code  protecting it from future
  676.            changes. Labtest detects these  'archive stamps' and will either
  677.            ignore them or honor them, depending  on how you have the option
  678.            set in LABTEST.CFG.
  679.  
  680.            ────────────────────────────────────────────────────────────────
  681.  
  682.            Software Solutions BBS is the official support site for Labtest.
  683.            All  future versions  of Labtest  will be  available on Software
  684.            Solutions BBS.
  685.  
  686.            Labtest may be requested by using  the magic name LABTEST or you
  687.            may log onto the BBS and download the latest version.
  688.  
  689.            Additionally, if you  are running Fido Net mail,  you may set up
  690.            your system for the Labtest echo, originating from 1:214/54. Tag
  691.            name is  LABTEST. Send a  netmail message to  1:214/54, indicate
  692.            your password  and archive preference. Your  system will then be
  693.            placed on the  export list. From there, just  poll us and you'll
  694.            get the latest tips, user comments and suggestions. It's also an
  695.            excellent way to keep in touch with us and Labtest users.
  696.  
  697.            Software Solutions
  698.            1:214/54
  699.            BBS:  (209)997-0224
  700.            PO Box 1233
  701.            Lemoore, CA 93245-1233
  702.  
  703.