1 # Copyright 2000-2015 Free Software Foundation, Inc.
3 # This program is free software; you can redistribute it and/or modify
4 # it under the terms of the GNU General Public License as published by
5 # the Free Software Foundation; either version 3 of the License, or
6 # (at your option) any later version.
8 # This program is distributed in the hope that it will be useful,
9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 # GNU General Public License for more details.
13 # You should have received a copy of the GNU General Public License
14 # along with this program. If not, see <http://www.gnu.org/licenses/>.
16 # This file is based on config/gdbserver.exp, which was written by
17 # Michael Snyder (msnyder@redhat.com).
20 # To be addressed or set in your baseboard config file:
22 # set_board_info gdb_protocol "remote"
23 # Unles you have a gdbserver that uses a different protocol...
24 # After GDB starts you should check global $gdbserver_protocol instead as
25 # the testfile may force a specific different target protocol itself.
27 # set_board_info gdb_server_prog
28 # This will be the path to the gdbserver program you want to test.
29 # Defaults to "gdbserver".
31 # set_board_info sockethost
32 # The name of the host computer whose socket is being used.
33 # Defaults to "localhost". Note: old gdbserver requires
34 # that you define this, but libremote/gdbserver does not.
36 # set_board_info gdb,socketport
37 # Port id to use for socket connection. If not set explicitly,
38 # it will start at "2345" and increment for each use.
39 # After GDB starts you should check global $gdbserver_gdbport for the
40 # real port used. It is not useful if $gdbserver_reconnect_p was not set.
45 # Send gdb the "target" command
47 proc gdb_target_cmd { targetname serialport } {
50 set serialport_re [string_to_regexp $serialport]
51 for {set i 1} {$i <= 3} {incr i} {
52 send_gdb "target $targetname $serialport\n"
54 -re "A program is being debugged already.*ill it.*y or n. $" {
58 -re "unknown host.*$gdb_prompt" {
59 verbose "Couldn't look up $serialport"
61 -re "Couldn't establish connection to remote.*$gdb_prompt $" {
62 verbose "Connection failed"
64 -re "Remote MIPS debugging.*$gdb_prompt" {
65 verbose "Set target to $targetname"
68 -re "Remote debugging using .*$serialport_re.*$gdb_prompt $" {
69 verbose "Set target to $targetname"
72 -re "Remote debugging using stdio.*$gdb_prompt $" {
73 verbose "Set target to $targetname"
76 -re "Remote target $targetname connected to.*$gdb_prompt $" {
77 verbose "Set target to $targetname"
80 -re "Connected to.*$gdb_prompt $" {
81 verbose "Set target to $targetname"
84 -re "Ending remote.*$gdb_prompt $" { }
85 -re "Connection refused.*$gdb_prompt $" {
86 verbose "Connection refused by remote target. Pausing, and trying again."
90 -re "Timeout reading from remote system.*$gdb_prompt $" {
91 verbose "Got timeout error from gdb."
93 -notransfer -re "Remote debugging using .*\r\n> $" {
94 # We got an unexpected prompt while creating the target.
95 # Leave it there for the test to diagnose.
111 # Locate the gdbserver binary. Returns "" if gdbserver could not be found.
113 proc find_gdbserver { } {
117 if [info exists GDBSERVER] {
121 if [target_info exists gdb_server_prog] {
122 return [target_info gdb_server_prog]
125 set gdbserver "${GDB}server"
126 if { [file isdirectory $gdbserver] } {
127 append gdbserver "/gdbserver"
130 if { [file executable $gdbserver] } {
137 # Return non-zero if we should skip gdbserver-specific tests.
139 proc skip_gdbserver_tests { } {
140 if { [find_gdbserver] == "" } {
147 # Download the currently loaded program to the target if necessary.
148 # Return the target system filename.
149 # NOTE: This was named "gdbserver_download", but that collides with the
150 # dejagnu "download" API function when using load_generic_config "gdbserver".
152 proc gdbserver_download_current_prog { } {
153 global gdbserver_host_exec
154 global gdbserver_host_mtime
155 global gdbserver_server_exec
156 global last_loaded_file
158 set host_exec $last_loaded_file
160 # If we already downloaded a file to the target, see if we can reuse it.
162 if { [info exists gdbserver_server_exec] } {
165 # If the file has changed, we can not.
166 if { $host_exec != $gdbserver_host_exec } {
170 # If the mtime has changed, we can not.
171 if { [file mtime $host_exec] != $gdbserver_host_mtime } {
177 set gdbserver_host_exec $host_exec
178 set gdbserver_host_mtime [file mtime $host_exec]
179 if [is_remote target] {
180 set gdbserver_server_exec [gdb_download $host_exec]
182 set gdbserver_server_exec $host_exec
186 return $gdbserver_server_exec
189 # Default routine to compute the argument to "target remote".
191 proc gdbserver_default_get_remote_address { host port } {
192 # Historically HOST included the trailing ":".
193 # To avoid breaking any board files out there we leave things alone.
197 # Default routine to compute the "comm" argument for gdbserver.
199 proc gdbserver_default_get_comm_port { port } {
203 # Start a gdbserver process with initial OPTIONS and trailing ARGUMENTS.
204 # The port will be filled in between them automatically.
206 # Returns the target protocol and socket to connect to.
208 proc gdbserver_start { options arguments } {
211 # Port id -- either specified in baseboard file, or managed here.
212 if [target_info exists gdb,socketport] {
213 set portnum [target_info gdb,socketport]
215 # Bump the port number to avoid conflicts with hung ports.
219 # Extract the local and remote host ids from the target board struct.
220 if [target_info exists sockethost] {
221 set debughost [target_info sockethost]
223 set debughost "localhost:"
226 # Some boards use a different value for the port that is passed to
227 # gdbserver and the port that is passed to the "target remote" command.
228 # One example is the stdio gdbserver support.
229 if [target_info exists gdb,get_remote_address] {
230 set get_remote_address [target_info gdb,get_remote_address]
232 set get_remote_address gdbserver_default_get_remote_address
234 if [target_info exists gdbserver,get_comm_port] {
235 set get_comm_port [target_info gdbserver,get_comm_port]
237 set get_comm_port gdbserver_default_get_comm_port
240 # Extract the protocol
241 if [target_info exists gdb_protocol] {
242 set protocol [target_info gdb_protocol]
244 set protocol "remote"
247 set gdbserver [find_gdbserver]
249 # Loop till we find a free port.
251 # Fire off the debug agent.
252 set gdbserver_command "$gdbserver"
254 # If gdbserver_reconnect will be called $gdbserver_reconnect_p must be
255 # set to true already during gdbserver_start.
256 global gdbserver_reconnect_p
257 if {![info exists gdbserver_reconnect_p] || !$gdbserver_reconnect_p} {
258 # GDB client could accidentally connect to a stale server.
259 # append gdbserver_command " --debug --once"
260 append gdbserver_command " --once"
263 if { $options != "" } {
264 append gdbserver_command " $options"
266 if { $portnum != "" } {
267 append gdbserver_command " [$get_comm_port $portnum]"
269 if { $arguments != "" } {
270 append gdbserver_command " $arguments"
273 global server_spawn_id
274 set server_spawn_id [remote_spawn target $gdbserver_command]
276 # GDBserver doesn't do inferior I/O through GDB. But we can
277 # talk to the program using GDBserver's tty instead.
278 global inferior_spawn_id
279 set inferior_spawn_id $server_spawn_id
281 # Wait for the server to open its TCP socket, so that GDB can connect.
286 -re "Listening on" { }
287 -re "Can't bind address: Address already in use\\.\r\n" {
288 verbose -log "Port $portnum is already in use."
289 if ![target_info exists gdb,socketport] {
290 # Bump the port number to avoid the conflict.
291 wait -i $expect_out(spawn_id)
297 error "Timeout waiting for gdbserver response."
303 return [list $protocol [$get_remote_address $debughost $portnum]]
306 # Start a gdbserver process running SERVER_EXEC, and connect GDB
307 # to it. CHILD_ARGS are passed to the inferior.
309 # Returns the target protocol and socket to connect to.
311 proc gdbserver_spawn { child_args } {
312 set target_exec [gdbserver_download_current_prog]
314 # Fire off the debug agent. This flavour of gdbserver takes as
315 # arguments the port information, the name of the executable file to
316 # be debugged, and any arguments.
317 set arguments "$target_exec"
318 if { $child_args != "" } {
319 append arguments " $child_args"
321 return [gdbserver_start "" $arguments]
324 # Close the GDBserver connection.
326 proc close_gdbserver {} {
327 global server_spawn_id inferior_spawn_id
329 # We can't just call close, because if gdbserver is local then that means
330 # that it will get a SIGHUP. Doing it this way could also allow us to
331 # get at the inferior's input or output if necessary, and means that we
332 # don't need to redirect output.
334 if {![info exists server_spawn_id]} {
338 verbose "Quitting GDBserver"
340 catch "close -i $server_spawn_id"
341 catch "wait -i $server_spawn_id"
342 unset server_spawn_id
343 unset inferior_spawn_id
346 # Hook into GDB exit, and close GDBserver.
348 if { [info procs gdbserver_gdb_exit] == "" } {
349 rename gdb_exit gdbserver_orig_gdb_exit
352 global gdb_spawn_id server_spawn_id inferior_spawn_id
354 global gdbserver_reconnect_p
356 # Leave GDBserver running if we're exiting GDB in order to
357 # reconnect to the same instance of GDBserver again.
358 if {[info exists gdbserver_reconnect_p] && $gdbserver_reconnect_p} {
359 gdbserver_orig_gdb_exit
363 if {[info exists gdb_spawn_id] && [info exists server_spawn_id]} {
364 # GDB may be terminated in an expected way or an unexpected way,
365 # but DejaGNU doesn't know that, so gdb_spawn_id isn't unset.
366 # Catch the exceptions.
368 send_gdb "monitor exit\n";
369 # We use expect rather than gdb_expect because
370 # we want to suppress printing exception messages, otherwise,
371 # remote_expect, invoked by gdb_expect, prints the exceptions.
373 -i "$gdb_spawn_id" -re "$gdb_prompt $" {
376 -i "$server_spawn_id" eof {
377 wait -i $expect_out(spawn_id)
378 unset server_spawn_id
379 unset inferior_spawn_id
386 gdbserver_orig_gdb_exit
389 # Start a gdbserver process running HOST_EXEC and pass CHILD_ARGS
390 # to it. Return 0 on success, or non-zero on failure: 2 if gdbserver
391 # failed to start or 1 if we couldn't connect to it.
393 proc gdbserver_run { child_args } {
394 global gdbserver_protocol
395 global gdbserver_gdbport
397 # Kill anything running before we try to start gdbserver, in case
398 # we are sharing a serial connection.
402 -re "Kill the program being debugged. .y or n. $" {
404 verbose "\t\tKilling previous program being debugged"
407 -re "$gdb_prompt $" {
412 if { [catch { gdbserver_spawn $child_args } res] == 1 } {
416 set gdbserver_protocol [lindex $res 0]
417 set gdbserver_gdbport [lindex $res 1]
419 return [gdb_target_cmd $gdbserver_protocol $gdbserver_gdbport]
422 # Reconnect to the previous gdbserver session.
424 proc gdbserver_reconnect { } {
425 global gdbserver_protocol
426 global gdbserver_gdbport
428 global gdbserver_reconnect_p
429 if {![info exists gdbserver_reconnect_p] || !$gdbserver_reconnect_p} {
430 error "gdbserver_reconnect_p is not set before gdbserver_reconnect"
434 return [gdb_target_cmd $gdbserver_protocol $gdbserver_gdbport]
437 # Start gdbserver in extended mode with OPTIONS and connect to it. Note
438 # this frobs $gdbserver_protocol, so should be used only from a board
439 # that usually connects in target remote mode.
440 proc gdbserver_start_extended { {options ""} } {
441 global gdbserver_protocol
442 global gdbserver_gdbport
445 set gdbserver_options "--multi"
447 if { $options != "" } {
448 append gdbserver_options " $options"
451 if { [catch { gdbserver_start $gdbserver_options "" } res] == 1 } {
455 set gdbserver_protocol [lindex $res 0]
456 if { [string first "extended-" $gdbserver_protocol] != 0} {
457 set gdbserver_protocol "extended-$gdbserver_protocol"
459 set gdbserver_gdbport [lindex $res 1]
461 # Even if the board file is testing with target remote, our caller
462 # wants to test against gdbserver in extended-remote mode. Make sure to
463 # disable stub-like techniques.
466 return [gdb_target_cmd $gdbserver_protocol $gdbserver_gdbport]
469 # Start and connect to a gdbserver in extended/multi mode. Unlike
470 # gdbserver_start_extended, this does not frob $gdbserver_protocol.
472 proc gdbserver_start_multi { } {
473 global gdbserver_protocol
474 global gdbserver_gdbport
476 if { [catch { gdbserver_start "--multi" "" } res] == 1 } {
480 set gdbserver_protocol [lindex $res 0]
481 set gdbserver_gdbport [lindex $res 1]
483 return [gdb_target_cmd $gdbserver_protocol $gdbserver_gdbport]
486 # Start a gdbserver process in multi/extended mode, and have GDB
487 # connect to it (MI version). Return 0 on success, or non-zero on
490 proc mi_gdbserver_start_multi { } {
491 global gdbserver_protocol
492 global gdbserver_gdbport
494 if { [catch { gdbserver_start "--multi" "" } res] == 1 } {
498 set gdbserver_protocol [lindex $res 0]
499 set gdbserver_gdbport [lindex $res 1]
501 return [mi_gdb_target_cmd $gdbserver_protocol $gdbserver_gdbport]