summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSteve Reinhardt <stever@eecs.umich.edu>2005-10-06 13:59:05 -0400
committerSteve Reinhardt <stever@eecs.umich.edu>2005-10-06 13:59:05 -0400
commita7974eef6b01655700bab0f40c318450ff42a375 (patch)
tree8616349b6c67d537703492650cb03263e09a429f
parentaf2a600f99ce2989d8aa888efa62795123e89dae (diff)
downloadgem5-a7974eef6b01655700bab0f40c318450ff42a375.tar.xz
More documentation for 1.1 release.
README: More updates for 1.1 release. --HG-- extra : convert_revision : 3e39cf4d1cba49dfb254cd1047144ac2aa728221
-rw-r--r--README63
-rw-r--r--RELEASE_NOTES29
2 files changed, 70 insertions, 22 deletions
diff --git a/README b/README
index af1057577..62214d8c5 100644
--- a/README
+++ b/README
@@ -1,24 +1,38 @@
This is release m5_1.1 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.
+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.
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:
+The basic source release includes these subdirectories:
- m5: the simulator itself
- - m5-test: regression tests and scripts to run them
+ - m5-test: regression tests
- ext: less-common external packages needed to build m5
- alpha-system: source for Alpha console and PALcode
-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.
+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_1.1.tar.bz2. This file
+is included on the CD release, or you can download it separately from
+Sourceforge.
+
+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-dev@eecs.umich.edu.
+
+The CD release includes a few extra goodies, such as a tar file
+containing doxygen-generated HTML documentation (html-docs.tar.gz), a
+set of Linux source patches (linux_m5-2.6.8.1.diff), and the scons
+program needed to build M5. If you do not have the CD, the same HTML
+documentation is available online at http://m5.eecs.umich.edu/docs,
+the Linux source patches are available at
+http://m5.eecs.umich.edu/dist/linux_m5-2.6.8.1.diff, and the scons
+program is available from http://www.scons.org.
WHAT'S NEEDED
-------------
@@ -50,8 +64,8 @@ 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 by copying the SConstruct file there and creating symbolic links
-to the 'm5' and 'ext' directories.
+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,
@@ -64,14 +78,19 @@ To build and test the syscall-emulation simulator:
cd $top/m5/build
scons ALPHA_SE/test/opt/quick
-To build and test the full-system simualator:
+This process takes under 10 minutes on a dual 3GHz Xeon system (using
+the '-j 4' option).
-1. Unpack the full-system binaries from m5_system_1.1.tar.bz2. This file
- is included on the CD release, or you can download it from
- http://m5.eecs.umich.edu/dist/ m5_system_1.1.tar.bz2.) This package
- includes disk images and kernel, palcode, and console binaries
- for Linux and FreeBSD.
-2. Edit SYSTEMDIR in $top/m5-test/SysPaths.py to point to your local copy
- of the binaries.
-3. In $top/m5/build, run "scons ALPHA_FS/opt/test/quick".
+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).
diff --git a/RELEASE_NOTES b/RELEASE_NOTES
new file mode 100644
index 000000000..983c9b2e9
--- /dev/null
+++ b/RELEASE_NOTES
@@ -0,0 +1,29 @@
+Oct. 8, 2005: m5_1.1
+--------------------
+Update release for IOSCA workshop mini-tutorial. New features include:
+- Preliminary FreeBSD support
+- Integration of regression tests into scons build framework
+- Several bug fixes and better compatibility for Cygwin hosts
+- Major cleanup of Alpha system code (console, PAL, etc.) to make
+ it easier for others to build/modify
+- Fixes to enable compilation under g++ 4.0
+- Numerous minor bug fixes
+
+June 10, 2005: m5_1.0_web
+-------------------------
+The 1.0 release posted on Sourceforge after the ISCA tutorial contains
+just a few very minor fixes relative to the CD.
+
+June 5, 2005: m5_1.0_tutorial
+-----------------------------
+First non-beta release. This release was on the CD distributed at the
+ISCA tutorial. Major enhancements relative to beta releases include
+Linux support and Python-based configuration language.
+
+June 17, 2004: m5_1.0_beta2
+---------------------------
+Stealth-mode beta bug-fix update, not widely advertised.
+
+Oct. 17, 2003: m5_1.0_beta1
+---------------------------
+Early beta release.