!AMFDisc  1.00 (23-Jun-92)
==========================
Disc Examiner
=============
AMFDisc is a program that will display the entire contents of a filing
system as a tree.This tree may be saved,and after a period of time,loaded
and compared with the current tree.From the comparison,a list of exceptions
may be generated that shows how the tree has been modified during the period
of time.

Use
===
Once loaded,click on the AMFDisc icon.A window will appear,containing three
writable icons,namely Root directory,Exclude file and Compare with.To begin
with,ignore the last two icons,and enter a filing system name (for example,
adfs::0.$ for the root directory of the current floppy disc,ram:$ for the
root directory of the RAM disc,etc).Click on the OK icon,and the selected
filing system will be examined,with its contents being displayed as a tree
in a window.All the subdirectories of the root directory entered will be
examined,but no files will be loaded from them,as with the conventional
filer.Whilst this means that some applications and files will be without
their sprites,it prevents any viri loading from !Boot files,etc.

Much as it is good to examine such a tree,AMFDisc also allows the tree to be
saved,as an internal format text file.Press menu on the tree window,and save
the data in the usual way.The file that is saved contains a complete record
of everything that was shown in the tree window,together with its load and
execution address,length and file attributes.

Should you call up the initial window again (by clicking on the AMFDisc
icon,as before),you can now drag the tree data file onto the Compare with
icon.Clicking on OK will once again create a tree window,but will compare
that tree (the one currently on the disc) with the one recorded in the file.
Should any differences be found,they will be shown in an Exceptions window.
Appropriate action may then be taken as to these differences,which will be
highlighted in red in the tree window if they are to be found there.

Exceptions
==========
Should no exceptions appear in the exceptions window,it is a sign that the
disc has not be altered since the tree was saved.(The time of this saving is
shown to the top of the exceptions window).Any exceptions that there are
will be of the following types:

Number of objects has changed
<number> (originally <number>)
The total number of objects within the tree has changed since the tree was
saved.More specific exceptions (below) will be generated,depending on how
this number has changed.

Original file not found:
<filename> (in blue,given that it cannot be found)
This exception shows that a file was present in the original tree,but cannot
be found in the present tree.The named file has thus been deleted or wiped
since the tree was originally saved.

Additional file found:
<filename> (in red,given that it is highlighted in the tree window)
An extra file was found in the present tree that cannot be found in the
original tree.The named file has thus been created since the tree was
originally saved.

Object type changed  : HHHHHHHH (originally HHHHHHHH)
<filename> (in red.HHHHHHHH represents an eight digit hexadecimal number)
An object in the tree has had its type changed from a file to a directory,or
from a directory to a file since the tree was originally saved.

Load address changed : HHHHHHHH (originally HHHHHHHH)
<filename> (in red.HHHHHHHH represents an eight digit hexadecimal number)
An object in the tree has had its load address changed since the tree was
originally saved.The load address is used to store the filetype in date
stamped files,so it is likely that the filetype of the file has been changed.

Exec address changed : HHHHHHHH (originally HHHHHHHH)
<filename> (in red.HHHHHHHH represents an eight digit hexadecimal number)
An object in the tree has had its exec address changed since the tree was
originally saved.The exec address is used to store the time and date in date
stamped files,so it is likely that this file has been resaved since the tree
was originally saved.

Length changed       : HHHHHHHH (originally HHHHHHHH)
<filename> (in red.HHHHHHHH represents an eight digit hexadecimal number)
An object in the tree has changed in size since the tree was originally
saved.Usually occurring with a change in exec address,a change in length
shows that the file has been altered and resaved since the tree was
originally saved.

File access changed  : HHHHHHHH (originally HHHHHHHH)
<filename> (in red.HHHHHHHH represents an eight digit hexadecimal number)
An object in the tree has had its file access (defining who can read/write
to it) changed since the tree was originally saved.

Should any exceptions be reported,examine the files that have changed
carefully.Be especially wary of !Boot files that have been extended,or
modules that have appeared from nowhere,as these are signs of active viri.
Should this be the case,load Edit,create a blank file by clicking on the
Edit icon,and press f2.Enter in the name of the suspect file into this
dialogue box,and it will load,without the filer having to be used.You can
thus examine any suspicious files,without having to use the filer,which
often loads many viri unawares.

Excluding files
===============
Whilst it is good to be able to check an entire filing system,often files
are altered for quite legitimate means,and it is necessary to screen these
files out.Using Edit,create a text file that consists of a list of the
files and directories you wish to exclude from the disc tree,in the
following format:

Exclude adfs::0.$.Text
Exclude adfs::0.$.Sprites
Exclude adfs::0.$.Draw.DrawFiles     (etc...)

(where adfs::0.$ is the root directory entered in the appropriate icon)

Be sure that every excluded directory has but eight characters before it,
namely the word Exclude and a space,and nothing more,otherwise the excluded
directory will be excluded from the list of excluded directories,and thus
included.

Once created,drag the exclude file into the Exclude file icon,and the files
defined within it will be automatically excluded from the creation of any
trees.

Script files
============
To simplify the process of comparison between trees,it is possible to create
a script file,that automatically contains the information required to screen
out all unwanted files,to set the root directory and to set the compare file.
Using Edit,create a text file that consists as follows:

Scan <Root$Dir>             where <Root$Dir> is the root directory
Exclude <Exclude$Dir1>      where <Exclude$Dir1>,etc,are replaced with any
Exclude <Exclude$Dir2>      files that should be excluded.More or less 
Exclude <Exclude$Dir3>      Exclude statements may be added,as needed.
Compare <Compare$File>      where <Compare$File> is the file to compare with.

Be sure that file and directory names are prefixed by the correct number of
characters,as shown above.When ready,save the resulting file,and drag it
onto the AMFDisc icon to execute the script file as if it had been entered
by hand.

Versions
========
1.00 Original version.

Source
======
This version of AMFDisc was originally supplied as part of a software
package,namely the AMF the Doomwatcher Collection Part II.It should not be
distributed separately from this package,although it may be separated for
the personal use of the owner,so long as it is not passed on to others in
this form.

Copyright
=========
This version of AMFDisc is not Public Domain.It may be distributed as
Public Domain only by those who are licensed so to do,with the terms of this
license and the official distributor for this version to be found as part of
the general information supplied with this software collection.No part of
this software may be used in any other program,whether commercial or public
domain,without my prior written consent,though any files created by this
software are not bound by this condition.This software may not be
distributed for a profit,save that required to cover packaging and media
costs,nor may it be distributed by an unlicensed person or company.Copyright
() is retained by the author,who may be contacted at the address beneath.No
liability can be accepted by the author for any loss or damage arising from
use or misuse of this software.

Addresses
=========
Should you wish to contact the author of this software,make any constructive
comments or suggestions,report any errors or bugs,or make any donations (all
cheques being made payable to A.M.Flintham),write to the address beneath:

AMF the Doomwatcher,
  The Monastery of Doomwatcher Monks,
    50 Burlington Way,
      Mickleover,
        Derby.
          DE3 5BD
