SuperScan Version 3.0ß Beta
by Flamming Idiot
Software Exchange BBS
616-329-6018 1:2201/13 (FIDO)
2 Gigs Online / HST 14.4
08/13/91
Beta Release 3.0ß
(Probably requires at least EGA monitor)
WARNING!!! Use this program at YOUR OWN RISK!........ It works for me..
SuperScan --- Upload integrity Shell Interface ---
* For TELEGARD BBS systems or ANY BBS software that can call a .EXE or .BAT
file and pass the file name along in a variable.
What does SuperScan Do?
1. SuperScan picks up the slack where Telegard left off. It handles the
integrity checking for uploads to you BBS just as Telegard does but then
does all the things I wished Telegard would do.
2. In addition to checking the file integrity, it will move ALL .BAT,
.COM, and .EXE uploads to the \BADFILES directory (for you to look at
later) and make a note in the SS.LOG file.
3. Then SuperScan checks the compressed file (ZIP,ARJ,PAK,LZH) for any of
those types of imbedded (ZIP,ARJ,PAK,LZH) compressed files. If it finds
inbedded compressed files, it notes what type of imbedded file(s) were
discovered in the SS.LOG. The imbedded compressed files are then un-
compressed and added to the files that were originally uncompressed to be
included in the Virus Scan. If the file checks out OK (both the original
and embedded files) then the upload is posted to the BBS. If it checks out
Bad, then the file is moved to the \BADFILES directory (for you to take a
look at later), and a note is made in the SS.LOG.
4. Then SuperScan will check for and extract .EXE files compressed with "Diet".
This is important as at this time SCAN.EXE does not check .EXE files that
were compressed by "Diet". So if you are not checking for EXE's compressed
with "Diet", you may get caught with your pants down.... A note is made in
the SS.LOG if a Diet file is detected. SuperScan with then attempt to un-
compress the Diet file and add it to the files to be scanned.
5. By using "CHECK4COMP", SuperScan will detect LZ,Scrunch,EYEPACK,PKlite,
Diet,Shrink,Axe,execUtrix,LeXem,ICE, and TINYPROG compressed .EXE files.
(Only LZEXE,PKLite,and Diet are supported. If anyone has any information
on these other types of compression programs, send it to me so the support
for them can be added.
6. SuperScan uses SCAN.EXE to check for known Viruses. So it can be updated
as required.
7. A Copy of all files that do not pass is placed in the \BADFILES directory.
With TELEGARD if a file fails an integrity test, the file is simply deleted,
and a "file no good-DELETED" type of message is left in the Sysop log,
leaving you to guess at what might have been wrong with the file, or if it
was a trojan, without a way to see what the user in question was trying to
do. But it is possible for PKZIP to fail an integrity test on files that
are "good". TELEGARD will delete these files, wasting a users time spent
uploading and really pissing the user off.
The two cases I have run across are:
(1) A user had used some ZIP comment adder utility to add a ZIP comment
to all his files. This utility just ask for a COMMENT.ANS file to use
as the ZIP comment. It didn't care how big the size of the file was,
it would just try to ram it into the ZIP comment. This guy was using a
huge ANSI screen that would fit. So when tested, all his uploads would
fail a ZIP integrity test (out of memory error). All that had to be
done to save these files was to change the ZIP comment back to an
acceptable size.(note that this has to be done with a comment utility
also, as PKZIP didn't want to change it back either).
(2) If PKZIP runs into a type of file that it does not reconize, it
gives a "I don't know how to handle ????????.???" message an an error
of 1 even when there is nothing wrong with the file.
There is nothing wrong with PKZIP giving an error on these types of files
except that TELEGARD then deletes them.. SuperScan moves them over to the
\BADFILES directory so you can take a look at them yourself and see what
(if anything) is wrong with them.
8. Although I will improve it later, SuperScan logs important
information to a log file so you can see what has happened! I try to
give as much information as possible (File Names, Date, Time, Imbedded
file names, compressed .EXE, .BAT/EXE/COM located, what files have imbedded
files..ect.).
9. The information is presented to the user in full color ANSI. They can
see what is going on, as it is happening. The Sysop is also kept posted
on the BBS side. *Keep in mind, most of the information(and graphics) are
being piped to the user(modem) and are not seen on the Sysop side.*
11. All file paths are stripped so they are *NOT* displayed out the modem.
If you have been using batch files before, then you had to redirect the
output away from the modem. At best the user just sits there looking at
an dead screen, at worst, they think you've locked up so they drop
carrier.
10. By the use of the SS.CFG file all paths and programs can be renamed
for security. (C:\util\PKUNZIP.EXE can become E:\tools\UNZIP.EXE).
SuperScan uses the following shareware programs:
PKUNZIP,SCAN.EXE,LHARC,ARJ,PAK,CHECK4COMP
(These may/do require their own registration fees)
The command line for SuperScan is:
SuperScan /P[C:\SS\SS.CFG] /F[FILENAME.ZIP]
Where /P is the path to the SS.CFG file
Where /F is the name of the file to be tested
Example: SuperScan /PC:\BBS\SS.CFG /FC:\UPLOADS\DATAFILE.ZIP
SS.CFG file *This is REQUIRED* Note the Setup- Set yours
SS\TEMP1 'A working directory *must be it's own because it is purged
SS\TEMP2 'Another working directory *Also gets purged each run..
SS 'The SuperScan directory (all log files will be put here
BADFILES 'This is where all the failing files are placed
UTIL\PKUNZIP 'The directory path and name of your PKUNZIP.EXE file
UTIL\SCAN 'The directory path and name of you SCAN.EXE file
UTIL\CHK4Comp.exe 'directory path and name for CHK4COMP.EXE
COM1 'The Com port you are using
D: ' The drive
UTIL\lha.exe 'The directory path and name for LHARC.EXE
UTIL\arj.exe 'The directory path and name for ARJ.EXE
UTIL\pak.exe 'The directory path and name for PKPAK.EXE
UTIL\diet.exe 'The directory path and name for DIET.EXE
│ Software Exchange BBS 616-329-6018 │ 'Your BBS Name (exactly 45 spaces)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
*DO NOT LEAVE THESE COMMENTS IN YOUR CONFIG FILE!!!*
* Note there are NO slashes in front of the directory names
*Do not
To install SuperScan for Telegard go to the ARCHIVE Menu (located by
first choosing (P)System Config, then (F)File Config, the (A)Archive).
From the Archive menu choose each format you want to use SuperScan with
(ZIP,ARJ,LZH,ARC,TXT,ect.) and change #6 to call SuperScan(or a batch
file).
Archive #1 of 5
1. Active : Yes
2. Extension name : ZIP
3. Interior list method : "/1" - *Internal* ZIP viewer
4. Compression cmdline : C:\BBS\PKZIP -aex @F @I
5. Decompression cmdline : C:\BBS\PKUNZIP @F @ I
6. Integrity check cmdline: C:\BBS\supers.bat @F
^^^^^^^^^^^^^^^^^^^^^^
* Change this to call SuperScan with the @F MCI code*
7. Add comment cmdline : C\BBS\PKZIP -
8. Errorlevel for success : 0
Q. Quit
Edit menu: (1-8,[,],Q) :
In this example I am calling a batch file(Supers.BAT)
You will probably have to call SuperScan from a Batch file unless you have
short paths and file names. You will need at least a minimum command line
like the following in your batch file.
SUPERS.BAT
C:\BBS\SS\SUPERS.EXE /PC:\SS\SS.CFG /F%1
Notice the %1 right against the /F - /F%1 - This passes the file name
from Telegard to the batch file to SuperScan.
Set up the other types (ARC,ARJ,ect.) the same way.
Most any type of BBS program that will pass the file name can run this
program. Just set it up the same way using whatever commands are required.
I used to do some of this with just plain Batch files, but they grew to be
enormous in size,were slow, and without much error traping or logging, and
gave away file paths if I tried to give the uploader more than a blank screen
to look at.
I will be adding a few more things (BBS & Sysop name input,User Name & number,
much more internal error trapping, and expanded graphics and log reporting),
later, but I am more interested in testing the main module right now.
** SuperScan may be used without charge by any BBS that is open to the public
and does not require/request any access fees or donations of any kind.
All others must send $5.00 per year for registration.
SuperScan v.3.00ß Flamming Idiot
beta release Software Exchange BBS
616-329-6018 1:2201/13 (FIDO)
(C)Copyright 1991 2 Gigs Online / HST 14.4
P.O BOX 845
PORTAGE MI 49081-0845
<*** End of File ***