ZipLab PLUS Version 1.1 (Generic)
(C)Copyright 1991 by Jeffrey S. Morley
November 4th, 1991
Archive test program for PCBoard/ProDoor
Page 1 ZipLab Plus 1.1 GENERIC
What is ZipLab Plus?
ZipLab is an way for bulletin board 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 1.1 GENERIC
******************************************************************************
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 PTEST.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 PTEST 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 PTEST1.CFG and PTEST2.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.
Page 3 ZipLab Plus 1.1 GENERIC
* 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 communications port (1-4) for the software to use.
- 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 1.1 GENERIC
Sample PTEST.CFG file:
2
1
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
PTEST %1 C:\ZIPLAB\PTEST1.CFG
* That's it... Now when your test .BAT is run by the board, it will
pass command over to PTEST.EXE with the parameter containing the
path and name of the file to be tested. PTEST will check out the
file, placing any rejects in the holding directory you specified in
the SETUP process above.
* NOTE - It has been reported to me that at least one BBS software passes
the filename of the archive to test in %2 instead of %1. If you have
problems with ZipLab not finding the file to test, try using %2 or even
%3 in place of %1 in the example above. Spitfire BBS is one that uses
%2.
Page 5 ZipLab Plus 1.1 GENERIC
NEW!! IN THIS VERSION *********************************************************
ZipLab PLUS GENERIC Version 1.1
* 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.
5) I was previously only running SCAN against .EXE and .COM files in
the archive. I have added .OVL (which SCAN recognizes as executable).
* Fixed a tricky little problem with an ASM routine I use to RD directories.
The routine was not properly killing the directory if SET ZIPLAB= was used
to set the "work" directory to a RAM drive. This should now work fine.
There were other instances where some machines (or DOS') were having
trouble with removing the "work" directory. These are also fixed...
* Fixed a problem where PKUNZIP was stopping with a "do you want to overwrite?"
message (which we couldn't see), if a file had imbedded paths with files of
the same name in different paths. This should no longer be a problem.
* The LHARC program is now called LHA.EXE in newer versions. ZipLab will
work properly with either LHARC.EXE or LHA.EXE.
* I had left in a lot of "local" display of the testing process, so that I
could get useful debugging information back from my users. I have now
removed as much as possible of the local displays, and the process should
look a lot less jerky to the watching sysop.
* Added a the ability to use ".*" as one of the extensions which will be
passed without archive testing. If you put ".*" in using Setup.Exe, ALL
files will be passed. Files passed with this method OR by specifing
particular extensions in PTest.Cfg will still be SCAN'd for virus'.
* Fixed a problem where in LOCAL mode using wildcards, a directory which
contained a mixture of archive types (ZIP, ARJ, LZH) would cause problems
after testing the first type.
* Some users were having problems reassigning the "working" directory. This
is by default PTEST.DIR under the current directory (C:\PCB\PTEST.DIR\ for
most sysops), but can be changed to another directory with an environment
variable. In your Autoexec.Bat, the line "SET ZIPLAB=d:\path" will allow
any drive and directory to be used for the "working" directory. PLEASE,
remember that this directory will be used and DELETED when the process is
done. Several people tried to use C:\PCB or just C:\ and experienced
unfortunate effects. I have tested ZipLab PLUS with a ramdrive as the
"working" directory, and it seems to work fine. There may be a problem
with directories containing a "." in early versions of DOS. if you are
not running DOS 4.0 or later, and are having problems with ZipLab Plus,
you may want to try reassigning to another directory name.
ZipLab PLUS GENERIC 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 GENERIC version, and should work with any BBS software which
passes the filename of an uploaded file to a testing process. Just have
the BBS use PTEST (with the command line above).
* 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 PTEST where they
are. You must put them in the PTEST.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 PTEST command line.
EXAMPLE: C:\ZIPLAB>PTEST m:\pcb\dir1\*.zip ptest.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 PTEST.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 PTEST.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
PTEST.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 PTEST.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 1.1 GENERIC
***********************************************************************************************
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 PTEST 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 1.1 GENERIC