user/tools/tester.rst: Clarifies the need of --rtems-tools in rtems-test command line

This commit is contained in:
Cláudio Maia 2020-04-09 15:34:11 +01:00 committed by Gedare Bloom
parent 564007287c
commit 6566e765f9

View File

@ -280,7 +280,6 @@ BSP build tree:
$ ~/development/rtems/test/rtems-tools.git/tester/rtems-test \ $ ~/development/rtems/test/rtems-tools.git/tester/rtems-test \
--log=log_erc32_run \ --log=log_erc32_run \
--rtems-bsp=erc32-run \ --rtems-bsp=erc32-run \
--rtems-tools=$HOME/development/rtems/5 \
sparc-rtems5/c/erc32/testsuites/samples sparc-rtems5/c/erc32/testsuites/samples
RTEMS Testing - Tester, 5.not_released RTEMS Testing - Tester, 5.not_released
[ 1/13] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 | sparc/erc32: base_sp.exe [ 1/13] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 | sparc/erc32: base_sp.exe
@ -316,7 +315,6 @@ appearance above, we have the following:
* The ``--log`` option sends the output to a log file. By default only failed * The ``--log`` option sends the output to a log file. By default only failed
tests log the complete output. tests log the complete output.
* The ``--rtems-bsp`` option selects the erc32 BSP. * The ``--rtems-bsp`` option selects the erc32 BSP.
* The path to the RTEMS tools so GDB can be found.
* The path to the erc32 BSP tests to run. If you add subdirectories * The path to the erc32 BSP tests to run. If you add subdirectories
to the path specific tests can be run. to the path specific tests can be run.
* The test results so far. See details below. * The test results so far. See details below.
@ -332,10 +330,14 @@ appearance above, we have the following:
``sparc-rtems5/c/erc32/testsuites/samples`` then all the executables ``sparc-rtems5/c/erc32/testsuites/samples`` then all the executables
would have been tested and not just those in samples. would have been tested and not just those in samples.
This BSP requires the ``--rtems-tools`` option because the SPARC GDB is the .. note:: Some BSPs require the use of the specific target architecture GDB
``sparc-rtems4.11-gdb`` command that is part of the RTEMS tools. Not every BSP command (e.g. RTEMS 5 SPARC GDB command is ``sparc-rtems5-gdb``).
will require this option so you will need to check the specifics of the BSP As this command is part of the RTEMS tools, the ``--rtems-tools``
configuration you are using in order to determine if it is needed. option should be added to the ``rtems-test`` command line, e.g.
``--rtems-tools=$HOME/development/rtems/5``.
Not every BSP requires this option so you will need to check the
specifics of the BSP configuration you are using in order to
determine if this option is needed.
An output line is printed for each test that is executed. The :program:`rtems-test` An output line is printed for each test that is executed. The :program:`rtems-test`
command by default runs multiple tests in parallel so you will see a number command by default runs multiple tests in parallel so you will see a number