PalmScan 1.11
Archive Conversion & Virus Scanning
User guide
PalmScan 1.11
Archive Conversion & Virus Scanning
January 23, 1994
Software and documentation written by Steven Hendriks
Copyright (C) 1993,94 by Steven Hendriks
All rights reserved.
All information in this documentation is
subject to change without prior notice
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Table of Contents
1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 Copyright and License Agreement . . . . . . . . . . . . . . . 5
1.2 Contacting the author . . . . . . . . . . . . . . . . . . . . 6
1.3 What is PalmScan . . . . . . . . . . . . . . . . . . . . . . 6
1.4 Features . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.5 System requirements . . . . . . . . . . . . . . . . . . . . . 9
1.6 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.7 Included files . . . . . . . . . . . . . . . . . . . . . . . 9
1.8 Runtime . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1 First time installation . . . . . . . . . . . . . . . . . . 11
2.2 Installing PalmScan in FileDoor . . . . . . . . . . . . . . 11
2.3 Installing PalmScan in SuperBBS . . . . . . . . . . . . . . 11
2.4 Installing PalmScan in Allfix . . . . . . . . . . . . . . . 12
2.5 Installing PalmScan in RemoteAccess 2.0x . . . . . . . . . 12
2.6 Installing PalmScan in The Remote Access Filearea Tools . . 12
2.7 Installing PalmScan in Maximus . . . . . . . . . . . . . . 13
2.8 Installing PalmScan in Ezycom . . . . . . . . . . . . . . . 14
2.9 Commandline . . . . . . . . . . . . . . . . . . . . . . . . 15
2.10 Watchdog, CTTY, ANSI.SYS . . . . . . . . . . . . . . . . . 17
3 The configuration . . . . . . . . . . . . . . . . . . . . . . . 18
3.1 PALMSCAN.CFG . . . . . . . . . . . . . . . . . . . . . . . 18
3.2 PSetup . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.2.1 Commandline . . . . . . . . . . . . . . . . . . . . 18
3.2.2 Starting PSetup . . . . . . . . . . . . . . . . . . 19
3.2.3 Keys . . . . . . . . . . . . . . . . . . . . . . . . 19
3.2.4 System data . . . . . . . . . . . . . . . . . . . . 19
BBS name . . . . . . . . . . . . . . . . . . . . . . 19
Key number . . . . . . . . . . . . . . . . . . . . . 19
SysOp name . . . . . . . . . . . . . . . . . . . . . 20
Net address . . . . . . . . . . . . . . . . . . . . 20
3.2.5 General settings . . . . . . . . . . . . . . . . . . 20
Redirect screen output of external programs . . . . 20
Running under FileDoor . . . . . . . . . . . . . . . 21
Update FILES.BBS / Extended descriptions character . 21
Spaces to indent . . . . . . . . . . . . . . . . . . 21
Download counters . . . . . . . . . . . . . . . . . 22
File-DataBase . . . . . . . . . . . . . . . . . . . 22
Import FILE_ID description . . . . . . . . . . . . . 23
Describe MOD's . . . . . . . . . . . . . . . . . . . 24
Normal color . . . . . . . . . . . . . . . . . . . . 24
Highlighted color . . . . . . . . . . . . . . . . . 24
Background color . . . . . . . . . . . . . . . . . . 25
3.2.6 Archive Conversion settings . . . . . . . . . . . . 26
Only process new files . . . . . . . . . . . . . . . 26
Only process listed files . . . . . . . . . . . . . 27
Put FILE_ID description in archive header . . . . . 27
Archive conversion . . . . . . . . . . . . . . . . . 28
Convert ALL archives . . . . . . . . . . . . . . . . 29
Process Self-Extracting archives . . . . . . . . . . 29
Process embedded archives . . . . . . . . . . . . . 29
Add CRC file list . . . . . . . . . . . . . . . . . 30
No title in headers . . . . . . . . . . . . . . . . 30
New archive date . . . . . . . . . . . . . . . . . . 31
3.2.7 Paths / filenames . . . . . . . . . . . . . . . . . 32
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Temporary directory . . . . . . . . . . . . . . . . 32
Bad files directory . . . . . . . . . . . . . . . . 32
Infected files directory . . . . . . . . . . . . . . 32
Hacked files directory . . . . . . . . . . . . . . . 32
Netmail directory . . . . . . . . . . . . . . . . . 33
BBS system directory . . . . . . . . . . . . . . . . 33
Files.bbs filename . . . . . . . . . . . . . . . . . 33
Log file . . . . . . . . . . . . . . . . . . . . . . 34
Archive header file . . . . . . . . . . . . . . . . 34
Substitute drive . . . . . . . . . . . . . . . . . . 35
3.2.8 Archivers . . . . . . . . . . . . . . . . . . . . . 36
3.2.9 Virus scan . . . . . . . . . . . . . . . . . . . . . 37
Files to scan . . . . . . . . . . . . . . . . . . . 37
Virus scanners . . . . . . . . . . . . . . . . . . . 37
3.2.10 HackList . . . . . . . . . . . . . . . . . . . . . . 39
3.2.11 Skip files . . . . . . . . . . . . . . . . . . . . . 39
3.2.12 Pack unpacked . . . . . . . . . . . . . . . . . . . 40
3.2.13 Remove files . . . . . . . . . . . . . . . . . . . . 40
3.2.14 Add files . . . . . . . . . . . . . . . . . . . . . 40
3.2.15 GIF settings . . . . . . . . . . . . . . . . . . . . 41
Add GIF specifications to descriptions . . . . . . . 41
GIF pack . . . . . . . . . . . . . . . . . . . . . . 41
JFIF unpack . . . . . . . . . . . . . . . . . . . . 41
JPEG unpack . . . . . . . . . . . . . . . . . . . . 42
Repack JFIF files . . . . . . . . . . . . . . . . . 42
Repack JPEG files . . . . . . . . . . . . . . . . . 42
3.2.16 Information . . . . . . . . . . . . . . . . . . . . 42
3.2.17 Exit to dos . . . . . . . . . . . . . . . . . . . . 42
4 Registration . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
I Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
PalmScan 1.11 User guide
-----------------------------------------------------------------------
1 Introduction
1.1 Copyright and License Agreement
'PalmScan' refers to all executables and documentation as
distributed in the compressed file in which the package was released.
Users of PalmScan must accept this disclaimer of warranty:
- PalmScan is copyrighted material by Steven Hendriks. It may only
be used in agreement with the conditions set out in this license
agreement.
- PalmScan is released as shareware.
- You may use PalmScan for an evaluation period of one month. After
this period you MUST either register PalmScan or stop using it.
- Registration is REQUIRED for commercial usage (in a commercial
environment, such as business, governmental organization,
association, school, foundation, or any other form of juridical
person, or any system where PalmScan is directly or indirectly
used to make profit).
- PalmScan may be distributed freely provided no money or any other
compensation is asked or accepted without prior written permission
from the author.
- PalmScan is supplied as is, without warranty or guarantee of any
kind, either expressed or implied, as to the fitness for a
particular purpose or quality or performance of this program,
except that PalmScan will occupy some disk space.
- In no event shall Steven Hendriks be liable to you or anyone else
for any damages or cost, including, but not limited to, any lost
profits, lost savings or lost income which may result from the use
or inability to use PalmScan.
- In no way is Steven Hendriks obligated to you or anyone else to
provide future versions of, or support for PalmScan.
- Steven Hendriks reserves the right not to release future shareware
versions of PalmScan, but switch to a commercial marketing concept
instead.
- It is forbidden to modify, adapt, translate, reverse engineer,
decompile and/or disassemble the software in this package.
Patching the medium at places that carry the software (including,
but not limited to, RAM memory and physical media) is seen as a
program change and is also forbidden.
- Your use of PalmScan constitutes your agreement to this license
and disclaimer and your release of the author from any form of
liability or litigation.
- 5 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
1.2 Contacting the author
If you have any problems with PalmScan, or if you wish to contact the
author for suggestions etc., you can:
- Call Oasis BBS (24 hours per day, 300 - 19200 bps, v32terbo, v42b) :
+31-1881-3132
- Send a NetMail message to Steven Hendriks at:
Fidonet 2:2802/140
VirNet 9:310/400
PNN 13:315/107
DigitalNet 15:1100/300
SIGnet 27:1331/40
OasisNet 52:52/0
AlarmNet 64:300/0
OASE 203:203/300
- Send an echomail message in the OASISSOFT support echo.
- Send an echomail message in an appropriate area in OasisNet.
- Send an echomail message in the DigitalNet N.V.P. (Helpdesk)
echomail area.
- Send a letter to this address:
Steven Hendriks
Hoofd 22
3214AH Zuidland
Netherlands
1.3 What is PalmScan
PalmScan is a conversion utility to convert almost any archive to
another format. It can check for viruses inside the archives (with
multiple virus-scanners) while converting, put the file description
(FILE_ID.DIZ or DESC.SDI) in the archive header and give this
description to FileDoor (along with some other info so PalmScan will
fit right in FileDoor's ExitAfterUpload) or put it in the FILES.BBS
file-list and/or the RemoteAccess 2.0x and Ezycom 1.02 file-database.
- 6 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
1.4 Features
- A very flexible configuration. You can configure almost anything
the way you want it.
- Runs under any BBS system which supports the DOOR.SYS or
DORINFO.DEF dropfile format. Without one of these dropfiles,
PalmScan can be run in local-only mode.
- Detects these archive types:
- ARC
- PAK *
- ZIP * ~
- LHA *
- ZOO
- SQZ *
- HYP
- ARJ * ~
- HAP
- UC2
PalmScan can detect other archives by looking at the archive
extension. Other archivers could be added, just send the archiving
program to the author and support will be added, if possible.
* Also self-extracting archives are detected.
~ Also security envelopes / authenticity validations are detected.
- Supports up to 30 different archive types.
- Supports GIF packing.
- Full FileDoor support (for FileDoor's ExitAfterUpload).
- Special FILES.BBS support.
- Full support for the RemoteAccess 2.0x file-database.
- Virus scanning with up to 20 virus scanners.
- Checking files in a hacklist.
- Compress un-archived files with your favorite archiver.
- Get file descriptions from FILE_ID.DIZ and DESC.SDI.
- Describes music files, like MOD, ScreamTracker, organ files, etc.
- Describes Compuserve GIF pictures.
- Ability to notify the SysOp about infected, bad and hacked
archives, in Fido-style (*.MSG) messages.
- Add and remove files to/from archives.
- Add file list with CRC-32's.
- Full support for the RemoteAccess 2.0x file-database.
- 7 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
- Full support for the Ezycom 1.02 file-database, including
maintenance features.
- Writes FrontDoor compatible log file.
- Supports both ANSI and ASCII when running under a BBS.
- Built-in Fossil support and carrier detection.
- Very user-friendly; virtually anything can be configured.
- A very easy-to-use setup program is included.
- High quality performance, very low registration fee.
- 8 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
1.5 System requirements
- IBM PC, XT, AT or compatible.
- IBM PC-DOS or Microsoft MS-DOS 3.0 (or compatible) or higher.
- At least 20 file handles ('FILES=20' in your CONFIG.SYS). A lower
value can cause 'Out of file handles' errors.
- At least 270 KB conventional memory available.
- At least one of the following compression utilities:
PKARC, PKZIP, LHA, ZOO, SQZ, Hyper, ARJ, HAP, PAK, UC2.
- A disk cache can improve performance, but isn't required. If you
aren't using a disk cache, make sure that the number of DOS
buffers is at least 30 ('BUFFERS=30' in your CONFIG.SYS) to
improve performance.
1.6 Logging
PalmScan can keep track of its activity in a FrontDoor style log. When
no filename is given in the configuration, logging is turned off.
The following characters are used in the log, to make things a bit
clearer:
! : Fatal error
? : Other (non-fatal) error or an infected/hacked/bad archive has been
found
$ : User information
# : Other information
+ : Statistics
1.7 Included files
This package includes:
PALMSCAN.EXE The main program
PALMSCAN.DOC This documentation
PALMSCAN.REG Registration form
PALMSCAN.CFG Sample configuration file
PALMSCAN.ANS Ansi advertisement
PSETUP.EXE PalmScan SETUP program
FILE_ID.DIZ Package description
UPDATE.LOG Update log
FILEINFO.INC Technical information about the PalmScan FileInfo system
- 9 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
1.8 Runtime
While PalmScan is running, no user input is required.
To abort processing of files, you can press escape. PalmScan will then
finish the file which is currently being processed, and after that ask
whether you wish to continue processing or not.
- 10 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
2 Installation
2.1 First time installation
PalmScan and all files included can be placed either in a separate
directory, or in the BBS directory. the most common way is creating a
sub-directory under the BBS directory, and place the files there.
After placing all files in a directory, edit PALMSCAN.CFG.
2.2 Installing PalmScan in FileDoor
The most common way for installing PalmScan in FileDoor is the
following:
ExitAfterUpload1 C:\PALMSCAN\PALMSCAN.EXE $U\*.* $N $M
$U\*.* tells PalmScan which files to process.
$N tells FileDoor to execute PalmScan only when files are
received.
$M tells FileDoor to swap to disk/EMS before executing PalmScan.
I recommend using the 'FileDoor' keyword in the configuration, PalmScan
will then tell FileDoor the new filename when a file has been
converted, and the original size of the archive. By using 'FileID'
also, PalmScan will also tell FileDoor the description (when found in
FILE_ID.DIZ or DESC.SDI). You should never use 'FilesBBS' when running
under FileDoor.
2.3 Installing PalmScan in SuperBBS
The most common way for installing PalmScan in SuperBBS is the
following:
Virus scanner: c:\xfd\palmscan\palmscan.exe %1 *S
%1 tells PalmScan which file to process.
*S tells SuperBBS to swap to disk/EMS before executing PalmScan.
You shouldn't use archive conversion when PalmScan is used as virus
scanner in SuperBBS. After uploads, SuperBBS wouldn't be
able to find the file back when it's got another filename.
For using archive conversion, you should run PalmScan in an event, with
'FilesBBS' and 'OnlyNewFiles' switched on.
- 11 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
2.4 Installing PalmScan in Allfix
Allfix version 4.21 (and later) has the option to use an external
archive conversion utility. The most common way for installing PalmScan
in Allfix at this option is the following:
MTA : PALMSCAN.EXE @1 /L
/L tells PalmScan to run in local-only mode (Allfix doesn't have a
user online anyway...) .
@1 tells PalmScan which file to process.
The errorlevels should be configured like this:
(MTA) virus errorlevel 213
(MTA) error errorlevel 199
PalmScan returns errorlevel 203 for bad archives (archives which can't
be unpacked), and errorlevel 213 for virus-infected archives.
With these errorlevel settings in Allfix, it will move the file to the
bad directory if either one of these occur.
You shouldn't configure a 'BadPath' and 'InfectedPath', Allfix will
move bad or infected archives to the BadTick directory (when the
errorlevels are configured as above). Also, both 'FilesBBS' and
'FileDoor' shouldn't be used, else PalmScan would create files which
are of no use for Allfix.
2.5 Installing PalmScan in RemoteAccess 2.0x
The commandline for using PalmScan in the upload scan option in
RemoteAccess 2.0x should be:
PALMSCAN.EXE @ *M
If you are using the file-database in RemoteAccess 2.0x, you should
also enable this option ('FDB RA') in the PalmScan configuration.
2.6 Installing PalmScan in The Remote Access Filearea Tools
The commandline for using PalmScan in the ARCCONV option in The Remote
Access Filearea Tools should be:
PALMSCAN.EXE %F @1 /L
- 12 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
2.7 Installing PalmScan in Maximus
If you don't already use the VirusCheck option in Maximus, you should
first uncomment the following line in MAX.CTL:
Upload Check Virus Vircheck.Bat
If you want to use the DORINFOx.DEF support of PalmScan, you should
also make a few changes to the MENUS.CTL file. Usually the upload
command is looking like this:
Upload Limited "Upload (send)"
Maximus includes a mecca script called DORINFO.MEC, which produces a
DORINFO1.DEF. The new structure of the upload command should be as
follows:
Display_File C:\Max\Dorinfo Limited "Upload (send)"
NoDsp Upload Limited "U"
This way whenever a user begins the upload procedure, a DORINFO1.DEF
file is created.
You can now edit the VIRCHECK.BAT to include the following:
PalmScan %1%2%3 /NoConversion /D[path to DORINFOx.DEF]
If you don't want to use the DORINFOx.DEF support, it should be this
way:
PalmScan %1%2%3 /NoConversion /L
Warning! Do not use spaces between the commandline variables (%1,%2 and
%3) or nothing will work properly.
You can find the location where the DORINFOx.DEF file will be created
by viewing the DORINFO.MEC file, located in the Misc directory.
You must not forget to SILT (compile) the configuration after changing
the .CTL files.
When PalmScan finds the archive to be bad or infected, it will remove
it from the upload directory. After returning to the BBS, Maximus will
then not find the file present and it won't credit the user for it, and
the file won't be placed in the FILES.BBS.
The 'ArchiveConversion' keyword should not be used in the PalmScan
configuration for running PalmScan inside Maximus, while Maximus would
think the file is missing when the filename is changed. You can also
use the /NOCONVERSION commandline option for PalmScan instead of
disabling the ArchiveConversion keyword (this can be especially usefull
when using PalmScan to convert the archives in an event, and using only
one configuration for PalmScan).
For doing archive conversions, FileID insertion and FILES.BBS update
options, run PalmScan in an event or just after exiting Maximus, with
the 'OnlyNewFiles', 'FileID' and 'FilesBBS' keywords turned on.
- 13 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
2.8 Installing PalmScan in Ezycom
There are various ways of using PalmScan with Ezycom. When using
PalmScan in one of the conversion batch-files used by Ezycom, PalmScan
will not update the Ezycom file-database. Ezycom will handle this
itself, so you should disable 'FDB Ezycom' when PalmScan is started
from one of those batch-files.
When using PalmScan with UPCONV.BAT, the commandline should be as
follows:
PalmScan.Exe %1%4.%6
When used in DOCONV.BAT, /L should be added to that.
The best way to use PalmScan with Ezycom is by not using it in these
batch-files, but running it in an event with the FDB maintenance
feature (/FDBMAINT commandline option). You could also run PalmScan
after every caller, processing only the upload directory
(/FDBMAINT<areanr>).
- 14 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
2.9 Commandline
The PalmScan commandline consists of:
PALMSCAN.EXE [FileSpec|@ListFile|Command] <filespecs> <options>
[..] is mandatory
<..> is optional
[FileSpec] must be a valid DOS file-secification. At least one
should be given, up to 30 can be given.
File-specifications can be either filenames or
directory's. In the last case, all files in that
directory will be processed.
Example : PalmScan *.ZIP
[@ListFile] Instead of (a) file-specification(s), you can also use a
listfile. This listfile should contain valid
file-specifications (see above). PalmScan will process
all file-specifications in the listfile (there isn't a
maximum size for the listfile!). The file-specifications
should be placed on the first part of each line,
everything behind it will be ignored.
Example listfile:
d:\files\upload This is the upload directory
d:\files\incoming This is the incoming files directory
In this example, all files in the directory's
d:\files\upload and d:\files\incoming, will be processed
(except for those files configured with the SkipFile
keyword in the PalmScan configuration). The comments
behind the directory's will be ignored.
You can also use FLSEARCH.CTL (QuickBBS format) with
this option.
Example : PalmScan @C:\BBS\FLSEARCH.CTL
[Command] :
/FDBMAINT<areanr>
Usage : Run Ezycom file-database maintenance. PalmScan will
first search the Ezycom file-database for files which
have not been checked, and place them in a file called
FILEINFO.FIX. After that, the PalmScan FileInfo system
will take over and those files will be processed. Files
will be converted to the archiver configured in the
Ezycom file-area configuration. When no archiver is
configured for an area, PalmScan will not process files
in that area.
- 15 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
<areanr> The area number which should be processed.
When no area number is specified, PalmScan
will process all areas which have a
destination archiver configured.
/FIX<+>
Usage : Use the PalmScan FileInfo system. This system
accomplishes an enhanced communication between PalmScan
and programs using PalmScan. When using /FIX, PalmScan
will use the FileInfo system in Read-Only mode, the
FileInfo file (FILEINFO.FIX) will be deleted when all
files have been processed.
When using /FIX+, PalmScan will use the FileInfo system
in Read/Write mode. PalmScan wil update the FileInfo
file with some information thath can be used by the
program which is calling PalmScan.
Technical information about the FileInfo system can be
found in FILEINFO.INC, which is included in the PalmScan
package.
<options> :
/L
Usage : Local operation. When this switch is NOT used, PalmScan
will search for DOOR.SYS and/or DORINFO?.DEF to get the
user information from.
/D[dorinfo-filename]
Usage : When your BBS-package creates a DORINFO file with a
filename that can't be found by searching for
DORINFO?.DEF (ie. Ezycom can create DORINF85.DEF for
line 85), you can specify this filename here.
Example : /Ddorinf85.def
/C[configuration-filename]
Usage : By default, PalmScan will search for it's configuration
file in the same directory where PALMSCAN.EXE is placed,
with the filename PALMSCAN.CFG. With this commandline
option, you can tell PalmScan to use an alternate
configuration file.
Example : /Cc:\palmscan\afixpalm.cfg
- 16 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
/NOCONVERSION
Usage : When this option is used, no archiving will be done at
all. This means that no archive will be converted, there
won't be any file removal or file adding, no music
modules will be described, and the archive header will
not be updated. This can be especially usefull for
running PalmScan as online virus scanner (when the
archive conversion is done in an event), or for just
updating file descriptions in FILES.BBS with the
'FileID' keyword used.
/S
Usage : When this option is used, PalmScan will search all sub-
directory's of the given file-specifications for files
to be processed. Together with the ProcessListedOnly
configuration keyword, this option can very well be used
to process all files on a bulletin board.
/MONO
Usage : Forces monochrome mode.
/NOCLS
Usage : Do not clear the screen at startup.
/NOREG
Usage : Do not display 'Registered to ...' at startup.
2.10 Watchdog, CTTY, ANSI.SYS
CTTY and WATCHDOG, or similar utilities, are not required and should
not be used with this program. PalmScan has its own communication
routines which monitor the COM port.
ANSI.SYS is not required for this program. When running under DESQview,
DVANSI isn't required either. It won't do any harm if either one is
loaded however.
- 17 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3 The configuration
3.1 PALMSCAN.CFG
The PALMSCAN.CFG file is a normal (ASCII) text-file. You can create
this file with any ASCII-editor. PalmScan will search for its
configuration file in the directory containing PALMSCAN.EXE, or the
configuration file specified on the commandline (see chapter 2.7).
If no configuration file is found, PalmScan will terminate abnormally.
PALMSCAN.CFG contains many options. Some of them are optional, others
are not. The general format for the PALMSCAN.CFG file is:
{statement} [mandatory parameter] <optional parameter>
There are no restrictions to the position you start the parameters, but
the parameters have to be separated with one or more spaces. The
{statement} must start on position 1 of each line.
When there should be spaces in a parameter (like in the archiver
commands), you can use underscores ('_') for that, PalmScan will
translate those in spaces.
You can insert comment-lines into PALMSCAN.CFG by putting a '%' or a
';' character on position 1 of the desired line(s). Also empty lines
are considered as comment.
3.2 PSetup
Besides editing the configuration file with an ASCII editor, you can
also configure PalmScan with PSetup. PSetup uses the same ASCII
text-file as PalmScan.
3.2.1 Commandline
The PSetup commandline consists of:
PSETUP [configuration-filename]
[configuration-filename]
Usage : By default, PSetup will search for it's configuration file in
the same directory where PSETUP.EXE is placed, with the
filename PALMSCAN.CFG. With this commandline option, you can
tell PSetup to use an alternate configuration file.
Example : PSETUP c:\palmscan\afixpalm.cfg
- 18 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.2 Starting PSetup
When you run PSetup, it will look for the configuration file as stated
in chapter 3.3.1. When no configuration file is found, it will inform
you of this. The configuration file will then be created when you exit
PSetup.
3.2.3 Keys
PSetup uses pop-up menus. You can use the cursor up and down keys to
move through the menus, and select an option by pressing Enter. The
Escape key will take you back to a previous level.
In all edit fields, Escape aborts and Enter saves changes (if you
didn't select the 'Cancel' button, that is). Tab moves the cursor to
the next field, Shift-Tab will to the opposite (move the cursor to the
previous field). With the Space-bar you can toggle on/off options.
3.2.4 System data
Here you can enter some information about your system.
BBS name
Keyword : BBSname [BBS_name]
Usage : This option informs PalmScan of your BBS name. This
option is only of use when you registered PalmScan and
also use the RegKey statement.
[BBS_name] This is your BBS name.
Example : BBSname Oasis_BBS
Key number
Keyword : RegKey [nnnnn]
Usage : When you registered PalmScan, you will receive a key so
that PalmScan will display 'Registered to ...' instead
of 'Unregistered evaluation copy'. Please see the
registration form for details on how to register, if you
have not already done so.
[nnnnn] This is your key number as you receive it
after registering PalmScan.
Example : RegKey 123456
- 19 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
SysOp name
Keyword : SysopName [Sysop_Name]
Usage : When writing messages in a Fido-style message board,
PalmScan will write those messages to 'SysOp', unless
your name is specified here, then it will write to your
name.
[Sysop_Name] Your name.
Example : SysopName Steven_Hendriks
Net address
Keyword : NetAddress [Zone:Net/Node<.Point>]
Usage : Here you can specify you main network address, as
installed in your mailer configuration. This is only
used for messages created when bad or infected archives
are found. If you don't have any network address, you
don't have to enter anything here either.
[Zone:Net/Node<.Point>] Your network address.
<.Point> is optional.
Example : NetAddress 2:2802/140
3.2.5 General settings
Redirect screen output of external programs
Keyword : RedirectOutput
Usage : PalmScan can redirect output of external programs
(archivers and virus-scanners) to NUL. This means that
those programs will display nothing to the (SysOp)
screen. Some programs, however, will still get output on
the screen (like TBScan and F-Prot). PalmScan will
restore the screen to it's original looks after the
external program has been executed, if that happens.
Enabling this option will cause the display on the SysOp
side to be exactly the same as the display on the user
side.
Example : RedirectOutput
- 20 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Running under FileDoor
Keyword : FileDoor
Usage : PalmScan has full FileDoor support. When this option is
used, and archives are converted, PalmScan will inform
FileDoor of the change in filesize and change of
filenames. In cooperation with FileID, PalmScan will
also give FileDoor the description of the file (when a
FILE_ID.DIZ or DESC.SDI file was found inside the
archive).
Example : FileDoor
Note : PalmScan assumes you are using FileDoor 3.10ΓP or
higher. If you are using an older version, you should
not use the FileDoor parameter in cooperation with the
FileID parameter, while the way FileDoor handles these
descriptions has been changed in version 3.10ΓP.
Update FILES.BBS / Extended descriptions character
Keyword : FilesBBS [c]
Usage : When this option is set, PalmScan will update the
filename in the FILES.BBS file list when archive
conversion is done, and, in cooperation with FileID, put
the description of the file in this file list.
[c] For using extended descriptions (descriptions
consisting of multiple lines), PalmScan should know
the character which is used by you BBS system for
this option. SuperBBS uses '>', RemoteAcces uses
'+'.
Example : FilesBBS >
Spaces to indent
KeyWord : IndentSpaces [nn]
Usage : By default, extended descriptions will be indented one
space, after which the extended descriptions character
(if any) is placed and then the actual description line.
With this option, you can change the number of spaces
that should be indented before extended descriptions.
[nn] This is the number of spaces that will be used.
Example : IndentSpaces 27
- 21 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Download counters
Keyword : DownloadCounter [l] [r] [nnn]
Usage : When a missing file has been added to the FILES.BBS
files list, or when an extended description has been
added, PalmScan will also update the download counter
when you set this option.
[l] This is the character that is being used as left
bracket in the download counters.
[r] This is the character that is being used as right
bracket in the download counters.
[nnn] This is the number of characters (numbers)
that should be used in between the brackets.
Example : DownloadCounter [ ] 3
File-DataBase
Keyword : FDB [RA|Ezycom]
Usage : PalmScan has full support for the RemoteAccess 2.0x and
Ezycom 1.02 file-database. With this keyword, you can
enable this.
Filenames, sizes, dates, descriptions, etcetera are
updated by PalmScan when needed.
[RA] PalmScan will use the RemoteAccess 2.0x
file-database.
When an infected file is found, PalmScan will use
the normal procedure to either move the file or
exit with an errorlevel, and besides this it will
also mark the file as deleted, unlisted and/or not
available, according to the settings in the
RemoteAccess configuration.
When an archive can not be unpacked, PalmScan will
also use the normal procedure as configured in the
PalmScan configuration, and it will mark the file
as not available in the RemoteAccess file-database.
[Ezycom] PalmScan will use the Ezycom 1.02
file-database.
When an infected file, an archive which can't
be unpacked, or a file which exists in the
HackList was found, PalmScan will use the
normal procedure to either move the file or
exit with an errorlevel, and besides this it
will also mark the file as offline in the
Ezycom file-database.
When the FileID keyword is also used, PalmScan
will filter out all ascii control codes and
all high ascii, and place the first non-empty
line at the description in the Ezycom
file-database.
- 22 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
To prevent problems, here is some inside information:
* When you are using on directory for different file
areas in RemoteAccess/Ezycom, PalmScan will always
use the FIRST area which uses the same directory as
where the file which is being processed was found.
* When PalmScan adds a description to the file-
database, the old description will not be removed
from the RemoteAccess database text. It will not be
used for the file anymore, but will remain on your
disk. To remove the old description, you should run
RAFILE COMPRESS.
Example : FDB RA
Import FILE_ID description
Keyword : FileID <OneLine> <Filter> <FiltLow>
Usage : When this switch is set, PalmScan will import the
description from the FILE_ID.DIZ or DESC.SDI file to
FileDoor, FILES.BBS or the RemoteAccess file-database.
<OneLine> Instead of placing descriptions from
FILE_ID.DIZ or DESC.SDI on multiple lines
(with the extended descriptions character),
PalmScan can put those descriptions on one
long line. To use this, OneLine must be
specified at the FileID keyword.
Note : This option is available for
registered users only.
<Filter> PalmScan can filter out high ASCII (characters
128 to 255) from FILE_ID.DIZ or DESC.SDI
descriptions. When this switch is used, all
high ASCII characters will be removed from the
description, and empty lines (which can be
caused by removing high ASCII characters when
a line consists of only those characters) will
be removed.
Note : This option is available for
registered users only.
<FiltLow> PalmScan can filter out ASCII control-codes
(characters 0 to 31) in FILE_ID.DIZ or
DESC.SDI descriptions before importing them.
Example : FileID OneLine Filter FiltLow
- 23 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Describe MOD's
Keyword : DescribeMod <OnlyMainArchive>
Usage : PalmScan has the ability to describe MOD, NST, STM
(ScreamTracker Modules), 669, JMusic and Organ music
files. PalmScan will put the description of those files
in a FILE_ID.DIZ descriptions file, which will be packed
with the other files in the archive. This will only be
done when no executables are found in the archive (ie.
the archive only consists of music files), or when a
FILE_ID.DIZ already exists in the archive (PalmScan will
add the descriptions of the music files to this
FILE_ID.DIZ in this case). With this keyword, you can
enable this option.
<OnlyMainArchive> When this switch is specified, only
modules in the main archive will be
described. When embedded archives
are being processed, modules in
those archives will be ignored. This
is only valid when the ArchInArch
keyword is used. When that keyword
isn't used, embedded archives
wouldn't be processed at all so
modules in those archives would
never be described either.
Example : DescribeMod OnlyMainArchive
Normal color
Keyword : ColorNormal [c]
Usage : With this keyword, you can configure the color of normal
text in PalmScan.
[c] This is the color number. This can be any value
from 0 to 15.
Example : ColorNormal 3
Highlighted color
Keyword : ColorHighlight [c]
Usage : With this keyword, you can configure the color of
highlighted text in PalmScan.
[c] This is the color number. This can be any value
from 0 to 15.
Example : ColorHighlight 11
- 24 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Background color
Keyword : ColorBackground [c]
Usage : With this keyword, you can configure the background
color in PalmScan.
[c] This is the color number. This can be any value
from 0 to 7.
Example : ColorBackground 0
- 25 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.6 Archive Conversion settings
Only process new files
Keyword : OnlyNewFiles <method>
Usage : For running PalmScan in a daily event, it's possible to
process only new files. When this option is used,
PalmScan will only process files with the archive
attribute set, and remove this attribute when a file has
been processed, thus processing files only once.
<method> By default, PalmScan will use the archive
attribute on files to determine whether a file
has been processed earlier or not. There are
two other methods available:
FileDate In this case, PalmScan will only
process files which have a file date
and time later than the last time a
file has been processed in that
directory. PalmScan will store the
date in a file called LASTSCAN.PS,
in the directory where the file was
found.
Because LASTSCAN.PS only contains
the last date and time a file has
been processed, it will affect the
processing of ALL files in that
directory.
This method will use a directory
entry (0-byte file) for each
processed directory.
DataFile In this case, PalmScan will only
process files which aren't found in
the data file, and files with a
changed size, date or time.
The file which is used to store the
data is called PALMSCAN.DAT.
PalmScan uses separate datafiles for
separate directory's, so when a file
is being moved, it will also be
processed (again).
This method uses 12 bytes of disk
space for each processed file (and a
directory entry in each processed
directory).
The DataFile method is the most secure OnlyNewFiles
method; The archive attribute method fails on systems
where the archive attribute is being reset by another
program (some backup programs do that), and the file
date method affects complete directory's, where this
method affects only the file which is processed.
Example : OnlyNewFiles DataFile
- 26 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Only process listed files
Keyword : ProcessListedOnly
Usage : By default, all files which comply with the given file
specifications (and aren't specified with the SkipFile
keyword) will be processed. With this keyword, you can
tell PalmScan to only process files which are listed in
the FILES.BBS files list (when the FilesBBS keyword is
used) and/or the RemoteAccess / Ezycom file-database
(when the FDB keyword is used).
Example : ProcessListedOnly
Note : This option is available for registered users only.
Put FILE_ID description in archive header
Keyword : FileIDarchiveHdr
Usage : When this switch is on, PalmScan will add the
description from FILE_ID.DIZ or DESC.SDI to the archive
header. When an archive header is already being added
(ArchiveHeader keyword), the description will be
appended to it.
Example : FileIDarchiveHdr
- 27 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Archive conversion
Keyword : ArchiveConversion [ttt] <OnlyMainArchive> <NoSFX>
<NoSecure>
Usage : This option sets the target archive system. When no
target archive system is set, no archive conversion will
be done.
[ttt] This sets the target. You can supply all
values you configured with the Archiver
statement.
<OnlyMainArchive> When this switch is specified, only
main archives will be converted to
the target archive type. Embedded
archives will still be processed for
other options when ArchInArch is
used, but those archives won't be
converted.
<NoSFX> When this switch is specified, self-
extracting archives will not be
converted to the target archive
type, and no files will be removed
from those archives. Also, the
/NOCONVERSION commandline option
will be used on archives embedded in
self-extracting archives.
<NoSecure> When this switch is used, secure
archives (archives with a security
envelope or authenticity
verification) will not be converted,
no files will be removed or added,
no music modules will be described,
and an archive header will not be
added to secured ARJ archives. Also,
the /NOCONVERSION commandline option
will be used on archives embedded in
secure archives.
PalmScan can detect ARJ security
envelopes and PkZIP (both 1.xx and
2.0x) authenticity verifications.
Note : This option is available
for registered users only.
Example : ArchiveConversion ZIP OnlyMainArchive NoSecure
- 28 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Convert ALL archives
Keyword : ConvertAll <OnlyMainArchive>
Usage : Normally, PalmScan will only convert archives of other
types than the target archive system. With this option
you can tell PalmScan to convert all archives, even if
it's already of the target archive type.
<OnlyMainArchive> When this switch is specified, only
main archives which are already in
the target archive type will be
converted, embedded archives which
are already in the target archive
type won't be converted. (This is
only of use when the ArchInArch
keyword is used).
Example : ConvertAll OnlyMainArchive
Process Self-Extracting archives
Keyword : ProcessSFX <OnlyMainArchive>
Usage : By default, Self-Extracting (SFX) archives, are not
recognised as being archives. With this switch, you can
tell PalmScan to process SFX archives, just like every
other archive. PalmScan can detect ZIP, LHA, SQZ, ARJ
and PAK SFX archives.
<OnlyMainArchive> When this switch is specified,
embedded SFX archives will not be
processed.
Example : ProcessSFX OnlyMainArchive
Process embedded archives
Keyword : ArchInArch
Usage : PalmScan has the ability to process embedded archives.
With this statement you can enable this feature. When
ArchInArch is enabled, PalmScan will swap itself to XMS,
EMS or disk, and startup another copy of itself.
PalmScan leaves only 1k of memory used, so it should be
able to handle well over 300 levels of embedded
archives. PalmScan will do some things less with those
embedded archives, than with main archives. It will not
add archive headers, or move infected or bad archives
(instead it will tell it's parent to do so).
Example : ArchInArch
Note : This is the main switch for embedded archive processing.
When this isn't used, all OnlyMainArchive switches will
have no meaning.
- 29 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Add CRC file list
Keyword : AddCRCfile <OnlyMainArchive>
Usage : PalmScan can create a list with all filenames, sizes,
dates and CRC-32's of all files in the archive. This
file will look like this:
CRC-32 files list for : ARCHIVE.EXT
Created by PalmScan 1.11 on BBS name
File Size Date Time CRC-32
-----------------------------------------------
FILENAME.EXT XXXXXXXX XX-XX-XXXX XX:XX XXXXXXXX
-----------------------------------------------
The filename of the list will be the same as the archive
filename, with extension .CRC.
<OnlyMainArchive> When this switch is specified,
PalmScan will only create a CRC-32
list in the main archive. Embedded
archives will not get a CRC-32 list.
Example : AddCRCfile OnlyMainArchive
Note : The BBS name will only be added for registered users.
No title in headers
Keyword : NoTitleInHdr
Usage : By default, PalmScan will add it's title to archive
headers, when an archive header is added (with the
keywords ArchiveHeader and FileIDarchiveHdr). With this
option, you can disable it.
Example : NoTitleInHdr
Note : This option is available for registered users only.
- 30 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
New archive date
Keyword : Touch <Original|Today|Latest|Oldest>
Usage : When an archive has been processed, PalmScan can touch
the file date and time on the archive. There are four
possible ways:
<Original> The processed archive will get the same
date and time as the original archive.
This is the default setting.
<Today> The processed archive will get the
current date and time.
<Latest> The processed archive will get the date
and time of the latest (newest) file in
the archive.
<Oldest> The processed archive will get the date
and time of the oldest file in the
archive.
Note : This option is available for registered users only.
- 31 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.7 Paths / filenames
Temporary directory
Keyword : TempPath [d:\path]
Usage : TempPath should point to a directory where PalmScan will
store temporary files. This directory is necessary for
running PalmScan.
[d:\path] This is the directory where the temporary
files will be stored.
Example : TempPath C:\TEMP
Bad files directory
Keyword : BadPath [d:\path]
Usage : When a bad file has been encountered (ie. the file
cannot be unpacked although it is an archive), PalmScan
can move it to this directory. When this option isn't
used, PalmScan will exit with errorlevel 203 instead of
moving the bad archive.
[d:\path] This is the directory where PalmScan will move
bad files to.
Example : BadPath C:\FILES\BAD
Infected files directory
Keyword : InfectedPath [d:\path]
Usage : When a virus has been found, PalmScan will move the file
so you can investigate it further. When this keyword is
not used, PalmScan will exit with errorlevel 213 instead
of moving the infected file.
[d:\path] This is the directory where PalmScan will move
infected files to.
Example : InfectedPath C:\FILES\INFECTED
Hacked files directory
Keyword : HackPath [d:\path]
Usage : When a file has been found in the hacklist, PalmScan
will move this file so you can investigate it further.
When this keyword is not used, PalmScan will exit with
errorlevel 212 instead of moving the hacked file.
Example : HackPath C:\FILES\HACKED
- 32 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Netmail directory
Keyword : NetmailPath [d:\path]
Usage : When a infected file or a bad archive has been found,
PalmScan can post a message in a Fido-style (*.MSG)
message board, telling you which archive contains
infected file(s), which scanner(s) reported this, what
action has been taken, and which user was online at that
time (when running in online mode). By specifying a
netmail path, this option is enabled.
[d:\path] The full path to the directory where messages
should be stored.
Example : NetmailPath C:\NETMAIL
BBS system directory
Keyword : BBSpath [d:\path]
Usage : When using the RemoteAccess/Ezycom file-database ('FDB'
keyword), PalmScan has to read some information from the
RemoteAccess/Ezycom configuration. Either the RA/EZY
environment variable or this keyword must be configured
to be able to use the file-database.
Example : BBSpath C:\RA
Files.bbs filename
Keyword : FilesBBSname [filename]
Usage : By default, PalmScan will use the file FILES.BBS in the
same directory as the processed files, when the FilesBBS
keyword is used. With this option, you can configure the
filename for this files list.
When it is configured to another name than FILES.BBS,
PalmScan will first try this file, and if that fails it
will still use the normal FILES.BBS. This option can be
used for 4DOS DESCRIPT.ION files, or when you have your
files list in a sub-directory of the directory where the
files are located. When the latter is used, PalmScan
will use this sub-directory for the files list, and when
the sub-directory does not exist, the normal FILES.BBS
will be used.
Example : FilesBBSname LIST\FILES.BBS
- 33 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Log file
Keyword : LogFile [d:\path\filename.ext]
Usage : PalmScan can keep track of its activity in a
FrontDoor-style log. When this option isn't used, no
logging will be done.
[d:\path\filename.ext] This is the full path and
filename of the logfile
PalmScan should maintain.
Example : LogFile C:\LOG\PALMSCAN.LOG
Archive header file
Keyword : ArchiveHeader [d:\path\filename.ext]
Usage : PalmScan can add a header to your archives. When this
parameter points to a valid ASCII textfile, this file
will be used as header for the archive.
[d:\path\filename.ext] This is the full path and
filename to the header text
file.
When using UC2 as archiver, PalmScan can also add
multimedia banners. The file configured with the
ArchiveHeader keyword will be added as TXT banner, for
multimedia banners, you should put the GIF/JPG/MOD/ASK
files in the same directory and filename as the
configured archive header, and with extension
GIF/JPG/MOD/ASK. If you don't want to use the TXT
banner, but do want to use other banners, you should put
the filename of the other banners at the ArchiveHeader
keyword without extension or with an extension of a non-
existing file (never put GIF/JPG/MOD extensions there,
PalmScan will then add these files as archive banner as
if they were normal text files).
Example : ArchiveHeader C:\PALMSCAN\HEADER.ASC
- 34 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
Substitute drive
Keyword : SubstDrive [Drive letter]
Usage : When archiving files with sub-directory's, some
archivers add complete path names instead of only the
sub-directory's names to the archives. PalmScan can use
a substituted drive for the archive conversion to make
sure the correct directory names are in the archives.
PalmScan will then call SUBST before every pack/unpack
command.
[Drive letter] The drive letter must be an unused drive
and should be available when PalmScan is
running (please test it with the SUBST
command before using it in PalmScan).
When an error occurs while SUBST is being
called, PalmScan will use the normal
pathname.
Example : SubstDrive F
- 35 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.8 Archivers
Here you can define the name and commandline options for compression
and decompression programs. Please make sure that the programs can be
found in your path, or include a full path before the commands.
Keyword : Archiver [ext] [compression] [decompression] <addheader>
Usage : This option can be used to tell PalmScan the archiver
commands.
[ext] This is the normal extension of archives
created by this archiver. This will also be
used as the name of the archiver within
PalmScan.
[compression] This is the full command for this
archiver to compress files.
[decompression] This is the full command for this
archiver to extract archives.
<addheader> This is the full command for this
archiver to add a header to an archive
(if available for this archiver).
Example : Archiver ARC pkarc_a pkxarc_-r_-e pkarc_x<
Archiver PAK pak_a_/i pak_e_/wa pak_h<
Archiver ZIP pkzip_-ex_-r_-p pkunzip_-o_-d pkzip_-z<
Archiver LHA lha_a_/rxpatm lha_x_/c
Archiver ZOO zoo_aPh zoo_eO// zoo_cA<
Archiver ARJ arj_a_-r arj_x_-y arj_c_-z
Archiver SQZ sqz_a_/p3_/s sqz_x_-o1
Archiver HAP hap_a pah_e
Archiver UC2 uc_a_-s_-tt_-f_-b uc_e_-s_-f_!ban=off
uc_a_-tt_-f_-b
Note : You can use up to 30 archivers in PalmScan. However, the
first 10 are reserved for ARC, PAK ZIP, LHA, ZOO, SQZ,
HYP, ARJ, HAP and UC2 (which PalmScan can automatically
detect), so that leaves 20 others. PalmScan will look at
the extensions of those 20 other archive types to
determine what type it is.
- 36 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.9 Virus scan
Files to scan
Keyword : VirusScan <filespec> <filespecs>
Usage : When this switched is used, PalmScan will scan for
viruses inside all files with the scanners configured
with the Scanner parameter. When this switch isn't set,
no virus scanning will be done.
<filespec> This can be any valid DOS file
specification.
When you give any filespec (you may use
up to 50 of them here), PalmScan will
only execute the virus scanner(s) when
one or more file(s) have been found that
meet the requirements of these file
specifications.
When no file specifications are given,
PalmScan will always execute the virus
scanner(s). (In PSetup, there must always
be at least one file specification, ie.
*.*).
Example : VirusScan *.EXE *.COM *.OVR *.OVL
Virus scanners
Keyword : Scanner [name] [command] [lll] <hhh> <nnn>
Usage : This is one of the most important options in PalmScan.
The files inside archives will be scanned with all
configured virus scanners.
[name] This is the name of the virus scanner.
[command] This is the command for the virus scanner to
be executed. The path/filename(s) of the
file(s) to be scanned will NOT be
automatically added to the commandline. There
are some meta-commands which will be replaced
with the correct string by PalmScan:
@PATH The directory that should be scanned
(without trailing backslash).
@FILENAME The filename of the file(s) to be
scanned.
@FULL The path and filename of the file(s)
to be scanned.
(@FULL = @PATH\@FILENAME)
@SPECIAL This meta-command is a special one;
it will act like @FULL when a
specific file should be scanned, and
like @PATH when all files in a
directory should be scanned.
- 37 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
[lll] This is the lowest errorlevel the virus
scanner will return when a virus has been
found.
<hhh> This is the highest errorlevel the virus
scanner will return when a virus has been
found. When it isn't set, PalmScan assumes the
virus scanner will only return errorlevel
[lll]
<nnn> This is the errorlevel that the virus scanner
will return when nothing is wrong. Most virus
scanners return errorlevel 0 when there are no
problems, but there are some scanner which
return another errorlevel just because there
aren't any executables found. With this option
you can make PalmScan simply ignore that
errorlevel.
Example : Scanner McAfee_Scan SCAN_/NOMEM_/A_/NOPAUSE_/SUB_@FULL 1
1 0
Scanner ThunderByte_Scan
TBSCAN_AF_NB_NM_BA_IN_NA_OLD_@SPECIAL 2 127 1
Scanner F-Prot
F-PROT_/ALL_/COMMAND_/NOMEM_/OLD_/NOBOOT_@FULL 3 3 0
Scanner AVScan AVSCAN_/NM_/NC_/Q_/R_/S_@FULL 100 255 0
Note : You can use up to 20 virus scanners in PalmScan. They
will be executed in the order they were found in the
configuration.
- 38 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.10 HackList
Keyword : HackList [d:\path\filename.ext] <triggers>
Usage : PalmScan can check a HackList (eg. 'The Hack Report' by
Lee Jackson) for dangerous files.
[d:\path\filename.ext] This is the full path and
filename of the .COL or .IDX
file to use. If you want to use
more than one of those (eg.
reports of previous years and
this year), you should copy
those files to one file.
Wildcards are not allowed for
this option.
<triggers> These are the sections (eg. HAK HOX TRO)
which should trigger PalmScan to move the
file to the hacked files directory or,
when no hacked files directory is
configured, exit with errorlevel 212. Up
to 10 sections can be given. When no
section is specified, or when you are
using a .COL list (sections are not
included in .COL lists), PalmScan will
always be triggered.
Example : HackList C:\PALMSCAN\HACK9401.IDX HAK HOX TRO PIR
Note : The used format for the HackList is:
FILENAME,year,section
3.2.11 Skip files
Keyword : SkipFile [filespec] <filespecs>
Usage : There are some files that shouldn't be processed by
PalmScan, for instance FILES.BBS or BIMODEM.LOG. With
this parameter you can specify up to 50 valid DOS file
specifications that should be skipped by PalmScan. Full
path names can also be included in these file
specifications.
[filespec] This must be a valid DOS file
specification.
Example : SkipFile FILES.BBS BIMODEM.*
SkipFile D:\FILES\SECURE\*.*
- 39 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.12 Pack unpacked
Keyword : PackUnpacked [filespec] <filespecs>
Usage : With this option, you can tell PalmScan to archive
un-archived files. All files which comply to one or more
of the given file-specifications and aren't archives,
will be archived with the archiver configured with the
ArchiveConversion keyword.
[filespec] This must be a valid DOS
file-specification.
Example : PackUnpacked *.MOD *.STM *.ANS
Note : Up to 50 file-specifications can be given.
3.2.13 Remove files
Keyword : RemoveFile [filespec] <filespecs>
Usage : Many archives contain some files which have no relation
with the actual archive, like advertisements added by
BBS SysOp's. This can eventually take up a great part of
your available disk space. PalmScan can now remove these
files from the archives.
[filespec] This must be a valid DOS
file-specification.
Example : RemoveFile OASISBBS.ADV OASIS.BBS
Note : Up to 50 file-specifications can be given.
3.2.14 Add files
Keyword : AddFile [filespec]
Usage : Just like PalmScan can remove files from archives, it
can also add files to them. You can use this to add an
advertisement for your BBS, or whatever you want added
to the archives.
[filespec] This must be a valid DOS
file-specification.
Example : AddFile C:\TEXT\OASIS.BBS
Note : Up to 10 AddFile keywords can be used.
- 40 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
3.2.15 GIF settings
Add GIF specifications to descriptions
Keyword : GIFspecs <[left bracket] ['by' character] [right
bracket]>
Usage : PalmScan will add GIF specifications (resolution and
colors) to descriptions when this keyword is used.
Optional are the characters that are used in the
descriptions, but when specifying one of them, both
others must be specified too. By default, these
characters are used : ( x )
When used with FILES.BBS or the RemoteAccess file-
database, PalmScan will first check if the
specifications already exist in the description, and
only add them when they do not already exist.
Example : GIFspecs < * >
GIF pack
Keyword : GIFpack [title] [command]
Usage : To convert GIF pictures to another format, this feature
can be used.
[title] This is only used to display to what format
the file is being converted, but must be
configured when using this feature.
[command] This is the command that should be executed to
convert the GIF picture.
Example : GIFpack JFIF CJPEG.EXE
JFIF unpack
Keyword : JFIFunpack [command]
Usage : PalmScan will use this setting to convert JFIF files to
GIF. JFIF files are standard JFIF/JPEG files, which can
be created by CJPEG and some other graphics conversion
utilities.
[command] This is the command that should be executed to
convert the JFIF file.
Example : JFIFunpack DJPEG.EXE
- 41 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
JPEG unpack
Keyword : JPEGunpack [command]
Usage : This is actually the same as JFIF unpack, with the
difference that JPEG files are files which are
incompatible with standard JFIF/JPEG files. Files
created by (older versions of) GIF2JPG are such JPEG
files.
When this command is not configured, and JFIF unpack is
configured, PalmScan will try to convert JPEG files to
GIF using the command configured at JFIF unpack.
[command] This is the command that should be executed to
convert the JPEG file.
Example : JPEGunpack JPG2GIF.EXE
Repack JFIF files
Keyword : JFIFrepack
Usage : When this keyword is used, JFIF files will first be
converted to GIF, and then converted using the command
configured with the GIFpack keyword.
Example : JFIFrepack
Repack JPEG files
Keyword : JPEGrepack
Usage : When this keyword is used, JPEG files will first be
converted to GIF, and then converted using the command
configured with the GIFpack keyword.
Example : JPEGrepack
3.2.16 Information
This is a small information window about PalmScan and PSetup.
3.2.17 Exit to dos
This option will take you out of PSetup. If you have made any changes
to the configuration, you will be asked if you want to save them before
you exit. You also have the option to cancel and return back to PSetup.
- 42 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
4 Registration
After you have evaluated PalmScan for the period of one month, you must
either register or discontinue using PalmScan. PalmScan is released as
'try before you buy', so please buy it if you like it.
As long as you don't register, PalmScan will remind you that you have
not registered when PalmScan is started up.
To register, fill out the registration form, PALMSCAN.REG, and send it
to the registration site.
The minimal registration fee for a noncommercial license for PalmScan
is 30 Dutch Guilders, 30 German Marks, 21 US Dollars or 600 Belgian
Francs.
A system is considered to be noncommercial only if it is at a private
residence at which no commercial activities are conducted.
For using PalmScan in a commercial environment, the minimal
registration fee is 60 Dutch Guilders, 60 German Marks, 42 US Dollars
or 1200 Belgian Francs.
If the amount is not sufficient because of additional transfer costs or
check bouncing, the registration cannot be accepted. The received money
will be seen as a donation until enough payment has been received.
Please note that banks often charge 10 US Dollars or more for
international transfers.
Keys will be sent by crash netmail, or, if you cannot receive crash
netmail, by snail mail, as soon as possible after the registration form
and fee have been received.
- 43 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
5 Credits
Thanks to all registered users and beta testers, for registering and
testing this software, and for all suggestions I got from you. I would
specially like to thank Jos Schorgers, Manolis Zoulias and Hans
Akkerman for their efforts.
All brand and product names are copyrighted (C) by and/or trademarks
(TM) or registered trademarks (R) of their respective holders:
4DOS JP Software Inc.
Allfix Harald Harms
ARJ Robert K. Jung
AVScan H+BEDV Datentechnik GmbH
CJPEG, DJPEG Thomas G. Lane
Ezycom Peter Davies
F-Prot Frisk Software International
Fido Tom Jennings and Fido Software
FileDoor Robert W. van Hoeven
FrontDoor Joaquim Homrighausen
GIF CompuServe Incorporated
GIF2JPG, JPG2GIF Handmade Software, Inc.
HAP, PAH Harald Feldmann
Hyper P. Sawatzki and K.P. Nischke
IBM, PC-DOS International Business Machines Corp.
LHA Haruyasu Yoskizaki
Microsoft, MS-DOS Microsoft Corporation
PAK NoGate Consulting
PKARC, PKZIP PKWARE, Inc.
QuickBBS Pegasus Software
RAFT Chris Buijs
RemoteAccess Wantree Development and Andrew Milner
SQZ J.I. Hammarsberg
SuperBBS Aki Antman and Risto Virkkala
TBScan Thunderbyte BV
UltraCompressor II, UC2 Ad Infinitum Programs
ViruScan McAfee Associates
ZOO Rahul Dhesi
- 44 -
PalmScan 1.11 User guide
-----------------------------------------------------------------------
I Index
/C[configuration-filename] . 16 FilesBBSname . . . . . . . . 33
/D[dorinfo-filename] . . . . 16 GIFpack . . . . . . . . . . . 41
/FDBMAINT<areanr> . . . . . . 15 GIFspecs . . . . . . . . . . 41
/FIX<+> . . . . . . . . . . . 16 HackList . . . . . . . . . . 39
/L . . . . . . . . . . . . . 16 HackPath . . . . . . . . . . 32
/MONO . . . . . . . . . . . . 17 InfectedPath . . . . . . . . 32
/NOCLS . . . . . . . . . . . 17 JFIFrepack . . . . . . . . . 42
/NOCONVERSION . . . . . . . . 17 JFIFunpack . . . . . . . . . 41
/NOREG . . . . . . . . . . . 17 JPEGrepack . . . . . . . . . 42
/S . . . . . . . . . . . . . 17 JPEGunpack . . . . . . . . . 42
AddCRCfile . . . . . . . . . 30 LogFile . . . . . . . . . . . 34
AddFile . . . . . . . . . . . 40 NetAddress . . . . . . . . . 20
ArchInArch . . . . . . . . . 29 NetmailPath . . . . . . . . . 33
ArchiveConversion . . . . . . 28 NoTitleInHdr . . . . . . . . 30
ArchiveHeader . . . . . . . . 34 OnlyNewFiles . . . . . . . . 26
Archiver . . . . . . . . . . 36 PackUnpacked . . . . . . . . 40
BadPath . . . . . . . . . . . 32 ProcessListedOnly . . . . . . 27
BBSname . . . . . . . . . . . 19 ProcessSFX . . . . . . . . . 29
BBSpath . . . . . . . . . . . 33 RedirectOutput . . . . . . . 20
ColorBackground . . . . . . . 25 RegKey . . . . . . . . . . . 19
ColorHighlight . . . . . . . 24 RemoveFile . . . . . . . . . 40
ColorNormal . . . . . . . . . 24 Scanner . . . . . . . . . . . 37
ConvertAll . . . . . . . . . 29 SkipFile . . . . . . . . . . 39
DescribeMod . . . . . . . . . 24 SubstDrive . . . . . . . . . 35
DownloadCounter . . . . . . . 22 SysopName . . . . . . . . . . 20
FDB . . . . . . . . . . . . . 22 TempPath . . . . . . . . . . 32
FileDoor . . . . . . . . . . 21 Touch . . . . . . . . . . . . 31
FileID . . . . . . . . . . . 23 VirusScan . . . . . . . . . . 37
FileIDarchiveHdr . . . . . . 27
FilesBBS . . . . . . . . . . 21
- 45 -