Update make release, README, and RELEASE_NOTES for b5
[gem5.git] / README
1 This is release 2.0_beta5 of the M5 simulator.
2
3 For detailed information about building the simulator and getting
4 started please refer to http://www.m5sim.org.
5
6 Specific pages of interest are:
7 http://www.m5sim.org/wiki/index.php/Compiling_M5
8 http://www.m5sim.org/wiki/index.php/Running_M5
9
10 Short version:
11
12 1. If you don't have SCons version 0.96.91 or newer, get it from
13 http://wwww.scons.org.
14
15 2. If you don't have SWIG version 1.3.28 or newer, get it from
16 http://wwww.swig.org.
17
18 3. In this directory, type 'scons build/ALPHA_SE/tests/debug/quick'. This
19 will build the debug version of the m5 binary (m5.debug) for the Alpha
20 syscall emulation target, and run the quick regression tests on it.
21
22 If you have questions, please send mail to m5-users@m5sim.org
23
24 WHAT'S INCLUDED (AND NOT)
25 -------------------------
26
27 The basic source release includes these subdirectories:
28 - m5:
29 - src: source code of the m5 simulator
30 - tests: regression tests
31 - ext: less-common external packages needed to build m5
32
33 To run full-system simulations, you will need compiled console,
34 PALcode, and kernel binaries and one or more disk images. These files
35 are collected in a separate archive, m5_system.tar.bz2. This file
36 can he downloaded separately.
37
38 M5 supports Linux 2.4/2.6, FreeBSD, and the proprietary Compaq/HP
39 Tru64 version of Unix. We are able to distribute Linux and FreeBSD
40 bootdisks, but we are unable to distribute bootable disk images of
41 Tru64 Unix. If you have a Tru64 license and are interested in
42 obtaining disk images, contact us at m5-users@m5sim.org