From: Luis Machado <luis.machado@arm.com>
Date: Thu, 9 Jun 2022 10:33:09 +0000 (+0100)
Subject: Document the ARM_CC_FOR_TARGET testsuite variable
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=3abc1d8fe0e09a4ba806d5e2a1902ac45f825ee9;p=binutils-gdb.git

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.
---

diff --git a/gdb/testsuite/README b/gdb/testsuite/README
index 3a34dcdd154..330a385f349 100644
--- a/gdb/testsuite/README
+++ b/gdb/testsuite/README
@@ -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
 **************