Document the ARM_CC_FOR_TARGET testsuite variable

This variable is useful when exercising AArch64 multi-arch support (debugging
32-bit AArch32 executables).

Unfortunately it isn't well documented. This patch adds information about it
and explains how to use it.
This commit is contained in:
Luis Machado
2022-06-09 11:33:09 +01:00
parent 6a72edd8e2
commit 3abc1d8fe0

View File

@@ -328,6 +328,36 @@ For example, to turn on gdbserver debugging, you can do:
make check GDBSERVER_DEBUG="debug,replay"
Architecture-specific Parameters
******************************
This section documents architecture-specific parameters that can be used with
the GDB testsuite.
- AArch64 (Linux)
ARM_CC_FOR_TARGET
The AArch64 ports of GDB and GDBserver support debugging AArch32
32-bit programs running on 64-bit state. There are some tests under
gdb.multi/ that exercise this particular feature.
By default, the testsuite tries to find a compiler capable of
generating 32-bit executables. If no compiler is found, or if the
32-bit executable generated by the found compiler can't be executed
correctly, the tests will be marked UNSUPPORTED. The list of 32-bit
Arm compiler names the testsuite will try can be found in
gdb/testsuite/lib/gdb.exp:arm_cc_for_target.
You can set ARM_CC_FOR_TARGET to override the search and explicitly
specify the compiler to use. This variable should contain the command
line for the compiler, including the full path to it, if the compiler
is not in $PATH.
Example:
make check-gdb TESTS="gdb.multi/multi-arch.exp" RUNTESTFLAGS="ARM_CC_FOR_TARGET=arm-linux-gnueabihf-gcc"
Race detection
**************