gdb/testsuite/boards/README

   1 This is a collection of boards for GDB.
   2
   3 The file gdb/testsuite/boards/README contains an overview of the boards.  The
   4 idea is to group similar boards together, and have one line to describe a
   5 board.
   6
   7 # Modify gdb default flags.
   8 readnow.exp
   9         Run gdb with -readnow.
  10
  11 # Post-process executable.
  12 cc-with-gdb-index.exp
  13         Use gdb to create .gdb_index section.
  14 cc-with-debug-names.exp
  15         Use gdb to create .debug_names section.
  16 cc-with-dwz.exp
  17         Use dwz to compress debug info in executable.
  18 cc-with-dwz-m.exp
  19         Use dwz to compress debug info in executable, optionally moving debug
  20         info to a separate file.
  21 cc-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.
  24 cc-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.
  29 debug-types.exp
  30         Add -fdebug-types-section.
  31 dwarf64.exp
  32         Add -gdwarf64.
  33 gold.exp
  34         Add -fuse-ld=gold.
  35 gold-gdb-index.exp
  36         Add -fuse-ld=gold -Wl,--gdb-index -ggnu-pubnames
  37 stabs.exp
  38         Add -gstabs+.
  39
  40 # Test -gsplit-dwarf.
  41 fission.exp
  42         Set debug_flags to -gdwarf-4 -gsplit-dwarf -ggnu-pubnames
  43         -fdebug-types-section -Wl,--gdb-index -fuse-ld=gold.
  44 fission-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.
  49 dwarf4-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.
  54 native-gdbserver.exp
  55         Test gdbserver using gdb_protocol remote.
  56 native-extended-gdbserver.exp
  57         Test gdbserver using gdb_protocol extended-remote.
  58 native-stdio-gdbserver.exp
  59         Test gdbserver using stdio connection.
  60
  61 # [is_remote host] == 0 && [is_remote target] == 1.
  62 remote-gdbserver-on-localhost.exp
  63         Run gdbserver on remote target.
  64 remote-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.
  69 local-remote-host-notty.exp
  70         Run gdb on remote host in pseudo-terminal with "set editing off".
  71 local-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.
  76 local-remote-host-native.exp
  77         Run gdb on remote host, run gdbserver on remote target, with
  78         host == target.
  79
  80 # Target-specific.
  81 simavr.exp
  82         Use simavr as target.
  83
  84 # Base boards, mostly to be included by other boards, so no individual
  85 # description.
  86 stdio-gdbserver-base.exp
  87 gdbserver-base.exp
  88 local-board.exp