xref: /netbsd-src/external/gpl3/gdb/dist/gdb/testsuite/boards/README (revision 4b169a6ba595ae283ca507b26b15fdff40495b1c)
1This is a collection of boards for GDB.
2
3The file gdb/testsuite/boards/README contains an overview of the boards.  The
4idea is to group similar boards together, and have one line to describe a
5board.
6
7# Modify gdb default flags.
8readnow.exp
9	Run gdb with -readnow.
10
11# Post-process executable.
12cc-with-gdb-index.exp
13	Use gdb to create .gdb_index section.
14cc-with-debug-names.exp
15	Use gdb to create .debug_names section.
16cc-with-dwz.exp
17	Use dwz to compress debug info in executable.
18cc-with-dwz-m.exp
19	Use dwz to compress debug info in executable, optionally moving debug
20	info to a separate file.
21cc-with-gnu-debuglink.exp
22	Use strip to move the debug info from executable to a separate file,
23	and add a .gnu_debuglink to it.
24cc-with-tweaks.exp
25	Base board used by all boards in this section, but can be used by
26	itself,	f.i. do more than one type of post-processing.
27
28# Modify debug_flags.
29debug-types.exp
30	Add -fdebug-types-section.
31dwarf64.exp
32	Add -gdwarf64.
33gold.exp
34	Add -fuse-ld=gold.
35gold-gdb-index.exp
36	Add -fuse-ld=gold -Wl,--gdb-index -ggnu-pubnames
37stabs.exp
38	Add -gstabs+.
39
40# Test -gsplit-dwarf.
41fission.exp
42	Set debug_flags to -gdwarf-4 -gsplit-dwarf -ggnu-pubnames
43	-fdebug-types-section -Wl,--gdb-index -fuse-ld=gold.
44fission-dwp.exp
45	As fission.exp, but also post-process executables to generate a .dwp
46	file.
47
48# Test various things at the same time.
49dwarf4-gdb-index.exp
50	Set debug_flags to -gdwarf-4 -fdebug-types-section, and post-process
51	executable using gdb to create .gdb_index section.
52
53# [is_remote host] == 0 && [is_remote target] == 0.
54native-gdbserver.exp
55	Test gdbserver using gdb_protocol remote.
56native-extended-gdbserver.exp
57	Test gdbserver using gdb_protocol extended-remote.
58native-stdio-gdbserver.exp
59	Test gdbserver using stdio connection.
60
61# [is_remote host] == 0 && [is_remote target] == 1.
62remote-gdbserver-on-localhost.exp
63	Run gdbserver on remote target.
64remote-stdio-gdbserver.exp
65	Run gdbserver on remote target, using stdio connection.
66
67# [is_remote host] == 1 && [is_remote target] == 0.
68# Note: need to pass the board with --host_board instead of --target_board.
69local-remote-host-notty.exp
70	Run gdb on remote host in pseudo-terminal with "set editing off".
71local-remote-host.exp
72	Run gdb on remote host in pseudo-terminal.
73
74# [is_remote host] == 1 && [is_remote target] == 1.
75# Note: need to pass the board with both --target_board and --host_board.
76local-remote-host-native.exp
77	Run gdb on remote host, run gdbserver on remote target, with
78	host == target.
79
80# Target-specific.
81simavr.exp
82	Use simavr as target.
83
84# Base boards, mostly to be included by other boards, so no individual
85# description.
86stdio-gdbserver-base.exp
87gdbserver-base.exp
88local-board.exp
89