                   The @stake Sleuth Kit (TASK)
            www.atstake.com/research/tools/index.html

                    Installation Instructions


REQUIREMENTS
=============================================================================
Tested Platform:
- FreeBSD 2-4.*
- Linux 2.*
- OpenBSD 2-3.*
- Mac OS X
- SunOS 4-5.*


System:
- C compiler


Optional Programs:
- Autopsy 1.60: Provides a graphical HTML-based interface to TASK (which 
makes it much easier to use).  Install this AFTER installing TASK.

    Available at: http://www.atstake.com/research/tools/index.html


INSTALLATION NOTES
=============================================================================
- If you are planning on using the Autopsy Forensic Browser with TASK,
then it is recommended that you make a symbolic link from the specific
install directory (i.e. task-1.00) to a generic directory (i.e. task)
and use that location for the Autopsy configuration file.  For example:

    $ ln -s /usr/local/task-1.00 /usr/local/task


INSTALLATION
=============================================================================
TASK uses basically the same installation scripts that were written
for TCT.  The process should happen automatically by typing:

    $ make

The script attempts to identify if certain items on the system.  If the
script says that it can not find something, then it does not necessarily
mean that it is an error.

If you get a 'gcc: not found' error, then the compiler can not be
found (the GNU compiler is used by default).  If you only have 'cc'
installed, use the following line:

    $ make CC=cc

Or if you have gcc installed, but not you your path, use something like:

    $ make CC=/usr/local/bin/gcc

If you do not have Perl, then you can use:

    $ make no-perl

If you only want the mactime tool (i.e. the file systems tools do not
support your OS), then you can use:

    $ make mactime



All tools will be compiled into the 'bin' directory.  All manual pages
are located in the 'man' directory.  To always have access to the
manual pages, add the directory to your MANPATH environment variable.
If you would like the binaries to be placed in a common directory,
such as /usr/local/bin, then it must be done manually.


REFERENCES
=============================================================================
As much of the installation process is from The Coroners Toolkit (TCT),
much of this file is based on the original INSTALL file.


-----------------------------------------------------------------------------
Brian Carrier
June 19, 2002

