fda4137780
The previous version of this requires the user to set the `main-isa` at runtime, as inplemented via https://gem5-review.googlesource.com/c/public/gem5/+/55423. In order to keep this work in-sync with how the multi-protocol approach will work (see here: https://gem5-review.googlesource.com/c/public/gem5/+/59193), it's been decided this should be set at compile time. With this we are keeping the `TARGET_ISA` parameter. If this is set, this is the de facto "main-isa". The `main-isa` parameter has been removed from the gem5 command-line. If the `TARGET_ISA` parameter is not set, but only one ISA is compiled, then this single ISA is assumed to be the `main-isa` for simulation. If neither `TARGET_ISA` is set or the binary is compiled to a single ISA, an exception is thrown when `get_runtime_isa` is called. At the time of writing this change is moot as the multi-isa work has yet to be merged into the gem5 develop branch. It exists here: https://gem5.googlesource.com/public/gem5/+/refs/heads/multi-isa and will need refactored to work with this patch. The multi-isa tests have been updated. As we no longer pass the `main-isa` as a run-time parameter, we remove many tests which validated this use-case. Change-Id: If3366212fe1dacbae389efa43d79349deb907537 Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/59949 Tested-by: kokoro <noreply+kokoro@google.com> Reviewed-by: Bobby Bruce <bbruce@ucdavis.edu> Maintainer: Bobby Bruce <bbruce@ucdavis.edu>
This is the gem5 simulator. The main website can be found at http://www.gem5.org 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. 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. 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. The main source tree includes these subdirectories: - build_opts: pre-made default configurations for gem5 - build_tools: tools used internally by gem5's build process. - configs: example simulation configuration scripts - ext: less-common external packages needed to build gem5 - include: include files for use in other programs - site_scons: modular components of the build system - src: source code of the gem5 simulator - 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 gem5-users@gem5.org Enjoy using gem5 and please share your modifications and extensions.