Nathan Binkert 368de4109f Sweeping change in the stats package....again...
base/statistics.cc:
    -  Merge the m5 display and simplescalar compatible display functions.
    -  Use functors for the stats printing instead of functions.  This
    gets rid of the very long argument lists and improves clarity.
    -  Fix a bug in binning that caused an invalid allocation to occur.
base/statistics.hh:
    -  Instead of using a compile time variable to choose whether
    to print in ss compat mode, we use a runtime variable.
    This is how we'll choose python output.
    -  There are no more virtual functions in the statistics themselves.
    All virtual functions have been moved into a secondary helper class.
    Every stat has an associated helper class that knows how to access
    certain variables in that stat.
    There is a hash_map from the stat to it's helper class data.  This was
    done because the helper data is only used during setup, stats reset,
    and printing.  All of which happen rarely, and you want to avoid
    any performance hit that you can.
    -  To provide the name(), desc(), etc functions to classes so that the
    user can set various parameters to the stats class, a single class
    containing all of those functions was created.  An odd trick was
    done to actually make this class derive from the stat class because
    a base class with no data actually does end up taking up space.
    -  The detail namespace was removed for now.  I'll put it back when the
    package is not in so much flux.
    -  Standard deviation, and mean were added to all distribution stats.
    -  There are several bugfixes and changes that aren't mentioned
test/Makefile:
    Don't test sim_stats foo.
test/stattest.cc:
    Don't test sim_stats foo.
    Fix bin usage so that it corresponds to the current usage.

--HG--
extra : convert_revision : ce8d9a8d485a84d55799f253d851e83650684170
2003-12-09 13:05:43 -05:00
2003-10-15 20:49:12 -04:00
2003-10-07 10:41:54 -04:00

This is release m5_1.0_beta1 of the M5 simulator.

This file contains brief "getting started" information and release
notes.  For more information, see http://m5.eecs.umich.edu.  If you
have questions, please send mail to m5sim-users@lists.sourceforge.net.

WHAT'S INCLUDED (AND NOT)
-------------------------

Since you're reading this file, presumably you've managed to untar the
distribution.  The archive you've unpacked has three subdirectories:
 - m5: the simulator itself
 - m5-test: regression tests and scripts to run them
 - ext: less-common external packages needed to build m5
   (currently just "ply")

Although M5 is capable of full-system simulation, the only OS it
currently supports is the proprietary Compaq/HP Tru64 version of Unix.
We are thus unable to distribute bootable disk images freely.  If you
have a Tru64 license and are interested in obtaining disk images,
contact us at m5-dev@eecs.umich.edu.

GETTING STARTED
---------------

The following steps will build and test the simulator.  The variable
"$top" refers to the top directory where you've unpacked the files,
i.e., the one containing the m5, m5-test, and ext directories.

cd $top/m5/setup
./setup ALPHA		# set up build/ALPHA directory
cd $top/m5/build/ALPHA
make m5.opt		# use "-j N" if you've got an MP system
# wait for build...
cd $top/m5-test
./do-tests.pl -B ALPHA	# test what you just built
# wait for tests to run...
# should end with "finished do-tests successfully!"

If you run into errors regarding m5/arch/alpha/decoder.cc, just
"touch" that file to update its timestamp.  This file is generated
from a compact ISA description using a program written in Python.  If
you have Python 2.2.2 or later installed on your system, you should be
able to generate it yourself, but if you don't have Python (or have an
older version), you may run in to trouble.  Since we've shipped a
working copy of decoder.cc, it's not necessary to have Python to build
M5 (unless you start modifying the ISA decription).  Unfortunately,
sometimes make gets confused and tries to do so anyway.  The "touch"
should convince make to stop trying.

Description
No description provided
Readme 272 MiB