ZipLab PLUS
Version 1.0
(C)Copyright 1991 by Jeffrey S. Morley
July 6th, 1991
Archive test program for PCBoard/ProDoor
ZipLab is a alternative/replacement for the PCBTEST.BAT/PROUTEST.BAT files
which are run by PCBoard/PRODOOR after a user uploads file(s). In the past,
we have all run maybe PKUNZIP -T on each file, and if there were no CRC
erorrs, 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 imbeded 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.
* Adds most recent archive member date to the description (Optional)
* Allow you to test outside of PCBoard/ProDoor, and use wildcards!
* Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
*******************************************************************************
** ZIPLAB IS NO LONGER "FREEWARE". REGISTRATION IS REQUIRED FOR ITS USE **
PLEASE SEE THE ENCLOSED REGISTER.DOC FILE FOR REGISTRATION INFORMATION
******** A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE! *********
DO A SEARCH FOR NEW! TO FIND IMPORTANT CHANGES
REQUIRED:
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 (verison 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 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 ---
* NOTE! Since PCBoard is SHELLING out to run PCBTEST.BAT, there is
limited memory available for PTEST.EXE. If you are running in a
multitasking or other memory constrained situation, PTEST may not work!
You should have at least 210k free memory when shelled out of PCBoard. If
this is a problem, you may want to consider the VAROOM (overlay) version
of PCBoard, which runs in considerably less memory than the standard
PCB.EXE.
The other option is to run PCBoard with the SET PCB = /SWAP environment
variable. This will cause PCBoard to "swap" its code to the best available
storage (EMS, DISK) whenever a SHELL function (external protocol, viewfile,
and even DOORs if you have the SHELL column in DOORS.DAT(LST) set to "Y")
is called. This method will cause a slight delay when SHELLing, but will
provide the largest amount of available DOS memory for your external code.
* 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 PCBoard ROOT/HOME directory for the node, but this is not
required.
* 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 DRIVE:\PATH\NAME of your PCBOARD.DAT file for this node.
- 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 acepted year. ZIPs
containing files older than this will be rejected.
- A "Y" if you wish the "recent date" notation added to the file
descriptions. A "N" if you do not wish this addition.
- The fully qualified filename of the zip comment to add, or
type "NONE" if you don't want to add a comment.
- Full DRIVE:\PATH to PKZIP.EXE.
- Full DRIVE:\PATH to PKUNZIP.EXE.
NEW!! - Full DRIVE:\PATH to LHARC.EXE.
NEW!! - Full DRIVE:\PATH to ARJ.EXE.
- Full DRIVE:\PATH to TDCHECK.EXE.
- Full DRIVE:\PATH to SCAN.EXE.
- Full DRIVE:\PATH to RECOM.EXE.
NEW!! - Full DRIVE:\PATH to GIFTEST.EXE (Just lie to it if not using)
NOTE!!! This was TESTGIF.EXE in previous versions, but is now
the more powerful GIFTEST.EXE from the same author.
NEW!! - The DRIVE:\PATH\FILENAME of your GIFTEST.CFG file.
Just hit ENTER 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.
NEW!! 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.
NEW!! 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.
Sample PTEST.CFG file:
2
C:\NODE1\PCBOARD.DAT
The Interconnect BBS
M:\HOLD
1990
Y
C:\EXE\COMMENT.CMT
C:\ZIP\PKZIP.EXE
C:\ZIP\PKUNZIP.EXE
NEW!! C:\ZIP\LHARC.EXE
NEW!! C:\ZIP\ARJ.EXE
C:\ZIP\TDCHECK.EXE
C:\DIAGS\SCAN.EXE
C:\EXE\RECOM.EXE
NEW!! C:\EXE\GIFTEST.EXE
NEW!! C:\EXE\GIFTEST.CFG
.ROM
.GIF
NEW!! @BBSADS.LST
* Edit your existing PCBTEST.BAT file, and delete the whole thing except
for two lines:
Sample PCBTEST.BAT file:
@ECHO OFF
PTEST %1 C:\ZIPLAB\PTEST1.CFG
* That's it... Now when PCBTEST.BAT is run by PCBoard, 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.
* PRODOOR SYSOPS -
You will need to set up your PROUTEST.BAT file like this:
echo off
rem -- process test uploads request - for ProDOOR 3.4
rem -- %1-logfile, %2-testdir, %3-comport
rem -- test each uploaded file individually
proecho %3 ~~Testing uploads. Please wait...~
SET PCBDOOR=PRODOOR
for %%f in (%2\*.*) do COMMAND /c PTEST %%f drive:\directory\configfilename
SET PCBDOOR=
:end
Replace the "drive:\..." stuff with the location and name
of the PTEST configuration file for this node.
Be sure you have enough ENVIRONMENT space to set up the
PCBDOOR variable. If you are using DesqView, you may
want to set PCBDOOR=xxxxxxx in your AUTOEXEC.BAT to be
sure enough room is allocated in your DesqView partions
for this variable. The x's will be replaced by PRODOOR
when PROUTEST.BAT is executed. I need this variable set
to "PRODOOR", or PTEST won't know you are running out of
ProDoor. You don't want to leave it set to PRODOOR though,
since this could confuse things for other doors/processes.
Thus the "SET PCBDOOR=" line. ZipLab will fully work
with ProDoor, including display/modification of the file
descriptions.
* NEW!! IN THIS VERSION *******************************************************
ZipLab PLUS - A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE!
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.
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 .CFG file, even if you don't accept these
formats, and don't have the programs... Just lie to it.
ZipLab now fully supports ProDoor as well as PCBoard.
You may now run ZipLab while out of the bulletin board
system, and may use wildcards (* or ?). This will allow
you to test existing archive files 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 so desire. Set the "holding" directory to
the location of your "private" or "upload" directory (as you
wish), and the files will remain there. The descriptions
will be posted to your "private" dir. This corrects a
situation where sysops trying to do this with earlier
releases of ZipLab would lose the rejected file.
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 testing is finished.
ZipLab now uses GIFTEST.EXE to test .GIF files (if you
permit them). 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.
***********************************************************************************************
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