
Installation instructions and requirements for The Coroner's Toolkit (TCT).

   ***                                                            ***
   ***                                                            ***
   *** TCT requires that the system have a working C compiler and ***
   *** perl, version 5.0004 or later.  The lsof utility is HIGHLY ***
   *** recommended.                                               ***
   ***                                                            ***
   ***                                                            ***

TCT is meant to be run from its own directory - efforts to move individual
files to various locations (/usr/local/bin or wherever) is left as an
excercise for the reader. If you do so, be aware that the file(1)
command has a non-standard path for the magic file wired into it.

Installation is therefore simple - find a location that has room -
preferably *lots* of room, as several of the tools in the toolkit can
generate *lots* of data (especially unrm/lazarus) and untar the thing.

   ***                                                              ***
   ***                                                              ***
   ***  At least 5 megabytes of storage is required for the output  ***
   *** of TCT, but it can easily consume 100 MB or more.  And the   ***
   *** unrm tool (which is not run from the main program, for what  ***
   *** will be obvious reasons) can consume *twice* as much disk    ***
   *** space as the unallocated (or free) space on a disk - easily  ***
   *** many *GB*'s (or more!) of data.  Be cautious and don't run   ***
   *** out of space!  It will help to practice on various systems   ***
   *** to get a feel for how much room it will consume.             ***
   ***                                                              ***
   ***                                                              ***


Currently the following OS's are at least semi-supported (e.g. the more 
recent versions (as of this writing, sep 16, 1999) of the OS should work):

  FreeBSD 2.*
  FreeBSD 3.*
  OpenBSD 2.*
   BSD/OS 2.*
   BSD/OS 3.*
    SunOS 4.*
    SunOS 5.*
    Linux 2.* (Tested only on Red Hat)


The "reconfig" program attempts to find perl and other various system 
utilities that are needed by the program, and needs to be executed first.
Don't be too alarmed by any files that it can't find - unless it's something
major, like perl (!) - it is attempting to find everything that it could
possibly use for any operating system.


The Makefile should automatically do the right thing.  Simply type "make".


At this point, if all has gone well, you can start using the toolkit.
You might read the "README" file in the "doc" directory for more instructions
on how to use this toolkit (or the "quick-start" mini doc for starting
very quickly). 

Individual utilities have manual pages in the "man" directory.

