X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=README;h=f8eef7417d29b0e78eaa7c8afb6a475db7dc1461;hb=b41725f7234e17d6d66d697ef415a4cb1bae80d9;hp=37ebeb403afbd7dc22acfdba01a9aa52b979ffb8;hpb=d9991ff59953389251c6d081c6318ac1e0549954;p=gem5.git diff --git a/README b/README index 37ebeb403..f8eef7417 100644 --- a/README +++ b/README @@ -1,59 +1,42 @@ -This is release m5_1.0 of the M5 simulator. +This is release 2.0_beta6 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. +For detailed information about building the simulator and getting +started please refer to http://www.m5sim.org. + +Specific pages of interest are: +http://www.m5sim.org/wiki/index.php/Compiling_M5 +http://www.m5sim.org/wiki/index.php/Running_M5 + +Short version: + +1. If you don't have SCons version 0.96.91 or newer, get it from +http://wwww.scons.org. + +2. If you don't have SWIG version 1.3.28 or newer, get it from +http://wwww.swig.org. + +3. In this directory, type 'scons build/ALPHA_SE/tests/debug/quick'. This +will build the debug version of the m5 binary (m5.debug) for the Alpha +syscall emulation target, and run the quick regression tests on it. + +If you have questions, please send mail to m5-users@m5sim.org 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 ply and libelf) - -M5 is a capable, full-system simulator that current supports both Linux -2.4/2.6 and the proprietary Compaq/HP Tru64 version of Unix. We are able -to distribute Linux bootdisks, but we are unable to distribute bootable -disk images of Tru64 Unix. If you have a Tru64 license and are interested -in obtaining disk images, contact us at m5-dev@eecs.umich.edu. - -WHAT'S NEEDED -------------- --GCC(3.X) --Python(2.4+) - -WHAT'S RECOMMENDED ------------------- --MySQL (for statistics complex statistics storage/retrieval) --Python-MysqlDB (for statistics analysis) - -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. - -There are three different build targets and three optimizations in each level: -Target: -------- -ALPHA_SE - Syscall emulation simulation -ALPHA_FS - Linux full system simulation -ALPHA_FS_TL - Tru64 (Turbolaser) Unix 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 - -cd $top/m5/build -scons TARGET/OPTLEVL # e.g. ALPHA_FS/m5.opt, use -j N if you have a MP system -cd $top/m5-test -./do-tests.pl -B ALPHA_SE # test what you just built -./do-tests.pl -B ALPHA_FS # test what you just built -# wait for tests to run... -# should end with "finished do-tests successfully!" +The basic source release includes these subdirectories: + - m5: + - src: source code of the m5 simulator + - tests: regression tests + - ext: less-common external packages needed to build m5 + +To run full-system simulations, you will need compiled console, +PALcode, and kernel binaries and one or more disk images. These files +are collected in a separate archive, m5_system.tar.bz2. This file +can he downloaded separately. + +M5 supports Linux 2.4/2.6, FreeBSD, and the proprietary Compaq/HP +Tru64 version of Unix. We are able to distribute Linux and FreeBSD +bootdisks, but we are unable to distribute bootable disk images of +Tru64 Unix. If you have a Tru64 license and are interested in +obtaining disk images, contact us at m5-users@m5sim.org