ZIPLAB.DOC

13.8 KB 1d10d8a10617602f…
ZipLab PLUS Version 1.3 (WILDCAT!)
(C)Copyright 1991 by Jeffrey S. Morley
November 3rd, 1991

Archive test program for WILDCAT!
                  


















































Page 1                                                 ZipLab Plus Wildcat! 1.3




What is ZipLab Plus?

   ZipLab is an way for WILDCAT! BBS SysOps to test files uploaded to  
their boards. In the past, we have all run maybe  PKUNZIP -T  on each 
file, and if there were no CRC errors, all was considered well.   
There is a lot more we can do  to protect ourselves and our users from 
unwanted files!  ZipLab will do the following:

* Test for CRC errors in the archive file.
* Test for imbedded archive files and if found, CRC check those too.
* Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
* Virus SCAN archive member files, using SCAN.EXE from McAffey.
* SCAN inside archive files imbedded inside another archive file.
* Remove all archive comments from the file.
* Replace archive comments with your own. (Optional)
* Delete unwanted BBS ads and/or other unwanted archive members as you define.
* Test .GIF files for validity if you accept that file format (Optional)
* Reject programs older than a date (year) which you specify.
* Test using any BBS software which can pass the .ZIP filename to a process.
* Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats






 SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE



  ** ZIPLAB IS NO LONGER "FREEWARE". REGISTRATION IS REQUIRED FOR ITS USE **

    PLEASE SEE THE ENCLOSED REGISTER.DOC FILE FOR REGISTRATION INFORMATION


          
 SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE


Page 2                                                 ZipLab Plus Wildcat! 1.3



******************************************************************************
 
REQUIRED FOR OPERATION:

You must already have the following programs.....

PKZIP.EXE   - Phil Katz archive create program (version 1.01 +)
PKUNZIP.EXE - Phil Katz archive extract program (version 1.01 +)
LHARC.EXE   - Yoshi's archive program (version 2.12 +)
ARJ.EXE     - Robert Jung's archive program (version 2.10 +)
TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
SCAN.EXE    - McAffey's virus detection program (any version)

There are other small utility programs which I have bundled with this 
.ZIP. They may require registration for continued use.  PLEASE SUPPORT 
SHAREWARE AND THE SHAREWARE CONCEPT! REGISTER THESE PROGRAMS IF REQUESTED 
TO DO SO!

RECOM.EXE   - Mike Loewen's ZIP file comment remover and date stamper.
GIFTEST.EXE - Dave Navarro's .GIF file tester (part of GIFTSTxx.ZIP)
DELF.COM    - A version of DEL with no "Are you sure?" prompt written by me.
              (No registration required)


Quick Start ---

  
* Place the WCTEST.EXE, SETUP.EXE and DELF.COM files into a directory which 
  is in your DOS PATH.

* UnZIP the enclosed supplemental utilities into directories in your DOS 
  PATH. Make note of where you put them, you will need this information 
  later.

* Create, or use any existing directory to hold your WCTEST configuration 
  files. Change into this directory, and run SETUP.EXE once for each of 
  your nodes. Be sure to give different configuration file names for each 
  node.  I use WCTEST1.CFG and WCTEST2.CFG. You may keep the particular 
  node's configuration file in the board's ROOT/HOME directory for the 
  node, but this is not required.  

* Add the ENVIRONMENT variable "WCNODE" to your CAT.BAT file, with the
  variable set to the node number for this node.  For node 1 of your
  BBS use:
  
  SET WCNODE=1


Page 3                                                 ZipLab Plus Wildcat! 1.3


* Fill in the following information when prompted by SETUP.EXE:

        -  The [drive:\path\]filename.ext of the .CFG file you wish created.
           (This information will not be written to the .CFG file)
        -  The type of modem HANDSHAKE you desire.  This can be 
           0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
           (Use 2 or 3 with an error correcting modem...)
        -  The DOS PATH of your WILDCAT! root directory.
        -  The name of your BBS system.  43 characters maximum.
        -  The DRIVE and PATH to the directory where rejects will be
           placed pending manual sysop inspection.
        -  The date (yyyy) which will be the minimum accepted year.  ZIPs
           containing files older than this will be rejected.
        -  The fully qualified filename of the zip comment to add, or
           type "NONE" if you don't want to add a comment.
        -  The fully qualified filename of a file which you may wish to
           add to the .ZIP, or "NONE" (please!) if you can refrain from
           this practice.
        -  Full DRIVE:\PATH to PKZIP.EXE.
        -  Full DRIVE:\PATH to PKUNZIP.EXE.
        -  Full DRIVE:\PATH to LHARC.EXE.
        -  Full DRIVE:\PATH to ARJ.EXE.
        -  Full DRIVE:\PATH to TDCHECK.EXE.
        -  Full DRIVE:\PATH to SCAN.EXE.
        -  Full DRIVE:\PATH to RECOM.EXE.
        -  Full DRIVE:\PATH to GIFTEST.EXE (or NONE if not using)   
           NOTE!!! This was TESTGIF.EXE in previous versions, but is now
           the more powerful GIFTEST.EXE from the same author.
        -  The DRIVE:\PATH\FILENAME of your GIFTEST.CFG file.
           Just enter NONE if you do not desire to test .GIF files.  
        -  A list, each on one line, of any extensions (.EXE, .TXT etc)
           Which will be passed without normal ZIP testing.  Any 
           extensions other than .ZIP which do not appear in this .CFG
           file will be rejected by the process.  The "." is optional.
           If .GIF appears in this list, GIFTEST will be used to test
           the integrity of the .GIF file.
        -  A list, each on one line, of files which you wish deleted
           from .ZIP's before posting.  This could include the famous
           "READMEOR.DIE", "BBS.AD", or other unwanted advertising.
           You may also have a file with these names listed one on each
           line, and pass the name of the file with an "@" before the
           name.

 
Page 4                                                 ZipLab Plus Wildcat! 1.3


Sample WCTEST.CFG file:
            
            2           
            C:\WC30
            The Interconnect BBS
            M:\HOLD
            1990
            C:\EXE\COMMENT.CMT
            C:\EXE\FILETO.ADD
            C:\ZIP\PKZIP.EXE
            C:\ZIP\PKUNZIP.EXE
            C:\ZIP\LHARC.EXE
            C:\ZIP\ARJ.EXE
            C:\ZIP\TDCHECK.EXE
            C:\DIAGS\SCAN.EXE
            C:\EXE\RECOM.EXE
            C:\EXE\GIFTEST.EXE
            C:\EXE\GIFTEST.CFG
            .ROM
            .GIF
            @BBSADS.LST

* Edit any existing .BAT file you may have which does upload testing, 
  and delete the whole thing except for two lines:
  
  Sample BAT file:
  
  @ECHO OFF
  C:
  CD \WC30\WCWORK\NODE%WCNODE%
  WCTEST %1 C:\ZIPLAB\WCTEST1.CFG
 
   
* That's it... Now when your test .BAT is run by the board, it will 
  pass command over to WCTEST.EXE with the parameter containing the 
  path and name of the file to be tested.  WCTEST will check out the 
  file, placing any rejects in the holding directory you specified in 
  the SETUP process above.  


Page 5                                                 ZipLab Plus Wildcat! 1.3



NEW!! IN THIS VERSION OF ZIPLAB PLUS WILDCAT! *********************************

                            
                            ZipLab PLUS Version 1.3

* No configuration file changes required for this version.

* Corrected several things which were not working correctly.  

  1)  If a file failed any test, ZipLab was doing everything it was supposed
      to, but then exiting with an ERROR 76.  Fixed.
  
  2)  A flag on ARJ was set wrong, so that imbedded files with the same 
      name as a file in the top level .ARJ would cause an "overwrite?" pause.
  
  3)  SCAN'ing for virus infestation was not working properly in "imbedded"
      archives.  ZipLab will now properly SCAN executables and overlays 
      contained in imbedded archives.
  
  4)  I broke CRC checking in imbedded archives and .TD0 files in the 
      1.2 version. This has been fixed.  Archives and .TD0 files 
      inside the top level archive will now be CRC checked properly.
  
  5)  I was previously only running SCAN against .EXE and .COM files in
      the archive.  I have added .OVL (which SCAN recognizes as executable).                        
      
                            
                            ZipLab PLUS Version 1.2                         
                            
* Fixes a problem with reading the COMM port correctly from the DOOR.SYS file
  created by Wildcat 3.0 when shelling to DOS.  Remote display was not being
  sent out the comm port in all cases.
  
                              
                            ZipLab PLUS Version 1.1

* Just a quick fix for an error in leaving in some debugging code in the 1.0
  version.  This will correct the pause at the beginning of the run.
  
                              
                            ZipLab PLUS Version 1.0
                
* This is the new ZipLab PLUS!  A lot of hard work has gone into this and 
  earlier versions,  and I will be requiring a *REGISTRATION FEE* with 
  this version.  See REGISTER.DOC for details on how to register ZipLab 
  PLUS.
  
* This is the WILDCAT! version of ZipLab PLUS, and will work with
  WILDCAT! version 3.0 or later.  This is NOT the GENERIC version, and
  will not work with BBS software other than WILDCAT!.

* ZipLab will now test .ARJ and .LZH files, as well as the .ZIP format.  
  You will need to have ARJ.EXE and LHARC.EXE if you accept these formats, 
  and a change to the .CFG file is *REQUIRED* to tell WCTEST where they 
  are.  You must put them in the WCTEST.CFG file, even if you don't accept 
  these formats,  and don't have the programs... Just lie to it.

* You may now run ZipLab while out of the bulletin board system and use 
  wildcards (* or ?) in the testing procedure. This will allow you to test 
  existing archive file(s) on your system.  *NO* changes will be made to 
  existing descriptions. To enable this feature, place the word LOCAL at 
  the end of the WCTEST command line.

  EXAMPLE: C:\ZIPLAB>WCTEST m:\wc30\dir1\*.zip WCTEST.cfg LOCAL
                
* ZipLab will now SCAN archives inside archives to test for virus 
  infestation.
                
* You may now have rejected uploads left in your private directory if you 
  prefer this setup.  Set the "holding" directory  to the location of your 
  "private" or "upload"  directory  (whichever you wish),  and the file(s) 
  will remain there. The description(s) will be posted to your "private" 
  dir file.  This corrects a situation where sysops trying to do this with 
  earlier releases of ZipLab would lose the rejected file.
                
* By default, ZipLab will use a directory called WCTEST.DIR under the 
  current directory for unzip'ing and testing purposes.  This directory 
  will be erased and removed by ZipLab at the end of the run.  If you wish 
  to use another directory for this purpose (like a RAM drive to improve 
  speed), set the DOS environment variable "ZIPLAB".  

  EXAMPLE:  SET ZIPLAB=E:\WORKDIR

* You may choose to add a file to the archive package, by adding the 
  appropriate information to the WCTEST.CFG file.  I am opposed to this 
  practice, but don't desire to tell anyone how to run their shop.

* The ORIGINAL file date of the archive file is now retained. Earlier 
  versions of ZipLab would set the archive file date  to the date of the 
  newest member in the archive.  This was required for age testing, but is 
  no longer.
                
* ZipLab will NOT leave behind  "hidden,  read-only  or  system" files 
  which were imbedded in archives.  They will be tested, and properly 
  deleted when the tests are finished.
                
* ZipLab now uses GIFTEST.EXE to test .GIF files (if permitted).  This 
  program by Dave Navarro will allow you to set up a GIFTEST.CFG file - 
  giving you even more control over  .GIF  testing.  An addition to your 
  WCTEST.CFG file is required to support this.  Please read the docs with  
  GIFTSTxx.ZIP  for details  on  how to best set up the GIFTEST.CFG file. 
  YOU MUST REGISTER GIFTEST TO USE IT!
                
* You may now put all BBS advertising file  names  into a text  file, one 
  on each line.  In WCTEST.CFG, place an "@" before the name of this text 
  file, and ZipLab will delete all listed advertising  files in one pass.  
  THIS IS MUCH FASTER for those with multiple advertising files to reject.




Page 7                                                 ZipLab Plus Wildcat! 1.3



***********************************************************************************************

   This program was written in QuickBasic 4.5, with some help from 
Hammerly Computing's ProBas 4.01.   I have also included a few utilities 
which WCTEST will use in the course of testing.  These utilities are the 
property of the authors, and you are strongly requested to register them 
if you continue to use ZIPLAB PLUS.

                             Jeffrey S. Morley
                           The Interconnect BBS
                               (703)425-2505

            PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION

                (C)Copyright 1989-1991 by Jeffrey S. Morley








































Page 8                                                 ZipLab Plus Wildcat! 1.3