73f78b9587
top-level release dir) before shipping it. --HG-- extra : convert_revision : 3013379ec6dc95217f35aeef9df2e4ac0a33b69f
51 lines
2.1 KiB
Text
51 lines
2.1 KiB
Text
|
|
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.
|
|
|