From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1585) id 8B715385023B; Fri, 10 Jun 2022 09:29:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 8B715385023B Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Luis Machado To: gdb-cvs@sourceware.org Subject: [binutils-gdb] Document the ARM_CC_FOR_TARGET testsuite variable X-Act-Checkin: binutils-gdb X-Git-Author: Luis Machado X-Git-Refname: refs/heads/master X-Git-Oldrev: 6a72edd8e26c670bbdce7aeae3c0c8f793fc8612 X-Git-Newrev: 3abc1d8fe0e09a4ba806d5e2a1902ac45f825ee9 Message-Id: <20220610092934.8B715385023B@sourceware.org> Date: Fri, 10 Jun 2022 09:29:34 +0000 (GMT) X-BeenThere: gdb-cvs@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 10 Jun 2022 09:29:34 -0000 https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D3abc1d8fe0e0= 9a4ba806d5e2a1902ac45f825ee9 commit 3abc1d8fe0e09a4ba806d5e2a1902ac45f825ee9 Author: Luis Machado Date: Thu Jun 9 11:33:09 2022 +0100 Document the ARM_CC_FOR_TARGET testsuite variable =20 This variable is useful when exercising AArch64 multi-arch support (deb= ugging 32-bit AArch32 executables). =20 Unfortunately it isn't well documented. This patch adds information abo= ut it and explains how to use it. Diff: --- gdb/testsuite/README | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) 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 d= o: =20 make check GDBSERVER_DEBUG=3D"debug,replay" =20 +Architecture-specific Parameters +****************************** + +This section documents architecture-specific parameters that can be used w= ith +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=3D"gdb.multi/multi-arch.exp" RUNTESTFLAGS=3D"ARM_CC_= FOR_TARGET=3Darm-linux-gnueabihf-gcc" + Race detection **************