gdb/testsuite/lib/mi-support.exp

   1 # Copyright 1999, 2000, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
   2
   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 2 of the License, or
   6 # (at your option) any later version.
   7 #
   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.
  12 #
  13 # You should have received a copy of the GNU General Public License
  14 # along with this program; if not, write to the Free Software
  15 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  16
  17 # Please email any bugs, comments, and/or additions to this file to:
  18 # bug-gdb@prep.ai.mit.edu
  19
  20 # This file was based on a file written by Fred Fish. (fnf@cygnus.com)
  21
  22 # Test setup routines that work with the MI interpreter.
  23
  24 # The variable mi_gdb_prompt is a regexp which matches the gdb mi prompt.
  25 # Set it if it is not already set.
  26 global mi_gdb_prompt
  27 if ![info exists mi_gdb_prompt] then {
  28     set mi_gdb_prompt "\[(\]gdb\[)\] \r\n"
  29 }
  30
  31 global mi_inferior_spawn_id
  32 global mi_inferior_tty_name
  33
  34 set MIFLAGS "-i=mi"
  35
  36 #
  37 # mi_gdb_exit -- exit the GDB, killing the target program if necessary
  38 #
  39 proc mi_gdb_exit {} {
  40     catch mi_uncatched_gdb_exit
  41 }
  42
  43 proc mi_uncatched_gdb_exit {} {
  44     global GDB
  45     global GDBFLAGS
  46     global verbose
  47     global gdb_spawn_id;
  48     global gdb_prompt
  49     global mi_gdb_prompt
  50     global MIFLAGS
  51
  52     gdb_stop_suppressing_tests;
  53
  54     if { [info procs sid_exit] != "" } {
  55         sid_exit
  56     }
  57
  58     if ![info exists gdb_spawn_id] {
  59         return;
  60     }
  61
  62     verbose "Quitting $GDB $GDBFLAGS $MIFLAGS"
  63
  64     if { [is_remote host] && [board_info host exists fileid] } {
  65         send_gdb "999-gdb-exit\n";
  66         gdb_expect 10 {
  67             -re "y or n" {
  68                 send_gdb "y\n";
  69                 exp_continue;
  70             }
  71             -re "Undefined command.*$gdb_prompt $" {
  72                 send_gdb "quit\n"
  73                 exp_continue;
  74             }
  75             -re "DOSEXIT code" { }
  76             default { }
  77         }
  78     }
  79
  80     if ![is_remote host] {
  81         remote_close host;
  82     }
  83     unset gdb_spawn_id
  84 }
  85
  86 #
  87 # mi_gdb_start [INFERIOR_PTY] -- start gdb running, default procedure
  88 #
  89 # INFERIOR_PTY should be set to separate-inferior-tty to have the inferior work
  90 # with it's own PTY. If set to same-inferior-tty, the inferior shares GDB's PTY.
  91 # The default value is same-inferior-tty.
  92 #
  93 # When running over NFS, particularly if running many simultaneous
  94 # tests on different hosts all using the same server, things can
  95 # get really slow.  Give gdb at least 3 minutes to start up.
  96 #
  97 proc mi_gdb_start { args } {
  98     global verbose
  99     global GDB
 100     global GDBFLAGS
 101     global gdb_prompt
 102     global mi_gdb_prompt
 103     global timeout
 104     global gdb_spawn_id;
 105     global MIFLAGS
 106
 107     gdb_stop_suppressing_tests;
 108     set inferior_pty no-tty
 109
 110     if { [llength $args] == 1} {
 111         set inferior_pty [lindex $args 0]
 112     }
 113
 114     set separate_inferior_pty [string match $inferior_pty separate-inferior-tty]
 115
 116     # Start SID.
 117     if { [info procs sid_start] != "" } {
 118         verbose "Spawning SID"
 119         sid_start
 120     }
 121
 122     verbose "Spawning $GDB -nw $GDBFLAGS $MIFLAGS"
 123
 124     if [info exists gdb_spawn_id] {
 125         return 0;
 126     }
 127
 128     if ![is_remote host] {
 129         if { [which $GDB] == 0 } then {
 130             perror "$GDB does not exist."
 131             exit 1
 132         }
 133     }
 134
 135     # Create the new PTY for the inferior process.
 136     if { $separate_inferior_pty } {
 137         spawn -pty
 138         global mi_inferior_spawn_id
 139         global mi_inferior_tty_name
 140         set mi_inferior_spawn_id $spawn_id
 141         set mi_inferior_tty_name $spawn_out(slave,name)
 142     }
 143
 144     set res [remote_spawn host "$GDB -nw $GDBFLAGS $MIFLAGS [host_info gdb_opts]"];
 145     if { $res < 0 || $res == "" } {
 146         perror "Spawning $GDB failed."
 147         return 1;
 148     }
 149     gdb_expect {
 150         -re "~\"GNU.*\r\n~\".*$mi_gdb_prompt$" {
 151             # We have a new format mi startup prompt.  If we are
 152             # running mi1, then this is an error as we should be
 153             # using the old-style prompt.
 154             if { $MIFLAGS == "-i=mi1" } {
 155                 perror "(mi startup) Got unexpected new mi prompt."
 156                 remote_close host;
 157                 return -1;
 158             }
 159             verbose "GDB initialized."
 160         }
 161         -re "\[^~\].*$mi_gdb_prompt$" {
 162             # We have an old format mi startup prompt.  If we are
 163             # not running mi1, then this is an error as we should be
 164             # using the new-style prompt.
 165             if { $MIFLAGS != "-i=mi1" } {
 166                 perror "(mi startup) Got unexpected old mi prompt."
 167                 remote_close host;
 168                 return -1;
 169             }
 170             verbose "GDB initialized."
 171         }
 172         -re ".*$gdb_prompt $" {
 173             untested "Skip mi tests (got non-mi prompt)."
 174             remote_close host;
 175             return -1;
 176         }
 177         -re ".*unrecognized option.*for a complete list of options." {
 178             untested "Skip mi tests (not compiled with mi support)."
 179             remote_close host;
 180             return -1;
 181         }
 182         -re ".*Interpreter `mi' unrecognized." {
 183             untested "Skip mi tests (not compiled with mi support)."
 184             remote_close host;
 185             return -1;
 186         }
 187         timeout {
 188             perror "(timeout) GDB never initialized after 10 seconds."
 189             remote_close host;
 190             return -1
 191         }
 192     }
 193     set gdb_spawn_id -1;
 194
 195     # FIXME: mi output does not go through pagers, so these can be removed.
 196     # force the height to "unlimited", so no pagers get used
 197     send_gdb "100-gdb-set height 0\n"
 198     gdb_expect 10 {
 199         -re ".*100-gdb-set height 0\r\n100\\\^done\r\n$mi_gdb_prompt$" {
 200             verbose "Setting height to 0." 2
 201         }
 202         timeout {
 203             warning "Couldn't set the height to 0"
 204         }
 205     }
 206     # force the width to "unlimited", so no wraparound occurs
 207     send_gdb "101-gdb-set width 0\n"
 208     gdb_expect 10 {
 209         -re ".*101-gdb-set width 0\r\n101\\\^done\r\n$mi_gdb_prompt$" {
 210             verbose "Setting width to 0." 2
 211         }
 212         timeout {
 213             warning "Couldn't set the width to 0."
 214         }
 215     }
 216     # If allowing the inferior to have its own PTY then assign the inferior
 217     # its own terminal device here.
 218     if { $separate_inferior_pty } {
 219         send_gdb "102-inferior-tty-set $mi_inferior_tty_name\n"
 220         gdb_expect 10 {
 221             -re ".*102\\\^done\r\n$mi_gdb_prompt$" {
 222                 verbose "redirect inferior output to new terminal device."
 223             }
 224             timeout {
 225                 warning "Couldn't redirect inferior output." 2
 226             }
 227         }
 228     }
 229
 230     return 0;
 231 }
 232
 233 # Many of the tests depend on setting breakpoints at various places and
 234 # running until that breakpoint is reached.  At times, we want to start
 235 # with a clean-slate with respect to breakpoints, so this utility proc
 236 # lets us do this without duplicating this code everywhere.
 237 #
 238
 239 proc mi_delete_breakpoints {} {
 240     global mi_gdb_prompt
 241
 242 # FIXME: The mi operation won't accept a prompt back and will use the 'all' arg
 243     send_gdb "102-break-delete\n"
 244     gdb_expect 30 {
 245          -re "Delete all breakpoints.*y or n.*$" {
 246             send_gdb "y\n";
 247             exp_continue
 248          }
 249          -re "102-break-delete\r\n102\\\^done\r\n$mi_gdb_prompt$" {
 250             # This happens if there were no breakpoints
 251          }
 252          timeout { perror "Delete all breakpoints in mi_delete_breakpoints (timeout)" ; return }
 253     }
 254
 255 # The correct output is not "No breakpoints or watchpoints." but an
 256 # empty BreakpointTable. Also, a query is not acceptable with mi.
 257     send_gdb "103-break-list\n"
 258     gdb_expect 30 {
 259          -re "103-break-list\r\n103\\\^done,BreakpointTable=\{\}\r\n$mi_gdb_prompt$" {}
 260          -re "103-break-list\r\n103\\\^done,BreakpointTable=\{nr_rows=\".\",nr_cols=\".\",hdr=\\\[\{width=\".*\",alignment=\".*\",col_name=\"number\",colhdr=\"Num\"\}.*colhdr=\"Type\".*colhdr=\"Disp\".*colhdr=\"Enb\".*colhdr=\"Address\".*colhdr=\"What\".*\\\],body=\\\[\\\]\}" {}
 261          -re "103-break-list\r\n103\\\^doneNo breakpoints or watchpoints.\r\n\r\n$mi_gdb_prompt$" {warning "Unexpected console text received"}
 262          -re "$mi_gdb_prompt$" { perror "Breakpoints not deleted" ; return }
 263          -re "Delete all breakpoints.*or n.*$" {
 264             warning "Unexpected prompt for breakpoints deletion";
 265             send_gdb "y\n";
 266             exp_continue
 267         }
 268          timeout { perror "-break-list (timeout)" ; return }
 269     }
 270 }
 271
 272 proc mi_gdb_reinitialize_dir { subdir } {
 273     global mi_gdb_prompt
 274     global MIFLAGS
 275
 276     global suppress_flag
 277     if { $suppress_flag } {
 278         return
 279     }
 280
 281     if [is_remote host] {
 282         return "";
 283     }
 284
 285     if { $MIFLAGS == "-i=mi1" } {
 286       send_gdb "104-environment-directory\n"
 287       gdb_expect 60 {
 288         -re ".*Reinitialize source path to empty.*y or n. " {
 289             warning "Got confirmation prompt for dir reinitialization."
 290             send_gdb "y\n"
 291             gdb_expect 60 {
 292                 -re "$mi_gdb_prompt$" {}
 293                 timeout {error "Dir reinitialization failed (timeout)"}
 294             }
 295         }
 296         -re "$mi_gdb_prompt$" {}
 297         timeout {error "Dir reinitialization failed (timeout)"}
 298       }
 299     } else {
 300       send_gdb "104-environment-directory -r\n"
 301       gdb_expect 60 {
 302         -re "104\\\^done,source-path=.*\r\n$mi_gdb_prompt$" {}
 303         -re "$mi_gdb_prompt$" {}
 304         timeout {error "Dir reinitialization failed (timeout)"}
 305       }
 306     }
 307
 308     send_gdb "105-environment-directory $subdir\n"
 309     gdb_expect 60 {
 310         -re "Source directories searched.*$mi_gdb_prompt$" {
 311             verbose "Dir set to $subdir"
 312         }
 313         -re "105\\\^done.*\r\n$mi_gdb_prompt$" {
 314             # FIXME: We return just the prompt for now.
 315             verbose "Dir set to $subdir"
 316             # perror "Dir \"$subdir\" failed."
 317         }
 318     }
 319 }
 320
 321 # Send GDB the "target" command.
 322 # FIXME: Some of these patterns are not appropriate for MI.  Based on
 323 # config/monitor.exp:gdb_target_command.
 324 proc mi_gdb_target_cmd { targetname serialport } {
 325     global mi_gdb_prompt
 326
 327     for {set i 1} {$i <= 3} {incr i} {
 328         send_gdb "47-target-select $targetname $serialport\n"
 329         gdb_expect 60 {
 330             -re "47\\^connected.*$mi_gdb_prompt$" {
 331                 verbose "Set target to $targetname";
 332                 return 0;
 333             }
 334             -re "Couldn't establish connection to remote.*$mi_gdb_prompt$" {
 335                 verbose "Connection failed";
 336             }
 337             -re "Remote MIPS debugging.*$mi_gdb_prompt$" {
 338                 verbose "Set target to $targetname";
 339                 return 0;
 340             }
 341             -re "Remote debugging using .*$serialport.*$mi_gdb_prompt$" {
 342                 verbose "Set target to $targetname";
 343                 return 0;
 344             }
 345             -re "Remote target $targetname connected to.*$mi_gdb_prompt$" {
 346                 verbose "Set target to $targetname";
 347                 return 0;
 348             }
 349             -re "Connected to.*$mi_gdb_prompt$" {
 350                 verbose "Set target to $targetname";
 351                 return 0;
 352             }
 353             -re "Ending remote.*$mi_gdb_prompt$" { }
 354             -re "Connection refused.*$mi_gdb_prompt$" {
 355                 verbose "Connection refused by remote target.  Pausing, and trying again."
 356                 sleep 5
 357                 continue
 358             }
 359             -re "Timeout reading from remote system.*$mi_gdb_prompt$" {
 360                 verbose "Got timeout error from gdb.";
 361             }
 362             timeout {
 363                 send_gdb "\ 3";
 364                 break
 365             }
 366         }
 367     }
 368     return 1
 369 }
 370
 371 #
 372 # load a file into the debugger (file command only).
 373 # return a -1 if anything goes wrong.
 374 #
 375 proc mi_gdb_file_cmd { arg } {
 376     global verbose
 377     global loadpath
 378     global loadfile
 379     global GDB
 380     global mi_gdb_prompt
 381     global last_mi_gdb_file
 382     global last_mi_remote_file
 383     upvar timeout timeout
 384
 385     if { $arg == "" } {
 386         set arg $last_mi_gdb_file;
 387     } else {
 388         set last_mi_gdb_file $arg
 389         if { [ info exists last_mi_remote_file ] } {
 390             unset last_mi_remote_file
 391         }
 392     }
 393
 394     if [is_remote host] {
 395         set arg [remote_download host $arg];
 396         if { $arg == "" } {
 397             error "download failed"
 398             return -1;
 399         }
 400     }
 401
 402 # FIXME: Several of these patterns are only acceptable for console
 403 # output.  Queries are an error for mi.
 404     send_gdb "105-file-exec-and-symbols $arg\n"
 405     gdb_expect 120 {
 406         -re "Reading symbols from.*done.*$mi_gdb_prompt$" {
 407             verbose "\t\tLoaded $arg into the $GDB"
 408             return 0
 409         }
 410         -re "has no symbol-table.*$mi_gdb_prompt$" {
 411             perror "$arg wasn't compiled with \"-g\""
 412             return -1
 413         }
 414         -re "Load new symbol table from \".*\".*y or n. $" {
 415             send_gdb "y\n"
 416             gdb_expect 120 {
 417                 -re "Reading symbols from.*done.*$mi_gdb_prompt$" {
 418                     verbose "\t\tLoaded $arg with new symbol table into $GDB"
 419                     # All OK
 420                 }
 421                 timeout {
 422                     perror "(timeout) Couldn't load $arg, other program already loaded."
 423                     return -1
 424                 }
 425             }
 426         }
 427         -re "No such file or directory.*$mi_gdb_prompt$" {
 428             perror "($arg) No such file or directory\n"
 429             return -1
 430         }
 431         -re "105-file-exec-and-symbols .*\r\n105\\\^done\r\n$mi_gdb_prompt$" {
 432             # We (MI) are just giving the prompt back for now, instead of giving
 433             # some acknowledgement.
 434             return 0
 435         }
 436         timeout {
 437             perror "couldn't load $arg into $GDB (timed out)."
 438             return -1
 439         }
 440         eof {
 441             # This is an attempt to detect a core dump, but seems not to
 442             # work.  Perhaps we need to match .* followed by eof, in which
 443             # gdb_expect does not seem to have a way to do that.
 444             perror "couldn't load $arg into $GDB (end of file)."
 445             return -1
 446         }
 447     }
 448 }
 449
 450 #
 451 # load a file into the debugger.
 452 # return a -1 if anything goes wrong.
 453 #
 454 proc mi_gdb_load { arg } {
 455     global verbose
 456     global loadpath
 457     global loadfile
 458     global GDB
 459     global mi_gdb_prompt
 460     upvar timeout timeout
 461
 462     # ``gdb_unload''
 463     if { $arg != "" } {
 464         mi_gdb_file_cmd $arg
 465     }
 466
 467     # ``load''
 468     if { [info procs gdbserver_gdb_load] != "" } {
 469         global last_mi_gdb_file
 470         global last_mi_remote_file
 471
 472         if { ! [info exists last_mi_remote_file] } {
 473             if [is_remote target] {
 474                 set last_mi_remote_file [remote_download target $arg /tmp/[file tail $arg].[pid]]
 475             } else {
 476                 set last_mi_remote_file $last_mi_gdb_file
 477             }
 478         }
 479
 480         set res [gdbserver_gdb_load $last_mi_remote_file]
 481         set protocol [lindex $res 0]
 482         set gdbport [lindex $res 1]
 483
 484         if { [mi_gdb_target_cmd $protocol $gdbport] != 0 } {
 485             return -1
 486         }
 487     } elseif { [info procs send_target_sid] != "" } {
 488         # For SID, things get complex
 489         send_target_sid
 490         gdb_expect 60 {
 491             -re "\\^done.*$mi_gdb_prompt$" {
 492             }
 493             timeout {
 494                 perror "Unable to connect to SID target"
 495                 return -1
 496             }
 497         }
 498         send_gdb "48-target-download\n"
 499         gdb_expect 10 {
 500             -re "48\\^done.*$mi_gdb_prompt$" {
 501             }
 502             timeout {
 503                 perror "Unable to download to SID target"
 504                 return -1
 505             }
 506         }
 507     } elseif { [target_info protocol] == "sim" } {
 508         # For the simulator, just connect to it directly.
 509         send_gdb "47-target-select sim\n"
 510         gdb_expect 10 {
 511             -re "47\\^connected.*$mi_gdb_prompt$" {
 512             }
 513             timeout {
 514                 perror "Unable to select sim target"
 515                 return -1
 516             }
 517         }
 518         send_gdb "48-target-download\n"
 519         gdb_expect 10 {
 520             -re "48\\^done.*$mi_gdb_prompt$" {
 521             }
 522             timeout {
 523                 perror "Unable to download to sim target"
 524                 return -1
 525             }
 526         }
 527     } elseif { [target_info gdb_protocol] == "remote" } {
 528         # remote targets
 529         if { [mi_gdb_target_cmd "remote" [target_info netport]] != 0 } {
 530             perror "Unable to connect to remote target"
 531             return -1
 532         }
 533         send_gdb "48-target-download\n"
 534         gdb_expect 10 {
 535             -re "48\\^done.*$mi_gdb_prompt$" {
 536             }
 537             timeout {
 538                 perror "Unable to download to remote target"
 539                 return -1
 540             }
 541         }
 542     }
 543     return 0
 544 }
 545
 546 # mi_gdb_test COMMAND PATTERN MESSAGE [IPATTERN] -- send a command to gdb;
 547 #   test the result.
 548 #
 549 # COMMAND is the command to execute, send to GDB with send_gdb.  If
 550 #   this is the null string no command is sent.
 551 # PATTERN is the pattern to match for a PASS, and must NOT include
 552 #   the \r\n sequence immediately before the gdb prompt.
 553 # MESSAGE is the message to be printed.  (If this is the empty string,
 554 #   then sometimes we don't call pass or fail at all; I don't
 555 #   understand this at all.)
 556 # IPATTERN is the pattern to match for the inferior's output.  This parameter
 557 #   is optional.  If present, it will produce a PASS if the match is
 558 #   successful, and a FAIL if unsuccessful.
 559 #
 560 # Returns:
 561 #    1 if the test failed,
 562 #    0 if the test passes,
 563 #   -1 if there was an internal error.
 564 #
 565 proc mi_gdb_test { args } {
 566     global verbose
 567     global mi_gdb_prompt
 568     global GDB expect_out
 569     upvar timeout timeout
 570
 571     set command [lindex $args 0]
 572     set pattern [lindex $args 1]
 573     set message [lindex $args 2]
 574
 575     if [llength $args]==4 {
 576         set ipattern [lindex $args 3]
 577     }
 578
 579     if [llength $args]==5 {
 580         set question_string [lindex $args 3];
 581         set response_string [lindex $args 4];
 582     } else {
 583         set question_string "^FOOBAR$"
 584     }
 585
 586     if $verbose>2 then {
 587         send_user "Sending \"$command\" to gdb\n"
 588         send_user "Looking to match \"$pattern\"\n"
 589         send_user "Message is \"$message\"\n"
 590     }
 591
 592     set result -1
 593     set string "${command}\n";
 594     set string_regex [string_to_regexp $command]
 595
 596     if { $command != "" } {
 597         while { "$string" != "" } {
 598             set foo [string first "\n" "$string"];
 599             set len [string length "$string"];
 600             if { $foo < [expr $len - 1] } {
 601                 set str [string range "$string" 0 $foo];
 602                 if { [send_gdb "$str"] != "" } {
 603                     global suppress_flag;
 604
 605                     if { ! $suppress_flag } {
 606                         perror "Couldn't send $command to GDB.";
 607                     }
 608                     fail "$message";
 609                     return $result;
 610                 }
 611                 gdb_expect 2 {
 612                     -re "\[\r\n\]" { }
 613                     timeout { }
 614                 }
 615                 set string [string range "$string" [expr $foo + 1] end];
 616             } else {
 617                 break;
 618             }
 619         }
 620         if { "$string" != "" } {
 621             if { [send_gdb "$string"] != "" } {
 622                 global suppress_flag;
 623
 624                 if { ! $suppress_flag } {
 625                     perror "Couldn't send $command to GDB.";
 626                 }
 627                 fail "$message";
 628                 return $result;
 629             }
 630         }
 631     }
 632
 633     if [info exists timeout] {
 634         set tmt $timeout;
 635     } else {
 636         global timeout;
 637         if [info exists timeout] {
 638             set tmt $timeout;
 639         } else {
 640             set tmt 60;
 641         }
 642     }
 643     gdb_expect $tmt {
 644          -re "\\*\\*\\* DOSEXIT code.*" {
 645              if { $message != "" } {
 646                  fail "$message";
 647              }
 648              gdb_suppress_entire_file "GDB died";
 649              return -1;
 650          }
 651          -re "Ending remote debugging.*$mi_gdb_prompt\[ \]*$" {
 652             if ![isnative] then {
 653                 warning "Can`t communicate to remote target."
 654             }
 655             gdb_exit
 656             gdb_start
 657             set result -1
 658         }
 659          -re "^($string_regex\[\r\n\]+)?($pattern\[\r\n\]+$mi_gdb_prompt\[ \]*)" {
 660             # At this point, $expect_out(1,string) is the MI input command.
 661             # and $expect_out(2,string) is the MI output command.
 662             # If $expect_out(1,string) is "", then there was no MI input command here.
 663
 664             # NOTE, there is no trailing anchor because with GDB/MI,
 665             # asynchronous responses can happen at any point, causing more
 666             # data to be available.  Normally an anchor is used to make
 667             # sure the end of the output is matched, however, $mi_gdb_prompt
 668             # is just as good of an anchor since mi_gdb_test is meant to
 669             # match a single mi output command.  If a second GDB/MI output
 670             # response is sent, it will be in the buffer for the next
 671             # time mi_gdb_test is called.
 672             if ![string match "" $message] then {
 673                 pass "$message"
 674             }
 675             set result 0
 676         }
 677          -re "(${question_string})$" {
 678             send_gdb "$response_string\n";
 679             exp_continue;
 680         }
 681          -re "Undefined.* command:.*$mi_gdb_prompt\[ \]*$" {
 682             perror "Undefined command \"$command\"."
 683             fail "$message"
 684             set result 1
 685         }
 686          -re "Ambiguous command.*$mi_gdb_prompt\[ \]*$" {
 687             perror "\"$command\" is not a unique command name."
 688             fail "$message"
 689             set result 1
 690         }
 691          -re "Program exited with code \[0-9\]+.*$mi_gdb_prompt\[ \]*$" {
 692             if ![string match "" $message] then {
 693                 set errmsg "$message (the program exited)"
 694             } else {
 695                 set errmsg "$command (the program exited)"
 696             }
 697             fail "$errmsg"
 698             return -1
 699         }
 700          -re "The program is not being run.*$mi_gdb_prompt\[ \]*$" {
 701             if ![string match "" $message] then {
 702                 set errmsg "$message (the program is no longer running)"
 703             } else {
 704                 set errmsg "$command (the program is no longer running)"
 705             }
 706             fail "$errmsg"
 707             return -1
 708         }
 709          -re ".*$mi_gdb_prompt\[ \]*$" {
 710             if ![string match "" $message] then {
 711                 fail "$message"
 712             }
 713             set result 1
 714         }
 715          "<return>" {
 716             send_gdb "\n"
 717             perror "Window too small."
 718             fail "$message"
 719         }
 720          -re "\\(y or n\\) " {
 721             send_gdb "n\n"
 722             perror "Got interactive prompt."
 723             fail "$message"
 724         }
 725          eof {
 726              perror "Process no longer exists"
 727              if { $message != "" } {
 728                  fail "$message"
 729              }
 730              return -1
 731         }
 732          full_buffer {
 733             perror "internal buffer is full."
 734             fail "$message"
 735         }
 736         timeout {
 737             if ![string match "" $message] then {
 738                 fail "$message (timeout)"
 739             }
 740             set result 1
 741         }
 742     }
 743
 744     # If the GDB output matched, compare the inferior output.
 745     if { $result == 0 } {
 746         if [ info exists ipattern ] {
 747             global mi_inferior_spawn_id
 748             expect {
 749                 -i $mi_inferior_spawn_id -re "$ipattern" {
 750                     pass "inferior_output:$message"
 751                 }
 752                 timeout {
 753                     fail "inferior output timeout"
 754                     set result 1
 755                 }
 756             }
 757         }
 758     }
 759
 760     return $result
 761 }
 762
 763 #
 764 # MI run command.  (A modified version of gdb_run_cmd)
 765 #
 766
 767 # In patterns, the newline sequence ``\r\n'' is matched explicitly as
 768 # ``.*$'' could swallow up output that we attempt to match elsewhere.
 769
 770 proc mi_run_cmd {args} {
 771     global suppress_flag
 772     if { $suppress_flag } {
 773         return -1
 774     }
 775     global mi_gdb_prompt
 776
 777     if [target_info exists gdb_init_command] {
 778         send_gdb "[target_info gdb_init_command]\n";
 779         gdb_expect 30 {
 780             -re "$mi_gdb_prompt$" { }
 781             default {
 782                 perror "gdb_init_command for target failed";
 783                 return;
 784             }
 785         }
 786     }
 787
 788     if [target_info exists use_gdb_stub] {
 789         if [target_info exists gdb,do_reload_on_run] {
 790             # Specifying no file, defaults to the executable
 791             # currently being debugged.
 792             if { [mi_gdb_load ""] < 0 } {
 793                 return;
 794             }
 795             send_gdb "000-exec-continue\n";
 796             gdb_expect 60 {
 797                 -re "000\\^running\[\r\n\]+$mi_gdb_prompt$" {}
 798                 default {}
 799             }
 800             return;
 801         }
 802
 803         if [target_info exists gdb,start_symbol] {
 804             set start [target_info gdb,start_symbol];
 805         } else {
 806             set start "start";
 807         }
 808
 809         # HACK: Should either use 000-jump or fix the target code
 810         # to better handle RUN.
 811         send_gdb  "jump *$start\n"
 812         warning "Using CLI jump command, expect run-to-main FAIL"
 813         return
 814     }
 815
 816     send_gdb "000-exec-run $args\n"
 817     gdb_expect {
 818         -re "000\\^running\r\n${mi_gdb_prompt}" {
 819         }
 820         timeout {
 821             perror "Unable to start target"
 822             return
 823         }
 824     }
 825     # NOTE: Shortly after this there will be a ``000*stopping,...(gdb)''
 826 }
 827
 828 #
 829 # Just like run-to-main but works with the MI interface
 830 #
 831
 832 proc mi_run_to_main { } {
 833     global suppress_flag
 834     if { $suppress_flag } {
 835         return -1
 836     }
 837
 838     global srcdir
 839     global subdir
 840     global binfile
 841     global srcfile
 842
 843     mi_delete_breakpoints
 844     mi_gdb_reinitialize_dir $srcdir/$subdir
 845     mi_gdb_load ${binfile}
 846
 847     mi_runto main
 848 }
 849
 850
 851 # Just like gdb's "runto" proc, it will run the target to a given
 852 # function.  The big difference here between mi_runto and mi_execute_to
 853 # is that mi_execute_to must have the inferior running already.  This
 854 # proc will (like gdb's runto) (re)start the inferior, too.
 855 #
 856 # FUNC is the linespec of the place to stop (it inserts a breakpoint here).
 857 # It returns:
 858 #   -1  if test suppressed, failed, timedout
 859 #    0  if test passed
 860
 861 proc mi_runto_helper {func run_or_continue} {
 862   global suppress_flag
 863   if { $suppress_flag } {
 864     return -1
 865   }
 866
 867   global mi_gdb_prompt expect_out
 868   global hex decimal fullname_syntax
 869
 870   set test "mi runto $func"
 871   mi_gdb_test "200-break-insert -t $func" \
 872     "200\\^done,bkpt=\{number=\"\[0-9\]+\",type=\"breakpoint\",disp=\"del\",enabled=\"y\",addr=\"$hex\",func=\"$func\(\\\(.*\\\)\)?\",file=\".*\",line=\"\[0-9\]*\",times=\"0\"\}" \
 873     "breakpoint at $func"
 874
 875   if {![regexp {number="[0-9]+"} $expect_out(buffer) str]
 876       || ![scan $str {number="%d"} bkptno]} {
 877     set bkptno {[0-9]+}
 878   }
 879
 880   if {$run_or_continue == "run"} {
 881       mi_run_cmd
 882   } else {
 883     send_gdb "000-exec-continue\n"
 884   }
 885   gdb_expect {
 886     -re ".*000\\*stopped,thread-id=\"$decimal\",frame=\{addr=\"$hex\",func=\"$func\",args=\(\\\[.*\\\]\|\{.*\}\),file=\".*\",fullname=\"${fullname_syntax}.*\",line=\"\[0-9\]*\"\}\r\n$mi_gdb_prompt$" {
 887       pass "$test"
 888       return 0
 889     }
 890     -re ".*$mi_gdb_prompt$" {
 891       fail "$test (2)"
 892     }
 893     timeout {
 894       fail "$test (timeout)"
 895       return -1
 896     }
 897   }
 898 }
 899
 900 proc mi_runto {func} {
 901     mi_runto_helper $func "run"
 902 }
 903
 904 # Next to the next statement
 905 # For return values, see mi_execute_to_helper
 906
 907 proc mi_next { test } {
 908   return [mi_next_to {.*} {.*} {.*} {.*} $test]
 909 }
 910
 911
 912 # Step to the next statement
 913 # For return values, see mi_execute_to_helper
 914
 915 proc mi_step { test } {
 916   return [mi_step_to {.*} {.*} {.*} {.*} $test]
 917 }
 918
 919 # cmd should not include the number or newline (i.e. "exec-step 3", not
 920 # "220-exec-step 3\n"
 921
 922 # Can not match -re ".*\r\n${mi_gdb_prompt}", because of false positives
 923 # after the first prompt is printed.
 924
 925 proc mi_execute_to_helper { cmd reason func args file line extra test } {
 926     global suppress_flag
 927     if { $suppress_flag } {
 928         return -1
 929     }
 930     global mi_gdb_prompt
 931     global hex
 932     global decimal
 933     global fullname_syntax
 934     send_gdb "220-$cmd\n"
 935     gdb_expect {
 936         -re "220\\^running\r\n${mi_gdb_prompt}.*220\\*stopped,reason=\"$reason\",thread-id=\"$decimal\",frame=\{addr=\"$hex\",func=\"$func\",args=$args,file=\".*$file\",fullname=\"${fullname_syntax}$file\",line=\"$line\"\}$extra\r\n$mi_gdb_prompt$" {
 937             pass "$test"
 938             return 0
 939         }
 940         -re "220\\^running\r\n${mi_gdb_prompt}.*220\\*stopped,reason=\"$reason\",thread-id=\"$decimal\",frame=\{addr=\"$hex\",func=\".*\",args=\[\\\[\{\].*\[\\\]\}\],file=\".*\",fullname=\"${fullname_syntax}.*\",line=\"\[0-9\]*\"\}.*\r\n$mi_gdb_prompt$" {
 941             fail "$test (stopped at wrong place)"
 942             return -1
 943         }
 944         -re "220\\^running\r\n${mi_gdb_prompt}.*\r\n${mi_gdb_prompt}$" {
 945             fail "$test (unknown output after running)"
 946             return -1
 947         }
 948         timeout {
 949             fail "$test (timeout)"
 950             return -1
 951         }
 952     }
 953 }
 954
 955 proc mi_execute_to { cmd reason func args file line extra test } {
 956     mi_execute_to_helper "$cmd" "$reason" "$func" "\\\[$args\\\]" \
 957         "$file" "$line" "$extra" "$test"
 958 }
 959
 960 proc mi_next_to { func args file line test } {
 961     mi_execute_to "exec-next" "end-stepping-range" "$func" "$args" \
 962         "$file" "$line" "" "$test"
 963 }
 964
 965 proc mi_step_to { func args file line test } {
 966     mi_execute_to "exec-step" "end-stepping-range" "$func" "$args" \
 967         "$file" "$line" "" "$test"
 968 }
 969
 970 proc mi_finish_to { func args file line result ret test } {
 971     mi_execute_to "exec-finish" "function-finished" "$func" "$args" \
 972         "$file" "$line" \
 973         ",gdb-result-var=\"$result\",return-value=\"$ret\"" \
 974         "$test"
 975 }
 976
 977 proc mi_continue_to {func} {
 978     mi_runto_helper $func "continue"
 979 }
 980
 981 proc mi0_execute_to { cmd reason func args file line extra test } {
 982     mi_execute_to_helper "$cmd" "$reason" "$func" "\{$args\}" \
 983         "$file" "$line" "$extra" "$test"
 984 }
 985
 986 proc mi0_next_to { func args file line test } {
 987     mi0_execute_to "exec-next" "end-stepping-range" "$func" "$args" \
 988         "$file" "$line" "" "$test"
 989 }
 990
 991 proc mi0_step_to { func args file line test } {
 992     mi0_execute_to "exec-step" "end-stepping-range" "$func" "$args" \
 993         "$file" "$line" "" "$test"
 994 }
 995
 996 proc mi0_finish_to { func args file line result ret test } {
 997     mi0_execute_to "exec-finish" "function-finished" "$func" "$args" \
 998         "$file" "$line" \
 999         ",gdb-result-var=\"$result\",return-value=\"$ret\"" \
1000         "$test"
1001 }
1002
1003 proc mi0_continue_to { bkptno func args file line test } {
1004     mi0_execute_to "exec-continue" "breakpoint-hit\",bkptno=\"$bkptno" \
1005         "$func" "$args" "$file" "$line" "" "$test"
1006 }
1007
1008 # Creates varobj named NAME for EXPRESSION.
1009 # Name cannot be "-".
1010 proc mi_create_varobj { name expression testname } {
1011     mi_gdb_test "-var-create $name * $expression" \
1012         "\\^done,name=\"$name\",numchild=\"\[0-9\]+\",type=.*" \
1013         $testname
1014 }
1015
1016 # Updates varobj named NAME and checks that all varobjs in EXPECTED
1017 # are reported as updated, and no other varobj is updated.
1018 # Assumes that no varobj is out of scope and that no varobj changes
1019 # types.
1020 proc mi_varobj_update { name expected testname } {
1021     set er "\\^done,changelist=\\\["
1022     set first 1
1023     foreach item $expected {
1024         set v "{name=\"$item\",in_scope=\"true\",type_changed=\"false\"}"
1025         if {$first} {
1026             set er "$er$v"
1027         } else {
1028             set er "$er,$v"
1029         }
1030     }
1031     set er "$er\\\]"
1032
1033     verbose -log "Expecting: $er" 2
1034     mi_gdb_test "-var-update $name" $er $testname
1035 }
1036
1037 proc mi_check_varobj_value { name value testname } {
1038
1039     mi_gdb_test "-var-evaluate-expression $name" \
1040         "\\^done,value=\"$value\"" \
1041         $testname
1042 }
1043
1044 # Check the results of the:
1045 #
1046 #   -var-list-children VARNAME
1047 #
1048 # command.  The CHILDREN parement should be a list of lists.
1049 # Each inner list can have either 3 or 4 elements, describing
1050 # fields that gdb is expected to report for child variable object,
1051 # in the following order
1052 #
1053 #   - Name
1054 #   - Expression
1055 #   - Number of children
1056 #   - Type
1057 #
1058 # If inner list has 3 elements, the gdb is expected to output no
1059 # type for a child.
1060 #
1061 proc mi_list_varobj_children { varname children testname } {
1062
1063     set numchildren [llength $children]
1064     set children_exp {}
1065     set whatever "\"\[^\"\]+\""
1066
1067     foreach item $children {
1068
1069         set name [lindex $item 0]
1070         set exp [lindex $item  1]
1071         set numchild [lindex $item 2]
1072         if {[llength $item] == 4} {
1073             set type [lindex $item 3]
1074
1075             lappend children_exp\
1076                 "child={name=\"$name\",exp=\"$exp\",numchild=\"$numchild\",type=\"$type\"}"
1077         } else {
1078             lappend children_exp\
1079                 "child={name=\"$name\",exp=\"$exp\",numchild=\"$numchild\"}"
1080         }
1081     }
1082     set children_exp_j [join $children_exp ","]
1083     set expected "\\^done,numchild=\"$numchildren\",children=\\\[$children_exp_j\\\]"
1084
1085     verbose -log "Expecting: $expected"
1086
1087     mi_gdb_test "-var-list-children $varname" $expected $testname
1088 }