$Id: README.MINOS,v 1.4 2004/02/22 20:37:43 bv Exp $

Intial version: Brett Viren Mon Sep 22 13:00:44 2003

This package contains underlying profiling engine from Jim Kowalkowski
and some python GUI wrapper by me.  It is partially integrated into
SRT.  Below describes what must be done to successfully build and use
it.  See the files in doc/ for more info.


3rd party build pre-requirements:
=================================

1) Install ELFIO library (required):

	http://elfio.sourceforge.net/

2) Install Python (strongly recommended):

	http://www.python.org/

Python is most certainly packaged for your system and may already be
installed.  Python 2.3 is recomended but older versions might work.
Python is required only for the post-processing of the profiling data,
but with out this, it will be very difficult to understand the
results.

3) Install Graphviz (recomended):

	http://www.graphviz.org/

Not required, but recomended if you want to actually understand the
output.  

Note the license for graphviz is less than Free Software and probably
isn't even Open Source (despite AT&T's Graphviz group's claim to the
contrary).  However, for our purposes, you should be okay to download,
compile and use it.  If you intend to re-distribute, read the FAQ.txt
in the top level directory of the Graphviz distribution.


Build time environment variables:
================================

When building PerfTools proper, some environment variables need to be
set in order to locate 3rd party software.  They are listed here along
with likely values.

  variable		likely value
  --------		------------
  ELFIO_DIR		/usr/local
  GRAPHVIZ_DIR		/usr/local
  PYTHON_INC		/usr/include/python2.3

Run time environment variables:
==============================

If you are NOT running in an SRT environment you must set PYTHONPATH
to point at the PerfTools/python subdirectory.  If running under SRT,
it should be found automatically.


-Brett.