README revision 9249:1f43ff3d9bc6
16019Shines@cs.fsu.eduThis is the gem5 simulator.
26019Shines@cs.fsu.edu
36019Shines@cs.fsu.eduFor detailed information about building the simulator and getting
46019Shines@cs.fsu.edustarted please refer to:
56019Shines@cs.fsu.edu* The main website:     http://www.gem5.org
66019Shines@cs.fsu.edu* Documentation wiki:   http://www.gem5.org/Documentation 
76019Shines@cs.fsu.edu* Doxygen generated:    http://www.gem5.org/docs
86019Shines@cs.fsu.edu* Tutorials:            http://www.gem5.org/Tutorials
96019Shines@cs.fsu.edu
106019Shines@cs.fsu.edu
116019Shines@cs.fsu.eduSpecific pages of interest are:
126019Shines@cs.fsu.eduhttp://www.gem5.org/Introduction
136019Shines@cs.fsu.eduhttp://www.gem5.org/Build_System
146019Shines@cs.fsu.eduhttp://www.gem5.org/Dependencies
156019Shines@cs.fsu.eduhttp://www.gem5.org/Running_gem5
166019Shines@cs.fsu.edu
176019Shines@cs.fsu.eduShort version:
186019Shines@cs.fsu.eduExternal tools and required versions
196019Shines@cs.fsu.edu
206019Shines@cs.fsu.eduTo build gem5, you will need the following software:
216019Shines@cs.fsu.edug++ version 4.3 or newer.
226019Shines@cs.fsu.eduPython, version 2.4 - 2.7 (we don't support Python 3.X). gem5 links in the 
236019Shines@cs.fsu.edu    Python interpreter, so you need the Python header files and shared 
246019Shines@cs.fsu.edu    library (e.g., /usr/lib/libpython2.4.so) in addition to the interpreter
256019Shines@cs.fsu.edu    executable. These may or may not be installed by default. For example,
266019Shines@cs.fsu.edu    on Debian/Ubuntu, you need the "python-dev" package in addition to the
276019Shines@cs.fsu.edu    "python" package. If you need a newer or different Python installation
286019Shines@cs.fsu.edu     but can't or don't want to upgrade the default Python on your system,
296019Shines@cs.fsu.edu     see http://www.gem5.org/Using_a_non-default_Python_installation
306019Shines@cs.fsu.eduSCons, version 0.98.1 or newer. SCons is a powerful replacement for make. 
316019Shines@cs.fsu.edu    If you don't have administrator privileges on your machine, you can use the
326019Shines@cs.fsu.edu    "scons-local" package to install scons in your m5 directory, or install SCons
336019Shines@cs.fsu.edu    in your home directory using the '--prefix=' option.  
346019Shines@cs.fsu.eduSWIG, version 1.3.34 or newer
356019Shines@cs.fsu.eduzlib, any recent version. For Debian/Ubuntu, you will need the "zlib-dev" or
366019Shines@cs.fsu.edu    "zlib1g-dev" package to get the zlib.h header file as well as the library
376019Shines@cs.fsu.edu    itself.
386019Shines@cs.fsu.edum4, the macro processor.
396019Shines@cs.fsu.edu
406019Shines@cs.fsu.edu
416019Shines@cs.fsu.edu4. In this directory, type 'scons build/<ARCH>/gem5.opt' where ARCH is one
426019Shines@cs.fsu.eduof ALPHA, ARM, MIPS, POWER, SPARC, or X86. This will build an optimized version
436019Shines@cs.fsu.eduof the gem5 binary (gem5.opt) for the the specified architecture.
446019Shines@cs.fsu.edu
456019Shines@cs.fsu.eduIf you have questions, please send mail to gem5-users@gem5.org
466019Shines@cs.fsu.edu
476019Shines@cs.fsu.eduWHAT'S INCLUDED (AND NOT)
486019Shines@cs.fsu.edu-------------------------
496019Shines@cs.fsu.edu
506019Shines@cs.fsu.eduThe basic source release includes these subdirectories:
516019Shines@cs.fsu.edu - gem5:
526019Shines@cs.fsu.edu   - configs: example simulation configuration scripts
536019Shines@cs.fsu.edu   - ext: less-common external packages needed to build gem5
546019Shines@cs.fsu.edu   - src: source code of the gem5 simulator
556019Shines@cs.fsu.edu   - system: source for some optional system software for simulated systems
566019Shines@cs.fsu.edu   - tests: regression tests
576019Shines@cs.fsu.edu   - util: useful utility programs and files
586019Shines@cs.fsu.edu
596019Shines@cs.fsu.eduTo run full-system simulations, you will need compiled system firmware
606019Shines@cs.fsu.edu(console and PALcode for Alpha), kernel binaries and one or more disk images. 
616019Shines@cs.fsu.eduPlease see the gem5 download page for these items at http://www.gem5.org/Download 
626019Shines@cs.fsu.edu