From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by sourceware.org (Postfix) with ESMTPS id 3047A3858D3C for ; Tue, 11 Oct 2022 10:17:19 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 3047A3858D3C Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 6179D219E9 for ; Tue, 11 Oct 2022 10:17:18 +0000 (UTC) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id 4B3F9139ED for ; Tue, 11 Oct 2022 10:17:18 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id DKo8Ea5CRWNpEQAAMHmgww (envelope-from ) for ; Tue, 11 Oct 2022 10:17:18 +0000 Date: Tue, 11 Oct 2022 12:17:16 +0200 From: Tom de Vries To: gdb-patches@sourceware.org Subject: [PATCH][gdb/testsuite] Add boards/README Message-ID: <20221011101714.GA30647@delia.home> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.10.1 (2018-07-13) X-Spam-Status: No, score=-12.6 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 11 Oct 2022 10:17:22 -0000 Hi, Add a file gdb/testsuite/boards/README, to make it easier to get a high-level overview of the various boards. Any comments? Thanks, - Tom [gdb/testsuite] Add boards/README --- gdb/testsuite/boards/README | 88 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) diff --git a/gdb/testsuite/boards/README b/gdb/testsuite/boards/README new file mode 100644 index 00000000000..f3994da365c --- /dev/null +++ b/gdb/testsuite/boards/README @@ -0,0 +1,88 @@ +This is a collection of boards for GDB. + +The file gdb/testsuite/boards/README contains an overview of the boards. The +idea is to group similar boards together, and have one line to describe a +board. + +# Modify gdb default flags. +readnow.exp + Run gdb with -readnow. + +# Post-process executable. +cc-with-gdb-index.exp + Use gdb to create .gdb_index section. +cc-with-debug-names.exp + Use gdb to create .debug_names section. +cc-with-dwz.exp + Use dwz to compress debug info in executable. +cc-with-dwz-m.exp + Use dwz to compress debug info in executable, optionally moving debug + info to a separate file. +cc-with-gnu-debuglink.exp + Use strip to move the debug info from executable to a separate file, + and add a .gnu_debuglink to it. +cc-with-tweaks.exp + Base board used by all boards in this section, but can be used by + itself, f.i. do more than one type of post-processing. + +# Modify debug_flags. +debug-types.exp + Add -fdebug-types-section. +dwarf64.exp + Add -gdwarf64. +gold.exp + Add -fuse-ld=gold. +gold-gdb-index.exp + Add -fuse-ld=gold -Wl,--gdb-index -ggnu-pubnames +stabs.exp + Add -gstabs+. + +# Test -gsplit-dwarf. +fission.exp + Set debug_flags to -gdwarf-4 -gsplit-dwarf -ggnu-pubnames + -fdebug-types-section -Wl,--gdb-index -fuse-ld=gold. +fission-dwp.exp + As fission.exp, but also post-process executables to generate a .dwp + file. + +# Test various things at the same time. +dwarf4-gdb-index.exp + Set debug_flags to -gdwarf-4 -fdebug-types-section, and post-process + executable using gdb to create .gdb_index section. + +# [is_remote host] == 0 && [is_remote target] == 0. +native-gdbserver.exp + Test gdbserver using gdb_protocol remote. +native-extended-gdbserver.exp + Test gdbserver using gdb_protocol extended-remote. +native-stdio-gdbserver.exp + Test gdbserver using stdio connection. + +# [is_remote host] == 0 && [is_remote target] == 1. +remote-gdbserver-on-localhost.exp + Run gdbserver on remote target. +remote-stdio-gdbserver.exp + Run gdbserver on remote target, using stdio connection. + +# [is_remote host] == 1 && [is_remote target] == 0. +# Note: need to pass the board with --host_board instead of --target_board. +local-remote-host-notty.exp + Run gdb on remote host. +local-remote-host.exp + Run gdb on remote host in pseudo-terminal. + +# [is_remote host] == 1 && [is_remote target] == 1. +# Note: need to pass the board with both --target_board and --host_board. +local-remote-host-native.exp + Run gdb on remote host, run gdbserver on remote target, with + host == target. + +# Target-specific. +simavr.exp + Use simavr as target. + +# Base boards, mostly to be included by other boards, so no individual +# description. +stdio-gdbserver-base.exp +gdbserver-base.exp +local-board.exp