tests: Update testing documentation

This edits the documentation regarding the usage of the --isa
tag, as this has fallen out of date in regards to the new
'ALL' isa.

Change-Id: I3b672ac2c03dd109bba458db688af05ed4135a91
Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/65651
Tested-by: kokoro <noreply+kokoro@google.com>
Reviewed-by: Bobby Bruce <bbruce@ucdavis.edu>
Maintainer: Bobby Bruce <bbruce@ucdavis.edu>
This commit is contained in:
Melissa Jost
2022-11-16 15:26:33 -08:00
parent e44cbe724b
commit aee282b79f
2 changed files with 13 additions and 6 deletions

View File

@@ -86,10 +86,10 @@ For instance, if you want to run only with `gem5.opt`, you can use
./main.py run --variant opt
```
Or, if you want to just run X86 tests with the `gem5.opt` binary:
Or, if you want to just run quick tests with the `gem5.opt` binary:
```shell
./main.py run --length quick --variant opt --isa X86
./main.py run --length quick --variant opt
```
@@ -102,6 +102,14 @@ To view all of the available tags, use
The output is split into tag *types* (e.g., isa, variant, length) and the
tags for each type are listed after the type name.
Note that when using the isa tag type, tests were traditionally sorted based
on what compilation it required. However, as tests have switched to all be
compiled under the ALL compilation, which includes all ISAs so one doesn't
need to compile each one individually, using the isa tag for ISAs other than
ALL has become a less optimal way of searching for tests. It would instead
be better to run subsets of tests based on their directories, as described
above.
You can specify "or" between tags within the same type by using the tag flag
multiple times. For instance, to run everything that is tagged "opt" or "fast"
use
@@ -112,10 +120,10 @@ use
You can also specify "and" between different types of tags by specifying more
than one type on the command line. For instance, this will only run tests with
both the "X86" and "opt" tags.
both the "ALL" and "opt" tags.
```shell
./main.py run --isa X86 --variant opt
./main.py run --isa All --variant opt
```
## Running tests in batch

View File

@@ -174,8 +174,7 @@ class SConsFixture(UniqueFixture):
)
log.test_log.message("%s" % (", ".join(self.targets)))
log.test_log.message(
"You may want to run with only a single ISA"
"(--isa=), use --skip-build, or use 'rerun'."
"You may want to use --skip-build, or use 'rerun'."
)
command.extend(self.targets)