1 /* Memory-access and commands for "inferior" process, for GDB. 2 3 Copyright (C) 1986-2019 Free Software Foundation, Inc. 4 5 This file is part of GDB. 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 3 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */ 19 20 #include "defs.h" 21 #include "arch-utils.h" 22 #include <signal.h> 23 #include "symtab.h" 24 #include "gdbtypes.h" 25 #include "frame.h" 26 #include "inferior.h" 27 #include "infrun.h" 28 #include "common/environ.h" 29 #include "value.h" 30 #include "gdbcmd.h" 31 #include "symfile.h" 32 #include "gdbcore.h" 33 #include "target.h" 34 #include "language.h" 35 #include "objfiles.h" 36 #include "completer.h" 37 #include "ui-out.h" 38 #include "event-top.h" 39 #include "parser-defs.h" 40 #include "regcache.h" 41 #include "reggroups.h" 42 #include "block.h" 43 #include "solib.h" 44 #include <ctype.h> 45 #include "observable.h" 46 #include "target-descriptions.h" 47 #include "user-regs.h" 48 #include "cli/cli-decode.h" 49 #include "gdbthread.h" 50 #include "valprint.h" 51 #include "inline-frame.h" 52 #include "tracepoint.h" 53 #include "inf-loop.h" 54 #include "continuations.h" 55 #include "linespec.h" 56 #include "cli/cli-utils.h" 57 #include "infcall.h" 58 #include "thread-fsm.h" 59 #include "top.h" 60 #include "interps.h" 61 #include "common/gdb_optional.h" 62 #include "source.h" 63 64 /* Local functions: */ 65 66 static void until_next_command (int); 67 68 static void step_1 (int, int, const char *); 69 70 #define ERROR_NO_INFERIOR \ 71 if (!target_has_execution) error (_("The program is not being run.")); 72 73 /* Scratch area where string containing arguments to give to the 74 program will be stored by 'set args'. As soon as anything is 75 stored, notice_args_set will move it into per-inferior storage. 76 Arguments are separated by spaces. Empty string (pointer to '\0') 77 means no args. */ 78 79 static char *inferior_args_scratch; 80 81 /* Scratch area where the new cwd will be stored by 'set cwd'. */ 82 83 static char *inferior_cwd_scratch; 84 85 /* Scratch area where 'set inferior-tty' will store user-provided value. 86 We'll immediate copy it into per-inferior storage. */ 87 88 static char *inferior_io_terminal_scratch; 89 90 /* Pid of our debugged inferior, or 0 if no inferior now. 91 Since various parts of infrun.c test this to see whether there is a program 92 being debugged it should be nonzero (currently 3 is used) for remote 93 debugging. */ 94 95 ptid_t inferior_ptid; 96 97 /* Nonzero if stopped due to completion of a stack dummy routine. */ 98 99 enum stop_stack_kind stop_stack_dummy; 100 101 /* Nonzero if stopped due to a random (unexpected) signal in inferior 102 process. */ 103 104 int stopped_by_random_signal; 105 106 /* See inferior.h. */ 107 108 int startup_with_shell = 1; 109 110 111 /* Accessor routines. */ 112 113 /* Set the io terminal for the current inferior. Ownership of 114 TERMINAL_NAME is not transferred. */ 115 116 void 117 set_inferior_io_terminal (const char *terminal_name) 118 { 119 xfree (current_inferior ()->terminal); 120 121 if (terminal_name != NULL && *terminal_name != '\0') 122 current_inferior ()->terminal = xstrdup (terminal_name); 123 else 124 current_inferior ()->terminal = NULL; 125 } 126 127 const char * 128 get_inferior_io_terminal (void) 129 { 130 return current_inferior ()->terminal; 131 } 132 133 static void 134 set_inferior_tty_command (const char *args, int from_tty, 135 struct cmd_list_element *c) 136 { 137 /* CLI has assigned the user-provided value to inferior_io_terminal_scratch. 138 Now route it to current inferior. */ 139 set_inferior_io_terminal (inferior_io_terminal_scratch); 140 } 141 142 static void 143 show_inferior_tty_command (struct ui_file *file, int from_tty, 144 struct cmd_list_element *c, const char *value) 145 { 146 /* Note that we ignore the passed-in value in favor of computing it 147 directly. */ 148 const char *inferior_io_terminal = get_inferior_io_terminal (); 149 150 if (inferior_io_terminal == NULL) 151 inferior_io_terminal = ""; 152 fprintf_filtered (gdb_stdout, 153 _("Terminal for future runs of program being debugged " 154 "is \"%s\".\n"), inferior_io_terminal); 155 } 156 157 const char * 158 get_inferior_args (void) 159 { 160 if (current_inferior ()->argc != 0) 161 { 162 char *n; 163 164 n = construct_inferior_arguments (current_inferior ()->argc, 165 current_inferior ()->argv); 166 set_inferior_args (n); 167 xfree (n); 168 } 169 170 if (current_inferior ()->args == NULL) 171 current_inferior ()->args = xstrdup (""); 172 173 return current_inferior ()->args; 174 } 175 176 /* Set the arguments for the current inferior. Ownership of 177 NEWARGS is not transferred. */ 178 179 void 180 set_inferior_args (const char *newargs) 181 { 182 xfree (current_inferior ()->args); 183 current_inferior ()->args = newargs ? xstrdup (newargs) : NULL; 184 current_inferior ()->argc = 0; 185 current_inferior ()->argv = 0; 186 } 187 188 void 189 set_inferior_args_vector (int argc, char **argv) 190 { 191 current_inferior ()->argc = argc; 192 current_inferior ()->argv = argv; 193 } 194 195 /* Notice when `set args' is run. */ 196 197 static void 198 set_args_command (const char *args, int from_tty, struct cmd_list_element *c) 199 { 200 /* CLI has assigned the user-provided value to inferior_args_scratch. 201 Now route it to current inferior. */ 202 set_inferior_args (inferior_args_scratch); 203 } 204 205 /* Notice when `show args' is run. */ 206 207 static void 208 show_args_command (struct ui_file *file, int from_tty, 209 struct cmd_list_element *c, const char *value) 210 { 211 /* Note that we ignore the passed-in value in favor of computing it 212 directly. */ 213 deprecated_show_value_hack (file, from_tty, c, get_inferior_args ()); 214 } 215 216 /* See common/common-inferior.h. */ 217 218 void 219 set_inferior_cwd (const char *cwd) 220 { 221 struct inferior *inf = current_inferior (); 222 223 gdb_assert (inf != NULL); 224 225 if (cwd == NULL) 226 inf->cwd.reset (); 227 else 228 inf->cwd.reset (xstrdup (cwd)); 229 } 230 231 /* See common/common-inferior.h. */ 232 233 const char * 234 get_inferior_cwd () 235 { 236 return current_inferior ()->cwd.get (); 237 } 238 239 /* Handle the 'set cwd' command. */ 240 241 static void 242 set_cwd_command (const char *args, int from_tty, struct cmd_list_element *c) 243 { 244 if (*inferior_cwd_scratch == '\0') 245 set_inferior_cwd (NULL); 246 else 247 set_inferior_cwd (inferior_cwd_scratch); 248 } 249 250 /* Handle the 'show cwd' command. */ 251 252 static void 253 show_cwd_command (struct ui_file *file, int from_tty, 254 struct cmd_list_element *c, const char *value) 255 { 256 const char *cwd = get_inferior_cwd (); 257 258 if (cwd == NULL) 259 fprintf_filtered (gdb_stdout, 260 _("\ 261 You have not set the inferior's current working directory.\n\ 262 The inferior will inherit GDB's cwd if native debugging, or the remote\n\ 263 server's cwd if remote debugging.\n")); 264 else 265 fprintf_filtered (gdb_stdout, 266 _("Current working directory that will be used " 267 "when starting the inferior is \"%s\".\n"), cwd); 268 } 269 270 271 /* Compute command-line string given argument vector. This does the 272 same shell processing as fork_inferior. */ 273 274 char * 275 construct_inferior_arguments (int argc, char **argv) 276 { 277 char *result; 278 279 if (startup_with_shell) 280 { 281 #ifdef __MINGW32__ 282 /* This holds all the characters considered special to the 283 Windows shells. */ 284 static const char special[] = "\"!&*|[]{}<>?`~^=;, \t\n"; 285 static const char quote = '"'; 286 #else 287 /* This holds all the characters considered special to the 288 typical Unix shells. We include `^' because the SunOS 289 /bin/sh treats it as a synonym for `|'. */ 290 static const char special[] = "\"!#$&*()\\|[]{}<>?'`~^; \t\n"; 291 static const char quote = '\''; 292 #endif 293 int i; 294 int length = 0; 295 char *out, *cp; 296 297 /* We over-compute the size. It shouldn't matter. */ 298 for (i = 0; i < argc; ++i) 299 length += 3 * strlen (argv[i]) + 1 + 2 * (argv[i][0] == '\0'); 300 301 result = (char *) xmalloc (length); 302 out = result; 303 304 for (i = 0; i < argc; ++i) 305 { 306 if (i > 0) 307 *out++ = ' '; 308 309 /* Need to handle empty arguments specially. */ 310 if (argv[i][0] == '\0') 311 { 312 *out++ = quote; 313 *out++ = quote; 314 } 315 else 316 { 317 #ifdef __MINGW32__ 318 int quoted = 0; 319 320 if (strpbrk (argv[i], special)) 321 { 322 quoted = 1; 323 *out++ = quote; 324 } 325 #endif 326 for (cp = argv[i]; *cp; ++cp) 327 { 328 if (*cp == '\n') 329 { 330 /* A newline cannot be quoted with a backslash (it 331 just disappears), only by putting it inside 332 quotes. */ 333 *out++ = quote; 334 *out++ = '\n'; 335 *out++ = quote; 336 } 337 else 338 { 339 #ifdef __MINGW32__ 340 if (*cp == quote) 341 #else 342 if (strchr (special, *cp) != NULL) 343 #endif 344 *out++ = '\\'; 345 *out++ = *cp; 346 } 347 } 348 #ifdef __MINGW32__ 349 if (quoted) 350 *out++ = quote; 351 #endif 352 } 353 } 354 *out = '\0'; 355 } 356 else 357 { 358 /* In this case we can't handle arguments that contain spaces, 359 tabs, or newlines -- see breakup_args(). */ 360 int i; 361 int length = 0; 362 363 for (i = 0; i < argc; ++i) 364 { 365 char *cp = strchr (argv[i], ' '); 366 if (cp == NULL) 367 cp = strchr (argv[i], '\t'); 368 if (cp == NULL) 369 cp = strchr (argv[i], '\n'); 370 if (cp != NULL) 371 error (_("can't handle command-line " 372 "argument containing whitespace")); 373 length += strlen (argv[i]) + 1; 374 } 375 376 result = (char *) xmalloc (length); 377 result[0] = '\0'; 378 for (i = 0; i < argc; ++i) 379 { 380 if (i > 0) 381 strcat (result, " "); 382 strcat (result, argv[i]); 383 } 384 } 385 386 return result; 387 } 388 389 390 /* This function strips the '&' character (indicating background 391 execution) that is added as *the last* of the arguments ARGS of a 392 command. A copy of the incoming ARGS without the '&' is returned, 393 unless the resulting string after stripping is empty, in which case 394 NULL is returned. *BG_CHAR_P is an output boolean that indicates 395 whether the '&' character was found. */ 396 397 static gdb::unique_xmalloc_ptr<char> 398 strip_bg_char (const char *args, int *bg_char_p) 399 { 400 const char *p; 401 402 if (args == NULL || *args == '\0') 403 { 404 *bg_char_p = 0; 405 return NULL; 406 } 407 408 p = args + strlen (args); 409 if (p[-1] == '&') 410 { 411 p--; 412 while (p > args && isspace (p[-1])) 413 p--; 414 415 *bg_char_p = 1; 416 if (p != args) 417 return gdb::unique_xmalloc_ptr<char> 418 (savestring (args, p - args)); 419 else 420 return gdb::unique_xmalloc_ptr<char> (nullptr); 421 } 422 423 *bg_char_p = 0; 424 return gdb::unique_xmalloc_ptr<char> (xstrdup (args)); 425 } 426 427 /* Common actions to take after creating any sort of inferior, by any 428 means (running, attaching, connecting, et cetera). The target 429 should be stopped. */ 430 431 void 432 post_create_inferior (struct target_ops *target, int from_tty) 433 { 434 435 /* Be sure we own the terminal in case write operations are performed. */ 436 target_terminal::ours_for_output (); 437 438 /* If the target hasn't taken care of this already, do it now. 439 Targets which need to access registers during to_open, 440 to_create_inferior, or to_attach should do it earlier; but many 441 don't need to. */ 442 target_find_description (); 443 444 /* Now that we know the register layout, retrieve current PC. But 445 if the PC is unavailable (e.g., we're opening a core file with 446 missing registers info), ignore it. */ 447 thread_info *thr = inferior_thread (); 448 449 thr->suspend.stop_pc = 0; 450 TRY 451 { 452 thr->suspend.stop_pc = regcache_read_pc (get_current_regcache ()); 453 } 454 CATCH (ex, RETURN_MASK_ERROR) 455 { 456 if (ex.error != NOT_AVAILABLE_ERROR) 457 throw_exception (ex); 458 } 459 END_CATCH 460 461 if (exec_bfd) 462 { 463 const unsigned solib_add_generation 464 = current_program_space->solib_add_generation; 465 466 /* Create the hooks to handle shared library load and unload 467 events. */ 468 solib_create_inferior_hook (from_tty); 469 470 if (current_program_space->solib_add_generation == solib_add_generation) 471 { 472 /* The platform-specific hook should load initial shared libraries, 473 but didn't. FROM_TTY will be incorrectly 0 but such solib 474 targets should be fixed anyway. Call it only after the solib 475 target has been initialized by solib_create_inferior_hook. */ 476 477 if (info_verbose) 478 warning (_("platform-specific solib_create_inferior_hook did " 479 "not load initial shared libraries.")); 480 481 /* If the solist is global across processes, there's no need to 482 refetch it here. */ 483 if (!gdbarch_has_global_solist (target_gdbarch ())) 484 solib_add (NULL, 0, auto_solib_add); 485 } 486 } 487 488 /* If the user sets watchpoints before execution having started, 489 then she gets software watchpoints, because GDB can't know which 490 target will end up being pushed, or if it supports hardware 491 watchpoints or not. breakpoint_re_set takes care of promoting 492 watchpoints to hardware watchpoints if possible, however, if this 493 new inferior doesn't load shared libraries or we don't pull in 494 symbols from any other source on this target/arch, 495 breakpoint_re_set is never called. Call it now so that software 496 watchpoints get a chance to be promoted to hardware watchpoints 497 if the now pushed target supports hardware watchpoints. */ 498 breakpoint_re_set (); 499 500 gdb::observers::inferior_created.notify (target, from_tty); 501 } 502 503 /* Kill the inferior if already running. This function is designed 504 to be called when we are about to start the execution of the program 505 from the beginning. Ask the user to confirm that he wants to restart 506 the program being debugged when FROM_TTY is non-null. */ 507 508 static void 509 kill_if_already_running (int from_tty) 510 { 511 if (inferior_ptid != null_ptid && target_has_execution) 512 { 513 /* Bail out before killing the program if we will not be able to 514 restart it. */ 515 target_require_runnable (); 516 517 if (from_tty 518 && !query (_("The program being debugged has been started already.\n\ 519 Start it from the beginning? "))) 520 error (_("Program not restarted.")); 521 target_kill (); 522 } 523 } 524 525 /* See inferior.h. */ 526 527 void 528 prepare_execution_command (struct target_ops *target, int background) 529 { 530 /* If we get a request for running in the bg but the target 531 doesn't support it, error out. */ 532 if (background && !target->can_async_p ()) 533 error (_("Asynchronous execution not supported on this target.")); 534 535 if (!background) 536 { 537 /* If we get a request for running in the fg, then we need to 538 simulate synchronous (fg) execution. Note no cleanup is 539 necessary for this. stdin is re-enabled whenever an error 540 reaches the top level. */ 541 all_uis_on_sync_execution_starting (); 542 } 543 } 544 545 /* Determine how the new inferior will behave. */ 546 547 enum run_how 548 { 549 /* Run program without any explicit stop during startup. */ 550 RUN_NORMAL, 551 552 /* Stop at the beginning of the program's main function. */ 553 RUN_STOP_AT_MAIN, 554 555 /* Stop at the first instruction of the program. */ 556 RUN_STOP_AT_FIRST_INSN 557 }; 558 559 /* Implement the "run" command. Force a stop during program start if 560 requested by RUN_HOW. */ 561 562 static void 563 run_command_1 (const char *args, int from_tty, enum run_how run_how) 564 { 565 const char *exec_file; 566 struct ui_out *uiout = current_uiout; 567 struct target_ops *run_target; 568 int async_exec; 569 570 dont_repeat (); 571 572 kill_if_already_running (from_tty); 573 574 init_wait_for_inferior (); 575 clear_breakpoint_hit_counts (); 576 577 /* Clean up any leftovers from other runs. Some other things from 578 this function should probably be moved into target_pre_inferior. */ 579 target_pre_inferior (from_tty); 580 581 /* The comment here used to read, "The exec file is re-read every 582 time we do a generic_mourn_inferior, so we just have to worry 583 about the symbol file." The `generic_mourn_inferior' function 584 gets called whenever the program exits. However, suppose the 585 program exits, and *then* the executable file changes? We need 586 to check again here. Since reopen_exec_file doesn't do anything 587 if the timestamp hasn't changed, I don't see the harm. */ 588 reopen_exec_file (); 589 reread_symbols (); 590 591 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (args, &async_exec); 592 args = stripped.get (); 593 594 /* Do validation and preparation before possibly changing anything 595 in the inferior. */ 596 597 run_target = find_run_target (); 598 599 prepare_execution_command (run_target, async_exec); 600 601 if (non_stop && !run_target->supports_non_stop ()) 602 error (_("The target does not support running in non-stop mode.")); 603 604 /* Done. Can now set breakpoints, change inferior args, etc. */ 605 606 /* Insert temporary breakpoint in main function if requested. */ 607 if (run_how == RUN_STOP_AT_MAIN) 608 tbreak_command (main_name (), 0); 609 610 exec_file = get_exec_file (0); 611 612 /* We keep symbols from add-symbol-file, on the grounds that the 613 user might want to add some symbols before running the program 614 (right?). But sometimes (dynamic loading where the user manually 615 introduces the new symbols with add-symbol-file), the code which 616 the symbols describe does not persist between runs. Currently 617 the user has to manually nuke all symbols between runs if they 618 want them to go away (PR 2207). This is probably reasonable. */ 619 620 /* If there were other args, beside '&', process them. */ 621 if (args != NULL) 622 set_inferior_args (args); 623 624 if (from_tty) 625 { 626 uiout->field_string (NULL, "Starting program"); 627 uiout->text (": "); 628 if (exec_file) 629 uiout->field_string ("execfile", exec_file); 630 uiout->spaces (1); 631 /* We call get_inferior_args() because we might need to compute 632 the value now. */ 633 uiout->field_string ("infargs", get_inferior_args ()); 634 uiout->text ("\n"); 635 uiout->flush (); 636 } 637 638 /* We call get_inferior_args() because we might need to compute 639 the value now. */ 640 run_target->create_inferior (exec_file, 641 std::string (get_inferior_args ()), 642 current_inferior ()->environment.envp (), 643 from_tty); 644 /* to_create_inferior should push the target, so after this point we 645 shouldn't refer to run_target again. */ 646 run_target = NULL; 647 648 /* We're starting off a new process. When we get out of here, in 649 non-stop mode, finish the state of all threads of that process, 650 but leave other threads alone, as they may be stopped in internal 651 events --- the frontend shouldn't see them as stopped. In 652 all-stop, always finish the state of all threads, as we may be 653 resuming more than just the new process. */ 654 ptid_t finish_ptid = (non_stop 655 ? ptid_t (current_inferior ()->pid) 656 : minus_one_ptid); 657 scoped_finish_thread_state finish_state (finish_ptid); 658 659 /* Pass zero for FROM_TTY, because at this point the "run" command 660 has done its thing; now we are setting up the running program. */ 661 post_create_inferior (current_top_target (), 0); 662 663 /* Queue a pending event so that the program stops immediately. */ 664 if (run_how == RUN_STOP_AT_FIRST_INSN) 665 { 666 thread_info *thr = inferior_thread (); 667 thr->suspend.waitstatus_pending_p = 1; 668 thr->suspend.waitstatus.kind = TARGET_WAITKIND_STOPPED; 669 thr->suspend.waitstatus.value.sig = GDB_SIGNAL_0; 670 } 671 672 /* Start the target running. Do not use -1 continuation as it would skip 673 breakpoint right at the entry point. */ 674 proceed (regcache_read_pc (get_current_regcache ()), GDB_SIGNAL_0); 675 676 /* Since there was no error, there's no need to finish the thread 677 states here. */ 678 finish_state.release (); 679 } 680 681 static void 682 run_command (const char *args, int from_tty) 683 { 684 run_command_1 (args, from_tty, RUN_NORMAL); 685 } 686 687 /* Start the execution of the program up until the beginning of the main 688 program. */ 689 690 static void 691 start_command (const char *args, int from_tty) 692 { 693 /* Some languages such as Ada need to search inside the program 694 minimal symbols for the location where to put the temporary 695 breakpoint before starting. */ 696 if (!have_minimal_symbols ()) 697 error (_("No symbol table loaded. Use the \"file\" command.")); 698 699 /* Run the program until reaching the main procedure... */ 700 run_command_1 (args, from_tty, RUN_STOP_AT_MAIN); 701 } 702 703 /* Start the execution of the program stopping at the first 704 instruction. */ 705 706 static void 707 starti_command (const char *args, int from_tty) 708 { 709 run_command_1 (args, from_tty, RUN_STOP_AT_FIRST_INSN); 710 } 711 712 static int 713 proceed_thread_callback (struct thread_info *thread, void *arg) 714 { 715 /* We go through all threads individually instead of compressing 716 into a single target `resume_all' request, because some threads 717 may be stopped in internal breakpoints/events, or stopped waiting 718 for its turn in the displaced stepping queue (that is, they are 719 running && !executing). The target side has no idea about why 720 the thread is stopped, so a `resume_all' command would resume too 721 much. If/when GDB gains a way to tell the target `hold this 722 thread stopped until I say otherwise', then we can optimize 723 this. */ 724 if (thread->state != THREAD_STOPPED) 725 return 0; 726 727 switch_to_thread (thread); 728 clear_proceed_status (0); 729 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 730 return 0; 731 } 732 733 static void 734 ensure_valid_thread (void) 735 { 736 if (inferior_ptid == null_ptid 737 || inferior_thread ()->state == THREAD_EXITED) 738 error (_("Cannot execute this command without a live selected thread.")); 739 } 740 741 /* If the user is looking at trace frames, any resumption of execution 742 is likely to mix up recorded and live target data. So simply 743 disallow those commands. */ 744 745 static void 746 ensure_not_tfind_mode (void) 747 { 748 if (get_traceframe_number () >= 0) 749 error (_("Cannot execute this command while looking at trace frames.")); 750 } 751 752 /* Throw an error indicating the current thread is running. */ 753 754 static void 755 error_is_running (void) 756 { 757 error (_("Cannot execute this command while " 758 "the selected thread is running.")); 759 } 760 761 /* Calls error_is_running if the current thread is running. */ 762 763 static void 764 ensure_not_running (void) 765 { 766 if (inferior_thread ()->state == THREAD_RUNNING) 767 error_is_running (); 768 } 769 770 void 771 continue_1 (int all_threads) 772 { 773 ERROR_NO_INFERIOR; 774 ensure_not_tfind_mode (); 775 776 if (non_stop && all_threads) 777 { 778 /* Don't error out if the current thread is running, because 779 there may be other stopped threads. */ 780 781 /* Backup current thread and selected frame and restore on scope 782 exit. */ 783 scoped_restore_current_thread restore_thread; 784 785 iterate_over_threads (proceed_thread_callback, NULL); 786 787 if (current_ui->prompt_state == PROMPT_BLOCKED) 788 { 789 /* If all threads in the target were already running, 790 proceed_thread_callback ends up never calling proceed, 791 and so nothing calls this to put the inferior's terminal 792 settings in effect and remove stdin from the event loop, 793 which we must when running a foreground command. E.g.: 794 795 (gdb) c -a& 796 Continuing. 797 <all threads are running now> 798 (gdb) c -a 799 Continuing. 800 <no thread was resumed, but the inferior now owns the terminal> 801 */ 802 target_terminal::inferior (); 803 } 804 } 805 else 806 { 807 ensure_valid_thread (); 808 ensure_not_running (); 809 clear_proceed_status (0); 810 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 811 } 812 } 813 814 /* continue [-a] [proceed-count] [&] */ 815 816 static void 817 continue_command (const char *args, int from_tty) 818 { 819 int async_exec; 820 int all_threads = 0; 821 822 ERROR_NO_INFERIOR; 823 824 /* Find out whether we must run in the background. */ 825 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (args, &async_exec); 826 args = stripped.get (); 827 828 if (args != NULL) 829 { 830 if (startswith (args, "-a")) 831 { 832 all_threads = 1; 833 args += sizeof ("-a") - 1; 834 if (*args == '\0') 835 args = NULL; 836 } 837 } 838 839 if (!non_stop && all_threads) 840 error (_("`-a' is meaningless in all-stop mode.")); 841 842 if (args != NULL && all_threads) 843 error (_("Can't resume all threads and specify " 844 "proceed count simultaneously.")); 845 846 /* If we have an argument left, set proceed count of breakpoint we 847 stopped at. */ 848 if (args != NULL) 849 { 850 bpstat bs = NULL; 851 int num, stat; 852 int stopped = 0; 853 struct thread_info *tp; 854 855 if (non_stop) 856 tp = inferior_thread (); 857 else 858 { 859 ptid_t last_ptid; 860 struct target_waitstatus ws; 861 862 get_last_target_status (&last_ptid, &ws); 863 tp = find_thread_ptid (last_ptid); 864 } 865 if (tp != NULL) 866 bs = tp->control.stop_bpstat; 867 868 while ((stat = bpstat_num (&bs, &num)) != 0) 869 if (stat > 0) 870 { 871 set_ignore_count (num, 872 parse_and_eval_long (args) - 1, 873 from_tty); 874 /* set_ignore_count prints a message ending with a period. 875 So print two spaces before "Continuing.". */ 876 if (from_tty) 877 printf_filtered (" "); 878 stopped = 1; 879 } 880 881 if (!stopped && from_tty) 882 { 883 printf_filtered 884 ("Not stopped at any breakpoint; argument ignored.\n"); 885 } 886 } 887 888 ERROR_NO_INFERIOR; 889 ensure_not_tfind_mode (); 890 891 if (!non_stop || !all_threads) 892 { 893 ensure_valid_thread (); 894 ensure_not_running (); 895 } 896 897 prepare_execution_command (current_top_target (), async_exec); 898 899 if (from_tty) 900 printf_filtered (_("Continuing.\n")); 901 902 continue_1 (all_threads); 903 } 904 905 /* Record the starting point of a "step" or "next" command. */ 906 907 static void 908 set_step_frame (void) 909 { 910 frame_info *frame = get_current_frame (); 911 912 symtab_and_line sal = find_frame_sal (frame); 913 set_step_info (frame, sal); 914 915 CORE_ADDR pc = get_frame_pc (frame); 916 thread_info *tp = inferior_thread (); 917 tp->control.step_start_function = find_pc_function (pc); 918 } 919 920 /* Step until outside of current statement. */ 921 922 static void 923 step_command (const char *count_string, int from_tty) 924 { 925 step_1 (0, 0, count_string); 926 } 927 928 /* Likewise, but skip over subroutine calls as if single instructions. */ 929 930 static void 931 next_command (const char *count_string, int from_tty) 932 { 933 step_1 (1, 0, count_string); 934 } 935 936 /* Likewise, but step only one instruction. */ 937 938 static void 939 stepi_command (const char *count_string, int from_tty) 940 { 941 step_1 (0, 1, count_string); 942 } 943 944 static void 945 nexti_command (const char *count_string, int from_tty) 946 { 947 step_1 (1, 1, count_string); 948 } 949 950 /* Data for the FSM that manages the step/next/stepi/nexti 951 commands. */ 952 953 struct step_command_fsm : public thread_fsm 954 { 955 /* How many steps left in a "step N"-like command. */ 956 int count; 957 958 /* If true, this is a next/nexti, otherwise a step/stepi. */ 959 int skip_subroutines; 960 961 /* If true, this is a stepi/nexti, otherwise a step/step. */ 962 int single_inst; 963 964 explicit step_command_fsm (struct interp *cmd_interp) 965 : thread_fsm (cmd_interp) 966 { 967 } 968 969 void clean_up (struct thread_info *thread) override; 970 bool should_stop (struct thread_info *thread) override; 971 enum async_reply_reason do_async_reply_reason () override; 972 }; 973 974 /* Prepare for a step/next/etc. command. Any target resource 975 allocated here is undone in the FSM's clean_up method. */ 976 977 static void 978 step_command_fsm_prepare (struct step_command_fsm *sm, 979 int skip_subroutines, int single_inst, 980 int count, struct thread_info *thread) 981 { 982 sm->skip_subroutines = skip_subroutines; 983 sm->single_inst = single_inst; 984 sm->count = count; 985 986 /* Leave the si command alone. */ 987 if (!sm->single_inst || sm->skip_subroutines) 988 set_longjmp_breakpoint (thread, get_frame_id (get_current_frame ())); 989 990 thread->control.stepping_command = 1; 991 } 992 993 static int prepare_one_step (struct step_command_fsm *sm); 994 995 static void 996 step_1 (int skip_subroutines, int single_inst, const char *count_string) 997 { 998 int count; 999 int async_exec; 1000 struct thread_info *thr; 1001 struct step_command_fsm *step_sm; 1002 1003 ERROR_NO_INFERIOR; 1004 ensure_not_tfind_mode (); 1005 ensure_valid_thread (); 1006 ensure_not_running (); 1007 1008 gdb::unique_xmalloc_ptr<char> stripped 1009 = strip_bg_char (count_string, &async_exec); 1010 count_string = stripped.get (); 1011 1012 prepare_execution_command (current_top_target (), async_exec); 1013 1014 count = count_string ? parse_and_eval_long (count_string) : 1; 1015 1016 clear_proceed_status (1); 1017 1018 /* Setup the execution command state machine to handle all the COUNT 1019 steps. */ 1020 thr = inferior_thread (); 1021 step_sm = new step_command_fsm (command_interp ()); 1022 thr->thread_fsm = step_sm; 1023 1024 step_command_fsm_prepare (step_sm, skip_subroutines, 1025 single_inst, count, thr); 1026 1027 /* Do only one step for now, before returning control to the event 1028 loop. Let the continuation figure out how many other steps we 1029 need to do, and handle them one at the time, through 1030 step_once. */ 1031 if (!prepare_one_step (step_sm)) 1032 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1033 else 1034 { 1035 int proceeded; 1036 1037 /* Stepped into an inline frame. Pretend that we've 1038 stopped. */ 1039 thr->thread_fsm->clean_up (thr); 1040 proceeded = normal_stop (); 1041 if (!proceeded) 1042 inferior_event_handler (INF_EXEC_COMPLETE, NULL); 1043 all_uis_check_sync_execution_done (); 1044 } 1045 } 1046 1047 /* Implementation of the 'should_stop' FSM method for stepping 1048 commands. Called after we are done with one step operation, to 1049 check whether we need to step again, before we print the prompt and 1050 return control to the user. If count is > 1, returns false, as we 1051 will need to keep going. */ 1052 1053 bool 1054 step_command_fsm::should_stop (struct thread_info *tp) 1055 { 1056 if (tp->control.stop_step) 1057 { 1058 /* There are more steps to make, and we did stop due to 1059 ending a stepping range. Do another step. */ 1060 if (--count > 0) 1061 return prepare_one_step (this); 1062 1063 set_finished (); 1064 } 1065 1066 return true; 1067 } 1068 1069 /* Implementation of the 'clean_up' FSM method for stepping commands. */ 1070 1071 void 1072 step_command_fsm::clean_up (struct thread_info *thread) 1073 { 1074 if (!single_inst || skip_subroutines) 1075 delete_longjmp_breakpoint (thread->global_num); 1076 } 1077 1078 /* Implementation of the 'async_reply_reason' FSM method for stepping 1079 commands. */ 1080 1081 enum async_reply_reason 1082 step_command_fsm::do_async_reply_reason () 1083 { 1084 return EXEC_ASYNC_END_STEPPING_RANGE; 1085 } 1086 1087 /* Prepare for one step in "step N". The actual target resumption is 1088 done by the caller. Return true if we're done and should thus 1089 report a stop to the user. Returns false if the target needs to be 1090 resumed. */ 1091 1092 static int 1093 prepare_one_step (struct step_command_fsm *sm) 1094 { 1095 if (sm->count > 0) 1096 { 1097 struct frame_info *frame = get_current_frame (); 1098 1099 /* Don't assume THREAD is a valid thread id. It is set to -1 if 1100 the longjmp breakpoint was not required. Use the 1101 INFERIOR_PTID thread instead, which is the same thread when 1102 THREAD is set. */ 1103 struct thread_info *tp = inferior_thread (); 1104 1105 set_step_frame (); 1106 1107 if (!sm->single_inst) 1108 { 1109 CORE_ADDR pc; 1110 1111 /* Step at an inlined function behaves like "down". */ 1112 if (!sm->skip_subroutines 1113 && inline_skipped_frames (tp)) 1114 { 1115 ptid_t resume_ptid; 1116 1117 /* Pretend that we've ran. */ 1118 resume_ptid = user_visible_resume_ptid (1); 1119 set_running (resume_ptid, 1); 1120 1121 step_into_inline_frame (tp); 1122 sm->count--; 1123 return prepare_one_step (sm); 1124 } 1125 1126 pc = get_frame_pc (frame); 1127 find_pc_line_pc_range (pc, 1128 &tp->control.step_range_start, 1129 &tp->control.step_range_end); 1130 1131 tp->control.may_range_step = 1; 1132 1133 /* If we have no line info, switch to stepi mode. */ 1134 if (tp->control.step_range_end == 0 && step_stop_if_no_debug) 1135 { 1136 tp->control.step_range_start = tp->control.step_range_end = 1; 1137 tp->control.may_range_step = 0; 1138 } 1139 else if (tp->control.step_range_end == 0) 1140 { 1141 const char *name; 1142 1143 if (find_pc_partial_function (pc, &name, 1144 &tp->control.step_range_start, 1145 &tp->control.step_range_end) == 0) 1146 error (_("Cannot find bounds of current function")); 1147 1148 target_terminal::ours_for_output (); 1149 printf_filtered (_("Single stepping until exit from function %s," 1150 "\nwhich has no line number information.\n"), 1151 name); 1152 } 1153 } 1154 else 1155 { 1156 /* Say we are stepping, but stop after one insn whatever it does. */ 1157 tp->control.step_range_start = tp->control.step_range_end = 1; 1158 if (!sm->skip_subroutines) 1159 /* It is stepi. 1160 Don't step over function calls, not even to functions lacking 1161 line numbers. */ 1162 tp->control.step_over_calls = STEP_OVER_NONE; 1163 } 1164 1165 if (sm->skip_subroutines) 1166 tp->control.step_over_calls = STEP_OVER_ALL; 1167 1168 return 0; 1169 } 1170 1171 /* Done. */ 1172 sm->set_finished (); 1173 return 1; 1174 } 1175 1176 1177 /* Continue program at specified address. */ 1178 1179 static void 1180 jump_command (const char *arg, int from_tty) 1181 { 1182 struct gdbarch *gdbarch = get_current_arch (); 1183 CORE_ADDR addr; 1184 struct symbol *fn; 1185 struct symbol *sfn; 1186 int async_exec; 1187 1188 ERROR_NO_INFERIOR; 1189 ensure_not_tfind_mode (); 1190 ensure_valid_thread (); 1191 ensure_not_running (); 1192 1193 /* Find out whether we must run in the background. */ 1194 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (arg, &async_exec); 1195 arg = stripped.get (); 1196 1197 prepare_execution_command (current_top_target (), async_exec); 1198 1199 if (!arg) 1200 error_no_arg (_("starting address")); 1201 1202 std::vector<symtab_and_line> sals 1203 = decode_line_with_last_displayed (arg, DECODE_LINE_FUNFIRSTLINE); 1204 if (sals.size () != 1) 1205 error (_("Unreasonable jump request")); 1206 1207 symtab_and_line &sal = sals[0]; 1208 1209 if (sal.symtab == 0 && sal.pc == 0) 1210 error (_("No source file has been specified.")); 1211 1212 resolve_sal_pc (&sal); /* May error out. */ 1213 1214 /* See if we are trying to jump to another function. */ 1215 fn = get_frame_function (get_current_frame ()); 1216 sfn = find_pc_function (sal.pc); 1217 if (fn != NULL && sfn != fn) 1218 { 1219 if (!query (_("Line %d is not in `%s'. Jump anyway? "), sal.line, 1220 SYMBOL_PRINT_NAME (fn))) 1221 { 1222 error (_("Not confirmed.")); 1223 /* NOTREACHED */ 1224 } 1225 } 1226 1227 if (sfn != NULL) 1228 { 1229 struct obj_section *section; 1230 1231 fixup_symbol_section (sfn, 0); 1232 section = SYMBOL_OBJ_SECTION (symbol_objfile (sfn), sfn); 1233 if (section_is_overlay (section) 1234 && !section_is_mapped (section)) 1235 { 1236 if (!query (_("WARNING!!! Destination is in " 1237 "unmapped overlay! Jump anyway? "))) 1238 { 1239 error (_("Not confirmed.")); 1240 /* NOTREACHED */ 1241 } 1242 } 1243 } 1244 1245 addr = sal.pc; 1246 1247 if (from_tty) 1248 { 1249 printf_filtered (_("Continuing at ")); 1250 fputs_filtered (paddress (gdbarch, addr), gdb_stdout); 1251 printf_filtered (".\n"); 1252 } 1253 1254 clear_proceed_status (0); 1255 proceed (addr, GDB_SIGNAL_0); 1256 } 1257 1258 /* Continue program giving it specified signal. */ 1259 1260 static void 1261 signal_command (const char *signum_exp, int from_tty) 1262 { 1263 enum gdb_signal oursig; 1264 int async_exec; 1265 1266 dont_repeat (); /* Too dangerous. */ 1267 ERROR_NO_INFERIOR; 1268 ensure_not_tfind_mode (); 1269 ensure_valid_thread (); 1270 ensure_not_running (); 1271 1272 /* Find out whether we must run in the background. */ 1273 gdb::unique_xmalloc_ptr<char> stripped 1274 = strip_bg_char (signum_exp, &async_exec); 1275 signum_exp = stripped.get (); 1276 1277 prepare_execution_command (current_top_target (), async_exec); 1278 1279 if (!signum_exp) 1280 error_no_arg (_("signal number")); 1281 1282 /* It would be even slicker to make signal names be valid expressions, 1283 (the type could be "enum $signal" or some such), then the user could 1284 assign them to convenience variables. */ 1285 oursig = gdb_signal_from_name (signum_exp); 1286 1287 if (oursig == GDB_SIGNAL_UNKNOWN) 1288 { 1289 /* No, try numeric. */ 1290 int num = parse_and_eval_long (signum_exp); 1291 1292 if (num == 0) 1293 oursig = GDB_SIGNAL_0; 1294 else 1295 oursig = gdb_signal_from_command (num); 1296 } 1297 1298 /* Look for threads other than the current that this command ends up 1299 resuming too (due to schedlock off), and warn if they'll get a 1300 signal delivered. "signal 0" is used to suppress a previous 1301 signal, but if the current thread is no longer the one that got 1302 the signal, then the user is potentially suppressing the signal 1303 of the wrong thread. */ 1304 if (!non_stop) 1305 { 1306 int must_confirm = 0; 1307 1308 /* This indicates what will be resumed. Either a single thread, 1309 a whole process, or all threads of all processes. */ 1310 ptid_t resume_ptid = user_visible_resume_ptid (0); 1311 1312 for (thread_info *tp : all_non_exited_threads (resume_ptid)) 1313 { 1314 if (tp->ptid == inferior_ptid) 1315 continue; 1316 1317 if (tp->suspend.stop_signal != GDB_SIGNAL_0 1318 && signal_pass_state (tp->suspend.stop_signal)) 1319 { 1320 if (!must_confirm) 1321 printf_unfiltered (_("Note:\n")); 1322 printf_unfiltered (_(" Thread %s previously stopped with signal %s, %s.\n"), 1323 print_thread_id (tp), 1324 gdb_signal_to_name (tp->suspend.stop_signal), 1325 gdb_signal_to_string (tp->suspend.stop_signal)); 1326 must_confirm = 1; 1327 } 1328 } 1329 1330 if (must_confirm 1331 && !query (_("Continuing thread %s (the current thread) with specified signal will\n" 1332 "still deliver the signals noted above to their respective threads.\n" 1333 "Continue anyway? "), 1334 print_thread_id (inferior_thread ()))) 1335 error (_("Not confirmed.")); 1336 } 1337 1338 if (from_tty) 1339 { 1340 if (oursig == GDB_SIGNAL_0) 1341 printf_filtered (_("Continuing with no signal.\n")); 1342 else 1343 printf_filtered (_("Continuing with signal %s.\n"), 1344 gdb_signal_to_name (oursig)); 1345 } 1346 1347 clear_proceed_status (0); 1348 proceed ((CORE_ADDR) -1, oursig); 1349 } 1350 1351 /* Queue a signal to be delivered to the current thread. */ 1352 1353 static void 1354 queue_signal_command (const char *signum_exp, int from_tty) 1355 { 1356 enum gdb_signal oursig; 1357 struct thread_info *tp; 1358 1359 ERROR_NO_INFERIOR; 1360 ensure_not_tfind_mode (); 1361 ensure_valid_thread (); 1362 ensure_not_running (); 1363 1364 if (signum_exp == NULL) 1365 error_no_arg (_("signal number")); 1366 1367 /* It would be even slicker to make signal names be valid expressions, 1368 (the type could be "enum $signal" or some such), then the user could 1369 assign them to convenience variables. */ 1370 oursig = gdb_signal_from_name (signum_exp); 1371 1372 if (oursig == GDB_SIGNAL_UNKNOWN) 1373 { 1374 /* No, try numeric. */ 1375 int num = parse_and_eval_long (signum_exp); 1376 1377 if (num == 0) 1378 oursig = GDB_SIGNAL_0; 1379 else 1380 oursig = gdb_signal_from_command (num); 1381 } 1382 1383 if (oursig != GDB_SIGNAL_0 1384 && !signal_pass_state (oursig)) 1385 error (_("Signal handling set to not pass this signal to the program.")); 1386 1387 tp = inferior_thread (); 1388 tp->suspend.stop_signal = oursig; 1389 } 1390 1391 /* Data for the FSM that manages the until (with no argument) 1392 command. */ 1393 1394 struct until_next_fsm : public thread_fsm 1395 { 1396 /* The thread that as current when the command was executed. */ 1397 int thread; 1398 1399 until_next_fsm (struct interp *cmd_interp, int thread) 1400 : thread_fsm (cmd_interp), 1401 thread (thread) 1402 { 1403 } 1404 1405 bool should_stop (struct thread_info *thread) override; 1406 void clean_up (struct thread_info *thread) override; 1407 enum async_reply_reason do_async_reply_reason () override; 1408 }; 1409 1410 /* Implementation of the 'should_stop' FSM method for the until (with 1411 no arg) command. */ 1412 1413 bool 1414 until_next_fsm::should_stop (struct thread_info *tp) 1415 { 1416 if (tp->control.stop_step) 1417 set_finished (); 1418 1419 return true; 1420 } 1421 1422 /* Implementation of the 'clean_up' FSM method for the until (with no 1423 arg) command. */ 1424 1425 void 1426 until_next_fsm::clean_up (struct thread_info *thread) 1427 { 1428 delete_longjmp_breakpoint (thread->global_num); 1429 } 1430 1431 /* Implementation of the 'async_reply_reason' FSM method for the until 1432 (with no arg) command. */ 1433 1434 enum async_reply_reason 1435 until_next_fsm::do_async_reply_reason () 1436 { 1437 return EXEC_ASYNC_END_STEPPING_RANGE; 1438 } 1439 1440 /* Proceed until we reach a different source line with pc greater than 1441 our current one or exit the function. We skip calls in both cases. 1442 1443 Note that eventually this command should probably be changed so 1444 that only source lines are printed out when we hit the breakpoint 1445 we set. This may involve changes to wait_for_inferior and the 1446 proceed status code. */ 1447 1448 static void 1449 until_next_command (int from_tty) 1450 { 1451 struct frame_info *frame; 1452 CORE_ADDR pc; 1453 struct symbol *func; 1454 struct symtab_and_line sal; 1455 struct thread_info *tp = inferior_thread (); 1456 int thread = tp->global_num; 1457 struct until_next_fsm *sm; 1458 1459 clear_proceed_status (0); 1460 set_step_frame (); 1461 1462 frame = get_current_frame (); 1463 1464 /* Step until either exited from this function or greater 1465 than the current line (if in symbolic section) or pc (if 1466 not). */ 1467 1468 pc = get_frame_pc (frame); 1469 func = find_pc_function (pc); 1470 1471 if (!func) 1472 { 1473 struct bound_minimal_symbol msymbol = lookup_minimal_symbol_by_pc (pc); 1474 1475 if (msymbol.minsym == NULL) 1476 error (_("Execution is not within a known function.")); 1477 1478 tp->control.step_range_start = BMSYMBOL_VALUE_ADDRESS (msymbol); 1479 /* The upper-bound of step_range is exclusive. In order to make PC 1480 within the range, set the step_range_end with PC + 1. */ 1481 tp->control.step_range_end = pc + 1; 1482 } 1483 else 1484 { 1485 sal = find_pc_line (pc, 0); 1486 1487 tp->control.step_range_start = BLOCK_ENTRY_PC (SYMBOL_BLOCK_VALUE (func)); 1488 tp->control.step_range_end = sal.end; 1489 } 1490 tp->control.may_range_step = 1; 1491 1492 tp->control.step_over_calls = STEP_OVER_ALL; 1493 1494 set_longjmp_breakpoint (tp, get_frame_id (frame)); 1495 delete_longjmp_breakpoint_cleanup lj_deleter (thread); 1496 1497 sm = new until_next_fsm (command_interp (), tp->global_num); 1498 tp->thread_fsm = sm; 1499 lj_deleter.release (); 1500 1501 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1502 } 1503 1504 static void 1505 until_command (const char *arg, int from_tty) 1506 { 1507 int async_exec; 1508 1509 ERROR_NO_INFERIOR; 1510 ensure_not_tfind_mode (); 1511 ensure_valid_thread (); 1512 ensure_not_running (); 1513 1514 /* Find out whether we must run in the background. */ 1515 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (arg, &async_exec); 1516 arg = stripped.get (); 1517 1518 prepare_execution_command (current_top_target (), async_exec); 1519 1520 if (arg) 1521 until_break_command (arg, from_tty, 0); 1522 else 1523 until_next_command (from_tty); 1524 } 1525 1526 static void 1527 advance_command (const char *arg, int from_tty) 1528 { 1529 int async_exec; 1530 1531 ERROR_NO_INFERIOR; 1532 ensure_not_tfind_mode (); 1533 ensure_valid_thread (); 1534 ensure_not_running (); 1535 1536 if (arg == NULL) 1537 error_no_arg (_("a location")); 1538 1539 /* Find out whether we must run in the background. */ 1540 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (arg, &async_exec); 1541 arg = stripped.get (); 1542 1543 prepare_execution_command (current_top_target (), async_exec); 1544 1545 until_break_command (arg, from_tty, 1); 1546 } 1547 1548 /* Return the value of the result of a function at the end of a 'finish' 1549 command/BP. DTOR_DATA (if not NULL) can represent inferior registers 1550 right after an inferior call has finished. */ 1551 1552 struct value * 1553 get_return_value (struct value *function, struct type *value_type) 1554 { 1555 regcache *stop_regs = get_current_regcache (); 1556 struct gdbarch *gdbarch = stop_regs->arch (); 1557 struct value *value; 1558 1559 value_type = check_typedef (value_type); 1560 gdb_assert (TYPE_CODE (value_type) != TYPE_CODE_VOID); 1561 1562 /* FIXME: 2003-09-27: When returning from a nested inferior function 1563 call, it's possible (with no help from the architecture vector) 1564 to locate and return/print a "struct return" value. This is just 1565 a more complicated case of what is already being done in the 1566 inferior function call code. In fact, when inferior function 1567 calls are made async, this will likely be made the norm. */ 1568 1569 switch (gdbarch_return_value (gdbarch, function, value_type, 1570 NULL, NULL, NULL)) 1571 { 1572 case RETURN_VALUE_REGISTER_CONVENTION: 1573 case RETURN_VALUE_ABI_RETURNS_ADDRESS: 1574 case RETURN_VALUE_ABI_PRESERVES_ADDRESS: 1575 value = allocate_value (value_type); 1576 gdbarch_return_value (gdbarch, function, value_type, stop_regs, 1577 value_contents_raw (value), NULL); 1578 break; 1579 case RETURN_VALUE_STRUCT_CONVENTION: 1580 value = NULL; 1581 break; 1582 default: 1583 internal_error (__FILE__, __LINE__, _("bad switch")); 1584 } 1585 1586 return value; 1587 } 1588 1589 /* The captured function return value/type and its position in the 1590 value history. */ 1591 1592 struct return_value_info 1593 { 1594 /* The captured return value. May be NULL if we weren't able to 1595 retrieve it. See get_return_value. */ 1596 struct value *value; 1597 1598 /* The return type. In some cases, we'll not be able extract the 1599 return value, but we always know the type. */ 1600 struct type *type; 1601 1602 /* If we captured a value, this is the value history index. */ 1603 int value_history_index; 1604 }; 1605 1606 /* Helper for print_return_value. */ 1607 1608 static void 1609 print_return_value_1 (struct ui_out *uiout, struct return_value_info *rv) 1610 { 1611 if (rv->value != NULL) 1612 { 1613 struct value_print_options opts; 1614 1615 /* Print it. */ 1616 uiout->text ("Value returned is "); 1617 uiout->field_fmt ("gdb-result-var", "$%d", 1618 rv->value_history_index); 1619 uiout->text (" = "); 1620 get_user_print_options (&opts); 1621 1622 string_file stb; 1623 1624 value_print (rv->value, &stb, &opts); 1625 uiout->field_stream ("return-value", stb); 1626 uiout->text ("\n"); 1627 } 1628 else 1629 { 1630 std::string type_name = type_to_string (rv->type); 1631 uiout->text ("Value returned has type: "); 1632 uiout->field_string ("return-type", type_name.c_str ()); 1633 uiout->text ("."); 1634 uiout->text (" Cannot determine contents\n"); 1635 } 1636 } 1637 1638 /* Print the result of a function at the end of a 'finish' command. 1639 RV points at an object representing the captured return value/type 1640 and its position in the value history. */ 1641 1642 void 1643 print_return_value (struct ui_out *uiout, struct return_value_info *rv) 1644 { 1645 if (rv->type == NULL 1646 || TYPE_CODE (check_typedef (rv->type)) == TYPE_CODE_VOID) 1647 return; 1648 1649 TRY 1650 { 1651 /* print_return_value_1 can throw an exception in some 1652 circumstances. We need to catch this so that we still 1653 delete the breakpoint. */ 1654 print_return_value_1 (uiout, rv); 1655 } 1656 CATCH (ex, RETURN_MASK_ALL) 1657 { 1658 exception_print (gdb_stdout, ex); 1659 } 1660 END_CATCH 1661 } 1662 1663 /* Data for the FSM that manages the finish command. */ 1664 1665 struct finish_command_fsm : public thread_fsm 1666 { 1667 /* The momentary breakpoint set at the function's return address in 1668 the caller. */ 1669 breakpoint_up breakpoint; 1670 1671 /* The function that we're stepping out of. */ 1672 struct symbol *function = nullptr; 1673 1674 /* If the FSM finishes successfully, this stores the function's 1675 return value. */ 1676 struct return_value_info return_value_info {}; 1677 1678 explicit finish_command_fsm (struct interp *cmd_interp) 1679 : thread_fsm (cmd_interp) 1680 { 1681 } 1682 1683 bool should_stop (struct thread_info *thread) override; 1684 void clean_up (struct thread_info *thread) override; 1685 struct return_value_info *return_value () override; 1686 enum async_reply_reason do_async_reply_reason () override; 1687 }; 1688 1689 /* Implementation of the 'should_stop' FSM method for the finish 1690 commands. Detects whether the thread stepped out of the function 1691 successfully, and if so, captures the function's return value and 1692 marks the FSM finished. */ 1693 1694 bool 1695 finish_command_fsm::should_stop (struct thread_info *tp) 1696 { 1697 struct return_value_info *rv = &return_value_info; 1698 1699 if (function != NULL 1700 && bpstat_find_breakpoint (tp->control.stop_bpstat, 1701 breakpoint.get ()) != NULL) 1702 { 1703 /* We're done. */ 1704 set_finished (); 1705 1706 rv->type = TYPE_TARGET_TYPE (SYMBOL_TYPE (function)); 1707 if (rv->type == NULL) 1708 internal_error (__FILE__, __LINE__, 1709 _("finish_command: function has no target type")); 1710 1711 if (TYPE_CODE (check_typedef (rv->type)) != TYPE_CODE_VOID) 1712 { 1713 struct value *func; 1714 1715 func = read_var_value (function, NULL, get_current_frame ()); 1716 rv->value = get_return_value (func, rv->type); 1717 if (rv->value != NULL) 1718 rv->value_history_index = record_latest_value (rv->value); 1719 } 1720 } 1721 else if (tp->control.stop_step) 1722 { 1723 /* Finishing from an inline frame, or reverse finishing. In 1724 either case, there's no way to retrieve the return value. */ 1725 set_finished (); 1726 } 1727 1728 return true; 1729 } 1730 1731 /* Implementation of the 'clean_up' FSM method for the finish 1732 commands. */ 1733 1734 void 1735 finish_command_fsm::clean_up (struct thread_info *thread) 1736 { 1737 breakpoint.reset (); 1738 delete_longjmp_breakpoint (thread->global_num); 1739 } 1740 1741 /* Implementation of the 'return_value' FSM method for the finish 1742 commands. */ 1743 1744 struct return_value_info * 1745 finish_command_fsm::return_value () 1746 { 1747 return &return_value_info; 1748 } 1749 1750 /* Implementation of the 'async_reply_reason' FSM method for the 1751 finish commands. */ 1752 1753 enum async_reply_reason 1754 finish_command_fsm::do_async_reply_reason () 1755 { 1756 if (execution_direction == EXEC_REVERSE) 1757 return EXEC_ASYNC_END_STEPPING_RANGE; 1758 else 1759 return EXEC_ASYNC_FUNCTION_FINISHED; 1760 } 1761 1762 /* finish_backward -- helper function for finish_command. */ 1763 1764 static void 1765 finish_backward (struct finish_command_fsm *sm) 1766 { 1767 struct symtab_and_line sal; 1768 struct thread_info *tp = inferior_thread (); 1769 CORE_ADDR pc; 1770 CORE_ADDR func_addr; 1771 1772 pc = get_frame_pc (get_current_frame ()); 1773 1774 if (find_pc_partial_function (pc, NULL, &func_addr, NULL) == 0) 1775 error (_("Cannot find bounds of current function")); 1776 1777 sal = find_pc_line (func_addr, 0); 1778 1779 tp->control.proceed_to_finish = 1; 1780 /* Special case: if we're sitting at the function entry point, 1781 then all we need to do is take a reverse singlestep. We 1782 don't need to set a breakpoint, and indeed it would do us 1783 no good to do so. 1784 1785 Note that this can only happen at frame #0, since there's 1786 no way that a function up the stack can have a return address 1787 that's equal to its entry point. */ 1788 1789 if (sal.pc != pc) 1790 { 1791 struct frame_info *frame = get_selected_frame (NULL); 1792 struct gdbarch *gdbarch = get_frame_arch (frame); 1793 1794 /* Set a step-resume at the function's entry point. Once that's 1795 hit, we'll do one more step backwards. */ 1796 symtab_and_line sr_sal; 1797 sr_sal.pc = sal.pc; 1798 sr_sal.pspace = get_frame_program_space (frame); 1799 insert_step_resume_breakpoint_at_sal (gdbarch, 1800 sr_sal, null_frame_id); 1801 1802 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1803 } 1804 else 1805 { 1806 /* We're almost there -- we just need to back up by one more 1807 single-step. */ 1808 tp->control.step_range_start = tp->control.step_range_end = 1; 1809 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1810 } 1811 } 1812 1813 /* finish_forward -- helper function for finish_command. FRAME is the 1814 frame that called the function we're about to step out of. */ 1815 1816 static void 1817 finish_forward (struct finish_command_fsm *sm, struct frame_info *frame) 1818 { 1819 struct frame_id frame_id = get_frame_id (frame); 1820 struct gdbarch *gdbarch = get_frame_arch (frame); 1821 struct symtab_and_line sal; 1822 struct thread_info *tp = inferior_thread (); 1823 1824 sal = find_pc_line (get_frame_pc (frame), 0); 1825 sal.pc = get_frame_pc (frame); 1826 1827 sm->breakpoint = set_momentary_breakpoint (gdbarch, sal, 1828 get_stack_frame_id (frame), 1829 bp_finish); 1830 1831 /* set_momentary_breakpoint invalidates FRAME. */ 1832 frame = NULL; 1833 1834 set_longjmp_breakpoint (tp, frame_id); 1835 1836 /* We want to print return value, please... */ 1837 tp->control.proceed_to_finish = 1; 1838 1839 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1840 } 1841 1842 /* Skip frames for "finish". */ 1843 1844 static struct frame_info * 1845 skip_finish_frames (struct frame_info *frame) 1846 { 1847 struct frame_info *start; 1848 1849 do 1850 { 1851 start = frame; 1852 1853 frame = skip_tailcall_frames (frame); 1854 if (frame == NULL) 1855 break; 1856 1857 frame = skip_unwritable_frames (frame); 1858 if (frame == NULL) 1859 break; 1860 } 1861 while (start != frame); 1862 1863 return frame; 1864 } 1865 1866 /* "finish": Set a temporary breakpoint at the place the selected 1867 frame will return to, then continue. */ 1868 1869 static void 1870 finish_command (const char *arg, int from_tty) 1871 { 1872 struct frame_info *frame; 1873 int async_exec; 1874 struct finish_command_fsm *sm; 1875 struct thread_info *tp; 1876 1877 ERROR_NO_INFERIOR; 1878 ensure_not_tfind_mode (); 1879 ensure_valid_thread (); 1880 ensure_not_running (); 1881 1882 /* Find out whether we must run in the background. */ 1883 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (arg, &async_exec); 1884 arg = stripped.get (); 1885 1886 prepare_execution_command (current_top_target (), async_exec); 1887 1888 if (arg) 1889 error (_("The \"finish\" command does not take any arguments.")); 1890 1891 frame = get_prev_frame (get_selected_frame (_("No selected frame."))); 1892 if (frame == 0) 1893 error (_("\"finish\" not meaningful in the outermost frame.")); 1894 1895 clear_proceed_status (0); 1896 1897 tp = inferior_thread (); 1898 1899 sm = new finish_command_fsm (command_interp ()); 1900 1901 tp->thread_fsm = sm; 1902 1903 /* Finishing from an inline frame is completely different. We don't 1904 try to show the "return value" - no way to locate it. */ 1905 if (get_frame_type (get_selected_frame (_("No selected frame."))) 1906 == INLINE_FRAME) 1907 { 1908 /* Claim we are stepping in the calling frame. An empty step 1909 range means that we will stop once we aren't in a function 1910 called by that frame. We don't use the magic "1" value for 1911 step_range_end, because then infrun will think this is nexti, 1912 and not step over the rest of this inlined function call. */ 1913 set_step_info (frame, {}); 1914 tp->control.step_range_start = get_frame_pc (frame); 1915 tp->control.step_range_end = tp->control.step_range_start; 1916 tp->control.step_over_calls = STEP_OVER_ALL; 1917 1918 /* Print info on the selected frame, including level number but not 1919 source. */ 1920 if (from_tty) 1921 { 1922 printf_filtered (_("Run till exit from ")); 1923 print_stack_frame (get_selected_frame (NULL), 1, LOCATION, 0); 1924 } 1925 1926 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 1927 return; 1928 } 1929 1930 /* Find the function we will return from. */ 1931 1932 sm->function = find_pc_function (get_frame_pc (get_selected_frame (NULL))); 1933 1934 /* Print info on the selected frame, including level number but not 1935 source. */ 1936 if (from_tty) 1937 { 1938 if (execution_direction == EXEC_REVERSE) 1939 printf_filtered (_("Run back to call of ")); 1940 else 1941 { 1942 if (sm->function != NULL && TYPE_NO_RETURN (sm->function->type) 1943 && !query (_("warning: Function %s does not return normally.\n" 1944 "Try to finish anyway? "), 1945 SYMBOL_PRINT_NAME (sm->function))) 1946 error (_("Not confirmed.")); 1947 printf_filtered (_("Run till exit from ")); 1948 } 1949 1950 print_stack_frame (get_selected_frame (NULL), 1, LOCATION, 0); 1951 } 1952 1953 if (execution_direction == EXEC_REVERSE) 1954 finish_backward (sm); 1955 else 1956 { 1957 frame = skip_finish_frames (frame); 1958 1959 if (frame == NULL) 1960 error (_("Cannot find the caller frame.")); 1961 1962 finish_forward (sm, frame); 1963 } 1964 } 1965 1966 1967 static void 1968 info_program_command (const char *args, int from_tty) 1969 { 1970 bpstat bs; 1971 int num, stat; 1972 ptid_t ptid; 1973 1974 if (!target_has_execution) 1975 { 1976 printf_filtered (_("The program being debugged is not being run.\n")); 1977 return; 1978 } 1979 1980 if (non_stop) 1981 ptid = inferior_ptid; 1982 else 1983 { 1984 struct target_waitstatus ws; 1985 1986 get_last_target_status (&ptid, &ws); 1987 } 1988 1989 if (ptid == null_ptid || ptid == minus_one_ptid) 1990 error (_("No selected thread.")); 1991 1992 thread_info *tp = find_thread_ptid (ptid); 1993 1994 if (tp->state == THREAD_EXITED) 1995 error (_("Invalid selected thread.")); 1996 else if (tp->state == THREAD_RUNNING) 1997 error (_("Selected thread is running.")); 1998 1999 bs = tp->control.stop_bpstat; 2000 stat = bpstat_num (&bs, &num); 2001 2002 target_files_info (); 2003 printf_filtered (_("Program stopped at %s.\n"), 2004 paddress (target_gdbarch (), tp->suspend.stop_pc)); 2005 if (tp->control.stop_step) 2006 printf_filtered (_("It stopped after being stepped.\n")); 2007 else if (stat != 0) 2008 { 2009 /* There may be several breakpoints in the same place, so this 2010 isn't as strange as it seems. */ 2011 while (stat != 0) 2012 { 2013 if (stat < 0) 2014 { 2015 printf_filtered (_("It stopped at a breakpoint " 2016 "that has since been deleted.\n")); 2017 } 2018 else 2019 printf_filtered (_("It stopped at breakpoint %d.\n"), num); 2020 stat = bpstat_num (&bs, &num); 2021 } 2022 } 2023 else if (tp->suspend.stop_signal != GDB_SIGNAL_0) 2024 { 2025 printf_filtered (_("It stopped with signal %s, %s.\n"), 2026 gdb_signal_to_name (tp->suspend.stop_signal), 2027 gdb_signal_to_string (tp->suspend.stop_signal)); 2028 } 2029 2030 if (from_tty) 2031 { 2032 printf_filtered (_("Type \"info stack\" or \"info " 2033 "registers\" for more information.\n")); 2034 } 2035 } 2036 2037 static void 2038 environment_info (const char *var, int from_tty) 2039 { 2040 if (var) 2041 { 2042 const char *val = current_inferior ()->environment.get (var); 2043 2044 if (val) 2045 { 2046 puts_filtered (var); 2047 puts_filtered (" = "); 2048 puts_filtered (val); 2049 puts_filtered ("\n"); 2050 } 2051 else 2052 { 2053 puts_filtered ("Environment variable \""); 2054 puts_filtered (var); 2055 puts_filtered ("\" not defined.\n"); 2056 } 2057 } 2058 else 2059 { 2060 char **envp = current_inferior ()->environment.envp (); 2061 2062 for (int idx = 0; envp[idx] != NULL; ++idx) 2063 { 2064 puts_filtered (envp[idx]); 2065 puts_filtered ("\n"); 2066 } 2067 } 2068 } 2069 2070 static void 2071 set_environment_command (const char *arg, int from_tty) 2072 { 2073 const char *p, *val; 2074 int nullset = 0; 2075 2076 if (arg == 0) 2077 error_no_arg (_("environment variable and value")); 2078 2079 /* Find seperation between variable name and value. */ 2080 p = (char *) strchr (arg, '='); 2081 val = (char *) strchr (arg, ' '); 2082 2083 if (p != 0 && val != 0) 2084 { 2085 /* We have both a space and an equals. If the space is before the 2086 equals, walk forward over the spaces til we see a nonspace 2087 (possibly the equals). */ 2088 if (p > val) 2089 while (*val == ' ') 2090 val++; 2091 2092 /* Now if the = is after the char following the spaces, 2093 take the char following the spaces. */ 2094 if (p > val) 2095 p = val - 1; 2096 } 2097 else if (val != 0 && p == 0) 2098 p = val; 2099 2100 if (p == arg) 2101 error_no_arg (_("environment variable to set")); 2102 2103 if (p == 0 || p[1] == 0) 2104 { 2105 nullset = 1; 2106 if (p == 0) 2107 p = arg + strlen (arg); /* So that savestring below will work. */ 2108 } 2109 else 2110 { 2111 /* Not setting variable value to null. */ 2112 val = p + 1; 2113 while (*val == ' ' || *val == '\t') 2114 val++; 2115 } 2116 2117 while (p != arg && (p[-1] == ' ' || p[-1] == '\t')) 2118 p--; 2119 2120 std::string var (arg, p - arg); 2121 if (nullset) 2122 { 2123 printf_filtered (_("Setting environment variable " 2124 "\"%s\" to null value.\n"), 2125 var.c_str ()); 2126 current_inferior ()->environment.set (var.c_str (), ""); 2127 } 2128 else 2129 current_inferior ()->environment.set (var.c_str (), val); 2130 } 2131 2132 static void 2133 unset_environment_command (const char *var, int from_tty) 2134 { 2135 if (var == 0) 2136 { 2137 /* If there is no argument, delete all environment variables. 2138 Ask for confirmation if reading from the terminal. */ 2139 if (!from_tty || query (_("Delete all environment variables? "))) 2140 current_inferior ()->environment.clear (); 2141 } 2142 else 2143 current_inferior ()->environment.unset (var); 2144 } 2145 2146 /* Handle the execution path (PATH variable). */ 2147 2148 static const char path_var_name[] = "PATH"; 2149 2150 static void 2151 path_info (const char *args, int from_tty) 2152 { 2153 puts_filtered ("Executable and object file path: "); 2154 puts_filtered (current_inferior ()->environment.get (path_var_name)); 2155 puts_filtered ("\n"); 2156 } 2157 2158 /* Add zero or more directories to the front of the execution path. */ 2159 2160 static void 2161 path_command (const char *dirname, int from_tty) 2162 { 2163 char *exec_path; 2164 const char *env; 2165 2166 dont_repeat (); 2167 env = current_inferior ()->environment.get (path_var_name); 2168 /* Can be null if path is not set. */ 2169 if (!env) 2170 env = ""; 2171 exec_path = xstrdup (env); 2172 mod_path (dirname, &exec_path); 2173 current_inferior ()->environment.set (path_var_name, exec_path); 2174 xfree (exec_path); 2175 if (from_tty) 2176 path_info ((char *) NULL, from_tty); 2177 } 2178 2179 2180 static void 2181 pad_to_column (string_file &stream, int col) 2182 { 2183 /* At least one space must be printed to separate columns. */ 2184 stream.putc (' '); 2185 const int size = stream.size (); 2186 if (size < col) 2187 stream.puts (n_spaces (col - size)); 2188 } 2189 2190 /* Print out the register NAME with value VAL, to FILE, in the default 2191 fashion. */ 2192 2193 static void 2194 default_print_one_register_info (struct ui_file *file, 2195 const char *name, 2196 struct value *val) 2197 { 2198 struct type *regtype = value_type (val); 2199 int print_raw_format; 2200 string_file format_stream; 2201 enum tab_stops 2202 { 2203 value_column_1 = 15, 2204 /* Give enough room for "0x", 16 hex digits and two spaces in 2205 preceding column. */ 2206 value_column_2 = value_column_1 + 2 + 16 + 2, 2207 }; 2208 2209 format_stream.puts (name); 2210 pad_to_column (format_stream, value_column_1); 2211 2212 print_raw_format = (value_entirely_available (val) 2213 && !value_optimized_out (val)); 2214 2215 /* If virtual format is floating, print it that way, and in raw 2216 hex. */ 2217 if (TYPE_CODE (regtype) == TYPE_CODE_FLT 2218 || TYPE_CODE (regtype) == TYPE_CODE_DECFLOAT) 2219 { 2220 struct value_print_options opts; 2221 const gdb_byte *valaddr = value_contents_for_printing (val); 2222 enum bfd_endian byte_order = gdbarch_byte_order (get_type_arch (regtype)); 2223 2224 get_user_print_options (&opts); 2225 opts.deref_ref = 1; 2226 2227 val_print (regtype, 2228 value_embedded_offset (val), 0, 2229 &format_stream, 0, val, &opts, current_language); 2230 2231 if (print_raw_format) 2232 { 2233 pad_to_column (format_stream, value_column_2); 2234 format_stream.puts ("(raw "); 2235 print_hex_chars (&format_stream, valaddr, TYPE_LENGTH (regtype), 2236 byte_order, true); 2237 format_stream.putc (')'); 2238 } 2239 } 2240 else 2241 { 2242 struct value_print_options opts; 2243 2244 /* Print the register in hex. */ 2245 get_formatted_print_options (&opts, 'x'); 2246 opts.deref_ref = 1; 2247 val_print (regtype, 2248 value_embedded_offset (val), 0, 2249 &format_stream, 0, val, &opts, current_language); 2250 /* If not a vector register, print it also according to its 2251 natural format. */ 2252 if (print_raw_format && TYPE_VECTOR (regtype) == 0) 2253 { 2254 pad_to_column (format_stream, value_column_2); 2255 get_user_print_options (&opts); 2256 opts.deref_ref = 1; 2257 val_print (regtype, 2258 value_embedded_offset (val), 0, 2259 &format_stream, 0, val, &opts, current_language); 2260 } 2261 } 2262 2263 fputs_filtered (format_stream.c_str (), file); 2264 fprintf_filtered (file, "\n"); 2265 } 2266 2267 /* Print out the machine register regnum. If regnum is -1, print all 2268 registers (print_all == 1) or all non-float and non-vector 2269 registers (print_all == 0). 2270 2271 For most machines, having all_registers_info() print the 2272 register(s) one per line is good enough. If a different format is 2273 required, (eg, for MIPS or Pyramid 90x, which both have lots of 2274 regs), or there is an existing convention for showing all the 2275 registers, define the architecture method PRINT_REGISTERS_INFO to 2276 provide that format. */ 2277 2278 void 2279 default_print_registers_info (struct gdbarch *gdbarch, 2280 struct ui_file *file, 2281 struct frame_info *frame, 2282 int regnum, int print_all) 2283 { 2284 int i; 2285 const int numregs = gdbarch_num_cooked_regs (gdbarch); 2286 2287 for (i = 0; i < numregs; i++) 2288 { 2289 /* Decide between printing all regs, non-float / vector regs, or 2290 specific reg. */ 2291 if (regnum == -1) 2292 { 2293 if (print_all) 2294 { 2295 if (!gdbarch_register_reggroup_p (gdbarch, i, all_reggroup)) 2296 continue; 2297 } 2298 else 2299 { 2300 if (!gdbarch_register_reggroup_p (gdbarch, i, general_reggroup)) 2301 continue; 2302 } 2303 } 2304 else 2305 { 2306 if (i != regnum) 2307 continue; 2308 } 2309 2310 /* If the register name is empty, it is undefined for this 2311 processor, so don't display anything. */ 2312 if (gdbarch_register_name (gdbarch, i) == NULL 2313 || *(gdbarch_register_name (gdbarch, i)) == '\0') 2314 continue; 2315 2316 default_print_one_register_info (file, 2317 gdbarch_register_name (gdbarch, i), 2318 value_of_register (i, frame)); 2319 } 2320 } 2321 2322 void 2323 registers_info (const char *addr_exp, int fpregs) 2324 { 2325 struct frame_info *frame; 2326 struct gdbarch *gdbarch; 2327 2328 if (!target_has_registers) 2329 error (_("The program has no registers now.")); 2330 frame = get_selected_frame (NULL); 2331 gdbarch = get_frame_arch (frame); 2332 2333 if (!addr_exp) 2334 { 2335 gdbarch_print_registers_info (gdbarch, gdb_stdout, 2336 frame, -1, fpregs); 2337 return; 2338 } 2339 2340 while (*addr_exp != '\0') 2341 { 2342 const char *start; 2343 const char *end; 2344 2345 /* Skip leading white space. */ 2346 addr_exp = skip_spaces (addr_exp); 2347 2348 /* Discard any leading ``$''. Check that there is something 2349 resembling a register following it. */ 2350 if (addr_exp[0] == '$') 2351 addr_exp++; 2352 if (isspace ((*addr_exp)) || (*addr_exp) == '\0') 2353 error (_("Missing register name")); 2354 2355 /* Find the start/end of this register name/num/group. */ 2356 start = addr_exp; 2357 while ((*addr_exp) != '\0' && !isspace ((*addr_exp))) 2358 addr_exp++; 2359 end = addr_exp; 2360 2361 /* Figure out what we've found and display it. */ 2362 2363 /* A register name? */ 2364 { 2365 int regnum = user_reg_map_name_to_regnum (gdbarch, start, end - start); 2366 2367 if (regnum >= 0) 2368 { 2369 /* User registers lie completely outside of the range of 2370 normal registers. Catch them early so that the target 2371 never sees them. */ 2372 if (regnum >= gdbarch_num_cooked_regs (gdbarch)) 2373 { 2374 struct value *regval = value_of_user_reg (regnum, frame); 2375 const char *regname = user_reg_map_regnum_to_name (gdbarch, 2376 regnum); 2377 2378 /* Print in the same fashion 2379 gdbarch_print_registers_info's default 2380 implementation prints. */ 2381 default_print_one_register_info (gdb_stdout, 2382 regname, 2383 regval); 2384 } 2385 else 2386 gdbarch_print_registers_info (gdbarch, gdb_stdout, 2387 frame, regnum, fpregs); 2388 continue; 2389 } 2390 } 2391 2392 /* A register group? */ 2393 { 2394 struct reggroup *group; 2395 2396 for (group = reggroup_next (gdbarch, NULL); 2397 group != NULL; 2398 group = reggroup_next (gdbarch, group)) 2399 { 2400 /* Don't bother with a length check. Should the user 2401 enter a short register group name, go with the first 2402 group that matches. */ 2403 if (strncmp (start, reggroup_name (group), end - start) == 0) 2404 break; 2405 } 2406 if (group != NULL) 2407 { 2408 int regnum; 2409 2410 for (regnum = 0; 2411 regnum < gdbarch_num_cooked_regs (gdbarch); 2412 regnum++) 2413 { 2414 if (gdbarch_register_reggroup_p (gdbarch, regnum, group)) 2415 gdbarch_print_registers_info (gdbarch, 2416 gdb_stdout, frame, 2417 regnum, fpregs); 2418 } 2419 continue; 2420 } 2421 } 2422 2423 /* Nothing matched. */ 2424 error (_("Invalid register `%.*s'"), (int) (end - start), start); 2425 } 2426 } 2427 2428 static void 2429 info_all_registers_command (const char *addr_exp, int from_tty) 2430 { 2431 registers_info (addr_exp, 1); 2432 } 2433 2434 static void 2435 info_registers_command (const char *addr_exp, int from_tty) 2436 { 2437 registers_info (addr_exp, 0); 2438 } 2439 2440 static void 2441 print_vector_info (struct ui_file *file, 2442 struct frame_info *frame, const char *args) 2443 { 2444 struct gdbarch *gdbarch = get_frame_arch (frame); 2445 2446 if (gdbarch_print_vector_info_p (gdbarch)) 2447 gdbarch_print_vector_info (gdbarch, file, frame, args); 2448 else 2449 { 2450 int regnum; 2451 int printed_something = 0; 2452 2453 for (regnum = 0; regnum < gdbarch_num_cooked_regs (gdbarch); regnum++) 2454 { 2455 if (gdbarch_register_reggroup_p (gdbarch, regnum, vector_reggroup)) 2456 { 2457 printed_something = 1; 2458 gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1); 2459 } 2460 } 2461 if (!printed_something) 2462 fprintf_filtered (file, "No vector information\n"); 2463 } 2464 } 2465 2466 static void 2467 info_vector_command (const char *args, int from_tty) 2468 { 2469 if (!target_has_registers) 2470 error (_("The program has no registers now.")); 2471 2472 print_vector_info (gdb_stdout, get_selected_frame (NULL), args); 2473 } 2474 2475 /* Kill the inferior process. Make us have no inferior. */ 2476 2477 static void 2478 kill_command (const char *arg, int from_tty) 2479 { 2480 /* FIXME: This should not really be inferior_ptid (or target_has_execution). 2481 It should be a distinct flag that indicates that a target is active, cuz 2482 some targets don't have processes! */ 2483 2484 if (inferior_ptid == null_ptid) 2485 error (_("The program is not being run.")); 2486 if (!query (_("Kill the program being debugged? "))) 2487 error (_("Not confirmed.")); 2488 2489 int pid = current_inferior ()->pid; 2490 /* Save the pid as a string before killing the inferior, since that 2491 may unpush the current target, and we need the string after. */ 2492 std::string pid_str = target_pid_to_str (ptid_t (pid)); 2493 int infnum = current_inferior ()->num; 2494 2495 target_kill (); 2496 2497 if (print_inferior_events) 2498 printf_unfiltered (_("[Inferior %d (%s) killed]\n"), 2499 infnum, pid_str.c_str ()); 2500 2501 /* If we still have other inferiors to debug, then don't mess with 2502 with their threads. */ 2503 if (!have_inferiors ()) 2504 { 2505 init_thread_list (); /* Destroy thread info. */ 2506 2507 /* Killing off the inferior can leave us with a core file. If 2508 so, print the state we are left in. */ 2509 if (target_has_stack) 2510 { 2511 printf_filtered (_("In %s,\n"), target_longname); 2512 print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1); 2513 } 2514 } 2515 bfd_cache_close_all (); 2516 } 2517 2518 /* Used in `attach&' command. Proceed threads of inferior INF iff 2519 they stopped due to debugger request, and when they did, they 2520 reported a clean stop (GDB_SIGNAL_0). Do not proceed threads that 2521 have been explicitly been told to stop. */ 2522 2523 static void 2524 proceed_after_attach (inferior *inf) 2525 { 2526 /* Don't error out if the current thread is running, because 2527 there may be other stopped threads. */ 2528 2529 /* Backup current thread and selected frame. */ 2530 scoped_restore_current_thread restore_thread; 2531 2532 for (thread_info *thread : inf->non_exited_threads ()) 2533 if (!thread->executing 2534 && !thread->stop_requested 2535 && thread->suspend.stop_signal == GDB_SIGNAL_0) 2536 { 2537 switch_to_thread (thread); 2538 clear_proceed_status (0); 2539 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 2540 } 2541 } 2542 2543 /* See inferior.h. */ 2544 2545 void 2546 setup_inferior (int from_tty) 2547 { 2548 struct inferior *inferior; 2549 2550 inferior = current_inferior (); 2551 inferior->needs_setup = 0; 2552 2553 /* If no exec file is yet known, try to determine it from the 2554 process itself. */ 2555 if (get_exec_file (0) == NULL) 2556 exec_file_locate_attach (inferior_ptid.pid (), 1, from_tty); 2557 else 2558 { 2559 reopen_exec_file (); 2560 reread_symbols (); 2561 } 2562 2563 /* Take any necessary post-attaching actions for this platform. */ 2564 target_post_attach (inferior_ptid.pid ()); 2565 2566 post_create_inferior (current_top_target (), from_tty); 2567 } 2568 2569 /* What to do after the first program stops after attaching. */ 2570 enum attach_post_wait_mode 2571 { 2572 /* Do nothing. Leaves threads as they are. */ 2573 ATTACH_POST_WAIT_NOTHING, 2574 2575 /* Re-resume threads that are marked running. */ 2576 ATTACH_POST_WAIT_RESUME, 2577 2578 /* Stop all threads. */ 2579 ATTACH_POST_WAIT_STOP, 2580 }; 2581 2582 /* Called after we've attached to a process and we've seen it stop for 2583 the first time. If ASYNC_EXEC is true, re-resume threads that 2584 should be running. Else if ATTACH, */ 2585 2586 static void 2587 attach_post_wait (const char *args, int from_tty, enum attach_post_wait_mode mode) 2588 { 2589 struct inferior *inferior; 2590 2591 inferior = current_inferior (); 2592 inferior->control.stop_soon = NO_STOP_QUIETLY; 2593 2594 if (inferior->needs_setup) 2595 setup_inferior (from_tty); 2596 2597 if (mode == ATTACH_POST_WAIT_RESUME) 2598 { 2599 /* The user requested an `attach&', so be sure to leave threads 2600 that didn't get a signal running. */ 2601 2602 /* Immediatelly resume all suspended threads of this inferior, 2603 and this inferior only. This should have no effect on 2604 already running threads. If a thread has been stopped with a 2605 signal, leave it be. */ 2606 if (non_stop) 2607 proceed_after_attach (inferior); 2608 else 2609 { 2610 if (inferior_thread ()->suspend.stop_signal == GDB_SIGNAL_0) 2611 { 2612 clear_proceed_status (0); 2613 proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT); 2614 } 2615 } 2616 } 2617 else if (mode == ATTACH_POST_WAIT_STOP) 2618 { 2619 /* The user requested a plain `attach', so be sure to leave 2620 the inferior stopped. */ 2621 2622 /* At least the current thread is already stopped. */ 2623 2624 /* In all-stop, by definition, all threads have to be already 2625 stopped at this point. In non-stop, however, although the 2626 selected thread is stopped, others may still be executing. 2627 Be sure to explicitly stop all threads of the process. This 2628 should have no effect on already stopped threads. */ 2629 if (non_stop) 2630 target_stop (ptid_t (inferior->pid)); 2631 else if (target_is_non_stop_p ()) 2632 { 2633 struct thread_info *lowest = inferior_thread (); 2634 2635 stop_all_threads (); 2636 2637 /* It's not defined which thread will report the attach 2638 stop. For consistency, always select the thread with 2639 lowest GDB number, which should be the main thread, if it 2640 still exists. */ 2641 for (thread_info *thread : current_inferior ()->non_exited_threads ()) 2642 if (thread->inf->num < lowest->inf->num 2643 || thread->per_inf_num < lowest->per_inf_num) 2644 lowest = thread; 2645 2646 switch_to_thread (lowest); 2647 } 2648 2649 /* Tell the user/frontend where we're stopped. */ 2650 normal_stop (); 2651 if (deprecated_attach_hook) 2652 deprecated_attach_hook (); 2653 } 2654 } 2655 2656 struct attach_command_continuation_args 2657 { 2658 char *args; 2659 int from_tty; 2660 enum attach_post_wait_mode mode; 2661 }; 2662 2663 static void 2664 attach_command_continuation (void *args, int err) 2665 { 2666 struct attach_command_continuation_args *a 2667 = (struct attach_command_continuation_args *) args; 2668 2669 if (err) 2670 return; 2671 2672 attach_post_wait (a->args, a->from_tty, a->mode); 2673 } 2674 2675 static void 2676 attach_command_continuation_free_args (void *args) 2677 { 2678 struct attach_command_continuation_args *a 2679 = (struct attach_command_continuation_args *) args; 2680 2681 xfree (a->args); 2682 xfree (a); 2683 } 2684 2685 /* "attach" command entry point. Takes a program started up outside 2686 of gdb and ``attaches'' to it. This stops it cold in its tracks 2687 and allows us to start debugging it. */ 2688 2689 void 2690 attach_command (const char *args, int from_tty) 2691 { 2692 int async_exec; 2693 struct target_ops *attach_target; 2694 struct inferior *inferior = current_inferior (); 2695 enum attach_post_wait_mode mode; 2696 2697 dont_repeat (); /* Not for the faint of heart */ 2698 2699 if (gdbarch_has_global_solist (target_gdbarch ())) 2700 /* Don't complain if all processes share the same symbol 2701 space. */ 2702 ; 2703 else if (target_has_execution) 2704 { 2705 if (query (_("A program is being debugged already. Kill it? "))) 2706 target_kill (); 2707 else 2708 error (_("Not killed.")); 2709 } 2710 2711 /* Clean up any leftovers from other runs. Some other things from 2712 this function should probably be moved into target_pre_inferior. */ 2713 target_pre_inferior (from_tty); 2714 2715 gdb::unique_xmalloc_ptr<char> stripped = strip_bg_char (args, &async_exec); 2716 args = stripped.get (); 2717 2718 attach_target = find_attach_target (); 2719 2720 prepare_execution_command (attach_target, async_exec); 2721 2722 if (non_stop && !attach_target->supports_non_stop ()) 2723 error (_("Cannot attach to this target in non-stop mode")); 2724 2725 attach_target->attach (args, from_tty); 2726 /* to_attach should push the target, so after this point we 2727 shouldn't refer to attach_target again. */ 2728 attach_target = NULL; 2729 2730 /* Set up the "saved terminal modes" of the inferior 2731 based on what modes we are starting it with. */ 2732 target_terminal::init (); 2733 2734 /* Install inferior's terminal modes. This may look like a no-op, 2735 as we've just saved them above, however, this does more than 2736 restore terminal settings: 2737 2738 - installs a SIGINT handler that forwards SIGINT to the inferior. 2739 Otherwise a Ctrl-C pressed just while waiting for the initial 2740 stop would end up as a spurious Quit. 2741 2742 - removes stdin from the event loop, which we need if attaching 2743 in the foreground, otherwise on targets that report an initial 2744 stop on attach (which are most) we'd process input/commands 2745 while we're in the event loop waiting for that stop. That is, 2746 before the attach continuation runs and the command is really 2747 finished. */ 2748 target_terminal::inferior (); 2749 2750 /* Set up execution context to know that we should return from 2751 wait_for_inferior as soon as the target reports a stop. */ 2752 init_wait_for_inferior (); 2753 clear_proceed_status (0); 2754 2755 inferior->needs_setup = 1; 2756 2757 if (target_is_non_stop_p ()) 2758 { 2759 /* If we find that the current thread isn't stopped, explicitly 2760 do so now, because we're going to install breakpoints and 2761 poke at memory. */ 2762 2763 if (async_exec) 2764 /* The user requested an `attach&'; stop just one thread. */ 2765 target_stop (inferior_ptid); 2766 else 2767 /* The user requested an `attach', so stop all threads of this 2768 inferior. */ 2769 target_stop (ptid_t (inferior_ptid.pid ())); 2770 } 2771 2772 mode = async_exec ? ATTACH_POST_WAIT_RESUME : ATTACH_POST_WAIT_STOP; 2773 2774 /* Some system don't generate traps when attaching to inferior. 2775 E.g. Mach 3 or GNU hurd. */ 2776 if (!target_attach_no_wait ()) 2777 { 2778 struct attach_command_continuation_args *a; 2779 2780 /* Careful here. See comments in inferior.h. Basically some 2781 OSes don't ignore SIGSTOPs on continue requests anymore. We 2782 need a way for handle_inferior_event to reset the stop_signal 2783 variable after an attach, and this is what 2784 STOP_QUIETLY_NO_SIGSTOP is for. */ 2785 inferior->control.stop_soon = STOP_QUIETLY_NO_SIGSTOP; 2786 2787 /* Wait for stop. */ 2788 a = XNEW (struct attach_command_continuation_args); 2789 a->args = xstrdup (args); 2790 a->from_tty = from_tty; 2791 a->mode = mode; 2792 add_inferior_continuation (attach_command_continuation, a, 2793 attach_command_continuation_free_args); 2794 2795 if (!target_is_async_p ()) 2796 mark_infrun_async_event_handler (); 2797 return; 2798 } 2799 2800 attach_post_wait (args, from_tty, mode); 2801 } 2802 2803 /* We had just found out that the target was already attached to an 2804 inferior. PTID points at a thread of this new inferior, that is 2805 the most likely to be stopped right now, but not necessarily so. 2806 The new inferior is assumed to be already added to the inferior 2807 list at this point. If LEAVE_RUNNING, then leave the threads of 2808 this inferior running, except those we've explicitly seen reported 2809 as stopped. */ 2810 2811 void 2812 notice_new_inferior (thread_info *thr, int leave_running, int from_tty) 2813 { 2814 enum attach_post_wait_mode mode 2815 = leave_running ? ATTACH_POST_WAIT_RESUME : ATTACH_POST_WAIT_NOTHING; 2816 2817 gdb::optional<scoped_restore_current_thread> restore_thread; 2818 2819 if (inferior_ptid != null_ptid) 2820 restore_thread.emplace (); 2821 2822 /* Avoid reading registers -- we haven't fetched the target 2823 description yet. */ 2824 switch_to_thread_no_regs (thr); 2825 2826 /* When we "notice" a new inferior we need to do all the things we 2827 would normally do if we had just attached to it. */ 2828 2829 if (thr->executing) 2830 { 2831 struct attach_command_continuation_args *a; 2832 struct inferior *inferior = current_inferior (); 2833 2834 /* We're going to install breakpoints, and poke at memory, 2835 ensure that the inferior is stopped for a moment while we do 2836 that. */ 2837 target_stop (inferior_ptid); 2838 2839 inferior->control.stop_soon = STOP_QUIETLY_REMOTE; 2840 2841 /* Wait for stop before proceeding. */ 2842 a = XNEW (struct attach_command_continuation_args); 2843 a->args = xstrdup (""); 2844 a->from_tty = from_tty; 2845 a->mode = mode; 2846 add_inferior_continuation (attach_command_continuation, a, 2847 attach_command_continuation_free_args); 2848 2849 return; 2850 } 2851 2852 attach_post_wait ("" /* args */, from_tty, mode); 2853 } 2854 2855 /* 2856 * detach_command -- 2857 * takes a program previously attached to and detaches it. 2858 * The program resumes execution and will no longer stop 2859 * on signals, etc. We better not have left any breakpoints 2860 * in the program or it'll die when it hits one. For this 2861 * to work, it may be necessary for the process to have been 2862 * previously attached. It *might* work if the program was 2863 * started via the normal ptrace (PTRACE_TRACEME). 2864 */ 2865 2866 void 2867 detach_command (const char *args, int from_tty) 2868 { 2869 dont_repeat (); /* Not for the faint of heart. */ 2870 2871 if (inferior_ptid == null_ptid) 2872 error (_("The program is not being run.")); 2873 2874 query_if_trace_running (from_tty); 2875 2876 disconnect_tracing (); 2877 2878 target_detach (current_inferior (), from_tty); 2879 2880 /* The current inferior process was just detached successfully. Get 2881 rid of breakpoints that no longer make sense. Note we don't do 2882 this within target_detach because that is also used when 2883 following child forks, and in that case we will want to transfer 2884 breakpoints to the child, not delete them. */ 2885 breakpoint_init_inferior (inf_exited); 2886 2887 /* If the solist is global across inferiors, don't clear it when we 2888 detach from a single inferior. */ 2889 if (!gdbarch_has_global_solist (target_gdbarch ())) 2890 no_shared_libraries (NULL, from_tty); 2891 2892 if (deprecated_detach_hook) 2893 deprecated_detach_hook (); 2894 } 2895 2896 /* Disconnect from the current target without resuming it (leaving it 2897 waiting for a debugger). 2898 2899 We'd better not have left any breakpoints in the program or the 2900 next debugger will get confused. Currently only supported for some 2901 remote targets, since the normal attach mechanisms don't work on 2902 stopped processes on some native platforms (e.g. GNU/Linux). */ 2903 2904 static void 2905 disconnect_command (const char *args, int from_tty) 2906 { 2907 dont_repeat (); /* Not for the faint of heart. */ 2908 query_if_trace_running (from_tty); 2909 disconnect_tracing (); 2910 target_disconnect (args, from_tty); 2911 no_shared_libraries (NULL, from_tty); 2912 init_thread_list (); 2913 if (deprecated_detach_hook) 2914 deprecated_detach_hook (); 2915 } 2916 2917 void 2918 interrupt_target_1 (int all_threads) 2919 { 2920 ptid_t ptid; 2921 2922 if (all_threads) 2923 ptid = minus_one_ptid; 2924 else 2925 ptid = inferior_ptid; 2926 2927 if (non_stop) 2928 target_stop (ptid); 2929 else 2930 target_interrupt (); 2931 2932 /* Tag the thread as having been explicitly requested to stop, so 2933 other parts of gdb know not to resume this thread automatically, 2934 if it was stopped due to an internal event. Limit this to 2935 non-stop mode, as when debugging a multi-threaded application in 2936 all-stop mode, we will only get one stop event --- it's undefined 2937 which thread will report the event. */ 2938 if (non_stop) 2939 set_stop_requested (ptid, 1); 2940 } 2941 2942 /* interrupt [-a] 2943 Stop the execution of the target while running in async mode, in 2944 the background. In all-stop, stop the whole process. In non-stop 2945 mode, stop the current thread only by default, or stop all threads 2946 if the `-a' switch is used. */ 2947 2948 static void 2949 interrupt_command (const char *args, int from_tty) 2950 { 2951 if (target_can_async_p ()) 2952 { 2953 int all_threads = 0; 2954 2955 dont_repeat (); /* Not for the faint of heart. */ 2956 2957 if (args != NULL 2958 && startswith (args, "-a")) 2959 all_threads = 1; 2960 2961 if (!non_stop && all_threads) 2962 error (_("-a is meaningless in all-stop mode.")); 2963 2964 interrupt_target_1 (all_threads); 2965 } 2966 } 2967 2968 /* See inferior.h. */ 2969 2970 void 2971 default_print_float_info (struct gdbarch *gdbarch, struct ui_file *file, 2972 struct frame_info *frame, const char *args) 2973 { 2974 int regnum; 2975 int printed_something = 0; 2976 2977 for (regnum = 0; regnum < gdbarch_num_cooked_regs (gdbarch); regnum++) 2978 { 2979 if (gdbarch_register_reggroup_p (gdbarch, regnum, float_reggroup)) 2980 { 2981 printed_something = 1; 2982 gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1); 2983 } 2984 } 2985 if (!printed_something) 2986 fprintf_filtered (file, "No floating-point info " 2987 "available for this processor.\n"); 2988 } 2989 2990 static void 2991 info_float_command (const char *args, int from_tty) 2992 { 2993 struct frame_info *frame; 2994 2995 if (!target_has_registers) 2996 error (_("The program has no registers now.")); 2997 2998 frame = get_selected_frame (NULL); 2999 gdbarch_print_float_info (get_frame_arch (frame), gdb_stdout, frame, args); 3000 } 3001 3002 static void 3003 unset_command (const char *args, int from_tty) 3004 { 3005 printf_filtered (_("\"unset\" must be followed by the " 3006 "name of an unset subcommand.\n")); 3007 help_list (unsetlist, "unset ", all_commands, gdb_stdout); 3008 } 3009 3010 /* Implement `info proc' family of commands. */ 3011 3012 static void 3013 info_proc_cmd_1 (const char *args, enum info_proc_what what, int from_tty) 3014 { 3015 struct gdbarch *gdbarch = get_current_arch (); 3016 3017 if (!target_info_proc (args, what)) 3018 { 3019 if (gdbarch_info_proc_p (gdbarch)) 3020 gdbarch_info_proc (gdbarch, args, what); 3021 else 3022 error (_("Not supported on this target.")); 3023 } 3024 } 3025 3026 /* Implement `info proc' when given without any futher parameters. */ 3027 3028 static void 3029 info_proc_cmd (const char *args, int from_tty) 3030 { 3031 info_proc_cmd_1 (args, IP_MINIMAL, from_tty); 3032 } 3033 3034 /* Implement `info proc mappings'. */ 3035 3036 static void 3037 info_proc_cmd_mappings (const char *args, int from_tty) 3038 { 3039 info_proc_cmd_1 (args, IP_MAPPINGS, from_tty); 3040 } 3041 3042 /* Implement `info proc stat'. */ 3043 3044 static void 3045 info_proc_cmd_stat (const char *args, int from_tty) 3046 { 3047 info_proc_cmd_1 (args, IP_STAT, from_tty); 3048 } 3049 3050 /* Implement `info proc status'. */ 3051 3052 static void 3053 info_proc_cmd_status (const char *args, int from_tty) 3054 { 3055 info_proc_cmd_1 (args, IP_STATUS, from_tty); 3056 } 3057 3058 /* Implement `info proc cwd'. */ 3059 3060 static void 3061 info_proc_cmd_cwd (const char *args, int from_tty) 3062 { 3063 info_proc_cmd_1 (args, IP_CWD, from_tty); 3064 } 3065 3066 /* Implement `info proc cmdline'. */ 3067 3068 static void 3069 info_proc_cmd_cmdline (const char *args, int from_tty) 3070 { 3071 info_proc_cmd_1 (args, IP_CMDLINE, from_tty); 3072 } 3073 3074 /* Implement `info proc exe'. */ 3075 3076 static void 3077 info_proc_cmd_exe (const char *args, int from_tty) 3078 { 3079 info_proc_cmd_1 (args, IP_EXE, from_tty); 3080 } 3081 3082 /* Implement `info proc files'. */ 3083 3084 static void 3085 info_proc_cmd_files (const char *args, int from_tty) 3086 { 3087 info_proc_cmd_1 (args, IP_FILES, from_tty); 3088 } 3089 3090 /* Implement `info proc all'. */ 3091 3092 static void 3093 info_proc_cmd_all (const char *args, int from_tty) 3094 { 3095 info_proc_cmd_1 (args, IP_ALL, from_tty); 3096 } 3097 3098 /* This help string is used for the run, start, and starti commands. 3099 It is defined as a macro to prevent duplication. */ 3100 3101 #define RUN_ARGS_HELP \ 3102 "You may specify arguments to give it.\n\ 3103 Args may include \"*\", or \"[...]\"; they are expanded using the\n\ 3104 shell that will start the program (specified by the \"$SHELL\" environment\n\ 3105 variable). Input and output redirection with \">\", \"<\", or \">>\"\n\ 3106 are also allowed.\n\ 3107 \n\ 3108 With no arguments, uses arguments last specified (with \"run\" or \n\ 3109 \"set args\"). To cancel previous arguments and run with no arguments,\n\ 3110 use \"set args\" without arguments.\n\ 3111 \n\ 3112 To start the inferior without using a shell, use \"set startup-with-shell off\"." 3113 3114 void 3115 _initialize_infcmd (void) 3116 { 3117 static struct cmd_list_element *info_proc_cmdlist; 3118 struct cmd_list_element *c = NULL; 3119 const char *cmd_name; 3120 3121 /* Add the filename of the terminal connected to inferior I/O. */ 3122 add_setshow_optional_filename_cmd ("inferior-tty", class_run, 3123 &inferior_io_terminal_scratch, _("\ 3124 Set terminal for future runs of program being debugged."), _("\ 3125 Show terminal for future runs of program being debugged."), _("\ 3126 Usage: set inferior-tty [TTY]\n\n\ 3127 If TTY is omitted, the default behavior of using the same terminal as GDB\n\ 3128 is restored."), 3129 set_inferior_tty_command, 3130 show_inferior_tty_command, 3131 &setlist, &showlist); 3132 cmd_name = "inferior-tty"; 3133 c = lookup_cmd (&cmd_name, setlist, "", -1, 1); 3134 gdb_assert (c != NULL); 3135 add_alias_cmd ("tty", c, class_alias, 0, &cmdlist); 3136 3137 cmd_name = "args"; 3138 add_setshow_string_noescape_cmd (cmd_name, class_run, 3139 &inferior_args_scratch, _("\ 3140 Set argument list to give program being debugged when it is started."), _("\ 3141 Show argument list to give program being debugged when it is started."), _("\ 3142 Follow this command with any number of args, to be passed to the program."), 3143 set_args_command, 3144 show_args_command, 3145 &setlist, &showlist); 3146 c = lookup_cmd (&cmd_name, setlist, "", -1, 1); 3147 gdb_assert (c != NULL); 3148 set_cmd_completer (c, filename_completer); 3149 3150 cmd_name = "cwd"; 3151 add_setshow_string_noescape_cmd (cmd_name, class_run, 3152 &inferior_cwd_scratch, _("\ 3153 Set the current working directory to be used when the inferior is started.\n\ 3154 Changing this setting does not have any effect on inferiors that are\n\ 3155 already running."), 3156 _("\ 3157 Show the current working directory that is used when the inferior is started."), 3158 _("\ 3159 Use this command to change the current working directory that will be used\n\ 3160 when the inferior is started. This setting does not affect GDB's current\n\ 3161 working directory."), 3162 set_cwd_command, 3163 show_cwd_command, 3164 &setlist, &showlist); 3165 c = lookup_cmd (&cmd_name, setlist, "", -1, 1); 3166 gdb_assert (c != NULL); 3167 set_cmd_completer (c, filename_completer); 3168 3169 c = add_cmd ("environment", no_class, environment_info, _("\ 3170 The environment to give the program, or one variable's value.\n\ 3171 With an argument VAR, prints the value of environment variable VAR to\n\ 3172 give the program being debugged. With no arguments, prints the entire\n\ 3173 environment to be given to the program."), &showlist); 3174 set_cmd_completer (c, noop_completer); 3175 3176 add_prefix_cmd ("unset", no_class, unset_command, 3177 _("Complement to certain \"set\" commands."), 3178 &unsetlist, "unset ", 0, &cmdlist); 3179 3180 c = add_cmd ("environment", class_run, unset_environment_command, _("\ 3181 Cancel environment variable VAR for the program.\n\ 3182 This does not affect the program until the next \"run\" command."), 3183 &unsetlist); 3184 set_cmd_completer (c, noop_completer); 3185 3186 c = add_cmd ("environment", class_run, set_environment_command, _("\ 3187 Set environment variable value to give the program.\n\ 3188 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\ 3189 VALUES of environment variables are uninterpreted strings.\n\ 3190 This does not affect the program until the next \"run\" command."), 3191 &setlist); 3192 set_cmd_completer (c, noop_completer); 3193 3194 c = add_com ("path", class_files, path_command, _("\ 3195 Add directory DIR(s) to beginning of search path for object files.\n\ 3196 $cwd in the path means the current working directory.\n\ 3197 This path is equivalent to the $PATH shell variable. It is a list of\n\ 3198 directories, separated by colons. These directories are searched to find\n\ 3199 fully linked executable files and separately compiled object files as \ 3200 needed.")); 3201 set_cmd_completer (c, filename_completer); 3202 3203 c = add_cmd ("paths", no_class, path_info, _("\ 3204 Current search path for finding object files.\n\ 3205 $cwd in the path means the current working directory.\n\ 3206 This path is equivalent to the $PATH shell variable. It is a list of\n\ 3207 directories, separated by colons. These directories are searched to find\n\ 3208 fully linked executable files and separately compiled object files as \ 3209 needed."), 3210 &showlist); 3211 set_cmd_completer (c, noop_completer); 3212 3213 add_prefix_cmd ("kill", class_run, kill_command, 3214 _("Kill execution of program being debugged."), 3215 &killlist, "kill ", 0, &cmdlist); 3216 3217 add_com ("attach", class_run, attach_command, _("\ 3218 Attach to a process or file outside of GDB.\n\ 3219 This command attaches to another target, of the same type as your last\n\ 3220 \"target\" command (\"info files\" will show your target stack).\n\ 3221 The command may take as argument a process id or a device file.\n\ 3222 For a process id, you must have permission to send the process a signal,\n\ 3223 and it must have the same effective uid as the debugger.\n\ 3224 When using \"attach\" with a process id, the debugger finds the\n\ 3225 program running in the process, looking first in the current working\n\ 3226 directory, or (if not found there) using the source file search path\n\ 3227 (see the \"directory\" command). You can also use the \"file\" command\n\ 3228 to specify the program, and to load its symbol table.")); 3229 3230 add_prefix_cmd ("detach", class_run, detach_command, _("\ 3231 Detach a process or file previously attached.\n\ 3232 If a process, it is no longer traced, and it continues its execution. If\n\ 3233 you were debugging a file, the file is closed and gdb no longer accesses it."), 3234 &detachlist, "detach ", 0, &cmdlist); 3235 3236 add_com ("disconnect", class_run, disconnect_command, _("\ 3237 Disconnect from a target.\n\ 3238 The target will wait for another debugger to connect. Not available for\n\ 3239 all targets.")); 3240 3241 c = add_com ("signal", class_run, signal_command, _("\ 3242 Continue program with the specified signal.\n\ 3243 Usage: signal SIGNAL\n\ 3244 The SIGNAL argument is processed the same as the handle command.\n\ 3245 \n\ 3246 An argument of \"0\" means continue the program without sending it a signal.\n\ 3247 This is useful in cases where the program stopped because of a signal,\n\ 3248 and you want to resume the program while discarding the signal.\n\ 3249 \n\ 3250 In a multi-threaded program the signal is delivered to, or discarded from,\n\ 3251 the current thread only.")); 3252 set_cmd_completer (c, signal_completer); 3253 3254 c = add_com ("queue-signal", class_run, queue_signal_command, _("\ 3255 Queue a signal to be delivered to the current thread when it is resumed.\n\ 3256 Usage: queue-signal SIGNAL\n\ 3257 The SIGNAL argument is processed the same as the handle command.\n\ 3258 It is an error if the handling state of SIGNAL is \"nopass\".\n\ 3259 \n\ 3260 An argument of \"0\" means remove any currently queued signal from\n\ 3261 the current thread. This is useful in cases where the program stopped\n\ 3262 because of a signal, and you want to resume it while discarding the signal.\n\ 3263 \n\ 3264 In a multi-threaded program the signal is queued with, or discarded from,\n\ 3265 the current thread only.")); 3266 set_cmd_completer (c, signal_completer); 3267 3268 add_com ("stepi", class_run, stepi_command, _("\ 3269 Step one instruction exactly.\n\ 3270 Usage: stepi [N]\n\ 3271 Argument N means step N times (or till program stops for another \ 3272 reason).")); 3273 add_com_alias ("si", "stepi", class_alias, 0); 3274 3275 add_com ("nexti", class_run, nexti_command, _("\ 3276 Step one instruction, but proceed through subroutine calls.\n\ 3277 Usage: nexti [N]\n\ 3278 Argument N means step N times (or till program stops for another \ 3279 reason).")); 3280 add_com_alias ("ni", "nexti", class_alias, 0); 3281 3282 add_com ("finish", class_run, finish_command, _("\ 3283 Execute until selected stack frame returns.\n\ 3284 Usage: finish\n\ 3285 Upon return, the value returned is printed and put in the value history.")); 3286 add_com_alias ("fin", "finish", class_run, 1); 3287 3288 add_com ("next", class_run, next_command, _("\ 3289 Step program, proceeding through subroutine calls.\n\ 3290 Usage: next [N]\n\ 3291 Unlike \"step\", if the current source line calls a subroutine,\n\ 3292 this command does not enter the subroutine, but instead steps over\n\ 3293 the call, in effect treating it as a single source line.")); 3294 add_com_alias ("n", "next", class_run, 1); 3295 3296 add_com ("step", class_run, step_command, _("\ 3297 Step program until it reaches a different source line.\n\ 3298 Usage: step [N]\n\ 3299 Argument N means step N times (or till program stops for another \ 3300 reason).")); 3301 add_com_alias ("s", "step", class_run, 1); 3302 3303 c = add_com ("until", class_run, until_command, _("\ 3304 Execute until the program reaches a source line greater than the current\n\ 3305 or a specified location (same args as break command) within the current \ 3306 frame.")); 3307 set_cmd_completer (c, location_completer); 3308 add_com_alias ("u", "until", class_run, 1); 3309 3310 c = add_com ("advance", class_run, advance_command, _("\ 3311 Continue the program up to the given location (same form as args for break \ 3312 command).\n\ 3313 Execution will also stop upon exit from the current stack frame.")); 3314 set_cmd_completer (c, location_completer); 3315 3316 c = add_com ("jump", class_run, jump_command, _("\ 3317 Continue program being debugged at specified line or address.\n\ 3318 Usage: jump LOCATION\n\ 3319 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\ 3320 for an address to start at.")); 3321 set_cmd_completer (c, location_completer); 3322 add_com_alias ("j", "jump", class_run, 1); 3323 3324 add_com ("continue", class_run, continue_command, _("\ 3325 Continue program being debugged, after signal or breakpoint.\n\ 3326 Usage: continue [N]\n\ 3327 If proceeding from breakpoint, a number N may be used as an argument,\n\ 3328 which means to set the ignore count of that breakpoint to N - 1 (so that\n\ 3329 the breakpoint won't break until the Nth time it is reached).\n\ 3330 \n\ 3331 If non-stop mode is enabled, continue only the current thread,\n\ 3332 otherwise all the threads in the program are continued. To \n\ 3333 continue all stopped threads in non-stop mode, use the -a option.\n\ 3334 Specifying -a and an ignore count simultaneously is an error.")); 3335 add_com_alias ("c", "cont", class_run, 1); 3336 add_com_alias ("fg", "cont", class_run, 1); 3337 3338 c = add_com ("run", class_run, run_command, _("\ 3339 Start debugged program.\n" 3340 RUN_ARGS_HELP)); 3341 set_cmd_completer (c, filename_completer); 3342 add_com_alias ("r", "run", class_run, 1); 3343 3344 c = add_com ("start", class_run, start_command, _("\ 3345 Start the debugged program stopping at the beginning of the main procedure.\n" 3346 RUN_ARGS_HELP)); 3347 set_cmd_completer (c, filename_completer); 3348 3349 c = add_com ("starti", class_run, starti_command, _("\ 3350 Start the debugged program stopping at the first instruction.\n" 3351 RUN_ARGS_HELP)); 3352 set_cmd_completer (c, filename_completer); 3353 3354 add_com ("interrupt", class_run, interrupt_command, 3355 _("Interrupt the execution of the debugged program.\n\ 3356 If non-stop mode is enabled, interrupt only the current thread,\n\ 3357 otherwise all the threads in the program are stopped. To \n\ 3358 interrupt all running threads in non-stop mode, use the -a option.")); 3359 3360 c = add_info ("registers", info_registers_command, _("\ 3361 List of integer registers and their contents, for selected stack frame.\n\ 3362 One or more register names as argument means describe the given registers.\n\ 3363 One or more register group names as argument means describe the registers\n\ 3364 in the named register groups.")); 3365 add_info_alias ("r", "registers", 1); 3366 set_cmd_completer (c, reg_or_group_completer); 3367 3368 c = add_info ("all-registers", info_all_registers_command, _("\ 3369 List of all registers and their contents, for selected stack frame.\n\ 3370 One or more register names as argument means describe the given registers.\n\ 3371 One or more register group names as argument means describe the registers\n\ 3372 in the named register groups.")); 3373 set_cmd_completer (c, reg_or_group_completer); 3374 3375 add_info ("program", info_program_command, 3376 _("Execution status of the program.")); 3377 3378 add_info ("float", info_float_command, 3379 _("Print the status of the floating point unit\n")); 3380 3381 add_info ("vector", info_vector_command, 3382 _("Print the status of the vector unit\n")); 3383 3384 add_prefix_cmd ("proc", class_info, info_proc_cmd, 3385 _("\ 3386 Show additional information about a process.\n\ 3387 Specify any process id, or use the program being debugged by default."), 3388 &info_proc_cmdlist, "info proc ", 3389 1/*allow-unknown*/, &infolist); 3390 3391 add_cmd ("mappings", class_info, info_proc_cmd_mappings, _("\ 3392 List memory regions mapped by the specified process."), 3393 &info_proc_cmdlist); 3394 3395 add_cmd ("stat", class_info, info_proc_cmd_stat, _("\ 3396 List process info from /proc/PID/stat."), 3397 &info_proc_cmdlist); 3398 3399 add_cmd ("status", class_info, info_proc_cmd_status, _("\ 3400 List process info from /proc/PID/status."), 3401 &info_proc_cmdlist); 3402 3403 add_cmd ("cwd", class_info, info_proc_cmd_cwd, _("\ 3404 List current working directory of the specified process."), 3405 &info_proc_cmdlist); 3406 3407 add_cmd ("cmdline", class_info, info_proc_cmd_cmdline, _("\ 3408 List command line arguments of the specified process."), 3409 &info_proc_cmdlist); 3410 3411 add_cmd ("exe", class_info, info_proc_cmd_exe, _("\ 3412 List absolute filename for executable of the specified process."), 3413 &info_proc_cmdlist); 3414 3415 add_cmd ("files", class_info, info_proc_cmd_files, _("\ 3416 List files opened by the specified process."), 3417 &info_proc_cmdlist); 3418 3419 add_cmd ("all", class_info, info_proc_cmd_all, _("\ 3420 List all available info about the specified process."), 3421 &info_proc_cmdlist); 3422 } 3423