tests,misc: update TESTING.md documentation
authorGiacomo Travaglini <giacomo.travaglini@arm.com>
Thu, 16 Jan 2020 10:01:08 +0000 (10:01 +0000)
committerGiacomo Travaglini <giacomo.travaglini@arm.com>
Tue, 11 Feb 2020 09:34:44 +0000 (09:34 +0000)
* Documentation was assuming only tests in tests/test-progs were run.
This is not true anymore since we are running linux-boot for arm
which doesn't have a directory inside test-progs and because it
is now possible to explicitly specify the bin directory
(--bin-path)

Change-Id: I4cbb02fa1c88839be45302ea64e07792e1fc81f5
Signed-off-by: Giacomo Travaglini <giacomo.travaglini@arm.com>
Reviewed-by: Ciro Santilli <ciro.santilli@arm.com>
Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/24526
Reviewed-by: Jason Lowe-Power <jason@lowepower.com>
Maintainer: Jason Lowe-Power <jason@lowepower.com>
Tested-by: kokoro <noreply+kokoro@google.com>
TESTING.md

index cf160e609bc30abb2f469f328eeb0cefe4291ad4..66706216776d99578b71934bc3ea000c53f42b67 100644 (file)
@@ -197,16 +197,23 @@ if the file causes an exception. This means there are no tests in that file
 
 ## Binary test applications
 
-The code for test binaries that are run in the gem5 guest during testing are
-found in `tests/test-progs`.
+The code for some test binaries that are run in the gem5 guest during
+testing can be found in `tests/test-progs`.
 There's one directory per test application.
 The source code is under the `source` directory.
 
 You may have a `bin` directory as well.
 The `bin` directory is automatically created when running the test case that
-uses the test binary. The binary is downloaded from the gem5 servers the first
+uses the test binary.
+This is not the case when a test is run via the --bin-path option.
+In that scenario a bin directory will be created in the selected path
+rather than in `tests/test-progs`.
+The binary is downloaded from the gem5 servers the first
 time it is referenced by a test.
 
+Some other tests (like Linux-boot) don't have sources inside gem5 and
+are simply downloaded from gem5 servers.
+
 ## Updating the test binaries
 
 The test infrastructure should check with the gem5 servers to ensure you have