README revision 5193:5485f026271e
16313Sgblack@eecs.umich.eduThis is release 2.0_beta4 of the M5 simulator.
26313Sgblack@eecs.umich.edu
36313Sgblack@eecs.umich.eduFor detailed information about building the simulator and getting
46313Sgblack@eecs.umich.edustarted please refer to http://www.m5sim.org.
56313Sgblack@eecs.umich.edu
66313Sgblack@eecs.umich.eduSpecific pages of interest are:
76313Sgblack@eecs.umich.eduhttp://www.m5sim.org/wiki/index.php/Compiling_M5
86313Sgblack@eecs.umich.eduhttp://www.m5sim.org/wiki/index.php/Running_M5
96313Sgblack@eecs.umich.edu
106313Sgblack@eecs.umich.eduShort version:
116313Sgblack@eecs.umich.edu
126313Sgblack@eecs.umich.edu1. If you don't have SCons version 0.96.91 or newer, get it from
136313Sgblack@eecs.umich.eduhttp://wwww.scons.org.
146313Sgblack@eecs.umich.edu
156313Sgblack@eecs.umich.edu2. If you don't have SWIG version 1.3.28 or newer, get it from
166313Sgblack@eecs.umich.eduhttp://wwww.swig.org.
176313Sgblack@eecs.umich.edu
186313Sgblack@eecs.umich.edu3. In this directory, type 'scons build/ALPHA_SE/tests/debug/quick'.  This
196313Sgblack@eecs.umich.eduwill build the debug version of the m5 binary (m5.debug) for the Alpha
206313Sgblack@eecs.umich.edusyscall emulation target, and run the quick regression tests on it.
216313Sgblack@eecs.umich.edu
226313Sgblack@eecs.umich.eduIf you have questions, please send mail to m5-users@m5sim.org
236313Sgblack@eecs.umich.edu
246313Sgblack@eecs.umich.eduWHAT'S INCLUDED (AND NOT)
256313Sgblack@eecs.umich.edu-------------------------
266313Sgblack@eecs.umich.edu
276313Sgblack@eecs.umich.eduThe basic source release includes these subdirectories:
286313Sgblack@eecs.umich.edu - m5: 
296313Sgblack@eecs.umich.edu   - src: source code of the m5 simulator
306313Sgblack@eecs.umich.edu   - tests: regression tests
3111793Sbrandon.potter@amd.com   - ext: less-common external packages needed to build m5
3211793Sbrandon.potter@amd.com
336335Sgblack@eecs.umich.eduTo run full-system simulations, you will need compiled console,
349377Sgblack@eecs.umich.eduPALcode, and kernel binaries and one or more disk images.  These files
356335Sgblack@eecs.umich.eduare collected in a separate archive, m5_system.tar.bz2.  This file
366335Sgblack@eecs.umich.educan he downloaded separately.
376335Sgblack@eecs.umich.edu
386313Sgblack@eecs.umich.eduM5 supports Linux 2.4/2.6, FreeBSD, and the proprietary Compaq/HP
398232Snate@binkert.orgTru64 version of Unix. We are able to distribute Linux and FreeBSD
408232Snate@binkert.orgbootdisks, but we are unable to distribute bootable disk images of
419384SAndreas.Sandberg@arm.comTru64 Unix. If you have a Tru64 license and are interested in
426313Sgblack@eecs.umich.eduobtaining disk images, contact us at m5-users@m5sim.org
436313Sgblack@eecs.umich.edu