1c1
< This is release m5_1.1 of the M5 simulator.
---
> This is release 2.0 of the M5 simulator.
3,5c3,4
< This file contains brief "getting started" instructions. For more
< information, see http://m5.eecs.umich.edu. If you have questions,
< please send mail to m5sim-users@lists.sourceforge.net.
---
> For information about building the simulator and getting started please refer
> to: http://m5.eecs.umich.edu/
6a6,11
> Specific Pages of Interest are:
> http://m5.eecs.umich.edu/wiki/index.php/Compiling_M5
> http://m5.eecs.umich.edu/wiki/index.php/Running_M5
>
> If you have questions, please send mail to m5sim-users@lists.sourceforge.net.
>
11,14c16,20
< - m5: the simulator itself
< - m5-test: regression tests
< - ext: less-common external packages needed to build m5
< - alpha-system: source for Alpha console and PALcode
---
> - m5:
> - src: source code of the m5 simulator
> - test: regression tests
> - ext: less-common external packages needed to build m5
> - system/alpha: source for Alpha console and PALcode
18c24
< are collected in a separate archive, m5_system_1.1.tar.bz2. This file
---
> are collected in a separate archive, m5_system_2.0.tar.bz2. This file
34,35c40,42
< http://m5.eecs.umich.edu/dist/linux_m5-2.6.8.1.diff, and the scons
< program is available from http://www.scons.org.
---
> http://m5.eecs.umich.edu/dist/linux_m5-2.6.8.1.diff, the scons
> program is available from http://www.scons.org, and swig is available from
> http://www.swig.org.
37,41d43
< WHAT'S NEEDED
< -------------
< - GCC version 3.3 or newer
< - Python 2.3 or newer
< - SCons 0.96.1 or newer (see http://www.scons.org)
43,96d44
< WHAT'S RECOMMENDED
< ------------------
< - MySQL (for statistics complex statistics storage/retrieval)
< - Python-MysqlDB (for statistics analysis)
<
< GETTING STARTED
< ---------------
<
< There are two different build targets and three optimizations levels:
<
< Target:
< -------
< ALPHA_SE - Syscall emulation simulation
< ALPHA_FS - Full system simulation
<
< Optimization:
< -------------
< m5.debug - debug version of the code with tracing and without optimization
< m5.opt - optimized version of code with tracing
< m5.fast - optimized version of the code without tracing and asserts
<
< Different targets are built in different subdirectories of m5/build.
< Binaries with the same target but different optimization levels share
< the same directory. Note that you can build m5 in any directory you
< choose;p just configure the target directory using the 'mkbuilddir'
< script in m5/build.
<
< 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. If you
< have a multiprocessor system, you should give scons a "-j N" argument (like
< make) to run N jobs in parallel.
<
< To build and test the syscall-emulation simulator:
<
< cd $top/m5/build
< scons ALPHA_SE/test/opt/quick
<
< This process takes under 10 minutes on a dual 3GHz Xeon system (using
< the '-j 4' option).
<
< To build and test the full-system simulator:
<
< 1. Unpack the full-system binaries from m5_system_1.1.tar.bz2. (See
< above for directions on obtaining this file if you don't have it.)
< This package includes disk images and kernel, palcode, and console
< binaries for Linux and FreeBSD.
< 2. Edit the SYSTEMDIR search path in $top/m5-test/SysPaths.py to
< include the path to your local copy of the binaries.
< 3. In $top/m5/build, run "scons ALPHA_FS/test/opt/quick".
<
< This process also takes under 10 minutes on a dual 3GHz Xeon system
< (again using the '-j 4' option).
<