CD Direkt 1995 #3/_.ISO/cdd/avirus/tbav_6_3/tbav.doc

Text File | 1994-12-04 | 314KB | 7,747 lines

     SECTION 0. INTRODUCTION
          1. How to use the manual . . . . . . . . . . . . . . . . .     0 - 1
          2. Overview of the TBAV utilities  . . . . . . . . . . . .     0 - 1

     SECTION I. INSTALLING TBAV
          1. How to install TBAV   . . . . . . . . . . . . . . . . .     I - 1
               1.1 Initial installation  . . . . . . . . . . . . . .     I - 1
               1.2 Menu and command syntax . . . . . . . . . . . . .     I - 4
          2. Configuration . . . . . . . . . . . . . . . . . . . . .     I - 6
          3. TbSetup . . . . . . . . . . . . . . . . . . . . . . . .     I - 8
               3.1. The Purpose of TbSetup . . . . . . . . . . . . .     I - 8
               3.2. How to use TbSetup . . . . . . . . . . . . . . .     I - 8
               3.3. Command line options . . . . . . . . . . . . . .    I - 13
               3.4. While executing  . . . . . . . . . . . . . . . .    I - 15
          4. TbDriver  . . . . . . . . . . . . . . . . . . . . . . .    I - 18
               4.1. Purpose of TbDriver  . . . . . . . . . . . . . .    I - 18
               4.2. Command line options . . . . . . . . . . . . . .    I - 18
               4.3. Language support . . . . . . . . . . . . . . . .    I - 21
          5. System maintenance  . . . . . . . . . . . . . . . . . .    I - 22
          6. Network maintenance . . . . . . . . . . . . . . . . . .    I - 23
               6.1. Using DOS REPLACE  . . . . . . . . . . . . . . .    I - 23
               6.2. Using PkUnZip  . . . . . . . . . . . . . . . . .    I - 23

     SECTION II. ANTI-VIRUS STRATEGY
          1. Protection against viruses  . . . . . . . . . . . . . .    II - 1
               1.1. Introduction . . . . . . . . . . . . . . . . . .    II - 1
               1.2. Basic precautions  . . . . . . . . . . . . . . .    II - 1
          2. What to do when a virus strikes . . . . . . . . . . . .    II - 6
               2.1. Detection of viruses . . . . . . . . . . . . . .    II - 6
               2.2. Recovering from viruses  . . . . . . . . . . . .    II - 7

     SECTION III. USING THE TBAV UTILITIES
          1. TbScan  . . . . . . . . . . . . . . . . . . . . . . .     III - 1
               1.1. The Purpose of TbScan  . . . . . . . . . . . .     III - 1
               1.2. How to use Tbscan  . . . . . . . . . . . . . .     III - 2
               1.3. Command line options . . . . . . . . . . . . .    III - 11
               1.4. The scanning process . . . . . . . . . . . . .    III - 18
          2. TbScanX . . . . . . . . . . . . . . . . . . . . . . .    III - 22
               2.1. The Purpose of TbScanX . . . . . . . . . . . .    III - 22
               2.2. How to use TbScanX . . . . . . . . . . . . . .    III - 22
               2.3. Command line options . . . . . . . . . . . . .    III - 23
               2.4. While scanning . . . . . . . . . . . . . . . .    III - 26
          3. TbCheck . . . . . . . . . . . . . . . . . . . . . . .    III - 28
               3.1. The Purpose of TbCheck . . . . . . . . . . . .    III - 28
               3.2. How to use TbCheck . . . . . . . . . . . . . .    III - 28
               3.3. Command line options . . . . . . . . . . . . .    III - 29
               3.4. While checking . . . . . . . . . . . . . . . .    III - 31
               3.5. Testing TbCheck  . . . . . . . . . . . . . . .    III - 31
          4. TbClean . . . . . . . . . . . . . . . . . . . . . . .    III - 32
               4.1. The Purpose of TbClean . . . . . . . . . . . .    III - 32
               4.2. How to use TbClean . . . . . . . . . . . . . .    III - 33
               4.3. Command line options . . . . . . . . . . . . .    III - 35
               4.4. The cleaning process . . . . . . . . . . . . .    III - 36
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                  CONTENTS


          5. Ongoing virus prevention: TbMon . . . . . . . . . . .    III - 40
               5.1. TbMem  . . . . . . . . . . . . . . . . . . . .    III - 41
               5.2. TbFile . . . . . . . . . . . . . . . . . . . .    III - 45
               5.3. TbDisk . . . . . . . . . . . . . . . . . . . .    III - 47
          6. TBAV Tools  . . . . . . . . . . . . . . . . . . . . .    III - 53
               6.1. TbUtil . . . . . . . . . . . . . . . . . . . .    III - 53
               6.2. TbLog  . . . . . . . . . . . . . . . . . . . .    III - 61

     SECTION IV. ADVANCED USER INFORMATION
          1. Memory requirements . . . . . . . . . . . . . . . . . .    IV - 1
          2. TbSetup . . . . . . . . . . . . . . . . . . . . . . . .    IV - 3
               2.1. Anti-Vir.Dat design considerations . . . . . . .    IV - 3
               2.2. Format of TbSetup.Dat  . . . . . . . . . . . . .    IV - 3
               2.3. TBAV site installation . . . . . . . . . . . . .    IV - 5
          3. TbScan  . . . . . . . . . . . . . . . . . . . . . . . .    IV - 7
               3.1. Heuristic scanning . . . . . . . . . . . . . . .    IV - 7
               3.2. Integrity checking . . . . . . . . . . . . . . .    IV - 8
               3.3. Program validation . . . . . . . . . . . . . . .    IV - 9
               3.4. The algorithms . . . . . . . . . . . . . . . . .    IV - 9
               3.5. The TbScan.Lng file  . . . . . . . . . . . . .     IV - 11
               3.6. The TBAV.MSG file  . . . . . . . . . . . . . .     IV - 11
          4. TbClean . . . . . . . . . . . . . . . . . . . . . . .     IV - 12
          5. TbGensig  . . . . . . . . . . . . . . . . . . . . . .     IV - 15
               5.1 The Purpose of TbGenSig . . . . . . . . . . . .     IV - 15
               5.2 Defining signatures . . . . . . . . . . . . . .     IV - 15
               5.3 Keywords  . . . . . . . . . . . . . . . . . . .     IV - 18
               5.4 Wildcards . . . . . . . . . . . . . . . . . . .     IV - 21

     Appendix A. TBAV messages

     Appendix B. TbScan - Heuristic flag descriptions

     Appendix C. Solving incompatibility problems

     Appendix D. Batch file handling

     Appendix E. Virus naming
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION 0


SECTION 0. INTRODUCTION


1. How to use the manual

     Congratulations! By purchasing the ThunderBYTE Anti-Virus utilities you
     have taken the basic step in building a massive anti-viral safety wall
     around your precious computer system. Setting up the appropriate defen-
     se, using the TBAV utilities, is a 'personal matter'. Therefore, we
     highly recommend to read this manual thoroughly, so you are well aware
     of all different kinds of security measures you may take.

     This manual consists of four main sections. Section I instructs you how
     to install the TBAV utilities on your hard disk(s), including some
     useful hints on customized initialization. Section II gives an instruc-
     tion on how to prevent viruses from infecting your computer system(s)
     and directions on how to handle when you actually have been struck by a
     computer virus.

     In section III, both purpose and functionality of all TBAV utilities are
     described. For those who want to know more about the subject, some
     'advanced user information' on the ThunderBYTE Anti-Virus utilities is
     presented in section IV.

     You may use the TBAV manual as a reference manual, via an extensive
     index and appendices referring to the TBAV error messages.

=>   Note that a complete reading of the manual is indispensible in order to
     become familiar with the many facets of ThunderBYTE Anti-Virus, to know
     what steps can - and must - be taken to ensure adequate protection and
     to be fully prepared for a complete recovery, if and when disaster
     strikes.


2. Overview of the TBAV utilities

     What is ThunderBYTE Anti-Virus?

     ThunderBYTE Anti-Virus (TBAV) is a comprehensive toolkit designed to
     protect against - and recover from - computer viruses. While TBAV
     focuses heavily on numerous ways to prevent a virus infection, the
     package would not be complete without various cleaner programs to purge
     a system, in the unlikely event that a virus manages to slip through.
     The package therefore consists of a number of programs each of which
     help you to prevent viruses to do their destructive jobs. Here is a
     quick overview.


     Collecting software information: TbSetup

     TbSetup is a program that collects information from all software found
     on your system. The information will be put in files named Anti-Vir.Dat.

                                       0 - 1
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION 0


     The information maintained in these files can be used for integrity
     checking, program validation, and to clean infected files.


     Enable memory resident TBAV utilities: TbDriver

~    TbDriver does not provide much protection against viruses by itself, but
     must be loaded in advance to enable the memory resident ThunderBYTE
     Anti-Virus utilities, such as TbScanX, TbCheck, TbMem, TbFile and TbDisk
     to perform properly. It also provides basic protection against ANSI
     bombs and 'stealth' viruses.


     Scanning for viruses: TbScan

     TbScan is both a very fast signature scanner and a so-called heuristic
     scanner. Besides its blazing speed it has many configuration options. It
     can detect mutants of viruses, it can bypass stealth type viruses, etc.
     The signature file used by TbScan is a coded 'TbScan.Sig' file, which
     can be updated by yourself in case of emergency.  TbScan is able to
     disassemble and decrypt files. This makes it possible to detect suspici-
     ous instruction sequences and to detect yet unknown viruses. This
     generic detection, named heuristic analysis, is a technique that makes
     it possible to detect about 90% of all viruses by searching for suspici-
     ous instruction se-quences rather than using any signature. For that
     purpose TbScan contains a disassembler, decryptor and code analyzer.

     Another feature of TbScan is the integrity checking it performs when it
     finds the Anti-Vir.Dat files generated by TbSetup. 'Integrity checking'
     means that TbScan will check that every file being scanned matches the
     information maintained in the Anti-Vir.Dat files. If a virus infects a
     file, the maintained information will not match the now changed file
     anymore, and TbScan will inform you about this.

     TbScan performs an integrity check automatically, and it does not have
     the false alarm rate other integrity checkers have. The goal is to
     detect viruses and not to detect configuration changes!


     Automatic scanning: TbScanX

     TbScanX is the memory resident version of TbScan. This signature scanner
     remains resident in memory and automatically scans those files which are
     being executed, copied, de-archived, downloaded, etc. TbScanX does not
     require much memory. It can swap itself into expanded, XMS, or high
     memory, using only 1Kb of conventional memory.


     Check while loading: TbCheck

     TbCheck is a memory resident integrity checker. This program remains
     resident in memory and checks automatically every file just before it is

                                       0 - 2
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION 0


     being executed. TbCheck uses a fast integrity checking method, consuming
     only 400 bytes of memory. It can be configured to reject files with
     incorrect checksums, and/or to reject files that do not have a corres-
     ponding Anti-Vir.Dat record.


     Restoring infected boot-sector, CMOS and partition tables: TbUtil

     Some viruses copy themselves into the hard disk's partition table, which
     makes them far more difficult to remove than bootsector viruses. Perfor-
     ming a low-level format is an effective, but rather drastic measure.
     TbUtil offers a more convenient alternative by making a precautionary
     back-up of uninfected partition tables and the boot sector. If an
     infection occurs, the TbUtil back-up can be used as a verifying tool and
     as a means to restore the original (uninfected) partition table and
     bootsector without the need for a destructive disk format. The program
     can also restore the CMOS configuration for you. If a back-up of your
     partition table is not available, TbUtil will try to create a new
     partition table anyway, again avoiding the need for a low-level format.

     Another important feature of TbUtil is the option to replace the parti-
     tion table code with new code offering greater resistance to viruses.
     The TbUtil partition code is executed before the boot sector gains
     control, enabling it to check this sector in a clean environment. The
     TbUtil partition code performs a CRC calculation on the master boot
     sector just before the boot sector code is activated and issues a
     warning if the boot sector has been modified. The TbUtil partition code
     also checks and reports changes in the RAM lay-out. These checks are
     carried out whenever the computer is booted from the hard disk.

     It should be noted that boot sector verification is imperative before
     allowing the boot sector code to execute. A virus could easily become
     resident in memory during boot-up and hide its presence. TbUtil offers
     total security at this stage by being active before the boot sector is
     executed. Obviously, TbUtil is far more convenient than the traditional
     strategy of booting from a clean DOS diskette for an undisturbed inspec-
     tion of the boot sector.


     Reconstructing infected files: TbClean

     TbClean is a generic file cleaning utility. It uses the Anti-Vir.Dat
     files generated by TbSetup to enhance file cleaning and/or to verify the
     results. TbClean can however also work without these files. It disassem-
     bles and emulates the infected file and uses this analysis to recon-
     struct the original file.


     Resident safeguard: TbMon

     TbMon is a set of memory resident anti-virus utilities, consisting of
     TbMem, TbFile and TbDisk. Most other resident anti-virus products offer

                                       0 - 3
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION 0


     you the choice to invoke them before the network is loaded and losing
     the protection after the logon procedure, or to load the anti-viral
     software AFTER the logon to the network, resulting in a partially
     unprotected system. The ThunderBYTE Anti-Virus utilities however recog-
     nize the network software and take appropriate actions to ensure their
     functionality.


     Controlling memory: TbMem

~    TbMem detects attempts from programs to remain resident in memory, and
     ensures that no program can remain resident in memory without permis-
     sion. Since most viruses remain resident in memory, this is a powerful
     weapon against all such viruses, known or unknown. Permission informa-
     tion is maintained in the Anti-Vir.Dat files. TbMem also protects your
     CMOS memory against unwanted modifications.


     Preventing infection: TbFile

     TbFile detects attempts from programs to infect other programs. It also
     guards read-only attributes, detects illegal time-stamps, etc. It will
     make sure that no virus succeeds in infecting programs.


     Protecting the disk: TbDisk

     TbDisk is a disk guard program which detects attempts from programs to
     write directly to disk (without using DOS), attempts to format, etc.,
     and makes sure that no malicious program will succeed in destroying your
     data. This utility also traps tunneling and direct calls into the BIOS
     code. Permission information about the rare programs that write directly
     and/or format the disk is maintained in the Anti-Vir.Dat files.


     Define your own signatures (in case of an emergency): TbGensig

     Since TBAV is distributed with an up-to-date, ready-to-use signature
     file, you do not really need to maintain a signature file yourself. If,
     however, you want to define your own virus signatures, you will need the
     TbGensig utility. You can use either published signatures or define your
     own ones if you are familiar with the structure of software.


     Remove infected files: TbDel

     The DOS 'DEL' command does not actually erase a file. It simply changes
     the first filename character in the directory listing and frees up the
     space by changing the disk's internal location tables. TbDel is a small
     program with just one but important purpose: it replaces every single
     byte in a file with zero characters before deleting it. The entire
     contents are therefore obliterated and totally unrecoverable.

                                       0 - 4
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


SECTION I. INSTALLING TBAV


1. How to install TBAV


     System requirements

     The ThunderBYTE Anti-Virus utilities can be executed on any IBM or
     compatible PC with at least 1 Mb disk space. The TBAV utilities need 256
     Kb free internal memory and require DOS 3. However, DOS 5 or a later
     version is recommended. The TBAV utilities are compatible with networks,
     Windows, DR-DOS, etc.


1.1 Initial installation

     You can install the TBAV utilities either by using the installation
     procedure (which is explained below) or by a fully customized TBAV
     installation (which is explained in sections  I - 3 and II).

     Insert the TBAV installation diskette in the diskette drive.

     Type:
          A: or B:

     Type:
          install C:\TBAV <Enter>


          +---------------------------------------+
          |    F1  First time installation        |
          |    F2  Update installation            |
          |    F3  About....                      |
          |    F4  Exit....                       |
          +---------------------------------------+

     Since this is the first time you install the TBAV package you choose the
     first option by pressing <Enter> or <F1>.


     ----- [ Please select Drive to install TBAV to: ]-----
         You need at least 1024 KB of available space to install TBAV !

               C:     3581952
               D:    21291008


     Toggle to the disk on which the TBAV utilities must be installed. TBAV
     Install displays the amount of free disk space of each available disk.



                                       I - 1
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     Next, TBAV Install will prompt you for the TBAV directory. The default
     directory is \TBAV:


     -----[ Please select Directory to install TBAV to: ]-----
          [C:\TBAV                                      ]


     If the specified directory does not exist, the installation pro-gram
     will create it. Subsequently, the TBAV files are copied onto your hard
     disk.

     +-----------------------------------------------------------+
     |    The documentation for TBAV is compressed into a file.  |
     |    The documentation-file will now be self-extracted.     |
     |    Press any key when ready....                           |
     |                                                           |
     |                                                           |
     |         Inflating: c:/tbav/TBSCAN.DOC    -AV              |
     |         Inflating: c:/tbav/TBSCANX.DOC   -AV              |
     |         Inflating: c:/tbav/TBCLEAN.DOC   -AV              |
     +-----------------------------------------------------------+

     The packed text files are copied onto your hard disk and inflated. After
     copying all files, TbSetup is loaded, which will generate or update the
     Anti-Vir.Dat file of the TBAV directory.


     +-----------------------------------------------------------+
     |    TbSetup will now generate or update the Anti-Vir.Dat   |
     |         file of the directory C:\TBAV                     |
     |              Press any key when ready...                  |
     +-----------------------------------------------------------+

     The ThunderBYTE Anti-Virus utilities are copied to the destination
     directory. The installation program helps you to setup the utilities in
     their most standard and non-customized way. After reading the manual
     thoroughly, you can configure the package to suit your own personal
     needs.

     +-----------------------------------------------------------+
     | This installation program helps you to setup the utilities|
     |         in their most standard and non-customized way.    |
     |              Do you want to continue ? (Y/N)              |
     +-----------------------------------------------------------+

     If 'No', TBAV Install will not prompt you for placing the memory resi-
     dent TBAV utilities in the autoexec.bat file, nor for creating the Anti-
     Vir.Dat files. If yes, TBAV Install backs up your original Autoexec.Bat
     file and appends a call to the tbstart.bat file. For easy access of the
     TBAV utilities it is recomended to put them into your PATH environment
     variable. Your Autoexec.Bat file now looks like this:

                                       I - 2
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


          @ECHO OFF
          PATH C:\TBAV

          call C:\TBAV\tbstart.bat

     Subsequently, TbSetup will process the indicated drive to generate the
     Anti-Vir.Dat files. You may need to repeat this process for other
     drives. Consult the relevant section for more information!


     The TBAV package contains some utilities that can be instal-
     led in the memory of your PC. For each of these utilities you can
     indicate whether the installation program must add them to the
     Tbstart.bat file:

          TBSCANX is a memory resident virus scanner.
                    Do you want to install it ? (Y/N)

          TBCHECK is a memory resident integrity checker.
               Do you want to install it ? (Y/N)

          TBMEM is a resident memory guard.
               Do you want to install it ? (Y/N

          TBFILE is a resident file guard.
               Do you want to install it ? (Y/N)


     If you answer the subsequent question with Yes, TBAV will scan your
     system for viruses automatically once every day:

          Do you want the system to be scanned automatically
               for viruses every day ? (Y/N)


     The installation program will write the indicated configuration values
     in the 'tbstart.bat' file, which is located in the Thunder-BYTE directo-
     ry you specified before, eg.:

          C:\TBAV\tbdriver
          C:\TBAV\tbscanx
          C:\TBAV\tbcheck
          C:\TBAV\tbmem
          C:\TBAV\tbfile
          C:\TBAV\tbscan /once /alldrives

     Finally, you can force the TBAV utilities to scan your disk right away.

     It is very likely that some of the TBAV utilities are going to display
     messages when you reboot and continue using the computer as you normally
     would. Some programs perform operations that are monitored by the TBAV
     utilities, so TBAV must first 'learn' which programs need proper permis-

                                       I - 3
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     sion. Execute some of the programs you use regularly and at each rele-
     vant query respond with 'Y' to authorize or 'N' to deny permission. TBAV
     will remember the settings and not bother you again. Reboot the computer
     at the end of this test run.

     The TBAV utilities are now ready to monitor the system and will issue a
     warning if something suspicious - or worse - is about to happen. They
     will also warn you if any new file contains a possible virus - well
     before it can do any harm.


1.2 Menu and command syntax

     You can activate most of the TBAV utilities from within the TBAV menu,
     by loading:

          cd\tbav
          tbav

     In order to execute the utilities automatically, all TBAV drivers and
     utilities may be executed from the DOS prompt. In a systemized setup,
     however, the drivers should be installed and activated in your Con-
     fig.Sys, with a device= or install= directive, or in the TbStart.Bat
     file as a TSR. Similarly, most utilities can be started automatically -
     in the case of TbScan restricted to once a day - in the TbStart.Bat
     file. The two exceptions are TbClean and TbDel, which should be executed
     only from the DOS prompt and (TbClean) from within the TBAV menu.

     All commands for ThunderBYTE Anti-Virus can be used with command line
     switches or options to control special features. The options may either
     be written out in full, or abbreviated to their one- or two-letter
     mnemonic to shorten the command line. Throughout this manual the exam-
     ples are given with options in verbose, unabbreviated form for clarity.
     Options must be separated by spaces. They do not need a preceding switch
     character, but you may use the customary slash or hyphen switch charac-
     ters if you wish.

     The standard command line syntax for all ThunderBYTE Anti-Virus commands
     is:

          command [<path>] [<filename>] [<option>] ... [<suboption>] ...

     You may review the correct syntax for any command, including a complete
     option list, with the command followed by the word 'help' or a question
     mark, as in:

          tbcheck ?

     The same on-line help is provided whenever the command is issued with an
     invalid option.



                                       I - 4
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     The examples, presented in this manual assume that all utilities were
     installed in the default \TBAV directory.


     Create a recovery diskette!

     It is highly recommended to make a recovery diskette. The example setups
     assume you have created such a recovery diskette (see the instructions
     in section II).












































                                       I - 5
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


2. Configuration

     The choices you made when installing the TBAV utilities may need some
     tuning, for instance by appending options to the loading command. This
     tuning can be done by editing the TBSTART.BAT file, which automatically
     loads the memory resident utilities.

=>   If suitable, you may write the relevant commands in the Config.Sys file
     instead. Do not forget to specify the .EXE extension in the Config.Sys
     file!

     Below, some basic hints are presented, to customize the initial settings
     to suit your own needs. After initializing and rebooting your system for
     the first time afterwards, TBAV will need your response in the initial
     'learning' stage.


     TBAV menu configuration

     The TBAV menu allows some configuration, as well.

     +----Main menu-----+
     |  Confi+----------TBAV configuration----------+
     |  TbSet|v Use colors                          |
     |  TbSca|  Save configuration to TBAV.INI      |
     |  TbUti|  File view utility                   |
     |  TbCLe|v Wait after program execution        |
     |  TBAV |  Show command line before executing  |
     |  Docum|v Edit path string before scanning    |
     |  Regis+--------------------------------------+
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+

     You can activate the configuration options by toggling to the relevant
     choice and pressing <Enter>.


     Use colors

     If disabled, TBAV will be displayed in monochrome mode, which is conve-
     nient for use on laptop computers.


     Save configuration to TBAV.INI

     All configuration values, set within the TBAV menu, are saved in the
     'TBAV.INI' file, once you have selected this option. The next time you
     load the TBAV utilities the configuration values in the current TBAV.INI
     file will be valid. These values apply to the TBAV menu itself and the
     utilities TbSetup, TbScan and TbClean. Although you may edit the TBAV.I-
     NI file manually, it is recommended to let the TBAV menu shell generate

                                       I - 6
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     it. By default, the contents of the TBAV.INI file is only valid while
     using the TBAV menu shell. You may, however, enable the "Use TBAV.INI
     file" options (or specify the 'UseIni' switches in the TBAV.INI file
     itself) for each of the utilities mentioned above. Doing so, the confi-
     guration, saved in the TBAV.INI file will also be valid when TbSetup,
     TbScan or TbClean are loaded from the command line. Be careful, since
     options specified in the TBAV.INI file can not be undone on the command
     line. TBAV will create a TBAV.INI file when enabling this option for the
     first time. In this file all valid configuration switches are listed.
     The disabled switches are preceded by a semicolon.


     File view utility

     TbSetup and TbScan generate a datafile and a logfile respectively. By
     default, you can view these files from the TBAV menu using an internal
     file view utility. By using this option you are able to attach your
     favorite external file view utility. Enter the complete path and the
     file name, including the extension.


     Wait after program execution

     By enabling this option, TBAV will display the message:
     "Press any key to return to the TBAV utilities" after executing an
     external utility.


     Show command line before executing

     Enabling this option will force TBAV to display the DOS command which
     will load the external utility. This option comes in handy in order to
     see the command(s) you specified before. After pressing <Enter> TBAV
     will execute the DOS commands.


     Edit path string before scanning

     If enabled, you are prompted to edit or confirm the path to be scanned
     after you have selected "Start scanning".













                                       I - 7
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


3. TbSetup


3.1. The Purpose of TbSetup

     TbSetup is an indispensible tool, adding support to the rest of the
     ThunderBYTE Anti-Virus utilities, even though it does not take an active
     part in actual virus detection or cleaning itself. TbSetup organizes
     control and recovery information giving extra power to the other utili-
     ties. The information is gathered, mainly from program files, into a
     single reference file called Anti-Vir.Dat, one each per directory. The
     nature of Anti-Vir.Dat files will be explained more fully at the end of
     this chapter.

     Although the ThunderBYTE utilities can work perfectly well without the
     Anti-Vir.Dat files it is highly recommended to have TbSetup generate
     these files. The Anti-Vir.Dat files can be used for several purposes:

     Integrity checking. TbScan and the memory resident TbCheck program will
     perform an integrity check while scanning if it can detect the Anti-
     Vir.Dat file. If a file gets infected by a virus, the information in the
     Anti-Vir.Dat file will not match the actual file contents, and TbScan
     and TbCheck will inform you that the file has been changed.

     The TbSetup program recognizes some files that need special treatment.
     An example of such a file is a disk image file of a network remote boot
     disk. - Such a file that actually represents a complete disk - should be
     scanned completely, and for all viruses. TbSetup will put a mark in the
     Anti-Vir.Dat file to make sure that TbScan scans the complete file for
     all viruses.

     Once a file is infected, TbClean will reconstruct the original file. The
     information in the Anti-Vir.Dat file will be of great help to TbClean.
     Some infected programs can only be cured if there is information about
     the program in the Anti-Vir.Dat file.

     TbCheck (a tiny resident integrity checker) has no purpose if there are
     no Anti-Vir.Dat files on your system.

     The resident TBAV utilities need the Anti-Vir.Dat files to maintain
     permission information. Without Anti-Vir.Dat files you can not get rid
     of false alarms other than by disabling a complete feature.


3.2. How to use TbSetup

     This is the one program where the rule applies: The less you use the
     program, the better your protection against viruses! Why? Keep in mind
     that an Anti-Vir.Dat file stores vital information needed to detect a
     virus, as well as data for subsequent recovery and for cleaning. But
     consider what would happen if you were to execute TbSetup after a virus
     entered the system: the information in the Anti-Vir.Dat file would be

                                       I - 8
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     'updated' to the state of the infected file, wiping out all traces of
     data needed to reconstruct the file of the original, uninfected state.
     Never use TbSetup when there is the slightest evidence of a virus in
     your system. Once the Anti-Vir.Dat files have been generated as part of
     the initial setup, any subsequent usage of TbSetup should be confined to
     directories with new or changed program files.

     Please note that the Anti-Vir.Dat directory entries will have the
     attribute 'hidden' and therefore do not show up when you use standard
     directory commands. You can see the filenames only with the help of
     special utilities.

     You may load TbSetup either from the DOS command line or from the TBAV
     menu. For the initial installation you can use option 'AllDrives':

          TbSetup AllDrives

     You may also specify which drives and paths should be processed. To
     setup disks C: and D: you should enter:

          TbSetup C:\ D:\

     When no filename has been specified but a drive and/or path instead, the
     specified path will be used as top-level path. All its sub-directories
     will be processed too. When a filename has been specified only the
     specified path will be processed. Sub-directories will not be processed.


     Wildcards in the filename are allowed.

     When executed from the DOS command line, the 'newonly' option can be
     used to prevent existing information from being overwritten.
     To help you remember that TbSetup needs to be executed again, the next
     time you execute TbScan it will display either a small 'c' after the
     file to indicate a new file or a capital 'C' if a file has simply been
     changed.

     Example:
     You add a new file TEST.EXE to your directory C:\FOO.

          TbSetup C:\FOO\TEST.EXE


     Example:
     You install a new product in a new directory C:\NEW.

          TbSetup C:\NEW


     When using the DOS command you may append a number of loading options.
     These options are presented in section 3.3. of this chapter.


                                       I - 9
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     The 'TbSetup' menu


     +----Main menu-----+
     |  Confi+------TbSetup menu------+
     |  TbSet|  Start TbSetup         |
     |  TbSca|  Options menu         >|
     |  TbUti|  Flags menu           >|
     |  TbCLe|  Data file path/name   |
     |  TBAV |  View data file        |
     |  Docum+------------------------+
     |  Register TBAV   |
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     Data file path/name

     TbSetup will search for 'special' files in a file named TbSetup.Dat.
     After selecting this option 'datfile' you can specify another path or
     filename that contains a list of 'special' files. Option format: Datfile
     [=<filename>]

     Example:
          TbSetup Datfile = c:\tbav\tbsetup.dat


     +----Main menu-----+
     |  Confi+------TbSetup menu------+
     |  TbSet|  Start+-------TbSetup options--------------+
     |  TbSca|  Optio|  Use TBAV.INI file                 |
     |  TbUti|  Flags|  Prompt for pause                  |
     |  TbCLe|  Data |  Only new files                    |
     |  TBAV |  View |  Remove Anti-Vir.Dat files         |
     |  Docum+-------|  Test mode (don't change anything) |
     |  Register TBAV|v Hide Anti-Vir.Dat files           |
     |  Quit and save|  Make executables readonly         |
     |  eXit (no save|  Clear readonly attributes         |
     +---------------|v Sub-Directory scan                |
                     +------------------------------------+


     Use TBAV.INI file

     By enabling this option, the TbSetup configuration values, saved in the
     TBAV.INI file, will also be valid when loading TbSetup from the command
     line. Be careful, since options specified in the TBAV.INI file can not
     be undone on the command line. See chapter I-2 ('Configuration').




                                      I - 10
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     Prompt for pause

     When you enter option 'pause' TbSetup will stop after it has processed
     the contents of one window. This gives you the possibility to examine
     the results.


     Only new files

     If you want to add new files to the Anti-Vir.Dat database, but prevent
     the information of changed files from being updated use option 'newon-
     ly'. Updating the information of changed files is dangerous because if
     the files are infected, the information to detect and cure the virus
     will be overwritten. Option 'newonly' prevents the information from
     being overwritten but it still allows information of new files to be
     added to the database.


     Remove Anti-Vir.Dat files

     If you want to stop using the ThunderBYTE utilities you do not have to
     remove all the Anti-Vir.Dat files yourself. By using this option TbSetup
     will neatly remove all Anti-Vir.Dat files from your system.


     Test mode (Don't change anything)

     If you want to see the effect of an option without the risk that somet-
     hing is activated you do not want, use option 'test'. If that option is
     specified the program will behave as it would normally, but it will not
     change or update anything on your hard disk.


     Hide Anti-Vir.Dat files

     The Anti-Vir.Dat files are normally not visual in a directory listing.
     If you prefer to have normal - i.e. visible - files disable this option.
=>   Note that this option only applies for new Anti-Vir.Dat files.


     Make executables read-only

     As TbFile guards the read-only attribute permanently it is highly
     recommended to make all executable files read-only to prevent any
     modifications on these files. TbSetup will do the job if you enable
     option 'read-only'. Files that should not be made read-only are recogni-
     zed by TbSetup.






                                      I - 11
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     Clear read-only attributes

     This option can be used to reverse the operation of option 'read-only'.
     If you enable this option all read-only attributes of all executable
     files will be cleared.


     Sub-Directory scan

     By default TbSetup will search sub-directories for executable files,
     unless a filename (wildcards allowed!) has been specified. If you
     disable this option, TbSetup will not process sub-directories.


     +----Main menu-----+
     |  Confi+-----TbSetup menu------+
     |  TbSet|  Start+-----TbSetup flags------+
     |  TbSca|  Optio|v Use normal flags      |
     |  TbUti|  Flags|  Set flags manually    |
     |  TbCLe|  Data |  Reset flags manually  |
     |  TBAV |  View |  Define flags         >|
     |  Docum+-------+------------------------+
     |  Register TBAV   |
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     Set flags manually

     This option is for advanced users only. With this option you can manual-
     ly set permission flags in the Anti-Vir.Dat record. This option requires
     a hexadecimal bitmask for the flags to set. For information about the
     bitmask consult the TbSetup.Dat file.

     Option format: Set =<flags>

     Example:
          Set = 0001


     Reset flags manually

     This option is for advanced users only. With this option you can manual-
     ly reset permission flags or prevent flags to be set in the Anti-Vir.Dat
     record. This option requires a hexadecimal bitmask for the flags to
     reset.  For information about the bit mask consult the TbSetup.Dat file.
     Option format: Reset =<flags>

     Example:
          Reset = 0001


                                      I - 12
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     +----Main menu-----+
     |  Confi+-----TbSetup menu------+
     |  TbSet|  Start+-----TbSetup flags------+
     |  TbSca|  Optio|v Use n+--Define flags to be changed--+
     |  TbUti|  Flags|  Set f|  0001: Heuristic analysis    |
     |  TbCLe|  Data |  Reset|  0002: Checksum changes      |
     |  TBAV |  View |  Defin|  0004: Disk image File       |
     |  Docum+-------+-------|  0008: Readonly sensitive    |
     |  Register TBAV   |    |  0010: TSR program           |
     |  Quit and save   |    |  0020: Direct disk access    |
     |  eXit (no save)  |    |  0040: Attribute modifier    |
     +------------------+    |  8000: Interrupt rehook      |
                             +------------------------------+

3.3. Command line options

     TbSetup allows options to be specified on the command line.  TbSetup
     recognizes option short-keys and option words. The words are easier to
     memorize, and they will be used in this manual for convenience. The
     syntax is as follows:

          TbSetup [<path>][<filename>]... [<options>]...


     option parameter      short  explanation
     ----------------------------------------------------------------
     help                  he   help
     pause                 pa   enable 'Pause' prompt
     mono                  mo   force monochrome
     nosub                 ns   skip sub-directories
     newonly               no   do not update changed records
     alldrives             ad   process all local fixed drives
     allnet                an   process all network drives
     remove                rm   remove Anti-Vir.Dat files
     test                  te   do not create / change anything
     nohidden              nh   do not make Anti-Vir.Dat files hidden
     readonly              ro   set read-only attribute on executables
     nordonly              nr   remove / do not set read-only attribute
     set     =<flags>      se   set flags
     reset   =<flags>      re   reset flags / do not set flags
     datfile [=<filename>] df   data file to be used


     help (he)
     If you specify this option, TbSetup displays the contents of the TBSE-
     TUP.HLP file (if available) in the home directory of TbSetup.  If you
     specify the '?' option you will get the summarized help info as listed
     above.





                                      I - 13
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     pause (pa)
     When you specify 'pause' TbSetup will stop after it has processed the
     contents of one window. This gives you the possibility to examine the
     results.

     mono (mo)
     This option forces TbSetup to refrain from using colors in the screen
     output. This might enhance the screen output on some LCD screens or
     color-emulating monochrome systems.

     nosub (ns)
     By default TbSetup will search sub-directories for executable files,
     unless a filename (wildcards allowed!) has been specified. If you
     specify this option, TbSetup will not process sub-directories.

     newonly (no)
     If you want to add new files to the Anti-Vir.Dat database, but prevent
     the information of changed files from being updated, use option 'newon-
     ly'. Updating the information of changed files is dangerous because if
     the files are infected, the information to detect and cure the virus
     will be overwritten. Option 'newonly' prevents the information from
     being overwritten but it still allows information of new files to be
     added to the database.

     alldrives (ad)
     If you want TbSetup to process all local non-removable drives you can
     specify this option. Except for the initial execution, it isn't a good
     idea to use this option.

     allnet (an)
     If you want TbSetup to process all network drives you can specify this
     option. Except for the initial execution, it isn't a good idea to use
     this option.

     remove (rm)
     If you want to stop using the ThunderBYTE utilities you do not have to
     remove all the Anti-Vir.Dat files yourself. By using this option TbSetup
     will neatly remove all Anti-Vir.Dat files from your system.

     test (te)
     If you want to see the effect of an option without the risk that somet-
     hing is activated you do not want, use option 'test'. If that option is
     specified the program will behave as it would normally, but it will not
     change or update anything on your
     hard disk.

     nohidden (nh)
     The Anti-Vir.Dat files are normally not visual in a directory listing.
     If you prefer to have normal - i.e. visible - files specify this option.
=>   Note that this option only applies for new Anti-Vir.Dat files.

     readonly (ro)

                                      I - 14
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     As TbFile guards the read-only attribute permanently it is highly
     recommended to make all executable files read-only to prevent any
     modifications on these files. TbSetup will do the job if you enable
     option 'read-only'. Files that should not be made read-only are recogni-
     zed by TbSetup.

     nordonly (nr)
     This option can be used to reverse the operation of option 'read-only'.
     If you enable this option all read-only attributes of all executable
     files will be cleared.

     set (se)
     This option is for advanced users only. With this option you can manual-
     ly set permission flags in the Anti-Vir.Dat record. This option requires
     a hexadecimal bitmask for the flags to set. For information about the
     bitmask consult the TbSetup.Dat file.
     Option format: Set =<flags>

     Example:
          Set = 0001

     reset (re)
     This option is for advanced users only. With this option you can manual-
     ly reset permission flags or prevent flags to be set in the Anti-Vir.Dat
     record. This option requires a hexadecimal bitmask for the flags to
     reset.  For information about the bit mask consult the TbSetup.Dat file.
     Option format: Reset =<flags>

     Example:
          Reset = 0001

     datfile (df)
     After the datfile option you can specify the name of the data file to be
     used.


3.4. While executing

     TbSetup divides the screen into three windows: an information window
     displaying data file comments across the top of the screen, a scanning
     window on the left and a status window on the right.

     The lower left window lists the names of the files being processed,
     along with file specific information:


     TEST.EXE 01234  12AB23CD   Added    * 0001
     |        |      |          |        | |
     |        |      |          |        | |
     |        |      |          |        | 'flags' set for this file
     |        |      |          |        indicates 'special' file
     |        |      |          action performed

                                      I - 15
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     |        |      32-bit CRC (checksum)
     |        file size in hexadecimal number
     name of file in process


     Do not be concerned if the information flies too fast for you to read,
     or if it puzzles you. You will probably never need these details anyway.

     The scanning window has an 'action performed' field indicating whether
     an entry in the Anti-Vir.Dat was added, changed or updated:

     Added
     There was no previous entry for this file in the Anti-Vir.Dat record. A
     new entry has been added.

     Changed
     There was an existing entry, but the file has been changed. The Anti-
     Vir.Dat information has been updated.

     Updated
     There was an Anti-Vir.Dat record and the file was found to be unchanged.
     TbSetup did, however, change some of the program's permission flags, on
     account of an entry in the TbSetup.Dat file, or in compliance with a
     'Set' or 'Reset' option.

     The process may be aborted by pressing Ctrl-Break.


     Purpose of the TbSetup.Dat file

     Although the ThunderBYTE utilities perform well on almost every file
     without extra help, there are some files that need particular attention.
     TbSetup uses information collected in a special data file, TbSetup.Dat,
     to flag such files in the Anti-Vir.Dat file. The other ThunderBYTE
     utilities then use that information to determine how such a 'special'
     file should be treated:


     Examples of such files:

     Some programs maintain configuration information inside the executable
     file (EXE, COM) itself. Whenever you change the configuration of these
     programs, the executable file will change as well, along with its
     checksum. The new checksum will not match the one stored in the TbSe-
     tup.Dat file anymore. Since some ThunderBYTE utilities use this checksum
     information to verify integrity or cleanup results, they need to 'know'
     when a file's checksum is not a fixed item and should be allowed to
     change.

     TbScan can use generic detection methods such as 'heuristic' analysis to
     detect unknown viruses. Since heuristic analysis implies inevitable


                                      I - 16
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     false alarms when a file looks like a virus, TbScan may have to decide
     not to do a heuristic analysis on such a program.

     Some of the ThunderBYTE utilities guard the read-only attribute and make
     sure that it can be removed only with the user's explicitpermission. A
     few programs, however, refuse to run properly with the read-only attri-
     bute set.

     TbScan's default scanning method performs perfectly well with just about
     any file, but there are some that need special analysis. Such a file is
     the Novell NET$DOS.SYS file, not a device driver - as the filename
     extension suggests - but a disk image of the bootable disk. It should be
     scanned completely and for all signatures, including COM and BOOT.

     The resident monitoring utilities of the TBAV package detect all sorts
     of virus-specific behaviour. Some programs, even though they may act
     like a virus, are still perfectly normal and should be permitted to be
     executed without TBAV interference.

     You need not be concerned to find that a few files will be excluded from
     heuristic analysis. Those files will still be scanned the conventional
     way for signatures and all the rest. Furthermore, no heuristic exclusion
     will be granted unless a file matches exactly with the entry in the
     TbSetup.Dat file - including its name, size and the 32-bit CRC checksum.
     This eliminates security holes effectively: if a listed file is already
     infected, its checksum won't match the 32-bit CRC in the TbSetup.Dat
     file and the exclusion will not apply. By the same token, if a program
     is infected at a later date, the result would be a change in at least
     one of its characteristics; the record in the Anti-Vir.Dat file will not
     match any longer and the file will be subject to full heuristic analysis
     like any other.






















                                      I - 17
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


4. TbDriver

4.1. Purpose of TbDriver

     TbDriver does not provide much protection against viruses by itself, but
     must be loaded in advance to enable the memory resident ThunderBYTE
     Anti-Virus utilities, such as TbScanX, TbCheck, TbMem, TbFile and
     TbDisk, to perform properly. It is the source for some of the routines
     these utilities have in common, including support to generate the pop-up
     window routines, driving the translation unit which enables the possibi-
     lity of displaying messages in your native language, and support for
     networks.

     In addition, TbDriver also contains basic protection against 'Stealth'
     viruses and against ANSI bombs.


     How to use TbDriver

     Loading TbDriver must be loaded before (one of) the other memory TbDri-
     ver resident TBAV utilities. For loading instructions, please consult
     the following pages.

=>   If you want protection against ANSI-bombs, you should load TbDriver
     AFTER the ANSI driver.

     In normal situations it is not necessary to use the 'net' option of
     TbDriver.

     If you install TbDriver on a machine that is booted from a boot ROM,
     specify the message file with the drive and path where it can be found
     AFTER the machine has booted. The default message file will not be
     accessible anymore after the machine has booted.


4.2. Command line options

     Tbdriver allows loading options to be specified on the command line. A
     filename specification will be treated as a language file specification.
     The upper three options are always available, the other options are only
     available if TbDriver is not already memory resident.












                                      I - 18
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     option  parameter    short explanation
     -------------------- ----- ---------------------------

     help                 ?     display this helpscreen
     net                  n     force LAN support
     remove               r     remove TbDisk from memory
     mode    =<m|c>       m     override video mode

     freeze               j     freeze machine after an alert
     lcd                  l     enhance output on LCD screens
     noavok  =<drives>    o     assume permission when AV record is missing
     quiet                q     do not display activity
     secure               s     do not allow permission updates
     notunnel             t     do not detect tunneling
     nofilter             f     do not filter dangerous ANSI codes
     nostack              ns    do not install a stack


     help (?)
     If you specify this option TbDriver will show you the valid command line
     options as listed above.

     net (n)
     TbDriver cooperates well with most networks; in normal situations option
     'net' will not be needed at all. It should be used only if all of the
     following conditions are true: A connection to a Novell network is made,
     and TbDriver.Exe is started before the logon command was used, and there
     is no valid Anti-Vir.Dat record in the directory where the NET?.COM
     program resides, or after the NET?.COM file has been renamed.

     remove (r)
     This option disables TbDriver and will try to remove the resident part
     of its code from memory in an attempt to restore this memory space back
     to the system. Unfortunately, this can work only if TbDriver was loaded
     last. An attempt to remove a TSR after another TSR has been started will
     simply leave a useless gap in memory and could disrupt the interrupt
     chain. TbDriver checks whether it is safe to remove its resident code;
     if not, it will simply disable itself.

     mode (m)
     On dual video systems TbDriver will use the currently active screen. It
     may be forced to use the alternate screen with option 'mode=m' for
     monochrome, or 'mode=c' for color systems.

     freeze (j)
     This option causes TbDriver to freeze the machine after a TbDriver
     message has been displayed. This prevents users to answer TbDriver
     messages without permission from the supervisor.

     lcd (l)
     This option improves the readability of the TbDriver messages on LCD
     screens.

                                      I - 19
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I



     noavok (o)
     This option is not recommended for normal usage. You may need it in
     order to grant permission automatically for programs without an Anti-
     Vir.Dat record. Option 'noavok' requires a parameter specifying the
     drives to which the default permission applies. If, for example, you do
     not want a message from TbMem when a TSR without Anti-Vir.Dat record is
     executed from drive E: and F:, you could specify 'noavok=ef' on the
     TbDriver command line. If you do want to exclude network drives you
     should specify an asterisk (*). So, if you want to grant permission for
     all files without Anti-Vir.Dat records on drive A:, your ramdisk F: and
     your remote network drives, specify 'noavok=af*'.

     quiet (q)
     Some resident TBAV utilities display an activity status. TbScanX, for
     instance, displays a rectangle with "*Scanning*" in the upper left
     corner of your screen while scanning a file. You can disable this with
     the 'quiet' option when TbDriver is loaded.

     secure (s)
     Some ThunderBYTE utilities are able to store permission flags in the
     Anti-Vir.Dat files. If you don't want these flags to be changed, specify
     this option. It has no effect on flags that are already set, so the
     option 'secure' may be used after installing new programs or packages.

     notunnel (t)
     TbDriver normally detects tunneling attempts on the part of viruses.
     'Tunneling' is a technique viruses apply to determine the location of
     the DOS system code in memory, and to use that address to communicate
     with DOS directly. This will inactivate all TSR programs, including
     resident anti-virus software. TbDriver is able to detect 'tunneling'
     attempts, and informs you about this. Some other anti-virus products
     also rely on tunneling techniques to bypass resident viruses, causing
     false alarms. If you are currently executing other anti-viral products,
     option 'notunnel' will disable tunneling detection.

     nofilter (f)
     The original ANSI driver has a feature to assign text strings to keys.
     Years ago, people used this feature to assign - for instance - the F10
     key to the text 'DIR /W'. This reprogramming can simply be done with
     embedded ANSI codes in text files. Typing such a file with the DOS
     'type' command is enough to reprogram the keys. Today, almost nobody
     uses this feature anymore, but it is still there. Some ill-minded people
     however use this feature to make a text file which reprograms - for
     instance - the Enter key to execute the text 'Del *.*', or worse...
     Such a text file is called an ANSI-bomb. TbDriver protects you against
     ANSI-bombs by filtering out the keyboard reprogramming codes. All other
     ANSI codes will pass without interference. If you don't want this
     protection, or if you want to use this obsolete ANSI feature you can
     specify option 'nofilter'.



                                      I - 20
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


     nostack (ns)
     By default, TbDriver maintains a stack for the resident TBAV utilities.
     For most systems however this isn't necessary. If you specify option
     'nostack' TbDriver will use the application stack, saving a few hundred
     bytes of memory. However, if the system hangs or becomes unstable, you
     should discontinue use of this option.


4.3. Language support

     The optional filename specification is used to determine where the
     language file can be found. TbDriver retrieves pop-up window messages
     from a TBDRIVER.LNG file, which it expects to find in its own home
     directory. The default English language file is TBDRIVER.LNG, which may
     be replaced by a file in your local language. You can order separate
     language support packages at your local ThunderBYTE dealer, or download
     the language file from a ThunderBYTE support BBS. Please refer to page
     I-38 for further details. To load a localized language file, either
     rename it to the default original, or specify the full path and filename
     following the command. You may also switch to another language by
     calling TbDriver again with a different message file. This will not take
     up any extra memory.































                                      I - 21
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


5. System maintenance

     All systems need maintenance and so do the TBAV utilities. As new
     viruses emerge, TbScan's signature file must be updated to avert new
     dangers. You may either get the latest signature file from your local
     ThunderBYTE dealer or download the file from one of our support Bulletin
     Board Systems.

     Whenever you add, update or replace programs on your system, be sure to
     use TbSetup to generate or update their fingerprints in the Anti-Vir.Dat
     files. Sometimes you will want to create a new recovery diskette. When
     you install a new version of DOS, the bootsector will be different.
     Changing the configuration of your hard disks may affect the partition
     tables and the CMOS setup. You should prepare a new recovery diskette
     after all system modifications.


     Updates

     The ThunderBYTE Anti-Virus utilities are updated at frequent intervals.
     Subscription to the ThunderBYTE update service (at your local dealer)
     guarantees delivery of each new update. You may download new revisions
     any time from any ThunderBYTE support BBS. Or check with a local bulle-
     tin board regularly, as many of them offer updated versions of our
     software.

     The standard complete release is issued in an archive named:
     TBAVxxx.ZIP, where 'xxx' stands for the three-digit version number. The
     archive extension may vary on local bulletin boards using a different
     archive method.

     TBAV-for-Windows is distributed in an archive named TBAVWxxx.Zip. Note
     that you need to download the DOS version of TBAV in addition to this
     archive.

     The resident ThunderBYTE Anti-Virus utilities are also available in
     processor optimized formats. These processor optimized versions, named
     TBAVXxxx.ZIP, are for registered users only. You can purchase these
     versions via your local ThunderBYTE dealer.


     Language support

     The ThunderBYTE Anti-Virus utilities currently support several langua-
     ges, by means of separate language files. Check your local ThunderBYTE
     dealer for the availability of the TBAV support file in your language.







                                      I - 22
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


6. Network maintenance

     The signature file TbScan.Sig should be replaced frequently. This can be
     a lot of work if you want to update all work stations on a network
     manually. Fortunately, there are several possibilities to do this job
     automatically.


6.1. Using DOS REPLACE

     Maintain a directory \TBAV_UPD\ on a public server drive. Any new
     version of the TBAV utilities or any new signature file TbScan.Sig
     should be placed it in this directory.

     The work stations should execute a batch file automatically after users
     log in on the network. This batch file should contain the following
     lines:

          rem Update the anti-virus product if a new one is available.
          replace x:\tbav_upd\*.* c:\tbav /u /r

     'Replace' is a standard DOS utility. It copies the files specified by
     the first parameter ONLY if they are newer than the files specified in
     the second parameter.

     Make sure the 'replace' command is in the current path, and that the
     specified paths are valid for your configuration. The 'x', used in the
     above example, denotes the drive specification.

     Thus, you only have to update one drive with the new signature file or
     anti-virus software, and all workstations will update themselves as soon
     as they log in! You can also add the /S option if you want REPLACE to
     scan all directories on the workstations' drives for matching files.
     Please consult the DOS manual for more details.

=>   Note: Do not forget to execute TbSetup on the new utilities in the
     x:\tbav_upd directory, thus ensuring that the REPLACE command also
     copies the new Anti-Vir.Dat file.


6.2. Using PkUnZip

     Maintain a directory \TBAV_UPD\ on a public server drive. Any new
     version of the TBAV distribution archive should be placed in this
     directory.

     The work stations should execute a batch file automatically after users
     log in on the network. This batch file should contain the following
     lines:

          rem Update the anti-virus product if a new one is available.
          PkUnZip -n -o x:\tbav_upd\TBAV???.ZIP c:\tbav

                                      I - 23
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                 SECTION I


=>   Make sure the file PkUnZip.Exe is in the current path, and that the
     paths specified are valid for your configuration.

     Following this procedure, the 'PkUnZip' command will only come into
     action when you just updated the ZIP files in the x:\tbav_upd directory.
     Now you only have to update one drive with the new anti-virus software,
     and all workstations will update themselves as soon as they log in!














































                                      I - 24
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


SECTION II. ANTI-VIRUS STRATEGY

1. Protection against viruses

1.1. Introduction

     Maintaining a reliable safety system implies that you will be active in
     taking measures to protect your system from virus infection, since some
     viruses can hide themselves perfectly once resident in memory. At least
     once every a week you should boot from a clean and write-protected
     diskette and execute TbScan.

     The tightness of your safety system very much depends on the amount of
     time you want to invest to let the safety measures take place and the
     vitality of the appropriate computer system. For use on a stand alone
     computer containing low risk data, in an environment with little exchan-
     ge of computer software, a daily scan will appear to be sufficient.

     For company use however, in a network environment where diskettes are
     exchanged frequently, where disks contain highly vulnerable information,
     where a network going 'down' means the loss of an extensive amount of
     money, protection must be as tight as the organisation can practically
     handle.

     Considering the above, a simple instruction on how to use the -highly
     flexible - TBAV utilities cannot be given. It all depends on your own
     demands and possibilities.

     Therefore, you are advised to study this manual thoroughly so you will
     be able to determine your own safety measures. To prevent viruses from
     doing any harm you should at least under-take the activities as presen-
     ted below.


1.2. Basic precautions

     1. Install TBAV on your hard disk

     You may customize the installation to suit your own needs. Make sure you
     use TbSetup to maintain recovery information of all executable files of
     your system! Please refer to the installation section (I) of this
     manual.

     In the following examples it is assumed that all utilities are copied in
     the (default) directory named TBAV. For all example setups it is requi-
     red that TbSetup has been executed. If your system has more hard disks
     or disk partitions you should repeat the TbSetup invocation for every
     drive or partition.

     The example setups assume you have created a recovery diskette.



                                      II - 1
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     The example setups outlined below are just intended to give you some
     ideas about the use of the TBAV utilities, and these examples are not
     intended as a full featured protection setup!


     2. Prepare a recovery diskette

     You will absolutely need a clean recovery diskette in order to be able
     to get rid of a virus at all later on. Take a few minutes to prepare one
     now well ahead of a possible future contamination when it would be too
     late.

     Take a new, empty diskette, put it in drive A:, go to your DOS directory
     and execute the following commands:

          Format A: /S
          Copy SYS.COM A:

     Now return to the TBAV directory, eg.:

          CD \TBAV

     Execute the MakeResc batch file:

          makeresc A:

     The MakeResc batch file will create a reliable recovery diskette by
     creating or copying the following files.

     -    A backup of the bootsector, partition sector and CMOS configu-
          ration.

     -    A Config.Sys file, containing:

          Files=20
          Buffers=20
          Device=TbDriver.Exe
          Device=TbCheck.Exe FullCRC

     -    An Autoexec.Bat file, containing:

          @echo off
          echo off
          PATH=A:\
          TBAV
          Cls
          Echo Warning!!!
          Echo If you suspect a virus, do NOT execute anything
          Echo from the hard disk!




                                      II - 2
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     -    The following files:

          TBAV.EXE
          TBAV.LNG
          TBSCAN.EXE
          TBSCAN.LNG
          TBSCAN.SIG
          TBDRIVER.EXE
          TBDRIVER.LNG
          TBCHECK.EXE
          TBCLEAN.EX
          TBUTIL.EXE
          TBUTIL.LNG

     Copy to the diskette any other utilities that could come in handy in an
     emergency situation, including a simple editor to edit Config.Sys and
     AutoExec.Bat files. If your hard disk needs special device drivers to
     unlock added features, such as DoubleSpace or Stacker, copy the approp-
     riate drivers to the recovery diskette and install them in the Con-
     fig.Sys file on drive A:, taking care to avoid statements that will
     access the hard disk. Be sure to check the instructions in the device
     driver's manual for the correct procedures.

     Make the disk write protected. Label the diskette 'Recovery' together
     with a short of the PC the diskette belongs to. Store the diskette in a
     safe place. Use it only in case of an emergency, so make a copy if you
     need a similar diskette for general purposes.


     3. Keep shady software out

     Many companies do not allow employees to install or execute unauthorized
     software. Or perhaps you wish to keep family members from invading your
     computer with haphazard games and sundry software. TBAV provides a
     watchdog function that can help to enforce this. First you will need to
     add the following lines to the Config.Sys file:

          Device=C:\TBAV\TbDriver.Exe
          Device=C:\TBAV\TbCheck.Exe secure

     If you have installed the TBAV Utilities using the TBAV installation
     program, you can - instead of editing the CONFIG.SYS file - adjust the
     TBSTART.BAT file, appending the 'secure' option to the TbCheck command:

          C:\TBAV\TbDriver
          C:\TBAV\TbCheck secure

     Execute TbSetup on the system:

          TbSetup C:\



                                      II - 3
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     Reboot the system by pressing <Ctrl>-<Alt>-<Del>. From now on, TbCheck
     will put an effective clamp on any user who tries to execute software
     which has not been duly authorized first by TbSetup. Whenever someone is
     trying to execute an unknown program, TBAV will display the following
     message:


     +---------- TBAV interception ---------+
     |                WARNING!              |
     | The requested program (GAME.EXE)     |
     | is not authorized and can not be     |
     | executed.                            |
     | Execution cancelled! Press any key...|
     +--------------------------------------+


     4. Restrict user access

     Most of the TBAV utilities are interactive. They need to communicate
     with a knowledgable user in order to establish appropriate action in
     ambiguous situations. Many companies, however, insist that the system
     operator be the sole authority allowed to communicate with TBAV and so
     avoid wrong decisions on the part of possibly inept employees. That is
     why most of TBAV utilities support the option 'secure'. When this option
     is specified, all user interaction with any of the TBAV utilities is
     suspended. In other words, users will never be queried for permission to
     allow questionable operations, avoiding erroneous decisions which may
     well result in irreparable havoc. This option will also prevent the user
     from disabling or unloading the TBAV utilities.


     5. Never use 'strange' diskettes to boot

     Only boot from your hard disk or from your original DOS diskette. NEVER
     use someone else's disk to boot from. Should you have a hard disk, make
     certain that you have opened the door to your floppy drive before
     resetting or booting your PC.


     6. Use ChkDsk frequently

     Use the DOS program ChkDsk frequently (without the /F switch). ChkDsk is
     able to detect some viruses, because such viruses change the disk
     structure in an incorrect manner, causing disk errors in the process.
     Look out for changes in the behaviour of your software or your PC. Any
     change in their behaviour is suspect, unless you know its cause. Some
     highly suspicious symptoms are:

     -    The amount of available memory space has decreased.

     -    Programs need more time to execute.


                                      II - 4
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     -    Programs do not operate as they used to, or cause the system to
          crash or reboot after some time.

     -    Data disappears or gets damaged.

     -    The size of one or more programs has increased.

     -    The screen behaves strangely, or unusual information is displayed.

     -    ChkDsk detects many errors.











































                                      II - 5
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


2. What to do when a virus strikes


2.1. Detection of viruses

     The first thing to do when you become aware that your system may have
     been infected is to back up all important files immediately. Use fresh
     backup media and do not overwrite a previous back up set. You may need
     the previous set to replace lost or contaminated files. Label the new
     backup as unreliable, as some of the files may be infected.

     As soon as you become aware of a virus infection it is imperative that
     you boot only from a reliable, write protected recovery system diskette.


     Know the symptoms

     Next, execute TbScan for an indication about what is wrong, or boot from
     a recovery diskette and compare its system files with those on the hard
     disk to check for changes. During this test you should take care to stay
     logged on to your system diskette.

     TbScan will report the virus name if the virus is known, or give a
     summary of file changes if the virus cannot be identified:

          TbScan alldrives logname=lpt1 log

     Also execute TbUtil to check the bootsector, partition code and the CMOS
     configuration.

          TbUtil compare

     Do not execute any program on your hard disk to prevent a virus from
     invading the system's memory and possibly masking the test results.
     TbCheck will warn you if you accidentially try to execute an infected or
     unauthorized program on your hard disk.

     Please bear in mind that it is in the nature of a file virus to infect
     as many programs as possible over a short period. You'll hardly find
     only a few infected programs on a hard disk that is in constant use. A
     TbScan virus alert flagging a mere one percent of the files on a hard-
     worked system is probably just a false alarm that has nothing to do with
     a real virus.

     If the file compare test indicates that all of them are still the same,
     you know at least that you are not dealing with a file virus.
     Avoid using the same copy of the TbScan program on another system after
     discovering a virus. TbScan performs a sanity check when it fires up.
     Unfortunately there is no way to make software 100% virus-resistant. A
     sanity check does not work if a 'stealth' type of virus is involved. A
     stealth virus can hide itself completely when a self-check is being
     performed. Do note that we are not dealing with a TbScan bug here. The

                                      II - 6
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     failure to detect stealth viruses is common to all software performing a
     sanity check. Therefore, we recommend to keep a clean version of TbScan
     on a write-protected diskette. Use this diskette to check other machines
     once you have found a virus in your own system.


     Identify the characteristics

     Viruses come in many different guises and have their own peculiarities.
     It is extremely important to know at the earliest possible stage which
     particular kind of virus you are dealing with. That will give you at
     least some indication of the nature and the amount of the damage it may
     have caused already. Some viruses infect only executable files that can
     easily be reinstalled or replaced from a clean source. Others swap some
     random bytes anywhere on the hard disk, which could affect data files as
     well, although the results may not be noticeable for some time. Then
     there are those that damage the hard disk partition table or file
     allocation table, while some of the even nastier ones, the multipartite
     viruses, operate in more than one area.

     Whatever you do, don't panic! An inexperienced user, reacting in confu-
     sion, can often create more havoc than the virus itself, such as eradi-
     cating important data in no time. While an instant reformat may get rid
     of the virus, it will definitely destroy all your recent work as well.

     Once isolated the virus, either contact your support BBS, consult
     literature on virus problems, or get in touch with a virus expert.


2.2. Recovering from viruses

     While recovering from a virus infection it is particularly important to
     boot only from a clean write-protected system diskette. That is the only
     way to keep a virus out of the system's memory. Never execute a program
     from the hard disk.

     Restore the master boot sector and the DOS system files on the hard
     disk, using the SYS command on the system diskette. If the bootsector or
     partition code contains a virus, you may also use TbUtil to get rid of
     it by restoring clean sectors:

          TbUtil restore

     Many modern hard disks, notably IDE or AT drives using advanced prefor-
     matting methods, are low-level formatted by the supplier, ready for
     partitioning and a DOS format. Do not try to low-level format these
     drives yourself. It is always better to back up the partition table with
     a utility such as TbUtil, which restores the partition table for you
     without reformatting.

     If the virus has been identified as a file virus, it will be safest to
     remove the infected files (by using TbDel) and to copy or reinstall all

                                      II - 7
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION II


     executables from a clean source. A virus cleaning utility, such as
     TbClean, won't always be able to fully restore the original program code
     and should be used only as a last resort, such as when you don't have a
     reliable backup. It may be necessary to replace data files as well if
     the virus is known to cause damage in that area.

     After reassuring yourself that the system is absolutely clean again, run
     a careful check on all diskettes and backups to remove every single
     trace of the virus. Keep in mind that it takes only one infected disket-
     te to cause the same trouble all over again.











































                                      II - 8
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


SECTION III. USING THE TBAV UTILITIES


1. TbScan

1.1. The Purpose of TbScan

     TbScan is a virus scanner: it has been specifically developed to detect
     viruses, Trojan Horses and other such threats to your valuable data.
     Most viruses consist of a unique sequence of instructions, called a
     signature. Hence through checking for the appearance of such signatures
     in a file we can find out whether or not a program has been infected.
     Scanning all program files for the signatures of all known viruses helps
     you to find out quickly whether or not your system has been infected
     and, if so, by which virus.


     Fast Scanning

     TbScan is the fastest scanner on the market today, therefore it invites
     users to invoke it from within their AUTOEXEC.BAT file every morning.

     TbScan checks itself on invocation. If it detects that it has been
     infected it aborts with an error. This minimizes the risk of transfer-
     ring a virus by the TbScan program itself and infecting your system.

     Heuristic Scanning

     TbScan can detect yet unknown viruses. The built-in disassembler is able
     to detect suspicious instruction sequences and abnormal program lay-
     outs. This feature is called 'heuristic scanning' and it is partially
     enabled by default. Heuristic scanning is performed on files and boots-
     ectors.

=>   Note that virus scanners can only tell you whether or not your system
     has been infected and if so, if any damage has already been done. By
     that time only a non-infected backup or a recovery program such as
     TbClean can properly counter a virus infection.


     Scan Scheduling

     Every PC owner should use a virus scanner frequently. At least one
     should do to avoid damage caused by a virus. It is highly recommended to
     devise your own schedule for a regular scan of your system. Creating a
     special TbScan boot diskette is also recommended in this respect.

     The following scan sessions (listed in order of preference) are recom-
     mended:

     Execute TbScan from a write-protected bootable diskette once a week.
     Boot from this diskette before invoking the scanner. Booting from a

                                      III - 1
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     diskette is the only way to make sure that no stealth virus will become
     resident in memory.

     Invoke a daily scan. You can invoke TbScan with the  'once' option from
     within the autoexec.bat file to perform the daily scan session automati-
     cally. It is not necessary to boot from the bootable TbScan diskette to
     perform the daily scan.

     Scan new diskettes.


1.2. How to use Tbscan

     For daily use you can activate TbScan by loading the program from the
     DOS commandline (eg. in the autoexec.bat file), or via the TBAV menu.
     For weekly use, when scanning from the TbScan diskette, you could use
     the DOS command. The TbScan DOS options are listed in section 1.3. of
     this chapter.


     The 'TbScan' menu

     +----Main menu-----+
     |  Confi+----TbScan menu-----+
     |  TbSet|  Start scanning   >|
     |  TbSca|  Options menu     >|
     |  TbUti|  Advanced options >|
     |  TbCle|  If virus found   >|
     |  TBAV |  Log file menu    >|
     |  Docum|  View log file     |
     |  Regis+--------------------+
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     View log file

     If one of the log file options is activated (see below) you can study
     the log file using this option.













                                      III - 2
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     The 'Path' menu

     +----Main menu-----+
     |  Confi+----TbScan menu-----+
     |  TbSet|  Start+---------Path menu----------+
     |  TbSca|  Optio|  Specified files/paths     |
     |  TbUti|  Advan|  Current directory         |
     |  TbCle|  If vi|  Diskette in drive A:      |
     |  TBAV |  Log f|  Diskette in drive B:      |
     |  Docum|  View |  All fixed Drives          |
     |  Regis+-------|  All fixed Local drives    |
     |  Quit and save|  All fixed Network drives  |
     |  eXit (no save+----------------------------+
     +------------------+


     This menu may look different depending on your use of .SCN (configurable
     scan) files. The lay-out above appears when you don't have any .SCN
     files at all.


     Specified files/paths

     This option will always present you with a prompt at which you can
     specify the drives, paths, or even files you want to scan. You can
     specify multiple path specifications separated by spaces. The field is
     initialized with the last path you scanned before you saved your confi-
     guration.


     Current directory

     Select this option if you want to scan the directory on your system from
     where you called the TBAV menu shell.


     Diskette in drive A: (or B:)

     If you want to scan multiple diskettes, you may wish to activate the
     'repeat' option of TbScan. See the 'TbScan options' menu for more
     information.


     All fixed drives

     This will cause all available drives (except the removable ones) to be
     scanned completely. Depending on the settings in the TBAV configuration
     menu you will be prompted to confirm the selected drives.


     All fixed Local drives


                                      III - 3
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     If you are connected to a network, you probably don't want to scan the
     entire network always. With this option you just scan the drives which
     reside in your machine. Depending on the settings in the TBAV configura-
     tion menu you will be prompted to confirm the selected drives.


     All fixed Network drives

     With this option you can scan all network drives. Depending on the
     settings in the TBAV configuration menu you will be prompted to confirm
     the selected drives.



     The 'TbScan options' menu

     +----Main menu-----+
     |  Confi+------TbScan menu------+
     |  TbSet|  Start+-----TbScan options------+
     |  TbSca|  Optio|  Use TBAV.INI file      |
     |  TbUti|  Advan|  Prompt for pause       |
     |  TbCLe|  If vi|  Quick scan             |
     |  TBAV |  Log f|  Non-executable scan    |
     |  Docum|  View |  Maximum Compatibility  |
     |  Regis+-------|v Bootsector scan        |
     |  Quit and save|v Memory scan            |
     |  eXit (no save|  HMA scan forced        |
     +---------------|v Upper memory scan      |
                     |v Windows-OS/2-virus scan|
                     |v Sub-Directory scan     |
                     |  Repeat scanning        |
                     |v Abort on Ctrl-Break    |
                     |v Fast scrolling         |
                     +-------------------------+


     Use TBAV.INI file

     TbScan searches for a file named TBAV.INI in the TbScan directory. By
     enabling this option, the TbScan configuration values, saved in the
     TBAV.INI file, will also be valid when loading TbScan from the command
     line. Be careful, since options specified in the TBAV.INI file can not
     be undone on the command line. See chapter I-2 ('Configuration').


     Prompt for pause

     When you activate the 'pause' option TbScan will stop after it has
     checked the contents of one window. This gives you the possibility to
     examine the results without having to consult a log file afterwards.



                                      III - 4
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Quick scan

     TbScan will use the Anti-Vir.Dat files to check for file changes since
     the last time. Only if a file has been changed (CRC change) or is not
     yet listed in Anti-Vir.Dat it will be scanned. Normally TbScan will
     always scan files.


     Non-executable scan

     With this option TbScan will scan non-executable files (files without
     extension COM, EXE, SYS or BIN) too. If TbScan finds out that such a
     file does not contain anything that can be executed by the processor the
     file will be 'skipped'. Otherwise the file will be searched for COM, EXE
     and SYS signatures. TbScan however will not perform heuristic analysis
     on non-executable files. Since viruses normally do not infect non-
     executable files it is not necessary to scan non-executable files too.
     We even recommend not to use this option unless you have a good reason
     to scan all files.

     Once again: a virus needs to be executed to perform what it is program-
     med to do, and since non-executable files will not be executed a virus
     in such a file can not do anything. For this reason viruses do not even
     try to infect such files. Some viruses however will write to non-execu-
     table files as a result of 'incorrect' programming. If so, these non-
     executable files will never harm other program or data files, but do
     contain corrupted data.


     Maximum compatibility

     If you select this option, TbScan attempts to be more compatible with
     your system. Use this option if the program does not behave as you would
     expect, or even halts the system. This option will slow down the scan-
     ning process. Therefore, it should only be used if necessary.
=>   Note that this option does not affect the results of a scan.


     Bootsector scan

     Enabling this option will force TbScan to scan the bootsector as well.


     Memory scan

     Enabling this option will force TbScan to scan the memory of the PC.







                                      III - 5
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     HMA scan forced

     TbScan detects the presence of an XMS-driver, and scans HMA automa-
     tically. If you have an HMA-driver which is not compatible with the XMS
     standard you can use the 'HMA' option to force TbScan to scan HMA.


     Upper memory scan

     By default TbScan identifies RAM beyond the DOS limit and scans that
     too. This means that video memory and the current EMS pages are scanned
     by default. You can use this option to enable the scanning of non-DOS
     memory.


     Windows-OS/2-virus scan

     TbScan also searches for Windows and OS/2 viruses. Although there exist
     only very few of these viruses, it takes TbScan relatively a lot of time
     to search for them. If you don't use Windows or OS/2 you can speed up
     TbScan by disabeling the detection of Windows and OS/2 virus detection.


     Subdirectory scan

     By default TbScan will search sub-directories for executable  files,
     unless a filename (wildcards allowed!) is specified. If you disable this
     option, TbScan will not scan sub-directories.


     Repeat scanning

     This option is very useful if you want to check a large amount of
     diskettes. TbScan does not return to DOS after checking a disk, but it
     prompts you to insert another disk in the drive.


     Abort on Ctrl-Break

     You can disable this option if you don't want to be able to abort TbScan
     with Ctrl-Break.


     Fast scrolling

     TbScan shows the processed file in a scrolling window. There are two
     methods of scrolling: fast scrolling where the files are displayed on
     top of the previous ones if the window becomes filled, and the conventi-
     onal slow method of scrolling where the files at the bottom 'push up'
     the previous ones. By default TbScan uses the faster but less attractive
     method of scrolling.


                                      III - 6
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     The 'TbScan advanced options' menu

     +----Main menu-----+
     |  Confi+------TbScan menu------+
     |  TbSet|  Start+------TbScan advanced options-----+
     |  TbSca|  Optio|  High heuristic sensitivity      |
     |  TbUti|  Advan|v Auto heuristic sensitivity      |
     |  TbCLe|  If vi|  Low heuristic sensitivity       |
     |  TBAV |  Log f|  Extract signatures              |
     |  Docum|  View |  Configure executable extensions |
     |  Regis+-------+----------------------------------+
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     High heuristic sensitivity

     TbScan always performs a heuristic scan on the files being processed.
     However, only if a file is very probably infected with a virus, TbScan
     will report the file as being infected. If you use option 'heuristic',
     TbScan is somewhat more sensitive. In this mode 90% of the new, unknown,
     viruses will be detected without any signature, but some false alarms
     may occur. Consult also section 'Heuristic scanning' of this chapter
     (3.1).


     Auto heuristic sensitivity

     TbScan automatically adjusts the heuristic detection level after a virus
     has been found. This provides you maximum detection capabilities in case
     you need it, while the amount of false alarms due to heuristics remains
     small in normal situations. In other words: as soon as a virus has been
     found, TbScan will anticipate and proceed as if 'high heuristic sensiti-
     vity' has been selected.


     Low heuristic sensitivity

     In this mode TbScan will almost never issue a false alarm. However still
     about 50% of the new unknown viruses will be detected.


     Extract signatures

     This option is available to registered users only. See the chapter
     'TbGensig' (IV-5) on how to use the option 'extract'.


     Configure executable extensions



                                      III - 7
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     By default, TbScan only scans file with a filename extension which
     indicates that the file is a program file. Viruses which do not infect
     executable code simply do not exist. Files with the extension EXE, COM,
     BIN, SYS, OV? are considered to be executable.

     However, there are some additional files which have an internal layout
     that makes them suitable for infection by viruses. Although it is not
     likely that you will ever execute most of these files, you may want to
     scan them anyway.

     Some filename extensions that may indicate an executable format are:
     .DLL.SCR.MOD.CPL.00?.APP
     The first four extensions indicate Windows executable files. They
     normally display "This program requires Microsoft Windows" when you try
     to execute them, so you probably won't run these files often under DOS.
     Even when they are infected by a DOS virus they are not likely a threat
     since you don't execute them. Therefore TbScan does not scan them by
     default. To make TbScan scan these files by default, select this option
     and fill out the extensions you want to have scanned. The question mark
     as wildcard is allowed.

     Warning! Be careful about which extensions you specify: scanning a non-
     executable file causes unpredicatble results, and may result in false
     alarms.


     The 'If virus found' menu

     In this menu, you can configure the actions TbScan should take, if
     detecting a virus.


     +----Main menu-----+
     |  Confi+------TbScan menu------+
     |  TbSet|  Start+--What if a virus is found?--+
     |  TbSca|  Optio|v Present action menu        |
     |  TbUti|  Advan|  Just continue (log only)   |
     |  TbCLe|  If vi|  Delete infected file       |
     |  TBAV |  Log f|  Kill infected file         |
     |  Docum|  View |  Rename infected file       |
     |  Regis+-------+-----------------------------+
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     Present action menu

     If TbScan detects a virus, the program will display a menu containing
     the possible actions to be taken: just continu, delete or rename the
     infected file.


                                      III - 8
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Just continue (log only)

     If TbScan detects an infected file it prompts the user to delete or
     rename the infected file, or to continue without action. If you select
     this option, TbScan will always continue. We highly recommend you to use
     a log file in such situations, as a scanning operation does not make
     much sense without the return messages being read (see 'Command line
     options').


     Delete infected file

     If TbScan detects a virus in a file it prompts the user to delete or
     rename the infected file, or to continue without action. If you specify
     the 'delete' option, TbScan will delete the infected file automatically,
     without prompting the user first. Use this option if you have determined
     it is a virus infection. Make sure that you have a clean back-up, and
     that you really want to get rid of all infected files at once.


     Kill infected file

     This option is nearly the same as the 'delete' option. However, with the
     DOS 'undelete' program you can recover a deleted file, but if a file has
     been deleted with the 'kill' option, recovery is not possible anymore.


     Rename infected file

     If TbScan detects a file virus it prompts the user to delete or rename
     the infected file, or to continue without action. If you select the
     'rename' option, TbScan will rename the infected file automatically,
     without prompting the user first. By default, the first character of the
     file extension will be replaced by the character 'V'. An .EXE file will
     be renamed to .VXE, and a .COM file to .VOM. This prevents the infected
     programs from being executed, spreading the infection. At the same time
     they can be kept for later examination and repair.
















                                      III - 9
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     The 'TbScan LOG' menu

     +----Main menu-----+
     |  Confi+------TbScan menu------+
     |  TbSet|  Start+-------TbScan LOG menu-------+
     |  TbSca|  Optio|  Log file path/name         |
     |  TbUti|  Advan|  Output to log file         |
     |  TbCLe|  If vi|  Specify log-level         >|
     |  TBAV |  Log f|  Append to existing log     |
     |  Docum|  View |  No heuristic descriptions  |
     |  Regis+-------+-----------------------------+
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     Log file path/name

     With option logname you can specify the name of the log file to be used.
     TbScan will create the file in the current directory unless you specify
     a path and filename after selecting this option. If the log file already
     exists, it will be overwritten. If you want to print the results, you
     can specify a printer device name rather than a filename (logname=lpt1).
=>   Note: you have to combine this option with option 'log'.


     Output to logfile

     When you use this option, TbScan creates a log file. The log file lists
     all infected program files, specifying heuristic flags (see: appendix B)
     and complete pathnames.


     Append to existing log

     If you use this option, TbScan will not overwrite an existing log file
     but append the new information to it. If you use this option often, it
     is recommended to delete or truncate the log file once in a while to
     avoid unlimited growth.
=>   Note: you have to combine this option with option 'log'.


     No heuristic descriptions

     If you enable this option TbScan will not specify the descrip-tions of
     the heuristic flags in the log file. The heuristic flag descriptions are
     listed in appendix B.






                                     III - 10
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     The 'LOG level' menu

     +----Main menu-----+
     |  Confi+------TbScan menu------+
     |  TbSet|  Start+-------TbScan LOG menu-------+
     |  TbSca|  Optio|  Log f+--------Log-level menu--------+
     |  TbUti|  Advan|  Outpu|  0: Log only infected files  |
     |  TbCLe|  If vi|  Speci|v 1: Log summary too          |
     |  TBAV |  Log f|  Appen|  2: Log suspected too        |
     |  Docum|  View |  No he|  3: Log all warnings too     |
     |  Regis+-------+-------|  4: Log clean files too      |
     |  Quit and save   |    +------------------------------+
     |  eXit (no save)  |
     +------------------+


     Loglevel

     These levels determine what kind of file information will be stored in
     the log file. The default log level is 1. You may select one of five log
     levels:

     0    Log only infected files. If there are no infected files do not
          create or change the log file.

     1    Log summary too. Put a summary and timestamp in the log file. Put
          only infected files in the log file.

     2    Log suspected too. Same as loglevel=1, but now also 'suspected'
          files are logged. Suspected files are files that would trigger the
          heuristic alarm if option 'heuristic' had been specified.

     3    Log all warnings too. Same as loglevel=2, but all files that have a
          warning character printed behind the filename will be logged too.

     4    Log clean files too. All files being processed will be put into the
          log file.


1.3. Command line options

     When loaded from the DOS command line, Tbscan recognizes option short-
     keys and option words. The words are easier to memorize, and they will
     be used in this manual for convenience. TbScan searches for a file named
     TBAV.INI in the TbScan directory.

     If the keyword 'UseIni' is specified in the [TbScan] section of the
     TBAV.INI file, the options will also be valid when TbScan is invoked
     from the command line. Be careful, as options specified in the TBAV.INI
     file can not be undone on the command line.



                                     III - 11
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     option parameter        short  explanation
     -----------------------------------------------------------------
     help                    he     help
     pause                   pa     enable 'Pause' prompt
     mono                    mo     force monochrome
     quick                   qs     quick scan (uses Anti-Vir.Dat)
     allfiles                af     scan non-executable files too
     alldrives               ad     scan all local non-removable drives
     allnet                  an     scan all network drives
     heuristic               hr     enable heuristic alerts
     extract                 ex     extract signature (registered only)
     once                    oo     only once a day
     slowscroll              ss     enable conventional (slow) scrolling
     secure                  se     user abort not allowed (reg. only)
     compat                  co     maximum-compatibility mode
     ignofile                in     ignore no-file-error
     old                     ol     disable "this program is old" message
     noboot                  nb     skip bootsector check
     nomem                   nm     skip memory check
     hma                     hm     force HMA scan
     nohmem                  nh     skip UMB/HMA scan
     nosub                   ns     skip sub-directories
     noautohr                na     auto heuristic level adjust
     nowin                   nw     do not scan for Windows/OS2 viruses
     repeat                  rp     scan multiple diskettes
     batch                   ba     batch mode. No user input
     delete                  de     delete infected files
     kill                    ki     kill infected files
     log                     lo     output to logfile
     append                  ap     log file append mode
     expertlog               el     no heuristic descriptions in log

     logname  =<filename>    ln     set path/name of log file
     loglevel =<0..4>        ll     set log level
     wait     =<0...255>     wa     amount of timerticks to wait
     rename   [=<text-mask>] rn     rename infected files
     exec     =.<ext-mask>   ee     specify executable extensions


     You can find an explanation on most of the command line options at the
     similar menu descriptions presented above.

     help (he)
     If you specify this option TbScan will display the help as listed above.

     pause (pa)
     When you activate the 'pause' option TbScan will stop after it has
     checked the contents of one window. This gives you the possibility to
     examine the results without having to consult a log file afterwards.




                                     III - 12
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     mono (mo)
     This option forces TbScan to refrain from using colors in the screen
     output. This might enhance the screen output on some LCD screens or
     color-emulating monochrome systems.

     quick (qs)
     TbScan will use the Anti-Vir.Dat files to check for file changes since
     the last time only. Only if a file has been changed (CRC change) or is
     not yet listed in Anti-Vir.Dat it will be scanned. Normally TbScan will
     always scan files.

     allfiles (af)
     With this option TbScan will scan non-executable files (files without
     extension COM, EXE, SYS or BIN) too. If TbScan finds out that such a
     file does not contain anything that can be executed by the processor the
     file will be 'skipped'. Otherwise the file will be searched for COM, EXE
     and SYS signatures. TbScan however will not perform heuristic analysis
     on non-executable files.

     Since viruses normally do not infect non-executable files it is not
     necessary to scan non-executable files too. We even recommend not to use
     this option unless you have a good reason to scan all files. Once again:
     a virus needs to be executed to perform what it is programmed to do, and
     since non-executable files will not be executed a virus in such a file
     can not do anything. For this reason viruses do not even try to infect
     such files. Some viruses however will write to non-executable files as a
     result of 'incorrect' programming. If so, these non-executable files
     will never harm other program or data files, but do contain corrupted
     data.

     alldrives (ad)
     This option causes TbScan to scan all local non-removabe disks.

     allnet (an)
     This option causes TbScan to scan all network drives.

     heuristic (hr)
     TbScan always performs a heuristic scan on the files being processed.
     However, only if a file is very probably infected with a virus, TbScan
     will report the file as being infected. If you use option 'heuristic',
     TbScan is somewhat more sensitive. In this mode 90% of the new, unknown,
     viruses will be detected without any signature, but some false alarms
     may occur. Consult also section 'Heuristic scanning' of this chapter
     (3.1).

     extract (ex)
     This option is available to registered users only. See the chapter
     'TbGensig' (IV-5) on how to use the option 'extract'.

     once (oo)
     If you specify this option TbScan will 'remember' after its scan that is
     has been executed that day, and that it should not be executed again the

                                     III - 13
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     same day with this particular option set. This option is very useful if
     you incorporate it in your AUTOEXEC.BAT file in combination with a scan
     list file (.SCN):
          TbScan @Everyday.Scn once rename

     TbScan will now scan the list of files and/or paths specified in the
     file EVERYDAY.SCN during the first boot-up of the day.

     If the systems boots more often that day, TbScan will then return to DOS
     immediately.  This option does not interfere with the regular use of
     TbScan. If you invoke TbScan without the 'once' option it will always be
     executed, regardless of a previous run with the 'once' option set.

=>   Note that if TbScan cannot write to TBSCAN.EXE because it has been
     flagged 'read-only' or is located on a write-protected diskette, the
     'once' option will fail and the scanner will be executed without it.

     slowscroll (ss)
     If you specify this option, TbScan will scroll the files in the files
     window conventionally. This method is slower but looks nicer.

     secure (se)
     This option is available to registered users only. If this option is
     specified it is no longer possible to cancel TbScan by pressing Ctrl-
     Break, or to respond to a virus alert window.

     compat (co)
     If you select this option, TbScan attempts to be more compatible with
     your system. Use this option if the program does not behave as you would
     expect, or even halts the system. This option will slow down the scan-
     ning process. Therefore, it should only be used if necessary.
     Note that this option does not affect the results of a scan.

     ignofile (in)
     If this option is specified and no files can be found, TbScan will not
     display the 'no files found' message, nor does it exit with errorlevel
     1. This option might be useful for automatic contents scanning.

     old (ol)
     This option suppresses the message which appears if TbScan is 6 months
     old.

     noboot (nb)
     If you specify this option TbScan will not scan the bootsector.

     nomem (nm)
     If you specify this option TbScan will not scan the memory of the PC for
     viruses.





                                     III - 14
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     hma (hm)
     TbScan detects the presence of an XMS-driver, and scans HMA automa-
     tically. If you have an HMA-driver which is not compatible with the XMS
     standard you can use the 'HMA' option to force TbScan to scan HMA.

     nohmem (nh)
     By default TbScan identifies RAM beyond the DOS limit and scans that
     too. This means that video memory and the current EMS pages are scanned
     by default. You can use this option to disable the scanning of non-DOS
     memory.

     nosub (ns)
     By default TbScan will search sub-directories for executable  files,
     unless a filename (wildcards allowed!) is specified. If you enable this
     option, TbScan will not scan sub-directories.

     noautohr (na)
     TbScan automatically adjusts the heuristic detection level after a virus
     has been found. This provides you maximum detection capabilities in case
     you need it, while the amount of false alarms due to heuristics remains
     small in normal situations. In other words: as soon as a virus has been
     found, TbScan will anticipate and proceed as if option 'heuristic' has
     been speci-fied. If you don't want this, you can specify option 'noau-
     tohr'.

     nowin (nw)
     TbScan also searches for Windows and OS/2 viruses. Although there exist
     only very few of these viruses, it takes TbScan relatively a lot of time
     to search for them. If you don't use Windows or OS/2 you can speed up
     TbScan by disabeling the detection of Windows and OS/2 virus detection.

     repeat (rp)
     This option is very useful if you want to check a large amount of
     diskettes. TbScan does not return to DOS after checking a disk, but it
     prompts you to insert another disk in the drive.

     batch (ba)
     By enabling this option TbScan will scan without displaying any messa-
     ges. Therefore, the use of a LOG file is highly
     advisable.

     delete (de)
     If TbScan detects a virus in a file it prompts the user to delete or
     rename the infected file, or to continue without action. If you specify
     the 'delete' option, TbScan will delete the infected file automatically,
     without prompting the user first. Use this option if you have determined
     it is a virus infection. Make sure that you have a clean back-up, and
     that you really want to get rid of all infected files at once.

     kill (ki)
     If TbScan detects a virus in a file it prompts the user to deleter or
     rename the infected file, or to continue without action. If you specify

                                     III - 15
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     the 'kill' option, TbScan will delete the infected file automatically,
     without prompting the user first. However, unlike the 'delete' option,
     files which have been killed can not be undeleted anymore. Be careful if
     you use this option. Make sure you have a clean back-up!

     log (lo)
     When you use this option, TbScan creates a log file. The log file lists
     all infected program files, specifying heuristic flags (see: appendix B)
     and complete pathnames.

     append (ap)
     If you use this option, TbScan will not overwrite an existing log file
     but append the new information to it. If you use this option often, it
     is recommended to delete or truncate the log file once in a while to
     avoid unlimited growth.
=>   Note: you have to combine this option with option 'log'.

     expertlog (el)
     If you enable this option TbScan will not specify the descriptions of
     the heuristic flags in the log file. The heuristic flag descriptions are
     listed in appendix B.

     logname =<filename> (ln)
     With option logname you can specify the name of the log file to be used.
     TbScan will create the file in the current directory unless you specify
     a path and filename after selecting this option. If the log file already
     exists, it will be overwritten. If you want to print the results, you
     can specify a printer device name rather than a filename (logname=lpt1).
=>   Note: you have to combine this option with option 'log'.

     loglevel =<0..4> (ll)
     These levels determine what kind of file information will be stored in
     the log file. The default log level is 1. You may select one of five log
     levels:

     0    Log only infected files. If there are no infected files do not
          create or change the log file.

     1    Log summary too. Put a summary and timestamp in the log file. Put
          only infected files in the log file.

     2    Log suspected too. Same as loglevel=1, but now also 'suspected'
          files are logged. Suspected files are files that would trigger the
          heuristic alarm if option 'heuristic' had been specified.

     3    Log all warnings too. Same as loglevel=2, but all files that have a
          warning character printed behind the filename will be logged too.

     4    Log clean files too. All files being processed will be put into the
          log file.

=>   Note: you have to combine this option with option 'log'.

                                     III - 16
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     wait =<0..255> (wa)
     This option can be used to delay TbScan, which may be handy if you want
     to scan a very busy network and you don't want to occupy the network to
     havily. You have to specify the amount of timer ticks you want to insert
     between every two files scanned.

     rename [=<text-mask>] (rn)
     If TbScan detects a file virus it prompts the user to delete or rename
     the infected file, or to continue without action. If you select the
     'rename' option, TbScan will rename the infected file automatically,
     without prompting the user first. By default, the first character of the
     file extension will be replced by the character 'V'. An .EXE file will
     be renamed to .VXE, and a .COM file to .VOM. This prevents the infected
     programs from being executed, spreading the infection. At the same time
     they can be kept for later examination and repair.

     You may also add a parameter to this option specifying the target
     extension. This parameter should always contain 3 characters; question
     marks are allowed. The default target extension is 'V??'.

     exec =.<ext-mask> (ee)
     With this option you can add filename extensions which indicate that a
     file is executable. If you want to use this option, you probably want to
     put it in the configuration file. Consult the explanation of the similar
     menu option for more details.


     Examples:
          TbScan c:\ noboot

     Process all executable files in the root directory and its subdirecto-
     ries. Skip the bootsector scan.

          TbScan \*.*

     Process all files in the root directory. Don't process subdirectories.

          TbScan @Local.Scn /nomem

     Process all paths specified in the file Local.Scn and skip memory
     scanning.

          TbScan c:\ log logname=c:\test.log loglevel=2

     All executable files on drive C: will be checked. A LOG file with the
     name c:\test.log will be created. The log file will contain all infected
     and suspected files.

          TbScan \ log logname=lpt1

     TbScan will scan the root directory and its subdirectories. The results
     are redirected to the printer rather than to a log file.

                                     III - 17
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III



1.4. The scanning process

     Choose the 'Start scanning' option in the TbScan menu or start the
     TbScan program from the DOS command line. TbScan will start scanning
     right away.

     +-----------------------------------------------------------------+
     |Thunderbyte virus detector v6.04 - (C) 1989-93, Thunderbyte B.V. |
     |                                                                 |
     | TBAV is upgraded every two months. Free hotline support is      |
     | provided for all registered users via telephone, fax and        |
     | electronic bulletin board. Read the comprehensive documentation |
     | files for detailed info. BBS: [phone]                  |
     |                                                                 |
     | C:\DOS\                                                         |
     | ** Unregistered evaluation version. Don't forget to register! **|
     |                                                                 |
     | ANSI.SYS      scanning..>        OK    signatures:        986   |
     | COUNTRY.SYS   skipping..>        OK                             |
     | DISKCOPY.COM  tracing...>        OK    file system:       OWN   |
     | DISPLAY.SYS   scanning..>        OK                             |
     | DRIVER.SYS    scanning..>        OK    directories:        01   |
     | EGA.CPI       skipping..>        OK    total files:        17   |
     | FASTOPEN.EXE  looking...>        OK    executables:        12   |
     | FDISK.EXE     looking...>        OK    CRC verified:       10   |
     | FORMAT.COM    tracing...>   E    OK    changed files:      00   |
     | GRAFTABL.COM  tracing...>        OK    infected items:     00   |
     | GRAPHICS.COM  tracing...>        OK                             |
     | GRAPHICS.PRO  skipping..>        OK    elapsed time:    00:05   |
     |                                        Kb /second:        57    |
     |                                                                 |
     +-----------------------------------------------------------------+

     TbScan divides the screen into three windows: an information window, a
     scanning window and a status window. The information window will initi-
     ally display the vendor information only.


     While Scanning

     If TbScan detects infected files the names of the file and the virus
     will be displayed in the upper window. The lower left window displays
     the names of the files being processed, the algorithm in use, info and
     heuristic flags, and finally an OK statement or the name of the virus
     detected.







                                     III - 18
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Example: NLSFUNC.EXE     checking..>    FU          OK
                 |              |            |           |
                 |              |            |           result of scan
                 |              |            heuristic flags
                 |              algorithm being used to process file
                 name of file in process


     You will see comments following each file name: 'looking', 'checking',
     'tracing', 'scanning' or 'skipping'. These refer to the various algo-
     rithms being used to scan files.

     Other comments that TbScan can display here are the heuristic flags.
     Consult the 'Heuristic flags' chapter (1.3) for more information on
     these warning characters.

     The lower right window is the status window. It displays the number of
     files and directories encountered, the amount of viruses found. It also
     displays which file system is being used: either "DOS" or "OWN". The
     latter means that TbScan is able to bypass DOS. If this is the case,
     TbScan reads all files directly from disk for extra security and speed.

     The scanning process can be aborted by pressing Ctrl-Break.


     Detecting Viruses

     As soon as an infected program is found, TbScan will display the name of
     the virus. If you did not specify one of the  options 'batch', 'rename'
     or 'delete', TbScan will prompt you to specify the appropriate action.
     If you choose to rename the file, the first character of the file
     extension will be replaced by the character 'V'. This prevents the file
     from being executed by accident before it has been investigated more
     thoroughly.


     If an infected file is detected, TbScan will display a message:

          Infected by [name of virus] virus.
          The file is infected by the virus mentioned.

          Is Joke named [name of Joke]
          There are some programs which simulate that the system is infected
          by a virus. A joke is completely harmless.

          Is Trojan named [name of Trojan]
          The file is a Trojan Horse.Do not execute the program but delete
          it.

          Damaged by [name of virus]
          A damaged file contains - unlike an infected file - not the virus
          itself, but has been damaged by the virus.

                                     III - 19
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


          Dropper of [name of virus]
          A dropper is a program that has not been infected itself, but which
          does contain a bootsector virus and is able to install it in your
          bootsector.

          Overwritten by [name of virus]
          Some viruses overwrite files. An overwritten file contains - unlike
          an infected file - not the virus itself, but has been overwritten
          with garbage.

     It is also possible that TbScan encounters a file that seems to be
     infected by a virus, although a signature could not be found. In this
     case TbScan displays the prefix 'Probably' before the message.


     Program Validation

     If TbScan finds a file to be very suspicious and pops up with the virus
     alert window, you can avoid future false alarms by pressing 'V' (Valida-
     te program). Note that this only works if there is an Anti-Vir.Dat
     record of the file available. Once a program is validated it will no
     longer be subject to heuristic analysis, unless the program changes and
     does not match the Anti-Vir.Dat record anymore. This will be the case if
     such a file gets infected afterwards, so TbScan will still report
     infections on these files.

=>   Note that a validated program is still subject to the conventional
     signature scanning.


     Heuristic Scanning

     If you have specified the option 'heuristic' it is likely that TbScan
     will find some files which look like a virus, and in this case TbScan
     uses the prefix 'Might be' to inform you about it. So, if TbScan dis-
     plays:

          Probably infected by an unknown virus (level 1)
     or:
          Might be infected by an unknown virus (level 2)

     it does not necessarily mean that the file is infected. There are a lot
     of files that look like a virus but are not.

=>   The heuristic levels are explained in section IV (page 9).


     False Positives

=>   Important!
     False alarms are part of the nature of heuristic scanning. In default
     mode it is very unlikely that TbScan issues a false alarm. However, if

                                     III - 20
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     you have specified option 'heuristic' some false alarms might occur. How
     to deal with these false alarms? If TbScan thinks it has found a virus
     it tells you the reason for this suspicion. In most cases you will be
     able to evaluate these reasons when you consider the purpose of the
     suspected file.

=>   Note that viruses infect other programs. It is highly unlikely that you
     will find only a few infected files on a hard disk used frequently. You
     should ignore the result of a heuristic scan if only a few programs on
     your hard disk trigger it. But, if your system behaves in a 'strange'
     manner and many programs cause TbScan to issue an alarm with the same
     serious flags, your system could very well be infected by a (yet un-
     known) virus.


     Heuristic flags

     Heuristic flags consist of single characters that are printed behind the
     name of the file that has been processed. There are two kinds of flags:
     the informative ones are printed in lower-case characters; the more
     serious flags are printed in upper-case characters.

     The lower-case flags are indicative of special characteristics of the
     file being processed, whereas the upper-case warnings may indicate a
     virus. If the 'loglevel' is 3 or above, the important warnings will not
     only appear as a warning character, but there will also be a description
     printed in the log file.

     How should you treat the flags? The less important lower-case flags can
     be considered to be for your information only.They provide you with file
     information you might find interesting. The more serious warning flags
     printed in upper-case MIGHT point towards a virus. It is quite normal
     that you have some files in your system which trigger an upper-case
     flag.

     The heuristic flag descriptions are listed in appendix B.

















                                     III - 21
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


2. TbScanX


2.1. The Purpose of TbScanX

     TbScanX is the resident version of the TbScan program, checking files on
     the basis of a virus signature list. Suppose you have a virus scanner
     automatically executed from your autoexec.bat file. If no viruses are
     found, your system is supposed to be uninfected. But, to be sure that no
     virus will infect your system, you have to execute the scanner every
     time after copying a file to your harddisk, after downloading a file
     from a bulletin board system, or after unarchiving an archive such as a
     ZIP file. Be honest, do YOU actually invoke your scanner every time you
     introduce a new file into the system? If you don't, you take the risk
     that within a couple of hours all files are infected by a virus...

     Once loaded, TbScanX will remain resident in memory, and will automati-
     cally scan all files you execute and all executable files you copy,
     create, download, modify, or unarchive. The same approach is used to
     protect against bootsector viruses: every time you put a diskette into a
     drive the bootsector will be scanned. If the disk is contaminated with a
     boot sector virus TbScanX will warn you in time!

     TbScanX is fully network compatible. It does not require to reload the
     scanner after logging on to the network.


2.2. How to use TbScanX

     Since TbScanX is memory resident, the program can be executed and
     configured from the command line or from within a batch file. It is
     important to load TbScanX as early as possible after the machine has
     booted. Therefore it is recommended to execute TbScanX from within the
     Config.Sys file.

=>   Note that TbScanX requires TbDriver to be loaded first!


     Loading TBScanX

     There are three possible ways to load TbScanX:

     1. From the DOS prompt or within the Autoexec.Bat file:
          <path>TbScanX

     2. From the Config.Sys as a TSR (Dos 4+):
          Install=<path>TbScanX.Exe

     The "Install=" Config.Sys command is NOT available in DOS 3.xx.

     3. From the Config.Sys as a device driver:
          Device=<path>TbScanX.Exe

                                     III - 22
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Unlike other anti-virus products, the ThunderBYTE anti-virus utlities
     can be loaded before the network is started without loosing the protec-
     tion afterwards.


     Highload TBScanX

     In addition to the three invocation possibilities users of DOS 5 and
     higher versions can "highload" TbScanX in UMB (upper memory block) if it
     is available:

          LoadHigh <path>TbScanX.Exe

     Within the Config.Sys file TbScanX can also be loaded high:

          DeviceHigh=<path>TbScanX.Exe


     TbScanX and MS-Windows

     Windows users should load TbScanX BEFORE starting MS-Windows. If you do
     that there is only one copy of TbScanX in memory, but every DOS-window
     will nevertheless have a fully functional TbScanX in it. TbScanX detects
     if Windows is starting up, and will switch itself in multitasking mode
     if necessary. You can even disable TbScanX in one window without affec-
     ting the functionality in another window.


2.3. Command line options

     TbScanx can be configured from the command line. The upper four options
     are always available, the other options are only available if TbScanX is
     not already resident in memory.




















                                     III - 23
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     option  short  explanation
     --------------------------------------------------

     help      ?    display this helpscreen
     off       d    disable scanning
     on        e    enable scanning
     remove    r    remove TbScanX from memory

     noexec    n    never scan at execute
     allexec   a    always scan at execute
     noboot    b    do not scan bootsectors
     wild      w    only viruses which appear in the wild
     ems       me   use expanded memory (EMS)
     xms       mx   use extended memory (XMS)
     secure    s    deny access without asking
     lock      l    lock PC when virus detected
     api       i    load Application Program Interface
     compat    c    increased compatibility


     help (?)
     If you specify this option TbScanX will show you the commandline options
     as shown above. Once TbScanX has been loaded the help option will not
     show all options anymore.

     off (d)
     If you specify this option TbScanX will be disabled, but it will remain
     in memory.

     on (e)
     If you use this option TbScanX will be activated again after you dis-
     abled it with the 'off' option.

     remove (r)
     This option can be used to remove the resident part of TbScanX from your
     memory. All memory used by TbScanX will be released. Unfortunately,
     removing a TSR (like TbScanX) is not always possible. TbScanX checks
     whether it is safe to remove the resident part from memory, if it is not
     safe it just disables TbScanX. A TSR can not be removed if another TSR
     is started after it. If this happens with TbScanX it will completely
     disable itself.

     compat (c)
     In most systems TbScanX performs troublefree. It is possible that
     TbScanX conflicts with other EMS or XMS using resident software. In this
     case the system will hang. Option 'compat' might solve this problem, but
     due to extensive memory swapping the performance of TbScanX will slow
     down.





                                     III - 24
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     noexec (n)
     TbScanX normally scans files located on removable media just before they
     are executed. You can use this option to disable this feature complete-
     ly.

     allexec (a)
     TbScanX normally scans files to be executed only if they reside on
     removable media. Files on the harddisk are trusted, because these files
     must have been copied or downloaded before. And by that time TbScanX has
     already scanned them automatically. However if you want every file to be
     scanned before executing, no matter whether on harddisk or removable
     media, you should use this option.

     noboot (b)
     TbScanX monitors the disk system: every time the bootsector is being
     read, TbScanX automatically scans the disk for bootsector viruses. If
     you change a disk, the first thing DOS has to do is read the bootsector,
     otherwise it does not know what kind of disk is in the drive. And as
     soon as DOS reads the bootsector, TbScanX checks it for viruses. If you
     don't like this feature, or if it causes problems, you can switch it off
     using the 'noboot' option. This option will also save some memory
     because the bootsector signatures will not be loaded.

     wild (w)
     There are many viruses which do not appear 'in the wild'. They only run
     on ancient machines or DOS versions, or they are so buggy that they can
     only survive in 'virus-laboratory' environments. If you specify option
     'wild', TbScanX will only search for the viruses which appear in the
     wild, saving memory and time.

     secure (s)
     TbScanX normally asks the user to continue or to cancel when it detects
     a virus. In some business environments however this choice should not be
     made by employees. By using option 'secure' it is no longer possible to
     allow suspicious operations. Option 'secure' also disables option 'off'
     and 'remove'.

     lock (l)
     System operators can use this option to instruct TbScanX to lock the
     system once a virus is detected.

     api (i)
     This option is intended for avanced users only. It enables the Applica-
     tion Program Interface of TbScanX which is needed if you want to call
     TbScanX from within your application. Consult the file Addendum.Doc for
     detailed programming information.

     ems (me)
     If you specify this option TbScanX will use expanded memory (like
     provided by LIM/EMS expansion boards or 80386 memory managers) to store
     the signatures and part of its program code. Since conventional memory


                                     III - 25
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     is more valuable to your programs than expanded memory, the use of EMS
     memory is recommended.

     xms (mx)
     If you specify this option TbScanX will use extended memory to store the
     signatures and part of its program code. An XMS driver (like HIMEM.SYS)
     needs to be installed to be able to use this option. XMS memory is not
     directly accessable from within DOS, so every time TbScanX has to scan
     data it has to copy the signatures to conventional memory.

     To be able to save the original memory contents TbScanX needs a double
     amount of XMS memory. Swapping to XMS is slower than swapping to EMS
     memory, so if you have EMS memory available swapping to EMS is recommen-
     ded. Swapping to XMS may conflict with some other software, so if you
     experience problems try using TbScanX without the XMS option.

     Example
          Device=C:\utils\TbScanX.Exe xms noboot


2.4. While scanning

     Whenever a program tries to write to an executable file (files with the
     extensions .COM and .EXE), you will briefly see the text "*Scanning*" in
     the upper left corner of your screen. Since TbScanX takes very little
     time to scan the file, the message will only appear very briefly. The
     text "*Scanning*" will also appear if you execute a program directly
     from a diskette, and if DOS accesses the bootsector of a diskette drive.


     Detecting Viruses

     If TbScanX detects a suspicious signature that is about to be written
     into a file, a window will appear with the message:

          WARNING, <filename> contains <virus name>!
          Abort? (Y/n)

     Press "N" to continue, press any other key to abort.

     If TbScanX detects a suspicious signature in a boot sector, it will
     display the message:

          WARNING, Disk in <drive> contains <virus name>!
          Press a key...

     Although a virus seems to be on the bootsector of the specified drive,
     the virus cannot do anything since it has not been executed yet. Howe-
     ver, if you reboot the machine with the contaminated diskette in the
     drive, the virus will copy itself to your harddisk.



                                     III - 26
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     To display the name of the virus, TbScanX needs the signature file
     again. It will automatically use the signature file that was used when
     you invoked the program. If the signature file is missing (because you
     deleted it, or because you removed the  floppy containing it), or no
     file handles are left, TbScanX will still detect viruses, but it is no
     longer able to display the name of the virus. It will display [Name
     unknown] instead.














































                                     III - 27
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


3. TbCheck


3.1. The Purpose of TbCheck

     TbCheck is a memory-resident integrity checker, coming into action
     whenever a file is about to be executed. It uses the Anti-Vir.Dat
     records generated by TbSetup to detect file changes, often the first
     sign of a virus infection. These records contain information, such as
     file sizes and checksums, of every executable file in a directory. By
     comparing this information with the actual file status it is possible to
     detect any changes, including infections caused by viruses - automati-
     cally.

     Suppose you have a conventional integrity checker automatically invoked
     in your autoexec.bat file. If no files are changed, your system is
     supposed to be uninfected. But, to be sure that no virus can infect your
     system, you have to execute the checker frequently.

     Once loaded TbCheck will remain resident in memory, and will automa-
     tically check all programs you try to execute.

     TbCheck is fully network compatible. It does not require you to reload
     the checker after logged on to the network.


3.2. How to use TbCheck

     Since TbCheck is a memory resident program, it can be executed and
     configured from the command line or from within a batch file. TbCheck
     should however be started automatically and as soon as the computer
     boots up, preferably during the execution of Config.Sys or Autoexec.Bat
     file.

=>   Be sure TbDriver has already been loaded - TbCheck wil refuse to start
     up without it.


     Loading TbCheck

     There are three possible ways to start TbCheck:

     1. From the DOS prompt or within the Autoexec.Bat file:
          <path>TbCheck

     2. From the Config.Sys as a TSR (Dos 4+):
          Install=<path>TbCheck.Exe

     The "Install=" Config.Sys command is NOT available in DOS 3.xx.

     3. To invoke TbCheck from the Config.Sys as a device driver:
          Device=<path>TbCheck.Exe

                                     III - 28
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     TbCheck should always work correctly after being started from within the
     Autoexec.Bat. Unlike other anti-virus products, the Thunderbyte anti-
     virus utilities can be loaded before the network is started without
     losing the protection after the network is started.


     Highload  TbCheck

     In addition to the three invocation possibilities DOS 5 users can
     "highload" TbCheck in a UMB (upper memory block) if it is available:

          LoadHigh <path>TbCheck.Exe

     Within the Config.Sys file TbCheck can also be loaded high:

          DeviceHigh=<path>TbCheck.Exe


     TbCheck and MS-Windows

     Windows users should load TbCheck BEFORE starting Windows. If you do
     that, there is only one copy of TbCheck in memory, but every DOS-window
     will nevertheless have a fully functional TbCheck in it.  TbCheck
     detects if Windows is starting up, and will switch itself into multitas-
     king mode if necessary. You can even disable TbCheck in one window
     without affecting the functionality in another window.


3.3. Command line options

     It is possible to specify options on the command line. The upper four
     options are always available, the other options are available only if
     TbCheck is not memory resident.


     option  parameter short explanation
     ------  --------- ----- ------------------

     help               ?    display this helpscreen
     off                d    disable checking
     on                 e    enable checking
     remove             r    remove TbCheck from memory

     noavok [=<drives>] o    do not warn for missing AV record
     fullcrc            f    calculate full CRC (slow!)
     secure             s    do not execute unauthorized files


     help (?)
     If you specify this option TbCheck displays the above options list.

     off (d)

                                     III - 29
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Disables TbCheck, but it will remain in memory and can be reactivated.

     on (e)
     TbCheck will be reactivated after having been disabled with the 'off'
     option.

     remove (r)
     This option disables TbCheck and will try to remove the resident part
     from memory. Unfortunately, this can only work if TbCheck was loaded
     last. An attempt to remove a TSR after another TSR has been started will
     simply leave a useless gap in memory and could disrupt the interrupt
     chain. TbCheck will try to find out whether it is safe to remove its
     resident code; if not, it will simply disable itself.

     noavok (o)
     TbCheck will look for checksum information on the file you want to be
     checked in the Anti-Vir.Dat file. TbCheck will display a message if no
     checksum information is found or if the specific checksum is incorrect.
     This makes sure that you will receive a warning whenever a malicious
     program deletes the Anti-Vir.Dat file.

     Although it is recommended to maintain Anti-Vir.Dat files on all drives,
     this may not always be practical with floppy disks, RAM disks or CD-ROM
     disks. Option 'noavok' tells TbCheck not to look for an Anti-Vir.Dat on
     specific drives. For instance, if you don't want to be alerted about the
     absence of an Anti-Vir.Dat record on floppy disks (A: and B:) or on your
     RAM disk (E:) you should specify:

          "NoAvOk=ABE"

     If you don't want a message if an Anti-Vir.Dat record is missing on
     network drives, you should specify an asterisk (*) instead of a drive
     letter.

     If you don't specify a drive to the 'noavok' option, TbCheck will never
     issue a warning if an Anti-Vir record is missing on any drive.

=>   Note that this presents a security hole for viruses: by deleting the
     Anti-Vir.Dat file you will not be able to detect file changes caused by
     a viral infection.

=>   Please note that the 'noavok' option does not do anything to prevent the
     detection of infected programs if the Anti-Vir record is available. If a
     program has been changed and the Anti-Vir record is available, you will
     still get an alarm regardless of how option 'noavok' was implemented.

     fullcrc (f)
     By default, TbCheck only verifies that part of the file near the pro-
     gram's entry point. If a virus infects the file, this area is guaranteed
     to change, so this is perfectly adequate to detect all infections. Other
     file changes, notably configuration variations, will not trigger the
     alarm. If, however, you should ever desire a full check that detects any

                                     III - 30
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     file changes, this option will take care of it. Note that this slows
     down the system considerably - this option is not recommended for normal
     (anti-virus) usage!

     secure (s)
     TbCheck normally asks whether the user wants to continue or cancel when
     a file has been changed or when there is no checksum information availa-
     ble. In a business environment it may be unwise to leave such decisions
     to employees. Option 'secure' makes it impossible to execute new or
     unknown programs, or programs that have been changed. Option 'secure'
     also disables option 'off' and 'remove'.


3.4. While checking

     Whenever a program wants to execute, TbCheck steps in to see if it
     really has the authority to do so. During that time it will display
     '*Checking*' in the screen's upper left hand corner. TbCheck operates at
     lightning speed, therefore the message will appear only momentarily.

     Since TbCheck does not take much time to check the file, you will see
     the message only in a short notice of time.


     Detecting File Changes

     TbCheck quickly checks a program when that program is loaded. If TbCheck
     detects that a file has been changed, a pop-up window will appear to
     inform you. You can either choose to continue, or to abort the program
     invocation.

     If there is no information (Anti-Vir.Dat) about the program, TbCheck
     will inform you about this too. You can either choose to continue
     without checking, or to abort the program invocation.

=>   Note that you can prevent users from executing non authorized software
     by combining the TbCheck command with the 'secure' option.


3.5. Testing TbCheck

     Many people understandably wish to test the product they are using. In
     contrast with, for instance, a word processor, it is very difficult to
     test a smart integrity checker like TbCheck. You cannot change a random
     25 bytes of an executable file just to find out whether or not TbCheck
     will detect the file change. On the contrary, it is very likely that
     TbCheck will NOT detect it because the program only checks the entry-
     area of the file whereas the changed bytes might be located on another
     location within the file.




                                     III - 31
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


4. TbClean


4.1. The Purpose of TbClean

     TbClean isolates viral code in an infected program and removes it. From
     then on it will be safe to use the program again, as the risk of other
     files being infected or damaged by it will have been securely elimina-
     ted.


     Generic Cleaners

     TbClean works completely different compared to 'conventional cleaners.
     First of all, it does not recognize any virus. Its disinfection scheme
     is completely different and it works with almost any virus. Actually,
     the TbClean program contains two cleaners: a 'repair' cleaner, and a
     'heuristic' cleaner. The repair cleaner needs an Anti-Vir.Dat file that
     is generated by the TbSetup program before the infection occurs. In this
     Anti-Vir.Dat file essential information is stored, like the original
     file size, the bytes at the beginning of the program, a cryptographic
     checksum to verify the results, etc. This information enables TbClean to
     disinfect almost every file, regardless of the virus it has been infec-
     ted with, known or unknown.


     No information available?

     In the heuristic cleaning mode TbClean does not need any information
     about viruses either, but it has the added advantage that it does not
     even care about the original, uninfected state of a program. This
     cleaning mode is very effective if your system is infected with an
     unknown virus and yo neglected to let TbSetup generate the Anti-Vir.Dat
     files in time.

     In the heuristic mode, TbClean loads the infected file and starts
     emulating the program code to find out which part of the file belongs to
     the original program and which to the virus. The result is successful if
     the functionality of the original program is restored, and the functio-
     nality of the virus has been reduced to zero.

=>   Note that this does not imply that the cleaned file is 100% equal to the
     original.

     When TbClean uses heuristic cleaning to disinfect the program, the file
     will most likely not be exactly the same as in its original state. This
     is not an indication of failure of TbClean, nor does it mean the file is
     still infected in some way. First of all, it is normal that the heuris-
     tically cleaned file is still larger than the original. This is normal
     because TbClean tries to be on the safe side and it will avoid removing
     too much. The bytes left at the end of the file are 'dead' code, the
     instructions will never be executed again since the 'jump' at the

                                     III - 32
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     beginning of the program has been removed. If the cleaned file is an EXE
     type file, it is likely that some bytes in front of the program - the
     exeheader - are different. There are many suitable solutions to recon-
     struct the exeheader, and TbClean can of course never know the original
     state of the program. The functionality of the cleaned file will never-
     theless be the same!

=>   Note that this only applies to heuristic cleaning: if there is a suit-
     able Anti-Vir.Dat record available, the cleaned program will normally be
     exactly the same as the original clean file.

     It is possible that the infected file is infected with multiple viruses,
     or multiple instances of the same virus! Some viruses keep on infecting
     files, and in such case the infected files will keep growing. If TbClean
     used its heuristic cleaning mode, it is very likely that TbClean removed
     only one instance of the virus. In this case, it is necessary to repeat
     the cleaning process until TbClean reports that it can not remove
     anything anymore.


4.2. How to use TbClean

     After tracking one or more viruses, all you should do is select the
     'Start cleaning' option in the TbClean menu. After specifying the
     relevant filename, TbClean will come into action. Beforehand, TbClean
     allows some additional parameters. These parameters are discussed below.


     The TbClean menu

     You can execute TbClean in combination with some useful parameters,
     which are listed in the TbClean menu. You can activate these parameters
     by toggling the selection bar to the desired option and type <ENTER>. A
     checkmark indicates that the specific parameter is ON.


     +----Main menu-----+
     |  Confi+-----TbClean menu-----+
     |  TbSet|  Start cleaning      |
     |  TbSca|  List-file name      |
     |  TbUti|  Use TBAV.INI file   |
     |  TbCLe|  Prompt for pause    |
     |  TBAV |v Use Anti-Vir.Dat    |
     |  Docum|v Use Heuristics      |
     |  Regis|v Expanded memory     |
     |  Quit |  Show program loops  |
     |  eXit |  Make list file      |
     +-------+----------------------+





                                     III - 33
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     List-file name

     By selecting this option you may specify a filename to be used as list-
     file (see also option 'make list-file').


     Use TBAV.INI file

     By enabling this option, the TbClean configuration values, saved in the
     TBAV.INI file, will also be valid when loading TbClean from the command
     line. Be careful, since options specified in the TBAV.INI file can not
     be undone on the command line. See chapter I-2 ('Configuration').


     Prompt for pause

     TbClean will stop disassembling information after each full screen to
     let you examine the results.


     Use Anti-Vir.Dat

     If this option is deselected, TbClean will act as if there were no Anti-
     Vir.Dat records available and will therefore perform heuristic cleaning.


     Use Heuristics

     If this option is deselected, TbClean will not try to apply heuristic
     cleaning, even when there are no Anti-Vir.Dat records available.


     Show program loops

     By default TbClean keeps track of looping conditions to keep an iterati-
     on that would be emulated thousands of times from being listed on your
     screen. With this option TbClean 'works out' every loop.

=>   Note that TbClean will perform at a drastically reduced speed. Do not
     combine this option with the 'list' option, because the list file might
     grow too big.


     Expanded memory

     If activated, TbClean will detect the presence of expanded memory and
     will use it in heuristic mode. You may disable EMS usage if it is too
     slow, or if your expanded memory manager is not very stable.





                                     III - 34
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Make list file

     TbClean will generate an output file with a chronological disassembly of
     the virus being removed.


4.3. Command line options

     TbClean recognizes option short-keys and option words. The words are
     easier to memorize, and they will be used in this manual for convenien-
     ce.


     option     parameter        short explanation
     ---------------------------------------------------------------
     help                         he   help (-? = short help)
     pause                        pa   enable 'Pause' prompt
     mono                         mo   force monochrome
     noav                         na   do not use Anti-Vir.Dat record
     noheur                       nh   do not use heuristic cleaning
     noems                        ne   do not use expanded memory
     showloop                     sl   show every loop iteration
     list       [=<filename>]     li   create list file


     Below, all command line options are explained briefly.

     help (he)
     If you specify this option TbClean displays the contents of the TBCLE-
     AN.HLP file if it is available in the home directory of TbClean.  If you
     specify the '?' option you will get the summarized help info as listed
     above.

     pause (pa)
     TbClean will stop disassembling information after each full screen to
     let you examine the results.

     mono (mo)
     This option forces TbClean to refrain from using colors in the screen
     output. This might enhance the screen output on some LCD screens or
     color-emulating monochrome systems.

     noav (na)
     If this option is specified, TbClean will act as if there were no Anti-
     Vir.Dat records available and will therefore perform heuristic cleaning.

     noheur (nh)
     If this option is specified, TbClean will not try to apply heuristic
     cleaning, even when there are no Anti-Vir.Dat records available.




                                     III - 35
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     noems (ne)
     If specified, TbClean will not detect the presence of expanded memory
     and will use it in heuristic mode. You may disable EMS usage if it is
     too slow, or if your expanded memory
     manager is not very stable.

     showloop (sl)
     By default TbClean keeps track of looping conditions to keep an iterati-
     on that would be emulated thousands of times from being listed on your
     screen. With this option TbClean 'works out' every loop.

=>   Note that TbClean will perform at a drastically reduced speed. Do not
     combine this option with the 'list' option, because the list file might
     grow too big.

     list [=<filename>] (li)
     TbClean will generate an output file with a chronological disassembly of
     the virus being removed.

     Examples
          TbClean VIRUS.EXE

     TbClean will make a backup with the name VIRUS.VIR and it will disinfect
     VIRUS.EXE

          TbClean VIRUS.EXE TEST.EXE

     TbClean will copy VIRUS.EXE to TEST.EXE and disinfect
     TEST.EXE


4.4. The cleaning process

     Choose 'Start cleaning' in the TBAV menu. Now you specify the name of
     the file that has to be cleaned. Suppose you want an infected program
     file named 'virus.exe' to be cleaned:

     Enter name of program to clean. TbClean will create a backup first!
               C:\VIRUS\VIRUS.EXE

     The ThunderBYTE utility cleans on a file-by-file approach: clean one
     file, verify the result, and proceed with the next file. This helps you
     to keep track of which file is clean, which file is damaged and should
     be restored from a backup, and which
     file is still infected.

     Enter name of cleaned file. Keep blank if infected program may be
     changed.
               C:\VIRUS\TEST.EXE

     By specifying a different name (eg. 'test.exe') you indicate that the
     cleaned file may not overwrite the original .exe file. In this example

                                     III - 36
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     TbClean will copy VIRUS.EXE to TEST.EXE and disinfect TEST.EXE. Next,
     TbClean will start the cleaning process.

     If you do not specify a backup filename, TbClean will create a backup
     with the '.vir' extension (eg. VIRUS.VIR) and it will disinfect the .exe
     file.


     +-----------------------------------------------------------------+
     |  Thunderbyte clean utility v6.03 (C) 1992-93 Thunderbyte B.V.   |
     +---------Infected state----------++---------Original state-------+
     | Entry point (CS:IP)   34BF:0012 || Entry point (CS:IP) 34BF:0012|
     | File length                     || File length         UNKNOWN! |
     | Cryptographic CRC     9F90F52A  || Cryptographic CRC   UNKNOWN! |
     +---------------------------------++------------------------------+
     |                                                                 |
     | Starting clean attempt. Analyzing infected file...              |
     | Anti-Vir not found: original state unknown. Trying emulation... |
     | Emulation terminated:                                           |
     |                                                                 |
     | C:\VIRUS\TEST.EXE                                               |
     | CS:IP    Instruction     AX  BX  CX  DX  DS  SI  ES  DI  SS  SP |
     | 9330:0101  mov ah,40    FFFE9330FFFFEFFFD382FFEDEFFEFFFF9520007E|
     | 9330:0103  mov bx,0002  40FE9330FFFFEFFFD382FFEDEFFEFFFF9520007E|
     | 9330:0106  mov cx,0016  40FE0002FFFFEFFFD382FFEDEFFEFFFF9520007E|
     | 9330:0109  mov dx,cs    40FE00020016EFFFD382FFEDEFFEFFFF9520007E|
     | 9330:010B  mov ds,dx    40FE000200169330D382FFEDEFFEFFFF9520007E|
     | 9330:010D  mov dx,0117  40FE0002001693309330FFEDEFFEFFFF9520007E|
     | 9330:0110  int 21       40FE0002001601179330FFEDEFFEFFFF9520007E|
     | 9330:0112  mov ax,4CFF  40FE0002001601179330FFEDEFFEFFFF9520007E|
     | 9330:0115  int 21       4CFF0002001601179330FFEDEFFEFFFF9520007E|
     | 9330:0115  <End of emulation>                                   |
     +-----------------------------------------------------------------+

     While Cleaning

     TbClean will display as much information as possible about the current
     operation, as illustrated above. All the major actions will be in the
     emulation window, displaying a disassembly and the register contents of
     the program under scrutiny, along with a progress report. The status
     windows reveal useful details of the infected file and, if TbClean can
     find a suitable Anti-Vir.Dat file, its original status. You may abort
     the cleaning process by pressing <Ctrl-Break>.


     The job isn't done yet

     A successful purge is not the end of the story! Your job is only parti-
     ally completed. Some viruses damage data files. They could randomly
     change bytes on your disks, swap sectors, or perform other nasty tricks.
     A cleaning utility will never be able to repair your data! Check your
     data files thoroughly and consult a viral expert to find out what the

                                     III - 37
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     virus is capable of doing. If there is any doubt, restoring the data is
     definitely the most reliable option.

=>   Under no circumstances should you continue to use cleaned software!

     Cleaning is a temporary solution to allow you to delay a large restore
     operation until the first available slack period. You should not rely on
     a cleaned program for any length of time.  Please, don't take this as a
     put down of antiviral cleaning agents. If your data is valuable to you,
     you should care for it as much as possible, and sticking to original
     software only is no more than an elementary precaution. In other words,
     restore the original programs as soon as possible!


     Cleaning Limitations

     Although TbClean has a very high success rate and is able to clean
     programs that other cleaners refuse to process, not all viruses can be
     removed, and not all files can be cleaned.

     Viruses that cannot be removed from an infected file:

     Overwriting viruses.

     This type of virus does not add itself to the end of the original
     program, they just copy themselves over the original file. They do not
     attempt to start the original program but they will simply return you to
     DOS after they are activated or will hang the machine. Since the origi-
     nal file is overwritten and damaged, no cleaner can remove the virus.

     Some encrypted viruses.

     TbClean is usually able to decrypt the virus. However, some viruses use
     anti-debugger features that TbClean cannot cope with yet.


     The way some program files are constructed makes them impossible to
     clean and reinstatement will be the only option. This category includes:

     EXE-programs with internal overlays.

     TbScan marks these files with an 'i' flag. Any infection is bound to
     cause major damage to these files. Some viruses recognize such programs
     and do not infect them, but most viruses infect these programs anyway,
     and corrupt the program. No cleaner can repair such damage.

     Programs with sanity check routines.

     Some programs - mostly anti-virus software or copy-protected programs -
     perform some kind of sanity check. Heuristic cleaning of an infected
     program normally results in a program that is not physically identical
     to the original. Although the virus is removed from the program and the

                                     III - 38
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     program is functionally identical to the original, the sanity check will
     usually detect the slight changes and abort the program.


     Multiple files cleaning

     TbClean has no provisions for cleaning multiple programs in one run.
     There are two reasons for this omission:

     -    TbClean can not search for viruses automatically since it does not
          know any virus.

     -    We highly recommend to clean the system on a file-by-file approach.
          Clean one file, verify the result, and proceed with the next file.
          This helps you to keep track of which file is clean, which file is
          damaged and should be restored from a backup, and which file is
          still infected.




































                                     III - 39
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


5. Ongoing virus prevention: TbMon

     The Purpose of TbMon utilities

     TbMon is a set of three memory resident anti-virus utilities:

     TbMem     Detects attempts of programs to remain resident in                                                                  memory, and
               makes sure that no program can remain resident in memory
               without permission.

     TbFile    detects attempts of programs to infect other programs.

     TbDisk    detects attempts of programs to write directly to the disk
               (without using DOS), attempts to format, etc.

     Instructions on how to use these utilities are presented below.


     How to use TbMon programs

     Loading TBMon programs
     The TbMon programs are all loaded in the same way. For specific informa-
     tion on each of the programs, such as commandline options, please refer
     to the appropriate sections in this chapter.

     There are three possible ways to start the TbMon programs:

     From the DOS prompt or within the Autoexec.Bat file:
          <path>Tbxx

     From the Config.Sys as a TSR (Dos 4+):
          Install=<path>Tbxxx.Exe

     The "Install=" Config.Sys command is NOT available in DOS 3.xx.

     To invoke a TbMon program from the Config.Sys as a device driver:
          Device=<path>Tbxxx.Exe


     A TbMon program should always work correctly after being started from
     within the Autoexec.Bat. Unlike other anti-virus products, the Thunder-
     byte anti-virus utilities can be loaded before the network is started
     without losing the protection after the network is started.


     Highload TBMon programs

     In addition to the three invocation possibilities DOS 5 users can
     "highload" TbMon programs in a UMB (upper memory block) if it is availa-
     ble:

          LoadHigh <path>Tbxxx.Exe

                                     III - 40
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III



     Within the Config.Sys file a TbMon program can also be loaded high:

          DeviceHigh=<path>Tbxxx.Exe


     TBMon and MS-Windows

     Windows users should load a TbMon program BEFORE starting Windows. If
     you do that there is only one copy of the TbMon program in memory, but
     every DOS-window will nevertheless have the fully functional TbMon
     program in it. The TbMon program detects if Windows is starting up, and
     will switch itself into multitasking mode if necessary. You can even
     disable the program in one window without affecting the functionality in
     another window.


     Command line options

     All TbMon utilities can be loaded in combination with several options.
     You may specify the options listed below in combination with all three
     utilities. The specific options are described in the relevant sections.

     help (?)
     If you specify this option the TbMon program will show you the brief
     help as shown above.

     off (d)
     If you specify this option the TbMon program will be disabled, but it
     will remain in memory.

     on (e)
     If you use this option the TbMon program will be activated again after
     you disabled it with the 'off' option.

     remove (r)
     This option can be used to remove the resident part of the TbMon program
     from your system's memory. All memory used by the TbMon program will be
     released. Unfortunately, the removal of a TSR is not always possible.
     The TbMon program checks whether it is safe to remove the resident part
     from memory. If it is not safe it just disables the TbMon program. A TSR
     can not be removed if another TSR has been started after it. If this
     happens with the TbMon program, it will completely disable itself.

     secure (s)
     If you specify this option, the user is not allowed to give permission.
     All warnings are automatically answered with 'Abort'. It is also not
     possible anymore to unload the utilities with 'remove' or to disable
     them with option 'off'.


5.1. TbMem

                                     III - 41
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     The Purpose of TbMem

     Most viruses remain resident in memory once they have been executed.
     While resident in memory, they may have many opportunities to infect
     other files in the background, interfere with the system operation, hide
     themselves from virus scanners or checksummers, and/or perform other
     nasty tasks.

     On the other hand, because so many viruses remain resident in memory, it
     is easy to detect most of them once the process of becoming resident in
     memory is monitored.

     TbMem monitors the system and ensures that no program will remain
     resident in memory without permission. This will draw attention to any
     software that attempts to remain resident, thereby reducing the likeli-
     hood that a virus will be able to go unnoticed. TbMem also protects
     CMOS.


     What is a memory-resident program?

     Most programs will be invoked by a command on the DOS command line,
     perform some task, and finally terminate, placing you right back where
     you started.

     Some programs however continue to operate after they are terminated.
     These programs load themselves into memory of your PC, remain resident
     in the memory and perform some task in the background. Programs in this
     category are disk caches, print spoolers, network software, etc. These
     programs are often referred to as 'TSR-software', which means 'Termina-
     te-and-Stay-Resident'.

     Most viruses remain resident in memory too, and that is why the process
     of becoming resident in memory should be controlled in some way, prefe-
     rably by TbMem.

     TbMem offers you the option to abort the program before it can become
     resident. TbMem will guard the DOS TSR function calls, while also
     monitoring important interrupts and memory structures. TbMem uses the
     Anti-Vir.Dat records to determine whether a program is allowed to remain
     resident in memory.

     Many common TSRs will be recognized by TbSetup. However, if TbSetup
     doesn't recognize a TSR, TbMem will ask your permission for the TSR to
     load. Permission information will be maintained in the Anti-Vir.Dat
     files, to prevent TbMem from bothering you when an approved TSR is
     loading.

     TbMem will also check the contents of the CMOS configuration memory
     after each program termination, to make sure that programs do not change
     it unnoticed. TbMem offers the possibility to restore the CMOS configu-
     ration when it has been changed. Once you have 'taught' TbMem which

                                     III - 42
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     programs are TSRs and which are not on one PC, you can use TbSetup to
     set the permission flag of these files on other machines.

     TbMem installs a hot key that can be used to escape from nearly all
     programs.

     TbMem is fully network compatible. It does not require you to reload the
     checker after logging on to a network.


     How to use TbMem

     Since TbMem is a memory resident program, it can be executed and confi-
     gured from the command line or from within a batch file. TbMem should
     however be started automatically and as soon as the computer boots up,
     preferably during the execution of Config.Sys or Autoexec.Bat file.

     Be sure TbDriver has already been loaded - TbMem wil refuse to start up
     without it.


     Command line options

     It is possible to specify options on the command line. The upper four
     options are always available, the other options are available only if
     TbMem is not memory resident.


     option  parameter      short explanation
     --------------------------------------------------------------
     help                    ?    display this helpscreen
     off                     d    disable checking
     on                      e    enable checking
     remove                  r    remove TbMem from memory

     secure                  s    do not execute unauthorized TSRs
     hotkey  <keycode>       k    specify keyboard scancode for hotkey
     nocancel                n    do not install cancel hot key
     nocmos                  m    do not protect CMOS


     help (?)
     If you specify this option TbMem will show you the brief help as shown
     above.

     off (d)
     If you specify this option TbMem will be disabled, but it will remain in
     memory.

     on (e)
     If you use this option TbMem will be activated again after you disabled
     it with the 'off' option.

                                     III - 43
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     remove (r)
     This option can be used to remove the resident part of TbMem from your
     system's memory. All memory used by TbMem will be released. Unfortunate-
     ly, the removal of a TSR (like TbMem) is not always possible. TbMem
     checks whether it is safe to remove the resident part from memory. If it
     is not safe it just disables TbMem. A TSR can not be removed if another
     TSR has been started after it. If this happens with TbMem it will
     completely disable itself.

     secure (s)
     TbMem normally asks the user to continue or to cancel when a program
     tries to remain resident in memory. In some business environments
     however this choice should not be made by employees. By using option
     'secure' it is no longer possible to execute new or unknown resident
     software. It is also no longer possible to use option 'remove' or 'off'.

     nocancel (n)
     TbMem normally installs the program cancel hot key (Ctrl-Alt-Insert). If
     you do not want this, specify this option. This also saves a few bytes
     of memory.

     hotkey (k)
     TbMem offers you a reliable way to escape from any program by pressing a
     special key combination. This can be used to escape from programs that
     'hang', but of course also to escape from software that seems to be
     malicious (although powering down and rebooting from a write-protected
     system disk is recommended).

     The program cancel hot key of TbMem is by default Ctrl-Alt-Insert. If
     you wish, you can specify another keyboard option with option 'hotkey
     =<keycode>'. The scancode is specified in a 4 digit hexadecimal number.
     The far left bytes specify the shift-key mask, the far right bytes
     specify the keyboard scancode. Consult your machine manual for a list of
     scancodes. The default scancode is 0C52h (Ctrl-Alt-Insert). The scancode
     for Ctrl-Alt-Escape is 0C01h.

     nocmos (m)
     TbMem normally protects the CMOS memory if available. If you do not want
     TbMem to do this you can specify this option.

     Examples
          C:\utils\TbMem
     or:
          Device=C:\utils\TbMem.Exe


     TbMem in process

     If TbMem detects that a program tries to remain resident in memory, a
     pop-up window will appear with a message. You can either choose to
     continue, or to abort the program invoca-tion. If you answer 'NO' to the
     question 'Remove program from memory?' the program will continue undis-

                                     III - 44
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     turbed, and TbMem places a mark in the Anti-Vir.Dat file about this
     program. Next time you invoke the same resident program, TbMem will not
     disturb you again.

     There are a lot of programs which normally remain resident in memory,
     such as disk caches, print spoolers, etc. How does TbMem distinguish
     between these programs and viruses?

     TbMem uses the Anti-Vir.Dat records generated by TbSetup to keep track
     of which files are normal TSRs and which are not. Most common resident
     software will be marked as such by TbSetup, so you don't have to worry
     about these files.

     If TbMem pops up with the message that a program tries to remain resi-
     dent in memory, you have to consider the purpose of the program mentio-
     ned. Is the program supposed to continue to operate in the background?
     The answer is obviously yes if the program mentioned is a disk cache,
     print spooler, pop-up utility or system extension software.

     However, if the message appears after you have finished a text proces-
     sing job, or terminated a database or spreadsheet application, something
     is definitely wrong! You ought to terminate the program and use a virus
     scanner to check the system.

     The same applies when software that operates normally without staying
     resident in memory suddenly changes its behavior and tries to remain
     resident in memory.


5.2. TbFile

     The Purpose of TbFile

     The two most perilous viral categories are the bootsector and the file
     variants. File viruses all have a common purpose -they infect programs.
     Infecting a program involves very unusual file manipulations that are
     quite dissimilar to normal files handling procedures, so in order to
     detect viral activity it is essential to keep an eye out for program
     file changes involving peculiar actions.

     TbFile monitors the system and detects attempts of programs to infect
     other programs. Unlike other file guards, TbFile monitors the system
     only for virus specific file modifications. TbFile won't generate an
     alarm when a program modifies itself for configuration purposes, nor
     does it bother you when you update a program or create one yourself.
     Running an average system, configurations should never cause a false
     alarm.

     TbFile not only detects attempts to infect programs, it also offers you
     the option to abort the infection process and to continue the program.



                                     III - 45
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     TbFile detects other suspicious activities - including setting the
     seconds value of time stamps to an illegal value.

     TbFile has a very sophisticated infection detector and it will not give
     a false alarm when you perform standard file operations. In normal
     configurations you will never get a false alarm!

     Files can be protected against unwanted modifications by means of the
     read-only attribute. Without TbFile this standard DOS protection can be
     circumvented easily. TbFile however makes sure any attempts to sabotage
     the readonly attribute will not go undetected. This gives you added
     security by letting you use an uncomplicated method to fully protect
     your files against destruction and infection.

     TbFile is fully network compatible. It does not require you to reload
     the checker after logging on to a network. Other resident anti-virus
     utilities force you to choose between protection before the network is
     started, or protection after the network is started, but not both.


     Command line options

     It is possible to specify options on the command line. The upper four
     options are always available, the other options are only available if
     TbFile is not already memory-resident.


     option     short explanation
     ---------- ----- -----------------------

     help       ?     display this helpscreen
     off        d     disable checking
     on         e     enable checking
     remove     r     remove TbFile from memory

     secure     s     all permissions denied
     allattrib  a     readonly check on all files
     compat     c     allow CPM style calls

     help (?)
     If you specify this option TbFile will show you the brief help as shown
     above.

     off (d)
     If you specify this option TbFile will be disabled, but it will remain
     in memory.

     on (e)
     If you use this option TbFile will be activated again after you disabled
     it with the 'off' option.

     remove (r)

                                     III - 46
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     This option can be used to remove the resident part of TbFile from your
     system's memory.  All memory used by TbFile
     will be released.
     Unfortunately, the removal of a TSR (like TbFile) is not always possi-
     ble.  TbFile checks whether it is safe to remove the resident part from
     memory. If it is not safe it just disables TbFile. A TSR can not be
     removed if another TSR has been started after it. If this happens with
     TbFile it will completely disable itself.

     secure (s)
     TbFile normally asks the user to continue or to cancel when a program
     tries to perform a suspicious operation. In some business environments
     however this choice should not be made by employees. By using option
     'secure' it is no longer possible to allow suspicious operations. It is
     also no longer possible to use options 'off' and 'remove'.

     allattrib (a)
     TbFile normally only protects the readonly attribute of executables
     (program files with the extension COM and EXE). If you want to have the
     readonly check on all files add option 'allattrib'. In this case you
     will always get an alarm when an attempt is made to remove the readonly
     attribute of any file.

     compat (c)
     DOS has still some CPM - an earlier operating system - functions left.
     No DOS program uses these functions anymore, but some viruses use these
     functions to bypass anti-virus software. TbFile closes these backdoors
     by default. Option 'compat' prevents this.


     Examples
          C:\utils\TbFile allattrib
     or:
          Device=C:\utils\TbFile.Exe allattrib


5.3. TbDisk

     The Purpose of TbDisk

     Many viruses try to damage the data on the disk. They accomplish this by
     formatting the disk, overwriting the FAT, swapping disk sectors, etc.
     Almost anything is possible.

     Another category of malicious software, known as 'bootsector virus
     droppers', installs a bootsector virus on the disk. The program itself
     is not a virus, so detection with virus scanners and other anti-viral
     software is very difficult. The only way to detect such programs is by
     monitoring their behavior.

     The main problem lies in the way these programs manage to avoid the
     usual DOS procedures - they go directly to the BIOS, the Basic In-

                                     III - 47
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     put/Output System. That is why you need TbDisk - to monitor the system
     and to ensure that no program can write directly to disk without permis-
     sion! It draws attention to any software that attempts to write directly
     to disk, thereby reducing the likelihood that a virus will remain
     unnoticed. TbDisk prevents viruses from damaging data on your disk and
     stops bootsector virus droppers in their tracks.

     TbDisk will come in handy, too, if you ever need to write protect a hard
     disk. This bonus feature often helps when testing new software.

     TbDisk not only informs you when a program tries to write directly to
     the disk, it also offers you the option to abort the program before it
     can cause any damage.

     Detection of 'stealth' techniques. TbDisk is able to detect attempts to
     single step through the BIOS handler, and even monitor the use of
     undocumented calls that could cause disk damage.

     TbDisk is able to distinguish whether DOS or an application makes direct
     write attempts via Int 13h. Direct writes are perfectly legal for DOS,
     but unusual for application software.

     TbDisk needs little maintenance. TbDisk uses the Anti-Vir.Dat records to
     determine if a program is allowed to write directly to the disk, inclu-
     ding popular disk utilities, which will have been recognized by TbSetup.
     In the absence of an Anti-vir.Dat record, TbDisk will ask your approval
     first and, if granted, updates the record accordingly in order to avoid
     repeated warnings about the same program.

     TbDisk is fully network compatible. It does not require you to reload
     the program after logging on to a network. Other resident anti-virus
     utilities force you to choose between either protection before the
     network is started, or protection after.


     How to use TbDisk

     Loading TBDisk

     Improper installation can cause excessive amounts of false alarms! If
     you want to install TbDisk in your Config.Sys or AutoExec.Bat file, it
     is highly recommended to use the 'install' option of TbDisk first. If
     the system continues to behave normally and TbDisk does not give false
     alarms when you copy files on your hard disk, TbDisk is installed
     correctly and you can remove option 'install'.


     TBDisk in your Install

     Failure to use option 'install' when you install TbDisk Config.Sys or
     AutoExec.Bat file may cause loss of data! Option 'install' causes TbDisk
     to allow all disk accesses, it will however pop-up a message like it

                                     III - 48
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     would do in normal mode. If no false alarms occur when you copy files on
     your hard disk, TbDisk is installed correctly and option 'install' can
     be removed.

     If TbDisk causes false alarms you should load TbDisk further ahead in
     your Config.Sys or AutoExec.Bat file, until it works as it should do.

     Unlike the other TBAV utilities it is recommended to load TbDisk after
     other resident software!  Failure to do so can cause excessive amounts
     of false alarms!


     TBDisk and MS-Windows

     TbDisk detects if Windows is starting up, and will switch itself into
     multi tasking mode if necessary. You can even disable TbDisk in one
     window without affecting the functionality in another window.  If you
     configured Windows to use fast 32-bit disk access you might need TbDisk
     option 'win32' if Windows displays an error-message.


     Command line options

     It is possible to specify options on the command line. The upper four
     options are always available, the other options are available only if
     TbDisk is not memory resident.


     option   short explanation
     ------   ----- ------------------

     help      ?    display this helpscreen
     remove    r    remove TbDisk from memory
     off       d    disable checking
     on        e    enable checking
     wrprot    p    make hard disk write protected
     nowrprot  n    allow writes to hard disk

     win32     w    allow Windows 32bit disk access
     secure    s    deny access without asking
     nostealth a    do not detect stealth disk access
     notunnel  t    do not detect tunneling
     install   i    installation test mode


     help (?)
     If you specify this option TbDisk will show you the brief help as shown
     above. Once TbDisk has been loaded the help option will not show all
     options anymore.

     remove (r)


                                     III - 49
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     This option can be used to remove the resident part of TbDisk from your
     system's memory.  All memory used by TbDisk will be released.
     Unfortunately, the removal of a TSR (like TbDisk) is not always possi-
     ble.  TbDisk checks whether it is safe to remove the resident part from
     memory. If it is not safe it just disables TbDisk. A TSR can not be
     removed if another TSR has been started after it. If this happens with
     TbDisk it will completely disable itself.

     off (d)
     If you specify this option TbDisk will be disabled, but it will remain
     in memory.

     on (e)
     If you use this option TbDisk will be activated again after you disabled
     it with the 'off' option.

     wrprot (p)
     Hard disks are more difficult to protect against writing than floppies,
     which adds considerably to the risks involved when, for instance,
     testing new software. Sometimes you might want to find out what this
     software will do to your hard disk and how this could possibly affect
     your valuable data. With option 'wrprot' it will be safer to do so.
     Whenever a program wishes to write to a protected disk you will receive
     a message such as:

     "Write protect error writing drive C: A)bort, R)etry, I)gnore?"

     You may then take appropriate action.

=>   Note: A software write protection solution is not absolutely reliable.
     It can be bypassed, but, fortunately, viruses that are actually capable
     to do so are few and far between. It can be a valuable shield against
     most malicious software, despite its shortcomings.

     nowrprot (n)
     You can use this option to undo the option 'wrprot'.

     win32 (w)
     Windows 386 Enhanced Mode uses some undocumented DOS calls to retrieve
     the original BIOS disk handler when 32-bit disk access has been enabled.
     Since TbDisk guards these calls, 32-bit disk access will no longer be
     possible, unless you specify option 'win32' when TbDisk is initialized.

=>   Note: Use this option, which reduces antiviral security to some extent,
     only in Windows 386 Enhanced Mode with fast 32-bit disk access enabled!

     secure (s)
     TbDisk normally asks whether the user wants to continue or cancel when a
     program tries to perform direct disk access. In some business environ-
     ments, however, this should not be left up to employees. Option 'secure'
     disables direct disk access permission to new or unknown software. It
     also disables option 'off' and 'remove'.

                                     III - 50
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     nostealth (a)
     TbDisk tries to detect direct calls into the BIOS. If such an  attempt
     occurs, TbDisk pops up with a message that the disk is accessed in an
     unusual way. If this feature causes false alarms, you can use this
     option to turn it off.

     notunnel (t)
     One of TbDisk's regular tasks is to detect tunneling attempts on the
     part of viruses. 'Tunneling' is a technique used by viruses to determine
     the location of the BIOS system code in memory, and to use that address
     to communicate with the BIOS directly. This will inactivate all TSR
     programs, including resident anti-virus software. TbDisk can detect
     'tunneling' attempts in advance and informs you about this. Some other
     antiviral products employ tunneling techniques also to bypass resident
     viruses, causing a false alarm. If you make use of such other anti-virus
     products, you may use the option 'notunnel' to disable tunneling-detec-
     tion.

     install (i)
     Incorrect installation may result in a large number of false alarms. You
     should use option 'install' when installing TbDisk, which will reduce
     the risk of cancelling a valid disk write operation as a result of false
     alarms.


     TbDisk in process

     What is Direct Disk Access?
     Programs often access files, usually through the operating system (DOS).
     Whenever a program wants to update a file, for example, it asks DOS to
     write the data to disk. There are however also possibilities to write to
     a disk without using DOS. This is called 'direct disk access'.

     Normal programs do not write to the disk directly. However, there are
     some programs that need to write to disk directly. Programs in this
     category are:

     -    Format utilities. A disk can only be formatted by direct disk
          access.

     -    Disk diagnosis utilities (such as the NORTON disk doctor, DOS
          chkdsk, etc.)

     -    Disk optimizers.

     As many viruses are able to perform direct disk access as well, it is
     essential to have some control over all this. TbDisk can distinguish
     between legitimate programs and a virus with the help of the Anti-
     Vir.Dat records, generated by TbSetup under your guidance.


     Detecting direct disk accesses

                                     III - 51
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Whenever TbDisk pops up with the message that a program accesses to the
     disk directly, consider its purpose carefully. While it is perfectly
     acceptable for a format utility or a disk optimizer to format or edit
     disk sectors, the same cannot be said about a word processor or databa-
     se. When TbDisk warns you that a spreadsheet or some other 'normal'
     program is about to format a sector, you can be sure that something is
     wrong. Terminate the program -pronto!- and check things out with a virus
     scanner before the worst can happen.













































                                     III - 52
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


6. TBAV Tools


6.1. TbUtil

     The Purpose of TbUtil

     TbUtil provides a defense against partition table and bootsector viru-
     ses:

     TbUtil copies the partition table, bootsector and CMOS data area into a
     file. On a regular base you can use TbUtil to compare both the current
     and the copied versions of the partition table, bootsector and CMOS data
     area. After a (virus) accident you can restore the copy with the TbUtil
     program.

     TbUtil removes a partition table virus without having to low-level
     format the hard disk, even if there is no backup of the partition table.

     TbUtil removes bootsector viruses.

     TbUtil creates a partition table that has some first-line virus defenses
     built-in.

     TbUtil replaces the infected or clean bootsector by a safe TBAV boots-
     ector.


     What is a partition table?

     A partition is a logical drive on a hard disk. A physical hard disk can
     contain multiple DOS partitions. Every DOS partition has its own drive
     ID (eg. C: D: E:). The partition table contains the disk lay-out and the
     start and end cylinder of every partition. The partition table also
     carries information about the operating system of a partition and which
     partition should be used to boot. The partition table is always located
     at the first sector of the hard disk. It is called the "Master Boot
     Record".


     No format needed

     Unlike most file viruses, partition table viruses are hard to remove.
     The only solution is to low-level format the hard disk and to make a new
     partition table, or to make use of undocumented DOS commands.

     TbUtil makes a backup of the partition table and bootsector, and will
     use this backup to compare and restore both the original partition table
     and bootsector once they have been infected. You don't have to format
     your disk anymore to get rid of a partition table or bootsector virus.
     The program can also restore the CMOS configuration.


                                     III - 53
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     If desired TbUtil replaces the partition table code with an immunized
     partition table, containing facilities against viruses. The TbUtil
     partition code will be executed before the bootsector gains control, so
     it is able to check the bootsector in a clean environment. Once the
     bootsector is executed it is difficult to check it, because the virus is
     already resident in memory and can fool any protection. Instead of
     booting from a clean DOS diskette just to inspect the bootsector, the
     TbUtil partition code performs a CRC calculation on the bootsector just
     before control is passed to it.

     If the bootsector has been modified the TbUtil partition code will warn
     you about this. The TbUtil partition code also checks the RAM layout and
     informs you when it has changed. It does this every time you boot from
     your hard disk.

     TbUtil can replace infected and clean diskette bootsectors by a new
     bootsector, which has advantages over the standard bootsector. It has
     bootsector virus detection capabilities, it performs a sanity check, and
     it offers you the possibility to redirect the boot process to the hard
     disk without opening the diskette drive door.


     How to use TbUtil

     The TbUtil module contains several programs, which can be executed from
     the TbUtil menu or in case of an emergency from a TbUtil recovery
     diskette using the DOS command line. TbUtil allows some additional menu
     options. These options are discussed below. The corresponding command
     line parameters are listed in chapter 6 of this section.


     The system maintenance menu

     This menu contains the actual TbUtil program. The program takes care of
     saving, restoring or comparing the system configuration of your PC. The
     backup system configuration is stored on a diskette in a file with
     either a default name or a name you can specify yourself.

=>   Warning: You can only restore a system configuration datafile on the
     machine which created the datafile. If not, restoring such a file will
     make your PC inaccessible!












                                     III - 54
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     +----Main menu-----+
     |  Confi+-----------TbUtil menu-----------+
     |  TbSet|  Syste+-------System maintenance-------+
     |  TbSca|  Immun|  Execute TbUtil                |
     |  TbUti|  Immun|  Describe this machine         |
     |  TbCLe|  Immun|  Save system configuration     |
     |  TBAV +-------|v Compare system configuration  |
     |  Documentation|  Restore system configuration  |
     |  Register TBAV|v process CMOS memory           |
     |  Quit and save|v process Partition code        |
     |  eXit (no save|v process Bootsector            |
     +---------------+--------------------------------+


     Execute TbUtil

     Before activating this option, you must select one of the optional
     functions: save, compare or restore the system configuration. Toggle to
     the desired option and type <ENTER>. A checkmark will indicate the
     selected option.


     Describe this machine

     Enter a meaningful description of the machine. Enter something like "AT
     12MHz, 4Mb, room 12, Mr. Smith". You do NOT have to remember it, TbUtil
     will display it on the screen when comparing or restoring, but it helps
     you to verify that the data file belongs to the machine.


     Save system configuration

     This option stores the partition table, bootsector and CMOS data area
     into the TbUtil data file.

=>>  Attention! Since the PC is completely inaccessible to DOS if the parti-
     tion table gets damaged, it is HIGHLY RECOMMENDED to store both the
     TbUtil data file and the program TbUtil.Exe itself on a diskette! It is
     not nice if the partition table is destroyed and the only solution to
     the problem resides on the same inaccessible disk...

     When loading TbUtil from the command line you must specify a filename
     after the 'store' option. Using the TBAV menu, you may use the default
     filename 'TBUTIL.DAT'. If you own more than one PC, it is advisable to
     create one TbUtil diskette with all TbUtil data files of all your PC's
     on it. Use the extension of the file for PC identification, eg.:

          a:TbUtil.<number>





                                     III - 55
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     Compare system configuration

     This option enables you to check on a regular basis that everything is
     still OK. If you specify this option TbUtil will compare the information
     in the TbUtil data file against the partition table, bootsector and CMOS
     data area. It will also  show the comment stored in the data file. And
     of course, if you use this option you will also be guaranteed that the
     TbUtil data file is still readable.


     Restore system configuration

     This option enables you to restore the partition table, bootsector, and
     CMOS data area. It will ask you to confirm that the data file belongs to
     the current machine. Finally it will restore the partition table,
     bootsector of the partition to be used to boot, and the CMOS data area.


     Process Partition code/Bootsector/CMOS memory

     TbUtil will by default restore the partition code, bootsector and CMOS
     if option 'restore' is specified. If you use one of the above mentioned
     options in combination with the option 'restore' TbUtil will restore
     just the items specified.



     The TbUtil menu

     Apart from the System maintenance menu, the TbUtil menu contains some
     useful programs to prevent bootsector virus infection or to remove these
     viruses.

     +----Main menu-----+
     |  Confi+-----------TbUtil menu-----------+
     |  TbSet|  System maintenance menu       >|
     |  TbSca|  Immunize/clean bootsector A:   |
     |  TbUti|  Immunize/clean bootsector B:   |
     |  TbCLe|  Immunize/clean partition code  |
     |  TBAV +---------------------------------+
     |  Documentation  >|
     |  Register TBAV   |
     |  Quit and save   |
     |  eXit (no save)  |
     +------------------+


     Immunize/clean diskette

     You can use the 'immunize' program to clean diskettes infected by a
     bootsector virus or to replace the standard bootsector by a bootsector
     which has advantages over the original one:

                                     III - 56
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     It has virus detection capabilities. The bootsector will check that it
     is still located on the correct place on the diskette, and that Int 13h
     and/or Int 40h are still located in system ROM. This makes it possible
     to detect even 'stealth' and bootsector viruses.

     The TBAV bootsector is able to load the system files if they are availa-
     ble on the disk, but if the DOS system files are not on the disk the
     TBAV bootsector will present a small menu and offers you two possibili-
     ties: retry the boot operation with another diskette, or to boot from
     the harddisk. If the user selects the latter, it is not required to open
     the diskette drive door.


     Immunize/clean hard disk

     This is a very powerful option, which can be used to clean an infected
     partition table if there is no TbUtil data file. It replaces the exis-
     ting partition table code by a new partition routine containing some
     virus detection capabilities. The original partition code will be saved
     in a file. You have to execute TbUtil from a floppy drive or you have to
     specify the name of the file (the specified drive should be a diskette
     drive) to store the original partition code.

     If the original partition table is completely damaged and cannot be used
     to build a new one, TbUtil will scan the entire disk for information
     about the original disk layout. TbUtil will also search for TbUtil data
     files on the hard disk. It is however recommended to store the data file
     on a diskette, although it is a good idea to keep a copy of it on the
     hard disk. Just in case!

     If your system configuration changes, i.e. you update your DOS version,
     or change the amount of memory, you need to update the information
     stored in the immune partition as well. You can do this by using this
     option.

     In the unlikely event that the system does not boot properly, you can
     restore the original partition table using the TbUtil 'restore' option
     or by using the DOS 5+ 'FDISK /MBR' command (which will create a new
     partition table).

     If the new partition code works properly, you should make a back-up copy
     of it on a diskette using the TbUtil 'store' option.


     Command line options

     TbUtil recognizes option-characters and option-words. The words are
     easier to remember, and they will be used in this manual for convenien-
     ce.




                                     III - 57
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     option     parameter   short explanation
     ------     ---------   ----  --------------------

     immunize   <drive>       im  Immunize/Clean boot/MBR of <drive>
     getboot    <drive>       gb  Save bootsector into file
     store      [<filename>]  st  Store system information
     restore    [<filename>]  re  Restore system information
     compare    [<filename>]  co  Compare system information
     Sub-options of option 'Immunize':
     norepeat                 nr  Do not ask for next diskette
     nomem                    nm  Do not check for amount of RAM
     batch                    ba  Do not prompt to insert a disk
     Sub-options of option 'Store':
     description<descr.>      de  Add description to data file
     Sub-options of option 'Restore':
     part                     pt  Restore partition table
     boot                     bo  Restore bootsector of HD
     cmos                     cm  Restore CMOS


     Below, the command line options are explained briefly.

     immunize diskette <drive> (im)
     You can use the 'immunize' program to clean diskettes infected by a
     bootsector virus or to replace the standard bootsector by a bootsector
     which has advantages over the original one:

     -    It has virus detection capabilities. The bootsector will check that
          it is still located on the correct place on the diskette, and that
          Int 13h and/or Int 40h are still located in system ROM. This makes
          it possible to detect even 'stealth' and bootsector viruses.

     -    The TBAV bootsector is able to load the system files if they are
          available on the disk, but if the DOS system files are not on the
          disk the TBAV bootsector will present a small menu and offers you
          two possibilities: retry the boot operation with another diskette,
          or to boot from the harddisk. If the user selects the latter, it is
          not required to open the diskette drive door.


     Immunize c: (im c:)
     This is a very powerful option, which can be used to clean an infected
     partition table if there is no TbUtil data file. It replaces the exis-
     ting partition table code by a new partition routine containing some
     virus detection capabilities. The original partition code will be saved
     in a file. You have to execute TbUtil from a floppy drive or you have to
     specify the name of the file (the specified drive should be a diskette
     drive) to store the original partition code.

     If the original partition table is completely damaged and cannot be used
     to build a new one, TbUtil will scan the entire disk for information
     about the original disk layout. TbUtil will also search for TbUtil data

                                     III - 58
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     files on the hard disk. It is however recommended to store the data file
     on a diskette, although it is a good idea to keep a copy of it on the
     hard disk. Just in case!

     If your system configuration changes, i.e. you update your DOS version,
     or change the amount of memory, you need to update the information
     stored in the immune partition as well. You can do this by using this
     option. In the unlikely event that the system does not boot properly,
     you can restore the original partition table using the TbUtil 'restore'
     option or by using the DOS 5+ 'FDISK /MBR' command (which will create a
     new partition table). If the new partition code works properly, you
     should make a back-up copy of it on a diskette using the TbUtil 'store'
     option.

     getboot <drive> (gb)
     With this option you can copy the bootsector of the specified drive into
     a file.

     store [<filename>] (st)
     This option stores the partition table, bootsector and CMOS data area
     into the TbUtil data file.

=>>  Attention! Since the PC is completely inaccessible to DOS if the parti-
     tion table gets damaged, it is HIGHLY RECOMMENDED to store both the
     TbUtil data file and the program TbUtil.Exe itself on a diskette! It is
     not nice if the partition table is destroyed and the only solution to
     the problem resides on the same inaccessible disk...

     When loading TbUtil from the command line you must specify a filename
     after the 'store' option. Using the TBAV menu, you may use the default
     filename 'TBUTIL.DAT'. If you own more than one PC, it is advisable to
     create one TbUtil diskette with all TbUtil data files of all your PC's
     on it. Use the extension of the file for PC identification, eg.:
     a:TbUtil.<number>

     restore [<filename>] (re)
     This option enables you to restore the partition table, bootsector, and
     CMOS data area. It will ask you to confirm that the data file belongs to
     the current machine. Finally it will restore the partition table,
     bootsector of the partition to be used to boot, and the CMOS data area.

     compare [<filename>] (co)
     This option enables you to check on a regular basis that everything is
     still OK. If you specify this option TbUtil will compare the information
     in the TbUtil data file against the partition table, bootsector and CMOS
     data area. It will also  show the comment stored in the data file. And
     of course, if you use this option you will also be guaranteed that the
     TbUtil data file is still readable.

     norepeat (nr)
     TbUtil will prompt you for next diskette after you immunized a diskette.
     With option 'norepeat' you can disable this.

                                     III - 59
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     nomem (nm)
     If you specify this option when you are immunizing your partition code,
     the partition code will skip the RAM check while booting. This is
     necessary for some systems which change the memory setup during the boot
     process.

     batch (ba)
     If you specify this option when you are immunizing diskettes, TbUtil
     will not prompt you to insert a disk but assume that there is a disk
     inserted.

     description <descr.> (de)
     Enter a meaningful description of the machine. Enter something like "AT
     12MHz, 4Mb, room 12, Mr. Smith". You do NOT have to remember it, TbUtil
     will display it on the screen when comparing or restoring, but it helps
     you to verify that the data file belongs to the machine.

     part (pt)
     boot (bo)
     cmos (cm)

     TbUtil will by default restore the partition code, bootsector and CMOS
     if option 'restore' is specified. If you use one of the above mentioned
     options in combination with the option 'restore' TbUtil will restore
     just the items specified.


     Examples
          TbUtil store
          TbUtil st
          TbUtil store A:TbUtil.Dat
          TbUtil store A:TbUtil.Dat description = "Test machine"
          TbUtil compare A:TbUtil.Dat
          TbUtil restore A:TbUtil.Dat part cmos
          TbUtil immunize A:
          TbUtil immunize C: nomem
          Type A:TbUtil.Dat


     Using the anti-virus partition

     If you install the Thunderbyte partition code (TbUtil immunize), you
     will see the following while booting a clean system:


          Thunderbyte anti-virus partition v6.03 (C) 1993 Thunderbyte BV.

          Checking bootsector CRC -> OK!
          Checking available RAM -> OK!
          Checking INT 13h -> OK!



                                     III - 60
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     If there is a virus in the bootsector or partition table you will see
     this:

          Thunderbyte anti-virus partition v6.03 (C) 1993 Thunderbyte BV.

          Checking bootsector CRC -> OK!
          Checking available RAM -> Failed!

          System might be infected. Continue? (N/Y)


     Some other messages that can be displayed are "No system.", which means
     that there is no active partition on the disk, and "Disk error" of which
     the meaning is obvious.


     Using the TbUtil diskette

     Take a new diskette, format it as a bootable diskette (eg. by using the
     dos 'format /s' command). Copy the TbUtil files onto the diskette:

          copy tbutil.* a:

     The TbUtil files you need are:
          tbutil.exe
          tbutil.lng


     Trouble-Shooting

     In case of an emergency, eg. a damaged or infected partition table, you
     should boot from the TbUtil diskette. Subsequently, you start the TbUtil
     program, using the 'immunize' option:

          a:\tbutil immunize c:


6.2. TbLog

     The purpose of TbLog

     TbLog is a TBAV log file utility. It writes a record into a log file
     whenever one of the resident TBAV utilities pops up with an alert
     message. Also when TbScan detects a virus a record will be written.

     This utility is primarily intended for network users. If all workstati-
     ons have TbLog installed and configured to maintain the same log file,
     the supervisor is able to keep track of what is going on easily. When a
     virus enters the network he is able to determine which machine introdu-
     ced the virus, and he can take action in time.



                                     III - 61
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     A TbLog record consists of the timestamp on which the event took place,
     the name of the machine on which the event occured, and an informative
     message about what happenend and which files were involved. The informa-
     tion is very comprehensive and takes just one line.


     How to use TbLog

     Just like the other TBAV utilities TbLog can be loaded in the Config.Sys
     or AutoExec.Bat file, after the TbDriver invokation.

     TbLog should be installed on every workstation. If you want to use all
     workstations to maintain the same log file, it is recommended to load
     TbLog after the network has been started.

     TbLog will by default maintain a log file with the name TbLog.Log in the
     TBAV directory. If you want to use another filename or in on another
     disk or directory you can specify a filename on the command line of
     TbLog. In a network environment it is highly recommended to put the log
     file on a server disk.


     Command line options

     It is possible to specify options on the command line. The upper five
     options are always available, the other options are available only if
     TbLog is not memory resident.

     option   parameter   short explanation
     ----------------------------------------------------
     help                  ?    display this helpscreen
     remove                r    remove TbLog from memory
     on                    e    enable TbLog
     off                   d    disable TbLog
     test                  t    log test message

     machine = <machine>   m    name of your machine
     secure                s    do not allow removal


     help (?)
     If you specify this option TbLog will show you the brief help as shown
     above.

     off (d)
     If you specify this option TbLog will be disable, but it will remain in
     memory.

     on (e)
     If you use this option TbLog will be activated again after you disabled
     it with the 'off' option.


                                     III - 62
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.               SECTION III


     remove (r)
     This option can be used to remove the resident part of TbLog from your
     system's memory.  All memory used by TbLog will be released. Unfortuna-
     tely, the removal of a TSR (like TbLog) is not always possible.  TbLog
     checks whether it is safe to remove the resident part from memory. If it
     is not safe it just disables TbLog. A TSR can not be removed if another
     TSR has been started after it. If this happens with TbLog it will
     completely disable itself.

     test (t)
     This option can be used to record a test message. If you use option
     'test' at the initial invocation of TbLog, it will record the time and
     machinename into the log file. If you use the 'test' option afterwards
     it will just put a test message in the log file.

     machine (m)
     With this option you can specify the name of the machine on which TbLog
     is loaded. This machine name will appear in the log file. On NetBios
     compatible machines TbLog will by default use the network machine name.
     On other networks - such as Novell - you have to enter the network name
     on the TbLog command line.

     secure (s)
     If you specify this option it is not possible anymore to use options
     'off' and 'remove'.


     Examples:
          C:\TBAV\TbLog f:\security\Tblog.log secure machine=DESK3
     or:
          Device=c:\TBAV\TbLog.Exe x:\logs\tblog.log machine=JOHN test






















                                     III - 63
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


SECTION IV. ADVANCED USER INFORMATION


1. Memory requirements

     Free memory needed:
                              min.                min.
                              to be               after
                              loaded:             termination:

     TbScan                   200 Kb
     TbScanX                  10 Kb               800 bytes
     TbCheck                  4 Kb                600 bytes
     TbUtil                   64 Kb
     TbClean                  96 Kb

     TbMem                    4 Kb                600 bytes
     TbFile                   5 Kb                1 Kb
     TbDisk                   4 Kb                800 bytes
     TbDriver                 5 Kb                3 Kb
     TbLog                    5 Kb                1 Kb


     If you decide to use a log file TbScan will need an additional 16 Kb of
     memory for the log file buffer. If TbScan uses its own built-in file
     system it uses additional memory to keep the FAT in memory. Note that
     the memory requirements are independent of the number of signatures. The
     current memory requirements are adequate to manage at least 2500 signa-
     tures.

     The amount of memory TbScanX requires depends on the number of signatu-
     res. With all features enabled TbScanX uses 30 Kb of memory when scan-
     ning for 1400 family signatures. If you enable swapping TbScanX normally
     uses only 1Kb of memory. You can swap to EMS and XMS memory. Of course
     the remaining kilobyte of TbScanX can be loaded in upper memory.

     In the heuristic cleaning mode TbClean needs much more memory, depending
     on the size of the infected file. TbClean can also use expanded memory
     (EMS).


     Reducing memory requirements

     Most PC users try to maintain as much free DOS memory as possible. The
     memory resident TBAV utilities (TbScanX, TbCheck, TbMem, TbFile, TbDisk
     and TbDriver) are designed to use only a little amount of DOS memory. To
     decrease the memory requirements of these utilities even further do the
     following:

     Load the program from within the Config.Sys file. If loaded as a device
     driver it has no Program Segment Prefix (PSP), which saves 256 bytes for
     each TBAV utility.

                                      IV - 1
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     If you load the TBAV utilities from within the Autoexec.Bat file, load
     them before establishing environment variables. DOS maintains a list of
     environment variables for every resident program, so keep this list
     small while installing TSRs. Once all TSRs are installed you can define
     all environment variables without affecting the memory requirements of
     the TSRs.

     By using one of the options 'ems' or 'xms' TbScanX swaps itself to non-
     DOS memory, leaving only 1 Kb of code in DOS memory. Swapping to expan-
     ded memory ('ems') is preferred.

     If you have DOS 5 or higher try to load the program into an upper memory
     block using the "loadhigh" or "devicehigh" commands. It is recommended
     to enable swapping also to limit the usage of upper memory.

     Use one of the processor specific versions of the relevant TBAV utility.
     They all consume less memory than the generic versions. Processor
     optimized versions are available on any ThunderBYTE support BBS.

     Consider the following memory saving options:
     TbDriver:      NoStack
     TbMem:         NoCancel
     TbScanX:       NoBoot, EMX, XMS, wild






























                                      IV - 2
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


2. TbSetup


2.1. Anti-Vir.Dat design considerations

     ThunderBYTE Anti-Virus expects every directory on your system with
     executable files to have its own Anti-Vir.Dat file. Some other anti-
     virus products maintain a somewhat similar 'fingerprint' list of all
     executable files, but in one large file rather than a separate file in
     every directory. TBAV contains a separate file in every directory
     instead of one file with all file information because of the following:

     One file in every directory will ease maintenance. If you want to remove
     a complete product, the accompanying Anti-Vir.Dat file can be removed as
     well.

     It will consume less disk space because path information need not to be
     stored in the information file.

     The TBAV utilities will perform faster because they do not have to
     search through a huge file to locate the information of one specific
     file.

     Installation is easier and more reliable in network environments. On
     networks it is not unusual that the same files have different drive ID's
     on different workstations. In case of only one information file the
     drive-ID's should be stored as well, so every workstation should main-
     tain its own list. The supervisor would easily lose control in this
     situation.


2.2. Format of TbSetup.Dat

     Editing the TbSetup.Dat file is useful to TBAV site installation (see
     IV-8). Therefore, some information on the format of this file is neces-
     sary. The format of the TbSetup.Dat file is very simple. Empty lines, or
     lines starting with a semi-colon (';') or percent symbol, are either
     ignored or treated as comment lines. The lines with a preceding percent
     symbol are also displayed in TbSetup's upper window.

     Every entry in the TbSetup.Dat file has four items:

     The filename. The filename must be written in capital letters and
     without spaces.

     The length of the file in hexadecimal notation. This field may contain a
     single asterisk ('*') if an exact filelength match is not required.

     The file's 32-bit CRC in hexadecimal notation. A single asterisk is
     allowed if an exact checksum match is not required.



                                      IV - 3
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     The hexadecimal number representing flags that should be set when the
     listed file is found on the system.

     The rest of the line may be used for a brief comment.

     You may use the following flags:

     bit 0  (0001)  Do not perform heuristic analysis
     bit 1: (0002)  Ignore CRC changes (self-modifying file)
     bit 2: (0004)  Scan for all signatures (lan remote boot file)
     bit 3: (0008)  Do not change read-only attribute of this file
     bit 4: (0010)  The program stays resident in memory
     bit 5: (0020)  The program performs direct disk access
     bit 6: (0040)  Program is allowed to remove read-only attributes
     bit 15:(8000)  Interrupt rehook required for TbDriver.Exe


     This is what the entries in TbSetup.Dat look like:

          ; filename   Length 32-bit CRC  Flags  Comment

          ; Files that trigger the heuristic alarm of TbScan:
          4DOS.COM     19FEA         *    0001   ;4Dos 4.0a
          AFD.COM      0FEFE  4B351A86    0001   ;AFD debugger
          ARGV0FIX.COM 001D8  431E70C0    0001   ;Argv[0]fix
          EXE2COM.EXE  00BEA  49276F89    0001   ;Exe to Com conv. utility
          KILL.EXE     00632  74D41811    0001   ;PcTools 6.0 utility
          WATCH.COM    003E1  2353625D    0001   ;TSR monitoring utility

          ; Files that need to be scanned completely, for ALL viruses:
          NET$DOS.SYS      *         *    0004   ;Disk image Novell boot

          ; Files without fixed checksum due to internal config area's:
          Q.EXE            *         *    000A    ;Qedit (all versions)
          TBCONFIG.COM     *         *    000A    ;all versions


     Defining new entries

     If you have any files that should be included in the list, please let us
     know! We would like to receive a copy to enhance our products and keep
     TbSetup.Dat up to date. Candidates for inclusion would be any program
     that triggers the heuristic analysis of TbScan. Whenever you choose
     'V)alidate program' in the TbScan message window, you will find that on
     subsequent occasions TbSetup displays the value '0001' in the flags
     field. If your company has many files like this installed on multiple
     machines, you may want to include these files in the TbSetup.Dat file
     yourself. In order to do that execute TbSetup for the file in question
     and make a note of its filelength and 32-bit CRC, as displayed on the
     screen. Then edit the TbSetup.Dat file entering the exact filename, the
     file length and the CRC number, plus the number of any flags you wish to


                                      IV - 4
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     set for that file. If you now use TbSetup on another machine it will set
     the appropriate flags automatically.

=>   Note:You may manually set or clear a flag field value when executing
     TbSetup at the DOS prompt with option 'set' and 'reset' as follows:

          TBSETUP TEST.EXE SET=0001


2.3. TBAV site installation

     If you have to install the TBAV utilities on a lot of machines in one
     company, it would be tedious to invoke for instance every single TSR and
     disk utility on each machine in order to 'teach' TBAV which programs are
     valid and which are not. Fortunately, this is not necessary. In the
     present section, three examples are presented on how to simplify instal-
     lation on several machines.

     1.   If a resident utility named, for instance, TSRUTIL.EXE is used
          throughout the company, you can predefine permission by using
          TbSetup to determine the length and CRC of the program. Now put the
          name of this program along with the other information in the file
          TbSetup.Dat and assign the value '0010' to it.

     Example:
          TSRUTIL.EXE  01286  E387AB21  0010  ;Our TSR utility


     2.   If a disk utility named, for instance, DISKUTIL.EXE is used throug-
          hout the company, you can predefine permission by using TbSetup to
          determine the length and CRC of the program. Now put the name of
          this program along with the other information in the file TbSetup.
          dat and assign the value '0020' to it.

     Example:
          DISKUTIL.EXE  01286  E387AB21  0020  ;Our DISK utility

     If you now execute TbSetup on every machine (you have to do this anyway)
     it will recognize this utility and it will set the disk access permissi-
     on flag for TbMem / TbDisk automatically.

     3.   If a utility named, for instance, UTIL.EXE is used throughout the
          company which causes TbScan to give false positives, you can
          predefine TbSetup to avoid heuristic scanning of the relevant
          program. Put the name of this program along with the other informa-
          tion in the file TbSetup.Dat and assign the value '0001' to it.







                                      IV - 5
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     Example:
          UTIL.EXE  01286  E387AB21  0001  ;Our utility

     If you now execute TbSetup on every machine (you have to do this anyway)
     it will recognize this utility and TbScan will not perform heuristic
     scanning.

     Also consult the TbSetup.Dat file.













































                                      IV - 6
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


3. TbScan

3.1. Heuristic scanning

     TbScan is not just a signature scanner. It also disassembles the file
     being processed, for the following purposes:

     1)   By disassembling the file the scanner can restrict itself to the
          area of the file where the virus might reside, reducing false
          alarms and speeding up the process.

     2)   It makes it possible to use the algorithmic detection method on
          encrypted viruses whose signatures would otherwise remain invisible
          to the scanner.

     3)   And it makes it possible to detect suspicious instruction sequen-
          ces.

     The detection of suspicious instruction sequences is named 'heuristic
     scanning'. It is a very powerful feature that enables you to detect new
     or modified viruses and to verify the results of the signature scan. You
     no longer have to rely on the scanner's publisher having the same virus
     as you might have. In normal cases a scanner can only find a virus if
     the scanner's publisher did have a sample of that virus, in order to
     make a suitable signature. With heuristic scanning a signature is no
     longer required, enabling the scanner to detect yet unknown viruses. You
     should not underestimate the importance of heuristic scanning, since
     every month at least 50 new viruses are reported. It is very unlikely
     that a publisher is the first one to get these new viruses...


     Heuristic level 1                       Heuristic level 2
     ------------------------------------------------------------
     Always enabled                          Only with option 'heuris
                                             tic' or after a virus has been
                                             found.
     Detects 50% of the unknown viruses.     Detects 90% of the viruses
     Almost never causes false alarms.       Causes a few false alarms.
     Displays 'Probably infected'            Displays 'Might be infec
                                             ted'


     TEST.EXE <scanning...>         OK  (no flags)
     TEST.EXE <scanning...> R       OK  (nothing serious)
     TEST.EXE <scanning...> FRM         might be infected by unknown virus
     TEST.EXE <scanning...> FRALM#      probably infected by unknown virus

     How does heuristic scanning actually work? Every program contains
     instructions for the PC's processor. By looking into the file's contents
     and by interpreting the instructions TbScan is able to detect the
     purpose of these instructions. If the purpose seems to be to format a
     disk, or to infect a file, TbScan issues a warning. There are a lot of

                                      IV - 7
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     instruction sequences which are very common for viruses, but very
     uncommon for normal programs. Every suspicious instruction sequence is
     assigned to a character: a heuristic flag. Every heuristic flag denotes
     a score. If the total score exceeds a predefined limit, TbScan assumes
     the file contains a virus.

     There are actually two predefined limits: the first one is quite sensi-
     tive and can be reached by some normal innocent programs. If this limit
     is reached, TbScan highlights the heuristic flags that are displayed on
     the screen and increases the 'suspected items' counter. TbScan does not
     indicate the existence of a virus, unless you have specified the 'heu-
     ristic' option. If you do have specified this option, TbScan tells you
     the file 'Might be infected by an unknown virus'.

     The second heuristic limit will be triggered by a lot of viruses, but
     not by normal programs. If this limit is reached TbScan tells you that
     the file is 'Probably infected by an unknown virus.'

=>   Note: TbScan performs heuristic analysis only nearby the entry-point of
     a file. Therefore, TbScan does not detect direct writes to disk by some
     disk utilities nor does TbScan detect some programs as TSR programs.
     This is just the result of a specific approach to minimize false alarms.
     In case of a virus, the offending instructions are always nearby the
     entry-point (except when the virus is over 10Kb in size) so TbScan will
     detect suspicious phenomenons in these situations anyway.


3.2. Integrity checking

     TbScan will perform integrity checking while scanning. You have to use
     TbSetup to generate the Anti-Vir.Dat files. Once these files exist on
     your system TbScan will check that every file being scanned matches the
     information maintained in the Anti-Vir.Dat files. If a virus infects a
     file, the maintained information will not match anymore with the now
     changed file, and TbScan will inform you about this. There are no
     (command line) options to enable this feature: TbScan will perform
     integrity checking automatically if it detects the Anti-Vir.Dat files.
     Note that TbScan only reports file changes that could indicate a virus.
     Internal configuration areas of program files may also change, but
     TbScan does normally not report this. However, if a file gets infected
     with any virus -known or unknown - the vital information will change and
     TbScan will indeed report it to you!

     It is however possible that the checked file changes itself or changes
     frequently due to another cause. In this case you might want to exclude
     the program from integrity checking to avoid future false alarms. TbScan
     will offer you an additional menu option: 'V)alidate program'. For more
     information about this menu option consult 'Program validation' (page 6
     of this section).




                                      IV - 8
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


3.3. Program validation

     This chapter only applies if you use TbSetup to generate the Anti-
     Vir.Dat records. Without these records program validation is not an
     option.

     TbScan will perform as intended on most programs. There are some pro-
     grams, however, that require special attention in order to avoid false
     alarms. Most of these programs are recognized automatically by the
     TbSetup program. Nevertheless it is certainly possible your PC contains
     some program files which trigger the heuristic alarm of TbScan and/or
     programs files which change frequently.

     If an 'infection' has been found with the heuristic analysis or integri-
     ty checking only and if there is an Anti-Vir.Dat record available,
     TbScan offers an additional option in its virus-alert window:

          'V)alidate program'

     If you are convinced that the indicated program does not contain a
     virus, you can press 'V' to set a flag in the program's record. This
     makes it possible to avoid future false alarms.

     There are two validation modes. If TbScan alarms you due to a file
     change, the validation applies to future file changes only. If the alarm
     is due to heuristic analysis, the validation only applies to heuristic
     results. If the file is excluded from heuristic analysis the file will
     still be checksummed.  If the file is excluded from integrity checking
     TbScan will still perform heuristic analysis on the file.

=>   Note: if you replaced a file (software upgrade) and you did not use
     TbSetup, TbScan will pop-up its virus alert window to inform you about
     the file change. Do not select the validation option in this case,
     because this would exclude the file for future integrity checking. You
     should abort TbScan and execute TbSetup on the changed file(s) instead.


3.4. The algorithms

     When TbScan processes a file it will display either 'Looking', 'Chec-
     king', 'Tracing', 'Scanning', 'Decrypting' or 'Skipping'.

     Looking

     With 'Looking' TbScan indicates it has successfully located the entry
     point of the program in one step. The program code has been identified
     so TbScan knows where to search without the need of additional analysis.
     'Looking' will be used on most known software.





                                      IV - 9
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     Checking

     'Checking' indicates TbScan has successfully located the entry point of
     the program, and is scanning a frame of about 2Kb around the entry
     point. If the file is infected, the virus' signature will be located in
     this area. 'Checking' is a very fast and reliable scan algorithm.
     Checking will be used on most unknown software.

     Tracing

     'Tracing' means that TbScan has successfully traced a chain of jumps or
     calls while locating the entry-point of the program, and is scanning a
     frame of about 2Kb around this location. If the file has been infected,
     the signature of the virus will be located in this area. 'Tracing' is a
     fast and reliable scan algorithm. Tracing will be primarily used for
     TSR-type COM files. Most viruses will force TbScan to use 'Tracing'.

     Scanning

     TbScan is scanning the entire file (except for the exe-header which
     cannot contain any viral code). This algorithm will be used if 'Look-
     ing', 'Checking' or 'Tracing' can't be used safely. This is the case
     when the entry-point of the program contains other jumps and calls to
     code located outside the scanning frame, or when the heuristic analyzer
     found something that should be investigated more thoroughly. 'Scanning'
     is a slow algorithm. Since it processes almost the entire file, inclu-
     ding data areas, false alarms are more likely to occur. The 'Scanning'
     algorithm will be used while scanning bootsectors, SYS and BIN files.

     Decrypting

     TbScan detected that the file is encrypted, and decrypts it to be able
     to 'look inside'. TbScan performs signature scanning and heuristic
     analysis on the decrypted code since that is very reliable and also
     reveals polymorphic viruses.

     Skipping

     'Skipping' will occur with SYS and OVL files only. It simply means that
     the file will not be scanned. As there are many SYS files containing no
     code at all (like CONFIG.SYS), it makes absolutely no sense to scan
     these files for viruses. The same applies to .OV? files. Many overlay
     files do not deserve to be called as such as they lack an exe-header.
     Such files cannot be invoked through DOS, which makes them just as
     invulnerable to direct virus attacks as .TXT files are. If a virus is
     reported to have infected an .OV? file, it involved one of the relative-
     ly few overlay files which do contain an exe-header. In that case the
     infection was the result of the virus monitoring the DOS exec-call
     (function 4Bh) and infecting any program being invoked that way, inclu-
     ding 'real' overlay files.



                                      IV - 10
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


3.5. The TbScan.Lng file

     The TbScan.Lng file contains all texts being displayed by TbScan. You
     can translate or customize the messages with any ASCII editor.

     The messages are separated by the dollar sign ($). The first message
     displays our address and registration info. You can edit this message as
     you please, for instance adding your company logo.

     You may add color codes to the TbScan.Lng file. A color code is precee-
     ded by the character '|'. The following color codes are available: (all
     numbers are in hex).

     Color          Foreground Highlight   Background

     Black          00         08          00
     Blue           01         09          10
     Green          02         0A          20
     Cyan           03         0B          30
     Red            04         0C          40
     Magenta        05         0D          50
     Yellow/Brown   06         0E          60
     White/gray     07         0F          70


     Example:  To make a highligted green character on a red background the
               color code would be 0A+40=4A. To make the character blink add
               80h to the result.


3.6. The TBAV.MSG file

     The TBAV menu shell will display the contents of a file named TBAV.MSG
     if it exists. You can use this feature to put your company logo on the
     TBAV screen. You can embed color codes in this file. Consult section 3.5
     ('The TbScan.Lng file') for more information about color codes.

















                                      IV - 11
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


4. TbClean

     In order to understand the way a cleaning program operates, try to
     imagine how a virus usually goes about infecting a program. The basic
     principle is not difficult. A virus - just another program really - adds
     itself to the end of the program it is going to infect. The additional
     viral code, naturally, increases the size of the program. But simply
     appending a viral program to another program is not enough, to do any
     real harm - the viral code has to be executed first. So, the virus grabs
     the first few bytes at the start of the program, and replaces them with
     a 'jump' instruction to its own viral code. That way the virus is able
     to take control as soon as the program is started. Chances are you will
     never even notice the momentary delay while the extra code is executed,
     doing whatever the virus has been programmed to do. The virus then
     restores the original instructions and restarts the program (jump to the
     start). Your program, more often than not, works as usual - and it goes
     without saying that any virus worth its salt will make sure it isn't
     going to draw undue attention too soon!

     So, in order to purge a program, we must first restore the starting
     instruction bytes, which the virus replaced with the jump to its own
     code. The virus is going to need these bytes again later on, so they
     will be stored somewhere in the viral code. The cleaner starts out to
     find those bytes, puts them back in their old place, and truncates the
     file to the original size.

     Cleaner programs basically come in two types - the conventional type,
     for specific types of viruses, and the far more advanced generic clea-
     ner, offering a much wider scope. Let's take a closer look at both
     cleaner types and find out where they differ.


     Conventional cleaners

     A conventional cleaner has to know which virus to remove. Suppose your
     system is infected with a Jerusalem/PLO virus. When you start such a
     conventional cleaner, a procedure much like the following will take
     place:















                                      IV - 12
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


         original program        infected program

         +--------------+        +--------------+
         |              |        |              |
         | p            |  100:  |jump          |
         | r            |        |to 2487       |
         | o            |        | o            |
         | g            |        | g            |
         | r            |        | r            |
         | a            |        | a            |
         | m            |        | m            |
         |              |        |              |
         | c            |        | c            |
         | o            |        | o            |
         | d            |        | d            |
         | e            |        | e            |
         |              |        |              |
         +--------------+        +--------------+
                           2487: |              |
                                 |  VIRUS!    p |
                                 |            r |
                                 |jmp 100       |
                                 +--------------+


     The virus has itself linked to the program start, and after it rstored
     the original bytes (the 'pr' in this example) it jumps then back to the
     original program start.

     The conventional cleaner: 'Hey, the signature file tells me this file is
     infected with the Jerusalem/PLO virus. Ok, let's see, this virus tacks
     on 1783 bytes at the end, and it overwrites the first three bytes of the
     original program with a jump to itself. The original bytes are located
     at offset 483 in the viral code. So, I have to take those bytes, copy
     them to the beginning of the file, and I have to remove 1873 bytes of
     the file. That's it!'

     There are several pitfalls to worry about in a scenario like this.
     Obviously, the cleaner has to be given some means to recognize the virus
     it is supposed to remove. A conventional cleaner cannot cope with a
     virus unless it knows what to look for. It is even more important to
     establish the fact that the virus is exactly the same one that the
     cleaner knows about after checking the validation data. Imagine what
     whould happen if the virus used in the example had been modified and is
     now 1869 bytes in size instead of 1873... The cleaner would remove too
     much! This is not an exceptional case, certainly not after the unslaught
     of countless so-called mutant straints. The Jerusalem/PLO family, to
     name but one example, now has more than 100 mutant members!





                                      IV - 13
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     Generic cleaners

     A generic cleaner works on the principle that any kind of virus -
     whether or not it has made the signature 'charts' - is bad news. That's
     why TbClean works with a completely different disinfection scheme that
     is effective with almost all viruses - it does not even need to recogni-
     ze them. Actually, TbClean represents two cleaners in one: a 'repair'
     cleaner and a 'heuristic' cleaner.

     Repair cleaning

     Repair cleaning needs an Anti-Vir.Dat file that was generated by TbSetup
     before the infection occurred. The Anti-Vir.Dat file stores vital
     information about programs, including their original size, the first few
     instruction codes and a cryptographic checksum. This information is
     usually all it takes to disinfect a file, no matter what virus, known or
     unknown, caused the infection. The cleaner will simply restore the bytes
     at the beginning of the program, truncate the file to the original size,
     and verify the result by way of the original checksum.


     Heuristic cleaning

     TbClean is the first cleaner in the world that has a heuristic cleaning
     mode. This mode does not need any information about viruses either, but
     it has the added advantage that it doesn't even care about the original,
     uninfected state of a program. This cleaning mode is very effective if
     your system is infected with an unknown virus and you neglected to let
     TbSetup generate the Anti-Vir.Dat files in time.

     In heuristic mode, TbClean loads the infected file and starts emulating
     the program code. It uses a combination of disassembly, emulation and,
     sometimes, execution to trace the flow of the viral code, pretending to
     do more or less exactly what the virus would normally be doing. When the
     virus gets to the original program's instructions and jumps back to the
     original program code, TbClean stops the emulation process, with a
     'thank you' to the virus for its cooperation in restoring the original
     bytes.

     The actual cleaning process involves almost the same three steps as with
     repair cleaning. First the program startup code is repaired and copied
     back to the file. Then the viral code, now rendered useless and ineffec-
     tive, is removed and, for the sake of security, TbClean will do a final
     analysis of the purged program file.









                                      IV - 14
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


5. TbGensig

5.1 The Purpose of TbGenSig

     TbGenSig is a signature file compiler. Since TBAV is distributed with an
     up to date, ready-to-use signature file, you do not really need the
     signature file compiler.

     If, however, you want to define your own virus signatures, you will need
     the TbGensig utility. You can use either published signatures or define
     your own ones if you are familiar with the structure of software.

     One way or another, you only need to do this in case of an emergency,
     like in case of the unfortunate event that your machine or even your
     company is attacked by a yet unknown, thus not recognized virus. It is
     recommended to send a few samples of the virus to some virus experts
     anyway, in order to let scanners recognize the virus in the next upgra-
     de.

     Since it is not possible to explain the whole subject of virus hunting
     in one manual, this document assumes you have enough experience and
     knowledge to make your own signatures.

     TbGenSig searches for a file named UserSig.Dat in the current directory.
     This file should contain the signatures you want to add to the TBAV
     signature file TbScan.Sig. TbGenSig checks the contents of the User-
     Sig.Dat file and applies it to the TbScan.Sig file.

     If you want to delete or modify your signatures, just edit or delete the
     UserSig.Dat file and execute TbGenSig again.

     TbGenSig will list all signatures in the TbScan.Sig file on screen while
     being executed.


5.2 Defining signatures

     Format of the  UserSig.dat text

     You can create and edit the UserSig.Dat file with every DOS editor which
     is able to output unformatted text. All lines starting with ';' are
     comment lines. TbGenSig file ignores these lines.

     Lines starting with '%' will be displayed in the upper TbGenSig window.

     In the first line the name of a virus is expected. The second line
     contains one or more keywords. The third line contains the signature
     itself. This combination of three lines is called a 'signature record'.





                                      IV - 15
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     A signature record should look like this:

          Test virus
          exe com inf
          abcd21436587abcd

     You may use spaces in the signature for your own convenience. TbGenSig
     will ignore these spaces.


     Adding a published signature

     If you want to add a signature that has been published, you should act
     as illustrated below.

     -    Edit or create the UserSig.Dat file. Convert the published signatu-
          re to an acceptable format for TbGenSig.

     -    Use keywords COM EXE BOOT INF

          You would get:

          New virus
          exe com boot inf
          1234abcd5678efab

     -    Execute TbGenSig.


     Defining a Signature with TBScan

     This section is intended for advanced users who own a TBAV.KEY file.

     Although the TbScan.Sig file is updated frequently, new viruses are
     created every day, outpacing the regular upgrading service of this data
     file. It is therefore possible that one day your system gets infected by
     a recently created virus that has not yet been listed in the signature
     file. TbScan will not always detect the virus in such cases, not even
     with the heuristic analysis. If you are convinced that your system must
     have been infected without TbScan confirming this, thischapter will
     supply you with a valuable tool to detect unknown viruses with. This
     section offers step-by-step assistance in creating an emergency signatu-
     re that can be (temporarily) added to your copy of TbScan.Sig

     -    Collect some infected files and copy them into a temporary directo-
          ry.

     -    Boot from a clean write-protected diskette. Do NOT execute ANY
          program from the infected system, even though you expect this
          program to be clean.



                                      IV - 16
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     -    Execute TbScan from your write-protected TbScan diskette with the
          'extract' option set. Make sure that the temporary directory where
          you stored the infected files will be TbScan's target directory.
          With its 'extract' option set, TbScan will NOT scan the files but,
          instead, display the first instructions that are found at the
          entry-point of the infected programs.


=>   Please note that we highly recommend you to simultaneously set the 'log'
     option of TbScan to generate a log file.

     -    Compare the 'signatures' extracted by TbScan. You should see
          something like this:


          NOVIRUS1.COM    2E67BCDEAB129090909090ABCD123490CD
          NOVIRUS2.COM    N/A
          VIRUS1.COM      1234ABCD5678EFAB909090ABCD123478FF
          VIRUS2.COM      1234ABCD5678EFAB901234ABCD123478FF
          VIRUS3.COM      1234ABCD5678EFAB9A5678ABCD123478FF

     If the 'signatures' are completely different, the files are either
     probably not infected, or they have been infected by a polymorphic virus
     that requires an algorithmic detection module to detect it.

     -    There might be some differences in the 'signatures'. You can use
          the question mark wildcard ('?') in this case.

     A signature to detect the 'virus' in the example above could be:

          1234ABCD5678EFAB ?3 ABCD123478FF

     The '?3' means that there are three bytes on that position that should
     be skipped.

     -    Add the signature to the data file UserSig.Dat. Give the virus a
          name in the first line of its entry. Specify the following key-
          words: COM, EXE, INF, ATE in the second line. Enter the signature
          in the third.


     You would get:

          New virus
          exe com ate inf
          1234abcd5678efab?3abcd123478ff


     -    Execute TbGenSig. Make sure the resulting TbScan.Sig file is in the
          TbScan directory.



                                      IV - 17
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     -    Execute TbScan again in the directory containing the infected
          files. TbScan should now detect the virus.

     -    Send a couple of infected files to a recommended virus expert,
          preferably to the ThunderBYTE organisation.

     Congratulations! You have defined a signature all by yourself! Now you
     can scan all your machines in search of the new virus.
     However, keep in mind that this method of extracting a signature is a
     'quick-and-dirty' solution to viral problems. The extracted signature
     might not detect the presence of the virus in all cases. A signature
     that is guaranteed to detect all instances of the virus can be made only
     after complete disassembly of the new virus. For these reasons you
     should NOT distribute your home-made 'signature' to others. The signatu-
     re eventually assembled by experienced anti-virus researchers will be
     completely different in most cases!


5.3 Keywords

     Keywords are used for several purposes. They are classified in catego-
     ries. Keywords may be separated by spaces, commas or tabs. The maximum
     line length is 80 characters.

     At least one of the following flags should be specified:
     BOOT, COM, EXE, HIGH, LOW, SYS or WIN.


     Item keywords


     BOOT       Signature can be found in bootsector/partition
     COM        Signature can be found in COM programs.

     This flag initiates the scanner to search for this signature in executa-
     ble files that do not have an EXE header or device header.
=>   Note:   The file contents determines the file type, not the filename
     extension!


     EXE        Signature can be found in EXE programs.

     This flag initiates the scanner to search for this signature in the load
     module of EXE type files. EXE files are files that have an EXE header.
=>   Note: The file contents determines the file type, not the filename
     extension!


     HIGH      Signature can be found in HIGH memory (above program).This
               flag initiates the scanner to search for this signature in
               memory above the memory allocated by the scanner.


                                      IV - 18
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     This keyword is intended for resident viruses that allocate memory at
     system boot, or viruses that decrease the size of the last MCB (Memory
     Control Block).
=>   Note:  The flag HIGH does not mean that the signature should be searched
     in UPPER memory.


     LOW       Signature can be found in LOW memory. This flag initiates the
               scanner to search for this signature in memory below the PSP
               (Program Segment Prefix) of the scanner and in the UMB (Upper
               Memory Blocks). This keyword is intended for viruses that
               remain resident in memory, using the normal DOS TSR (Terminate
               and Stay Resident) function calls.


     SYS       Signature can be found in SYS programs.


     WIN       Signature can be found in Windows programs.


     Message keywords

     DAM        Message prefix:  'damaged by'.
     DROP       Message prefix:  'dropper of'.
     FND        Message prefix:  'found the'.
     INF        Message prefix:  'infected by'
                Message suffix:  'virus'
     JOKE       Message prefix:  'joke named'.
     OVW        Message prefix:  'overwritten by'.
     PROB       Mess. pre-prefix:'probably'.
     TROJ       Message prefix:  'trojanized by'.



     Position keywords


     UATE      Signature should be found at unresolved entry-point.

     Purpose:
     The signature starts directly at the unresolved entry-point of the viral
     code. With some polymorphic viruses, it may be possible to create a
     signature from the degarbling routine, although it may either be too
     short or give false positives with a global search. An initial branch
     instruction  may be part of the signature.

                COM type files:  top of file (IP 0100h).
                EXE type files:  CS:IP as defined in the
                                 EXE-header.
                WIN type files:  Non-DOS CS:IP of the new
                                 EXE-header.

                                      IV - 19
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     Remarks:
     The keyword UATE is not allowed for BOOT, SYS, LOW, HMA or HIGH type
     signatures.


     ATE        Signature should be found AT ENTRY point.

     Purpose:
     The signature starts directly at the entry-point of the viral code. With
     some polymorphic viruses, it may be possible to create a signature from
     the degarbling routine, although it may either be too short or give
     false positives with a global search.

     Therefore the keyword ATE is used to make sure that the scanners do not
     scan the entire file for the signature, but only look at the entry-point
     for the signature.

     The entry-point of a virus is defined by the first byte that is not
     equal to either a JUMP SHORT, JUMP LONG or a CALL NEAR.

                Unresolved entry point:1JUMP LONG   3
                                     2 ...
                                     3 JUMP SHORT   5
                                     4 ...
                                     5 CALL FAR     7
                                     6 ...
                                     7 CALL NEAR    9
                                     8 ...
                Resolved entry point:9  POP <reg>

          The entry-point of the above fragment is Line 9 as this is the
          first code to be executed which is not a JUMP SHORT, JUMP LONG or
          CALL  NEAR or CALL FAR.

     Remarks:
     1)   The entry-point can be determined by a code analyzer to cope with
          tricks like coding a NOP or DEC just before the branch instruction.
          Therefore the results of the scanner should be tested carefully. In
          case of trouble use the TbScan 'extract' option to find out what
          TbScan considers to be the entry point of the program.

     2)   The flag ATE is not allowed for BOOT, SYS, LOW, HMA or HIGH type
          signatures.


     XHD       Signature can be found at offset 2 of the EXE header.

     Purpose:
     This position keyword is rarely used. It should only be used to detect
     the also very rare high-level language viruses; viruses written in a
     language like C or Basic. These viruses normally contain standard setup
     routines and library routines which are not suitable to define a signa-

                                      IV - 20
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     ture. The XHD keyword can be used as a last resort to detect such
     viruses.

     Remarks:
     This flag may only be used for EXE or WIN type signatures.


5.4 Wildcards

     In a virus signature, wildcards characters may be used to recognize so
     called polymorphic (self- modifying/mutating) virus code. Below a
     description is presented of the wildcard notation. All numbers are in
     hexadecimal.


     Position Wildcards

     Position wildcards affect the position where the parts of the signature
     will be matched.

          Skip
          ?n         =  Skip n amount of bytes and continue.
          ?@nn       =  Skip nn amount of bytes and continue.
                         nn should not exceed 7F.

          Variable
          *n         =  Skip up to n bytes.
          *@nn       =  Skip up to nn bytes and continue.
                         nn should not exceed 1F.


     Opcode wildcards

     The 'opcode' wildcards are shaped to detect instruction ranges:

          Low opcode
          nL         =  One of the values in the range n0-n7.

          High opcode
          nH         =  One of the values in the range n8-nF.


     Intended use of the opcode wildcards:

     Suppose a polymorphic virus puts a value in a word register (using a MOV
     WREG,VALUE instruction), and increments a register (using an INC WREG
     instruction, and pops a word register from the stack (using a POP
     instruction). Both the registers and the value are variable.

     You could code it like this:
          bh4l5h


                                      IV - 21
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     B8-BF are the opcodes for 'MOV WREG,VALUE', 40-47 are the opcodes for
     'INC WREG', and 58-5F are the opcodes for 'POP REG'.


     Example

     To show the power of the use of the appropriate keywords and wildcards
     here is the signature of the Haifa.Mozkin virus. This virus is highly
     polymorphic and encrypted. It contains a small variable decryptor to
     decrypt the virus.

     There are two problems here: most bytes are encrypted or variable, thus
     not suitable to be part of a signature, and the remainder is short and
     would cause dozens of false alarms.

     However, using the appropriate keywords and wildcards, it is possible to
     define a reliable signature. The signature below is used by TbScan to
     detect the Haifa.Mozkin virus.

          Haifa.Mozkin
          com exe ate inf
          bh?2bh?109?2*22e80?24l4h75fl


     Let's analyze it.

     The first line describes the name of the virus. The second line tells
     the scanner to search for this signature in COM and EXE type files. It
     also tells the scanner that it should report the file as infected if the
     signature can be matched. The keyword ATE instructs the scanner to match
     this signature only at the resolved entry-point of the file. The virus
     starts of course with decrypting itself, so it is guaranteed that the
     scanner will scan this location. The ATE instruction limits the scope of
     this signature to just one position in a file, so this will reduce the
     chances of false alarms significantly.


     The third line is the signature definition. Let's reverse engineer it:

     bh?2      This means: a byte in the range B8-BF followed by two variable
               bytes. B8-BF is a 'MOV WREG,VALUE' instruction. From the
               register we only know it is a word register, the value is
               unknown as well.

     bh?109    This means: another 'MOV WREG,VALUE' instruction. The register
               is a word register, and from the value we know that it is in
               the range 0900 to 09FF.

     ?2*2      This means: skip two to four bytes. This instruction is inser-
               ted by the virus to make it harder to define a signature.



                                      IV - 22
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                SECTION IV


     2e80?2    This means: the virus performs an arithmethic byte sized
               operation with an immediate value (decrypts one byte) with a
               CS: segment override. The exact operation, the memory location
               and the value are unknown.

     4l        This means: a byte in the range 40-47. This is an 'INC WREG'
               instruction. The virus increments the counter to the next byte
               to be decrypted.

     4h        This means: a byte in the range 48-4F. This is a 'DEC WREG'
               instruction. The virus decrements the iteration count.

     75fl      Opcode 75 is a JNZ instruction. If the decremented register
               did not reach zero, the virus jumps back and repeats the
               operation. How much does it jump? That tells the 'fl' part:
               somewhere between -16 (F0h) to -8 (F7h) bytes.


     Although the signature language of TbGenSig is very powerful, there are
     viruses which are so highly polymorphic that they require even more
     sophisticated wildcards, keywords or even special detection algorithms.
     The explanation however of these wildcards, keywords or algorithmic
     detection definitions is so complicated that it is not suitable to be
     presented in a user manual.





























                                      IV - 23
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX A


Appendix A. TBAV messages


     The TBAV utilities may display various messages when executed. Most
     messages will be clear enough, but here is some additional information
     followed by the name of the appropriate TBAV utility.



TbClean


     Anti-Vir.Dat record          The Anti-Vir.Dat record has been found, but
     found: information mat-      the information matches the current state
     ches the current state       of the file. The Anti-Vir.Dat record was
     of the file. Anti-           created after the file got infected, or the
     Vir.Dat file was created     file is not changed at all. TbClean is
     after the infection.         going to emulate the file to clean it heu-
     Trying emulation...          ristically.

     Anti-Vir.Dat record          The Anti-Vir.Dat record that belongs to the
     found: reconstructing        infected file has been found. The informa-
     original state...            tion will be used to reconstruct the file.

     Anti-Vir.Dat record not      The Anti-Vir.Dat file did not exist or did
     found: original state        not contain information of the infected
     unknown. Trying emulati-     program, so the original state of the in-
     on...                        fected program is unknown to TbClean. Tb-
                                  Clean will switch to its heuristic mode to
                                  determine the state of the original file.

                                  Note: to prevent a situation like this,
                                  make sure to use the TbSetup program to
                                  generate the Anti-Vir.Dat records.

                                  These records are of great help to TbClean.
                                  When the file is already infected it is too
                                  late to generate the Anti-Vir.Dat records.

     Emulation terminate:         The emulation process has been terminated
     <reason>                     for the reason specified. TbClan will now
     <reason> can be one of       consult the collected information to see if
     the following:               it can disinfect the file.

     Jump to BIOS code.           The virus tried to perform a call or jump
                                  directly into BIOS code. This process can
                                  not be emulated so it will be aborted. The
                                  program can probably not be disinfected.

     Approached stack crash.      The emulated program is approaching a
                                  crash. Something went wrong while emulating
                                  the program so it will be aborted. The
                                  program can probably not be disinfected.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX A


     Attempt to violate li-       TbClean will not disassemble this program
     cense agreements.            for obvious reasons.

     Encountered keyboard         The emulated program tries to read the
     input request.               keyboard. This is very unusual for viruses,
                                  so the file is probably not infected at
                                  all.

     Encountered an invalid       The emulator encountered an unknown in-
     instruction.                 struction. For some reason the emulation
                                  failed. The program can probably not be
                                  disinfected.

     DOS program-terminate        The emulated program requests DOS to stop
     request.                     execution. The program is not infected at
                                  all, or infected by an overwriting virus
                                  that does not pass control to its host
                                  program. The program can not be disinfec-
                                  ted.

     Jumped to original pro-      The program jumped back to the start po-
     gram entry point.            sition. It is very likely it is infected.
                                  The program can probably be disinfected.

     Undocumented DOS call        This is very common for viruses that add
     with pointers to reloca-     themselves in front of the COM type pro-
     ted code.                    gram. The program can probably be disin-
                                  fected.

     Encountered an endless       TbClean encountered a situation in which
     loop.                        the program is executing the same in-
                                  struction sequences over and over again for
                                  hundreds of thousands of times. It is unli-
                                  kely that the program will ever escape from
                                  this loop, so the emulation will be abor-
                                  ted.

     Ctrl-break pressed.          The user pressed <Ctrl><Break> so the clean
                                  attempt is aborted.

     Emulation aborted for        If this message is shown, please send a
     unknown reason.              copy of the file being emulated to ESaSS BV
                                  or one of the support BBSs.

     Sorry, the collected         The heuristic cleaning mode of TbClean is
     information is not suf-      aborted and has not been successful. The
     ficient to clean file...     only option left is to restore the file
                                  from a backup or to re-install the program.

     Collected enough infor-      The emulation of the virus provided TbClean
     mation to attempt a re-      with all information to disinfect the file.
     liable clean opera-
     tion...
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX A


     Some DOS error occured.      Some DOS error occured while trying to
     TbClean aborted!             clean the file. Check that no files are
                                  read-only or located on a write protected
                                  disk, and make sure there is a reasonable
                                  amount of free disk space.

     The clean attempt seems      It seems that TbClean removed the virus
     to be successful. Test       from the file. No doubt about the virus: it
     the file carefully!          is gone. However, take care and test the
                                  file carefully to see if it works as expec-
                                  ted.

     Reconstruction failed.       TbClean tried to reconstruct the original
     Program might be over-       file with the help of the Anti-Vir.Dat
     written. Trying emulati-     record. However, the attempt failed. Tb-
     on...                        Clean is going to emulate the file to try
                                  to clean it heuristically.

     Reconstruction succes-       The file has been reconstructed to its
     sfully completed.            original state with help of the information
                                  of the Anti-Vir.Dat record. The CRC (check-
                                  sum) of the original file and the cleaned
                                  file are completely equal, so the cleaned
                                  file is almost certain equal to the origi-
                                  nal file.

     Staring clean attempt.       TbClean is analyzing the infected file and
     Analyzing infected fi-       tries to locate the Anti-Vir.Dat record.
     le...


TbDriver

     Another version of Tb-       You started a TbDriver.Exe with another
     Driver is already resi-      version number or processor type than the
     dent!                        TbDriver already in memory.

     Cannot remove TbDriver.      You tried to remove TbDriver from memory,
     Unload other TSRs first!     but other resident software as loaded after
                                  TbDriver. Resident software can only be
                                  removed from memory by unloading them in
                                  reversed order.

     LAN support was  already     You tried to use the option 'net' for a
     installed.                   second time, or TbDriver already enabled
                                  network support automatically.

     TbDriver not active.         The resident TBAV utilities need TbDriver,
     Load TbDriver first!         so you have to load TbDriver first.

     TbDriver is not <versi-      The version of TbDriver found in memory
     on>.                         does not match the version number of this
                                  resident TBAV utility. Make sure you do not
                                  mix version numbers!
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX A


     This version of TbDriver     You are using a processor optimized version
     requires a <typeID> pro-     of TbDriver which can not be executed by
     cessor.                      the current processor.


TbScan

     Cannot create logfile.       The specified log file path is illegal, the
                                  disk is full or write protected, or the
                                  file already exists and cannot be overwrit-
                                  ten.

     [Cannot read datafile]       TbScan needs access to its data file to be
                                  able to tell you the name of the virus. If
                                  it cannot access the data file it displays
                                  this message instead of the virus.

     Command line error.          An invalid or illegal commandline option
                                  has been specified.

     No matching executable       The specified path does not exist, is emp-
     files found.                 ty, or is not an executable file.

     Sanity check failed!         TbScan detected that its internal checksum
                                  does not match anymore. TbScan is possibly
                                  contaminated by a virus. Obtain a clean
                                  copy of TbScan, copy the program on a write
                                  protected diskette, boot from that diskette
                                  and try again!


TbScanX

     Data file not found.         TbScanX has not been able to locate the
                                  data file.

     Not enough memory.           There is not enough free memory to process
                                  the data file. Try to enable swapping, or
                                  if you are already doing so, try another
                                  swapping mode. See also section IV, chapter
                                  "Memory requirements".
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX B


Appendix B. TbScan - Heuristic flag descriptions


     # - Decryptor code found
     The file possibly contains a self-decryption routine. Some copy-protec-
     ted software is encrypted so this warning may appear for some of your
     files. If, however, this warning appears in combination with, for
     example, the 'T' warning, there could be a virus involved and TbScan
     assumes the file is contaminated! Many viruses encrypt themselves and
     cause this warning to be displayed.

     ! - Invalid program.
     Invalid opcode or out-of-range branch. The program has either an entry
     point that has been located outside the body of the file, or reveals a
     chain of 'jumps' that can be traced to a location outside the program
     file. Another possibility is that the program contains invalid processor
     instructions. The program being checked is probably damaged, and cannot
     be executed in most cases. Anyway, TbScan does not take any risk and
     uses the 'scan' method to scan the file.

     1 - 80186+ instructions
     The file contains instructions which can not be executed by 8088 proces-
     sors, and require a 80186 or better processor.

     @ - Strange instructions
     The file contains instructions which are not likely to be generated by
     an assembler, but by some code generator like a polymorphic virus
     instead.

     ? - Inconsistent header.
     The program being processed has an exe-header that does not reflect the
     actual program lay-out. Many viruses do not update the exe-header of an
     EXE file correctly after they have infected the file, so if this warning
     pops up frequently, it seems you have a problem.

     c - No integrity check
     This warning indicates that no checksum/recovery information has been
     found about the indicated file. It is highly recommended to use TbSetup
     in this case to store information of the mentioned file. This info can
     be used later on for integrity checking and to recover from virus
     infections.

     h - Hidden or System file.
     The file has the 'Hidden' or the 'System' file attribute set. This means
     that the file is not visible in a DOS directory display but TbScan will
     scan it anyway. If you don't know the origin and/or purpose of this
     file, you might be dealing with a 'Trojan Horse' or a 'joke' virus
     program. Copy such a file onto a diskette; then remove it from it's
     program environment and check if the program concerned is missing the
     file. If a program does not miss it, you will have freed some disk
     space, and maybe you have saved your system from a future disaster in
     the process.

     i - Internal overlay.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX B


     The program being processed has additional data or code behind the load-
     module as specified in the exe-header of the file. The program might
     have internal overlay(s), or configuration or debug information appended
     behind the load-module of the EXE file.

     p - Packed or compressed file.
     The program has been packed or compressed. There are some utilities that
     are able to compress a program file, like EXEPACK or PKLITE. If the file
     was infected after the file had been compressed, TbScan will be able to
     detect the virus. However, if the file had already been infected before
     it was compressed, the virus has also been compressed in the process,
     and a virus scanner might not be able to recognize the virus anymore.
     Fortunately, this does not happen very often, but you should beware! A
     new program might look clean, but can turn out to be the carrier of a
     compressed virus. Other files in your system will then be infected too,
     and it is these infections that will be clearly visible to virus scan-
     ners.

     w - Windows or OS/2 header.
     The program can be or is intended to be used in a Windows (or OS/2)
     environment. TbScan will also scan this file for Windows and OS/2
     viruses too.

     A - Suspicious Memory Allocation
     The program uses a non-standard way to search for, and/or to allocate
     memory. A lot of viruses try to hide themselves in memory so they use a
     non-standard way to allocate this memory. Some programs (high-loaders or
     diagnostic software) also use non-standard ways to search or allocate
     memory.

     B - Back to entry.
     The program seems to execute some code, and after that it jumps back to
     the entry-point of the program. Normally this would result in an endless
     loop, except when the program has also modified some of its instructi-
     ons. This is quite common behaviour for computer viruses. In combination
     with any other flag TbScan will report a virus.

     C - File has been changed
     This warning can only appear if you used TbSetup to generate the Anti-
     Vir.Dat files. If this warning appears this means that the file has been
     changed. If you did not upgrade the software it is very likely that a
     virus infected the file! Note that TbScan does not display this warning
     if only some internal configuration area of the file changes. This
     warning means that code at the program entry point, the entry-point
     itself and/or the file size have been changed.

     D - Direct disk access
     This flag is displayed if the program being processed has instructions
     near the entry-point to write to a disk directly. It is quite normal
     that some disk-related utilities cause this flag to be displayed. As
     usual, if many of your files (which have no business writing directly to
     the disk) cause this flag to be displayed, your system might be infected
     by an unknown virus.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX B


=>   Note that a program that accesses the disk directly does not always have
     to be marked by the 'D' flag. Only when the direct disk instructions are
     near the program entry point it will be reported by TbScan. If a virus
     is involved the harmful instructions are always near the entry point,
     which is the place where TbScan looks for them.

     E - Flexible Entry-point
     The program starts with a routine that determines its own location
     within the program file. This is rather suspicious because sound pro-
     grams have a fixed entry-point so they do not have to determine this
     location. For viruses however this is quite common: about 50% of the
     known viruses cause this flag to be displayed.

     F - Suspicious file access
     TbScan has found instruction sequences common to infection schemes used
     by viruses. This flag will appear with those programs that are able to
     create or modify existing files.

     G - Garbage instructions.
     The program contains code that seems to have no purpose other than
     encryption or avoiding recognition by virus scanners. In most cases
     there will not be any other flags since the file is encrypted and the
     instructions are hidden. In a few cases this flag will appear for
     'normal' files. These files however are badly designed, which is the
     reason the 'garbage' flag appears.

     J - Suspicious jump construct.
     The program did not start at the program entry point. The code has
     jumped at least two times before reaching the final start-up code, or
     the program jumped using an indirect operand. Sound programs should not
     display this kind of strange behaviour. If many files cause this warning
     to be displayed, you should investigate your system thoroughly.

     K - Unusual stack.
     The EXE file being processed has an odd (instead of even) stack offset
     or a suspicious stack segment. Many viruses are quite 'buggy' by setting
     up an illegal stack value.

     L - program Load trap
     The program might trap the execution of other software. If the file also
     causes flag M (memory resident code) to be displayed, it is very likely
     that the file is a resident program that determines when another program
     is executed. A lot of viruses trap the program load and use it to infect
     the program. Some anti-virus utilities also trap the program load.

     M - Memory resident code.
     TbScan has found instruction sequences which could cause the program to
     hook into important interrupts. A lot of TSR (Terminate and Stay Resi-
     dent) programs will trigger this flag, because hooking into interrupts
     is part of their usual behaviour. If, however, a lot of non-TSR programs
     cause this warning flag to appear, you should be suspicious. It is
     likely that your files have been infected by a virus that remains
     resident in memory. Note that this warning does not appear with all true
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX B


     TSR programs. Nor can TSR detection in non-TSR programs always be relied
     upon.

     N - Wrong name extension
     Name conflict. The program carries the extension .EXE but appears to be
     an ordinary .COM file, or it has the extension .COM but the internal
     layout of an .EXE file. A wrong name extension might in some cases
     indicate a virus, but in most cases it does not.

     O - code Overwrite.
     This flag will be displayed if TbScan detects that the program overwri-
     tes some of its own instructions. However, it does not seem to have a
     complete (de)cryptor routine.

     R - Suspicious relocator
     Flag 'R' refers to a suspicious relocator. A relocator is a sequence of
     instructions that changes the proportion of CS:IP. It is often used by
     viruses. Those viruses have to relocate the CS:IP proportion because
     they have been compiled for a specific location in the executable file;
     a virus that infects another program can hardly ever use its original
     location in the file as it is appended to this file. Sound pro-
     grams'know' their location in the executable file, so they don't have to
     relocate themselves. On systems that operate normally only a small
     percentage of the programs should therefore cause this flag to be
     displayed.

     S - Search for executables
     The program searches for *.COM or *.EXE files. This by itself does not
     indicate a virus, but it is an ingredient of most viruses anyway (they
     have to search for suitable files to spread themselves).  If accompanied
     by other flags, TbScan will assume the file is infected by a virus.

     T - Invalid timestamp.
     The timestamp of the program is invalid: e.g. the number of seconds in
     the timestamp is illegal, or the date is illegal or later than the year
     2000. This is suspicious because many viruses set the timestamp to an
     illegal value (like 62 seconds) to mark that they already infected the
     file, preventing themselves from infecting a file for a second time
     around. It is possible that the program being checked is contaminated
     with a virus that is still unknown, especially if many files on your
     system have an invalid timestamp. If only a very few programs have an
     invalid timestamp you'd better correct it and scan frequently to check
     that the timestamp of the files remains valid.

     U - Undocumented system call.
     The program uses unknown DOS calls or interrupts. These unknown calls
     can be issued to invoke undocumented DOS features, or to communicate
     with an unknown driver in memory. Since a lot of viruses use undocumen-
     ted DOS features, or communicate with memory resident parts of a previ-
     ously loaded instance of the virus, it is suspicious if a program
     performs unknown or undocumented communications. Nevertheless, it does
     not necessarily indicate a virus, since some 'tricky' programs use
     undocumented features also.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX B


     V - Validated program
     The program has been validated to avoid false alarms.
     -    The design of this program would normally cause a false alarm by
          the heuristic scan mode of TbScan, or:
     -    This program might change frequently, and the file is excluded from
          integrity checking.
     These exclusions are stored in the Anti-Vir.Dat file by either TbSetup
     (automatically) or by TbScan (manually).

     Y - Invalid bootsector.
     The bootsector is not completely in accordance with the IBM defined
     bootsector format. It is possible that the bootsector contains a virus
     or has been corrupted.

     Z - EXE/COM determinator.
     The program seems to check whether a file is a COM or EXE type program.
     Infecting a COM file is a process that is not similar to infecting an
     EXE file, which implies that viruses able to infect both program types
     should also be able to distinguish between them. There are of course
     also innocent programs that need to find out whether a file is a COM or
     EXE file. Executable file compressors, EXE2COM converters, debuggers,
     and high-loaders are examples of programs that may contain a routine to
     distinguish between EXE and COM files.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX C


Appendix C. Solving incompatibility problems


     Although TBAV utilities have been designed to cooperate with other
     resident software, other software may not, causing system errors or
     worse.



     Problem:  If any TBAV utility tries to display a message, the text
               'message file <filename> could not be opened' appears.

     Solution: Specify the FULL path and filename of the file you will use as
               message file after the TbDriver loading command. The default
               file name is "TbDriver.Lng".



     Problem:  One of your utilities is loading a TSR into memory without an
               'executable' filename extension, such as .EXE or .COM. Since
               TbSetup will only create Anti-Vir.Dat records for files with
               an 'executable' extension, there is no Anti-Vir.Dat, so TbMem
               is not able to record the TSR permission information.

     Solution: Run TbSetup and specify the exact filename of the TSR. TbSetup
               will create an Anti-Vir.Dat record, regardless of the filename
               extension, so TbMem is now able to record its information.

               Although the Anti-Vir.Dat record exists, TbScan will not use
               it to check the CRC to avoid false alarms.


     Problem:  You are running a network.

               TbScanX is installed succesfully, but it does not display the
               "*scanning*" message while accessing files. It does not detect
               viruses either.

               TbCheck is installed succesfully, but it does not display the
               "*checking*" message while accessing files. It does not detect
               viruses either.

               TbFile is installed succesfully, but it does not detect anyt-
               hing anymore.

               TbMem is installed succesfully, but it does not detect TSRs
               anymore.

     Solution: Use the command 'TbDriver net' after the network has been
               loaded.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX C


     Problem:  The system sometimes hangs when the message "*scanning*" is on
               the screen.

     Solution: Try TbScanX without option 'EMS' or 'XMS'. If TbScanX now
               works without any problems, add option 'EMS' or 'XMS' again
               along with option 'compat'. On some systems the TbScanX 'XMS'
               option cannot be used at all, because these systems do not
               allow the use of extended memory by resident software.

               If the problem is related to option 'XMS' and can not be
               solved with option 'compat', you can use option 'XMSseg =
               <value>' to change the XMS swap segment address. The value
               should be between 2000 and 8000. The default value is 4000.



     Problem:  After you have given permission for a program to remain resi-
               dent in memory, TbMem asks the same question the next time.

     Solution: 1)   The 'secure' option of TbDriver is specified. Remove this
                    option, reboot and try again.

               2)   The program mentioned does not appear in the Anti-Vir.Dat
                    file and therefore TbMem cannot permanently store the
                    permission flag. Use TbSetup to generate the Anti-Vir.Dat
                    record of this program!



     Problem:  The system sometimes hangs when you answer 'YES' (abort pro-
               gram) to a TbMem message.

     Solution: None. Some resident programs deeply interfere with the system,
               and once they are rejected from memory the state of the system
               is not stable anymore.



     Problem:  When you load TbDisk from the DOS command prompt everything
               works OK. However, when you install TbDisk from within the
               Config.Sys or AutoExec.Bat file it keeps on warning that
               programs write to disk directly.

     Solution: Load TbDisk at the end of your AutoExec.Bat file.



     Problem:  You formatted the hard disk using DOS FORMAT.COM, but TbDisk
               did not come up with a message until the process was almost
               finished.

     Solution: This is not a problem. A high level format program like DOS
               FORMAT.COM does actually not format the disk, but it reads all
               tracks to locate possible bad spots, and finally it clears the
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX C


               FAT and directory structure. Only this last step implies a
               disk write, so only this last step is detected by TbDisk.



     Problem:  After you have given permission for a program to perform
               direct disk access, TbDisk asks the same question next time.

     Solution: 1)   The 'secure' option of TbDriver is specified.  Remove
                    this option, reboot and try again.

               2)   The program mentioned does not appear in the Anti-Vir.Dat
                    file and therefore TbDisk can not permanently store the
                    permission flag. Use TbSetup to generate the Anti-Vir.Dat
                    record ofthis program!



     Problem:  If you try to use Windows fast 32 bit disk access, Windows
               comes up with an error message.

     Solution: Use option 'win32' on the TbDisk command line.
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX D


Appendix D. Batch file handling


     All TBAV utilities return to DOS with an error code which you can use by
     the DOS 'errorlevel' command. Consult your DOS manual for information
     how to use this command.

     TbScan terminates with one of the following exit codes:

     Errorlevel      0        No viruses found / No error occurred
                     1        No files found
                     2        Error occurred
                     3        Files have been changed
                     4        Virus found by heuristic analysis
                     5        Virus found by signature scanning
                   255        Sanity check failed


     TbUtil terminates with one of the following exit codes:

     Errorlevel      0        No error occurred
                     1        When option 'compare' fails or an error occurs


     All other ultilities exit with one of the following exit codes:

     Errorlevel      0        No error occurred
                     1        Error occurred


     To detect within a batch file whether a resident TBAV utility has been
     loaded you can check for the device names. All TBAV utilities install a
     device name, whether they are loaded in the Config.Sys or AutoExec.Bat.

     You can use the DOS 'if exist' construction to check for the device
     names:

          @echo off
          if not exist SCANX echo TbScanX has not been loaded!

     Or you can branch to a label by using the goto command:

          If not exist SCANX goto noscanx
          bla bla
          :noscanx
          bla bla

     The TBAV device names are:
          TbScanX:            SCANX
          TbCheck:            TBCHKXXX
          TbMem:              TBMEMXXX
          TbFile:             TBFILXXX
          TbDisk:             TBDSKXXX
          TbLog:              TBLOGXXX
TBAV user manual (C) Copyright 1994 Thunderbyte B.V.                APPENDIX E


Appendix E. Virus naming


     How many viruses does TbScan detect?

     Most of the TbScan signatures are family signatures: one signature
     detects a whole set of viruses. All these viruses are related to each
     other. The Jerusalem signature for instance covers more than 100 viru-
     ses. For this reason one cannot tell how many viruses TbScan detects.
     Some competitive products treat each virus mutant as a separate virus,
     thus claiming to detect over 2000 viruses. TbScan, however can detect
     viruses using 'only' 1000 signatures. If you want to compare virus
     scanners, you have to rely on the tests frequently published in magazi-
     nes.


     The virus naming convention

     TbScan follows the CARO virus naming recommendations. CARO is an organi-
     sation in which leading anti-virus researchers participate. Viruses are
     grouped in a hierarchical tree, which indicates to which family viruses
     belong. TbScan shows the complete CARO name where possible. Many other
     anti-virus products however just show the family name or the member
     name. For instance, the 'Leprosy.Seneca.493' virus might be indicated by
     the familiy name 'Leprosy' or member name 'Seneca', or even by the
     variant name '493'.

     Anti-virus products developed by non CARO members might even use a
     completely different name. TbScan however tries to display as much of
     the name as possible. If TbScan is not able to distinguish between the
     'Leprosy.Seneca.493' and 'Leprosy.Seneca.517' viruses, both viruses are
     indicated by the name 'Leprosy.Seneca'.

     Some viruses mutate themselves frequently. To detect all instances of
     such a virus it is sometimes necessary to use multiple signatures.
     Although these signatures cover exactly the same virus, they do have a
     slightly different indication. Behind the name of the virus you will see
     a number between anglebrackets. This number however has nothing to do
     with the name of the virus, but is there just for maintenance reasons.