Difference between revisions of "Extras"
m |
|||
| Line 1: | Line 1: | ||
| − | The <code>EXTRAS</code> SCons option is a way to add functionality in | + | The <code>EXTRAS</code> SCons option is a way to add functionality in gem5 without adding your files to the gem5 source tree. It's present to allow a user to compile in additional functionality that isn't or can't be distributed with gem5. This is useful for code that has an incompatible license, or code that is not suitable for inclusion in the gem5 source tree at the present time. |
| − | The EXTRAS functionality is used to support EIO traces. The trace reader for EIO is licensed under the SimpleScalar license and the code to read these traces is not included in the | + | The EXTRAS functionality is used to support EIO traces. The trace reader for EIO is licensed under the SimpleScalar license and the code to read these traces is not included in the gem5 distribution. |
The next examples show how to compile the EIO code. By adding to or modifying the extras path, any other suitable extra could be compiled in. To compile in code using EXTRAS simply execute the following | The next examples show how to compile the EIO code. By adding to or modifying the extras path, any other suitable extra could be compiled in. To compile in code using EXTRAS simply execute the following | ||
| − | scons EXTRAS=/path/to/m5_2.0_encumbered build/ | + | scons EXTRAS=/path/to/m5_2.0_encumbered build/ALPHA/gem5.opt |
In the root of this directory you should have a SConscript that uses the <code>Source()</code> and <code>SimObject()</code> scons functions that are used in the rest of M5 to compile the appropriate sources and add any SimObjects of interest. | In the root of this directory you should have a SConscript that uses the <code>Source()</code> and <code>SimObject()</code> scons functions that are used in the rest of M5 to compile the appropriate sources and add any SimObjects of interest. | ||
Revision as of 23:11, 27 August 2012
The EXTRAS SCons option is a way to add functionality in gem5 without adding your files to the gem5 source tree. It's present to allow a user to compile in additional functionality that isn't or can't be distributed with gem5. This is useful for code that has an incompatible license, or code that is not suitable for inclusion in the gem5 source tree at the present time.
The EXTRAS functionality is used to support EIO traces. The trace reader for EIO is licensed under the SimpleScalar license and the code to read these traces is not included in the gem5 distribution.
The next examples show how to compile the EIO code. By adding to or modifying the extras path, any other suitable extra could be compiled in. To compile in code using EXTRAS simply execute the following
scons EXTRAS=/path/to/m5_2.0_encumbered build/ALPHA/gem5.opt
In the root of this directory you should have a SConscript that uses the Source() and SimObject() scons functions that are used in the rest of M5 to compile the appropriate sources and add any SimObjects of interest.
Note that EXTRAS is a "sticky" parameter, so after a value is provided to scons once, the value will be reused for future scons invocations targeting the same build directory (build/ALPHA_SE in this case) as long as it is not overridden. Thus you only need to specify EXTRAS the first time you build a particular configuration or if you want to override a previously specified value. For more information on sticky scons options, see the SCons build system page.
To run a regression with EXTRAS use a command line similar to the following:
./util/regress --scons-opts="EXTRAS=/tmp/m5_2.0b4_encumbered" -j 2 quick
