-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Change-Id: I2d6eb67b0f431b41e25c8f37dc087c7fbd54c47e
- Loading branch information
1 parent
f6e1fba
commit 544db5c
Showing
2 changed files
with
17 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,24 +1,23 @@ | ||
This is the gem5 simulator. | ||
## CAPStone gem5 simulator | ||
|
||
The main website can be found at http://www.gem5.org | ||
This repo contains an out of order CPU model for CAPStone, built on top | ||
of gem5's O3 CPU model. This design is intended to be used for performance evaluations. | ||
|
||
A good starting point is http://www.gem5.org/about, and for | ||
more information about building the simulator and getting started | ||
please see http://www.gem5.org/documentation and | ||
http://www.gem5.org/documentation/learning_gem5/introduction. | ||
This version of the CAPStone implementation is based on the CAPStone Academic Spec (vxx.xx, link) | ||
|
||
To build gem5, you will need the following software: g++ or clang, | ||
Python (gem5 links in the Python interpreter), SCons, zlib, m4, and lastly | ||
protobuf if you want trace capture and playback support. Please see | ||
http://www.gem5.org/documentation/general_docs/building for more details | ||
concerning the minimum versions of these tools. | ||
## Dependencies | ||
|
||
Once you have all dependencies resolved, type 'scons | ||
build/<CONFIG>/gem5.opt' where CONFIG is one of the options in build_opts like | ||
ARM, NULL, MIPS, POWER, SPARC, X86, Garnet_standalone, etc. This will build an | ||
optimized version of the gem5 binary (gem5.opt) with the the specified | ||
configuration. See http://www.gem5.org/documentation/general_docs/building for | ||
more details and options. | ||
To build, make sure you have apptainer installed. | ||
Then simply run the following from the project root directory: | ||
|
||
``` | ||
chmod +x run.sh | ||
./run.sh <NUM_THREADS> | ||
``` | ||
|
||
This will automatically build an apptainer image with all dependencies | ||
required to build gem5, and use that image to build gem5 and run Capstone | ||
functional tests. | ||
|
||
The main source tree includes these subdirectories: | ||
- build_opts: pre-made default configurations for gem5 | ||
|
@@ -31,13 +30,3 @@ The main source tree includes these subdirectories: | |
- system: source for some optional system software for simulated systems | ||
- tests: regression tests | ||
- util: useful utility programs and files | ||
|
||
To run full-system simulations, you may need compiled system firmware, kernel | ||
binaries and one or more disk images, depending on gem5's configuration and | ||
what type of workload you're trying to run. Many of those resources can be | ||
downloaded from http://resources.gem5.org, and/or from the git repository here: | ||
https://gem5.googlesource.com/public/gem5-resources/ | ||
|
||
If you have questions, please send mail to [email protected] | ||
|
||
Enjoy using gem5 and please share your modifications and extensions. |
Submodule src
updated
from e15b7d to e3a6b5