1 /* Memory-access and commands for "inferior" process, for GDB.
3 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
5 2008 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 #include "gdb_string.h"
38 #include "completer.h"
40 #include "event-top.h"
41 #include "parser-defs.h"
43 #include "reggroups.h"
47 #include "gdb_assert.h"
49 #include "target-descriptions.h"
50 #include "user-regs.h"
51 #include "exceptions.h"
52 #include "cli/cli-decode.h"
53 #include "gdbthread.h"
55 /* Functions exported for general use, in inferior.h: */
57 void all_registers_info (char *, int);
59 void registers_info (char *, int);
61 void nexti_command (char *, int);
63 void stepi_command (char *, int);
65 void continue_command (char *, int);
67 void interrupt_target_command (char *args
, int from_tty
);
69 /* Local functions: */
71 static void nofp_registers_info (char *, int);
73 static void print_return_value (struct type
*func_type
,
74 struct type
*value_type
);
76 static void until_next_command (int);
78 static void until_command (char *, int);
80 static void path_info (char *, int);
82 static void path_command (char *, int);
84 static void unset_command (char *, int);
86 static void float_info (char *, int);
88 static void detach_command (char *, int);
90 static void disconnect_command (char *, int);
92 static void unset_environment_command (char *, int);
94 static void set_environment_command (char *, int);
96 static void environment_info (char *, int);
98 static void program_info (char *, int);
100 static void finish_command (char *, int);
102 static void signal_command (char *, int);
104 static void jump_command (char *, int);
106 static void step_1 (int, int, char *);
107 static void step_once (int skip_subroutines
, int single_inst
, int count
, int thread
);
109 static void next_command (char *, int);
111 static void step_command (char *, int);
113 static void run_command (char *, int);
115 static void run_no_args_command (char *args
, int from_tty
);
117 static void go_command (char *line_no
, int from_tty
);
119 static int strip_bg_char (char **);
121 void _initialize_infcmd (void);
123 #define GO_USAGE "Usage: go <location>\n"
125 #define ERROR_NO_INFERIOR \
126 if (!target_has_execution) error (_("The program is not being run."));
128 /* String containing arguments to give to the program, separated by spaces.
129 Empty string (pointer to '\0') means no args. */
131 static char *inferior_args
;
133 /* The inferior arguments as a vector. If INFERIOR_ARGC is nonzero,
134 then we must compute INFERIOR_ARGS from this (via the target). */
136 static int inferior_argc
;
137 static char **inferior_argv
;
139 /* File name for default use for standard in/out in the inferior. */
141 static char *inferior_io_terminal
;
143 /* Pid of our debugged inferior, or 0 if no inferior now.
144 Since various parts of infrun.c test this to see whether there is a program
145 being debugged it should be nonzero (currently 3 is used) for remote
148 ptid_t inferior_ptid
;
150 /* Last signal that the inferior received (why it stopped). */
152 enum target_signal stop_signal
;
154 /* Address at which inferior stopped. */
158 /* Flag indicating that a command has proceeded the inferior past the
159 current breakpoint. */
161 int breakpoint_proceeded
;
163 /* Nonzero if stopped due to a step command. */
167 /* Nonzero if stopped due to completion of a stack dummy routine. */
169 int stop_stack_dummy
;
171 /* Nonzero if stopped due to a random (unexpected) signal in inferior
174 int stopped_by_random_signal
;
176 /* If stepping, nonzero means step count is > 1
177 so don't print frame next time inferior stops
178 if it stops due to stepping. */
182 /* Environment to use for running inferior,
183 in format described in environ.h. */
185 struct gdb_environ
*inferior_environ
;
187 /* When set, no calls to target_resumed observer will be made. */
188 int suppress_resume_observer
= 0;
189 /* When set, normal_stop will not call the normal_stop observer. */
190 int suppress_stop_observer
= 0;
192 /* Accessor routines. */
195 set_inferior_io_terminal (const char *terminal_name
)
197 if (inferior_io_terminal
)
198 xfree (inferior_io_terminal
);
201 inferior_io_terminal
= NULL
;
203 inferior_io_terminal
= savestring (terminal_name
, strlen (terminal_name
));
207 get_inferior_io_terminal (void)
209 return inferior_io_terminal
;
213 get_inferior_args (void)
215 if (inferior_argc
!= 0)
219 n
= gdbarch_construct_inferior_arguments (current_gdbarch
,
220 inferior_argc
, inferior_argv
);
221 old
= set_inferior_args (n
);
225 if (inferior_args
== NULL
)
226 inferior_args
= xstrdup ("");
228 return inferior_args
;
232 set_inferior_args (char *newargs
)
234 char *saved_args
= inferior_args
;
236 inferior_args
= newargs
;
244 set_inferior_args_vector (int argc
, char **argv
)
246 inferior_argc
= argc
;
247 inferior_argv
= argv
;
250 /* Notice when `set args' is run. */
252 notice_args_set (char *args
, int from_tty
, struct cmd_list_element
*c
)
258 /* Notice when `show args' is run. */
260 notice_args_read (struct ui_file
*file
, int from_tty
,
261 struct cmd_list_element
*c
, const char *value
)
263 /* Note that we ignore the passed-in value in favor of computing it
265 deprecated_show_value_hack (file
, from_tty
, c
, get_inferior_args ());
269 /* Compute command-line string given argument vector. This does the
270 same shell processing as fork_inferior. */
272 construct_inferior_arguments (struct gdbarch
*gdbarch
, int argc
, char **argv
)
276 if (STARTUP_WITH_SHELL
)
278 /* This holds all the characters considered special to the
279 typical Unix shells. We include `^' because the SunOS
280 /bin/sh treats it as a synonym for `|'. */
281 char *special
= "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
286 /* We over-compute the size. It shouldn't matter. */
287 for (i
= 0; i
< argc
; ++i
)
288 length
+= 2 * strlen (argv
[i
]) + 1 + 2 * (argv
[i
][0] == '\0');
290 result
= (char *) xmalloc (length
);
293 for (i
= 0; i
< argc
; ++i
)
298 /* Need to handle empty arguments specially. */
299 if (argv
[i
][0] == '\0')
306 for (cp
= argv
[i
]; *cp
; ++cp
)
308 if (strchr (special
, *cp
) != NULL
)
318 /* In this case we can't handle arguments that contain spaces,
319 tabs, or newlines -- see breakup_args(). */
323 for (i
= 0; i
< argc
; ++i
)
325 char *cp
= strchr (argv
[i
], ' ');
327 cp
= strchr (argv
[i
], '\t');
329 cp
= strchr (argv
[i
], '\n');
331 error (_("can't handle command-line argument containing whitespace"));
332 length
+= strlen (argv
[i
]) + 1;
335 result
= (char *) xmalloc (length
);
337 for (i
= 0; i
< argc
; ++i
)
340 strcat (result
, " ");
341 strcat (result
, argv
[i
]);
349 /* This function detects whether or not a '&' character (indicating
350 background execution) has been added as *the last* of the arguments ARGS
351 of a command. If it has, it removes it and returns 1. Otherwise it
352 does nothing and returns 0. */
354 strip_bg_char (char **args
)
358 p
= strchr (*args
, '&');
362 if (p
== (*args
+ strlen (*args
) - 1))
364 if (strlen (*args
) > 1)
368 while (*p
== ' ' || *p
== '\t');
380 tty_command (char *file
, int from_tty
)
383 error_no_arg (_("terminal name for running target process"));
385 set_inferior_io_terminal (file
);
388 /* Common actions to take after creating any sort of inferior, by any
389 means (running, attaching, connecting, et cetera). The target
390 should be stopped. */
393 post_create_inferior (struct target_ops
*target
, int from_tty
)
395 /* Be sure we own the terminal in case write operations are performed. */
396 target_terminal_ours ();
398 /* If the target hasn't taken care of this already, do it now.
399 Targets which need to access registers during to_open,
400 to_create_inferior, or to_attach should do it earlier; but many
402 target_find_description ();
406 /* Sometimes the platform-specific hook loads initial shared
407 libraries, and sometimes it doesn't. Try to do so first, so
408 that we can add them with the correct value for FROM_TTY.
409 If we made all the inferior hook methods consistent,
410 this call could be removed. */
412 SOLIB_ADD (NULL
, from_tty
, target
, auto_solib_add
);
414 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
417 /* Create the hooks to handle shared library load and unload
419 #ifdef SOLIB_CREATE_INFERIOR_HOOK
420 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid
));
422 solib_create_inferior_hook ();
426 observer_notify_inferior_created (target
, from_tty
);
429 /* Kill the inferior if already running. This function is designed
430 to be called when we are about to start the execution of the program
431 from the beginning. Ask the user to confirm that he wants to restart
432 the program being debugged when FROM_TTY is non-null. */
435 kill_if_already_running (int from_tty
)
437 if (! ptid_equal (inferior_ptid
, null_ptid
) && target_has_execution
)
439 /* Bail out before killing the program if we will not be able to
441 target_require_runnable ();
444 && !query ("The program being debugged has been started already.\n\
445 Start it from the beginning? "))
446 error (_("Program not restarted."));
448 no_shared_libraries (NULL
, from_tty
);
449 init_wait_for_inferior ();
453 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
454 a temporary breakpoint at the begining of the main program before
455 running the program. */
458 run_command_1 (char *args
, int from_tty
, int tbreak_at_main
)
464 kill_if_already_running (from_tty
);
465 clear_breakpoint_hit_counts ();
467 /* Clean up any leftovers from other runs. Some other things from
468 this function should probably be moved into target_pre_inferior. */
469 target_pre_inferior (from_tty
);
471 /* The comment here used to read, "The exec file is re-read every
472 time we do a generic_mourn_inferior, so we just have to worry
473 about the symbol file." The `generic_mourn_inferior' function
474 gets called whenever the program exits. However, suppose the
475 program exits, and *then* the executable file changes? We need
476 to check again here. Since reopen_exec_file doesn't do anything
477 if the timestamp hasn't changed, I don't see the harm. */
481 /* Insert the temporary breakpoint if a location was specified. */
483 tbreak_command (main_name (), 0);
485 exec_file
= (char *) get_exec_file (0);
487 if (non_stop
&& !target_supports_non_stop ())
488 error (_("The target does not support running in non-stop mode."));
490 /* We keep symbols from add-symbol-file, on the grounds that the
491 user might want to add some symbols before running the program
492 (right?). But sometimes (dynamic loading where the user manually
493 introduces the new symbols with add-symbol-file), the code which
494 the symbols describe does not persist between runs. Currently
495 the user has to manually nuke all symbols between runs if they
496 want them to go away (PR 2207). This is probably reasonable. */
500 if (target_can_async_p ())
501 async_disable_stdin ();
505 int async_exec
= strip_bg_char (&args
);
507 /* If we get a request for running in the bg but the target
508 doesn't support it, error out. */
509 if (async_exec
&& !target_can_async_p ())
510 error (_("Asynchronous execution not supported on this target."));
512 /* If we don't get a request of running in the bg, then we need
513 to simulate synchronous (fg) execution. */
514 if (!async_exec
&& target_can_async_p ())
516 /* Simulate synchronous execution */
517 async_disable_stdin ();
520 /* If there were other args, beside '&', process them. */
523 char *old_args
= set_inferior_args (xstrdup (args
));
530 ui_out_field_string (uiout
, NULL
, "Starting program");
531 ui_out_text (uiout
, ": ");
533 ui_out_field_string (uiout
, "execfile", exec_file
);
534 ui_out_spaces (uiout
, 1);
535 /* We call get_inferior_args() because we might need to compute
537 ui_out_field_string (uiout
, "infargs", get_inferior_args ());
538 ui_out_text (uiout
, "\n");
539 ui_out_flush (uiout
);
542 /* We call get_inferior_args() because we might need to compute
544 target_create_inferior (exec_file
, get_inferior_args (),
545 environ_vector (inferior_environ
), from_tty
);
547 /* Pass zero for FROM_TTY, because at this point the "run" command
548 has done its thing; now we are setting up the running program. */
549 post_create_inferior (¤t_target
, 0);
551 /* Start the target running. */
552 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
557 run_command (char *args
, int from_tty
)
559 run_command_1 (args
, from_tty
, 0);
563 run_no_args_command (char *args
, int from_tty
)
565 char *old_args
= set_inferior_args (xstrdup (""));
570 /* Start the execution of the program up until the beginning of the main
574 start_command (char *args
, int from_tty
)
576 /* Some languages such as Ada need to search inside the program
577 minimal symbols for the location where to put the temporary
578 breakpoint before starting. */
579 if (!have_minimal_symbols ())
580 error (_("No symbol table loaded. Use the \"file\" command."));
582 /* Run the program until reaching the main procedure... */
583 run_command_1 (args
, from_tty
, 1);
587 proceed_thread_callback (struct thread_info
*thread
, void *arg
)
589 if (!is_stopped (thread
->ptid
))
592 context_switch_to (thread
->ptid
);
593 clear_proceed_status ();
594 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
599 continue_1 (int all_threads
)
603 if (non_stop
&& all_threads
)
605 /* Don't error out if the current thread is running, because
606 there may be other stopped threads. */
607 struct cleanup
*old_chain
;
609 /* Backup current thread and selected frame. */
610 old_chain
= make_cleanup_restore_current_thread ();
612 iterate_over_threads (proceed_thread_callback
, NULL
);
614 /* Restore selected ptid. */
615 do_cleanups (old_chain
);
619 ensure_not_running ();
620 clear_proceed_status ();
621 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
625 /* continue [-a] [proceed-count] [&] */
627 continue_command (char *args
, int from_tty
)
633 /* Find out whether we must run in the background. */
635 async_exec
= strip_bg_char (&args
);
637 /* If we must run in the background, but the target can't do it,
639 if (async_exec
&& !target_can_async_p ())
640 error (_("Asynchronous execution not supported on this target."));
642 /* If we are not asked to run in the bg, then prepare to run in the
643 foreground, synchronously. */
644 if (!async_exec
&& target_can_async_p ())
646 /* Simulate synchronous execution */
647 async_disable_stdin ();
652 if (strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
655 args
+= sizeof ("-a") - 1;
661 if (!non_stop
&& all_threads
)
662 error (_("`-a' is meaningless in all-stop mode."));
664 if (args
!= NULL
&& all_threads
)
666 Can't resume all threads and specify proceed count simultaneously."));
668 /* If we have an argument left, set proceed count of breakpoint we
675 struct thread_info
*tp
;
678 tp
= find_thread_pid (inferior_ptid
);
682 struct target_waitstatus ws
;
684 get_last_target_status (&last_ptid
, &ws
);
685 tp
= find_thread_pid (last_ptid
);
688 bs
= tp
->stop_bpstat
;
690 while ((stat
= bpstat_num (&bs
, &num
)) != 0)
693 set_ignore_count (num
,
694 parse_and_eval_long (args
) - 1,
696 /* set_ignore_count prints a message ending with a period.
697 So print two spaces before "Continuing.". */
699 printf_filtered (" ");
703 if (!stopped
&& from_tty
)
706 ("Not stopped at any breakpoint; argument ignored.\n");
711 printf_filtered (_("Continuing.\n"));
713 continue_1 (all_threads
);
716 /* Step until outside of current statement. */
719 step_command (char *count_string
, int from_tty
)
721 step_1 (0, 0, count_string
);
724 /* Likewise, but skip over subroutine calls as if single instructions. */
727 next_command (char *count_string
, int from_tty
)
729 step_1 (1, 0, count_string
);
732 /* Likewise, but step only one instruction. */
735 stepi_command (char *count_string
, int from_tty
)
737 step_1 (0, 1, count_string
);
741 nexti_command (char *count_string
, int from_tty
)
743 step_1 (1, 1, count_string
);
747 delete_longjmp_breakpoint_cleanup (void *arg
)
749 int thread
= * (int *) arg
;
750 delete_longjmp_breakpoint (thread
);
754 step_1 (int skip_subroutines
, int single_inst
, char *count_string
)
757 struct frame_info
*frame
;
758 struct cleanup
*cleanups
= make_cleanup (null_cleanup
, NULL
);
763 ensure_not_running ();
766 async_exec
= strip_bg_char (&count_string
);
768 /* If we get a request for running in the bg but the target
769 doesn't support it, error out. */
770 if (async_exec
&& !target_can_async_p ())
771 error (_("Asynchronous execution not supported on this target."));
773 /* If we don't get a request of running in the bg, then we need
774 to simulate synchronous (fg) execution. */
775 if (!async_exec
&& target_can_async_p ())
777 /* Simulate synchronous execution */
778 async_disable_stdin ();
781 count
= count_string
? parse_and_eval_long (count_string
) : 1;
783 if (!single_inst
|| skip_subroutines
) /* leave si command alone */
785 if (in_thread_list (inferior_ptid
))
786 thread
= pid_to_thread_id (inferior_ptid
);
788 set_longjmp_breakpoint ();
790 make_cleanup (delete_longjmp_breakpoint_cleanup
, &thread
);
793 /* In synchronous case, all is well, just use the regular for loop. */
794 if (!target_can_async_p ())
796 for (; count
> 0; count
--)
798 struct thread_info
*tp
= inferior_thread ();
799 clear_proceed_status ();
801 frame
= get_current_frame ();
802 tp
->step_frame_id
= get_frame_id (frame
);
806 find_pc_line_pc_range (stop_pc
,
807 &tp
->step_range_start
, &tp
->step_range_end
);
808 if (tp
->step_range_end
== 0)
811 if (find_pc_partial_function (stop_pc
, &name
,
812 &tp
->step_range_start
,
813 &tp
->step_range_end
) == 0)
814 error (_("Cannot find bounds of current function"));
816 target_terminal_ours ();
817 printf_filtered (_("\
818 Single stepping until exit from function %s, \n\
819 which has no line number information.\n"), name
);
824 /* Say we are stepping, but stop after one insn whatever it does. */
825 tp
->step_range_start
= tp
->step_range_end
= 1;
826 if (!skip_subroutines
)
828 Don't step over function calls, not even to functions lacking
830 tp
->step_over_calls
= STEP_OVER_NONE
;
833 if (skip_subroutines
)
834 tp
->step_over_calls
= STEP_OVER_ALL
;
836 step_multi
= (count
> 1);
837 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
843 do_cleanups (cleanups
);
846 /* In case of asynchronous target things get complicated, do only
847 one step for now, before returning control to the event loop. Let
848 the continuation figure out how many other steps we need to do,
849 and handle them one at the time, through step_once(). */
852 step_once (skip_subroutines
, single_inst
, count
, thread
);
853 /* We are running, and the continuation is installed. It will
854 disable the longjmp breakpoint as appropriate. */
855 discard_cleanups (cleanups
);
859 struct step_1_continuation_args
862 int skip_subroutines
;
867 /* Called after we are done with one step operation, to check whether
868 we need to step again, before we print the prompt and return control
869 to the user. If count is > 1, we will need to do one more call to
870 proceed(), via step_once(). Basically it is like step_once and
871 step_1_continuation are co-recursive. */
873 step_1_continuation (void *args
)
875 struct step_1_continuation_args
*a
= args
;
877 if (!step_multi
|| !stop_step
)
879 /* If we stopped for some reason that is not stepping there are
880 no further steps to make. Cleanup. */
881 if (!a
->single_inst
|| a
->skip_subroutines
)
882 delete_longjmp_breakpoint (a
->thread
);
886 step_once (a
->skip_subroutines
, a
->single_inst
, a
->count
- 1, a
->thread
);
889 /* Do just one step operation. If count >1 we will have to set up a
890 continuation to be done after the target stops (after this one
891 step). This is useful to implement the 'step n' kind of commands, in
892 case of asynchronous targets. We had to split step_1 into two parts,
893 one to be done before proceed() and one afterwards. This function is
894 called in case of step n with n>1, after the first step operation has
897 step_once (int skip_subroutines
, int single_inst
, int count
, int thread
)
899 struct frame_info
*frame
;
900 struct step_1_continuation_args
*args
;
904 /* Don't assume THREAD is a valid thread id. It is set to -1 if
905 the longjmp breakpoint was not required. Use the
906 INFERIOR_PTID thread instead, which is the same thread when
908 struct thread_info
*tp
= inferior_thread ();
909 clear_proceed_status ();
911 frame
= get_current_frame ();
912 if (!frame
) /* Avoid coredump here. Why tho? */
913 error (_("No current frame"));
914 tp
->step_frame_id
= get_frame_id (frame
);
918 find_pc_line_pc_range (stop_pc
,
919 &tp
->step_range_start
, &tp
->step_range_end
);
921 /* If we have no line info, switch to stepi mode. */
922 if (tp
->step_range_end
== 0 && step_stop_if_no_debug
)
924 tp
->step_range_start
= tp
->step_range_end
= 1;
926 else if (tp
->step_range_end
== 0)
929 if (find_pc_partial_function (stop_pc
, &name
,
930 &tp
->step_range_start
,
931 &tp
->step_range_end
) == 0)
932 error (_("Cannot find bounds of current function"));
934 target_terminal_ours ();
935 printf_filtered (_("\
936 Single stepping until exit from function %s, \n\
937 which has no line number information.\n"), name
);
942 /* Say we are stepping, but stop after one insn whatever it does. */
943 tp
->step_range_start
= tp
->step_range_end
= 1;
944 if (!skip_subroutines
)
946 Don't step over function calls, not even to functions lacking
948 tp
->step_over_calls
= STEP_OVER_NONE
;
951 if (skip_subroutines
)
952 tp
->step_over_calls
= STEP_OVER_ALL
;
954 step_multi
= (count
> 1);
955 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
957 args
= xmalloc (sizeof (*args
));
958 args
->skip_subroutines
= skip_subroutines
;
959 args
->single_inst
= single_inst
;
961 args
->thread
= thread
;
962 add_intermediate_continuation (step_1_continuation
, args
, xfree
);
967 /* Continue program at specified address. */
970 jump_command (char *arg
, int from_tty
)
973 struct symtabs_and_lines sals
;
974 struct symtab_and_line sal
;
980 ensure_not_running ();
982 /* Find out whether we must run in the background. */
984 async_exec
= strip_bg_char (&arg
);
986 /* If we must run in the background, but the target can't do it,
988 if (async_exec
&& !target_can_async_p ())
989 error (_("Asynchronous execution not supported on this target."));
992 error_no_arg (_("starting address"));
994 sals
= decode_line_spec_1 (arg
, 1);
997 error (_("Unreasonable jump request"));
1003 if (sal
.symtab
== 0 && sal
.pc
== 0)
1004 error (_("No source file has been specified."));
1006 resolve_sal_pc (&sal
); /* May error out */
1008 /* See if we are trying to jump to another function. */
1009 fn
= get_frame_function (get_current_frame ());
1010 sfn
= find_pc_function (sal
.pc
);
1011 if (fn
!= NULL
&& sfn
!= fn
)
1013 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal
.line
,
1014 SYMBOL_PRINT_NAME (fn
)))
1016 error (_("Not confirmed."));
1023 fixup_symbol_section (sfn
, 0);
1024 if (section_is_overlay (SYMBOL_OBJ_SECTION (sfn
)) &&
1025 !section_is_mapped (SYMBOL_OBJ_SECTION (sfn
)))
1027 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
1029 error (_("Not confirmed."));
1039 printf_filtered (_("Continuing at "));
1040 fputs_filtered (paddress (addr
), gdb_stdout
);
1041 printf_filtered (".\n");
1044 /* If we are not asked to run in the bg, then prepare to run in the
1045 foreground, synchronously. */
1046 if (!async_exec
&& target_can_async_p ())
1048 /* Simulate synchronous execution */
1049 async_disable_stdin ();
1052 clear_proceed_status ();
1053 proceed (addr
, TARGET_SIGNAL_0
, 0);
1057 /* Go to line or address in current procedure */
1059 go_command (char *line_no
, int from_tty
)
1061 if (line_no
== (char *) NULL
|| !*line_no
)
1062 printf_filtered (GO_USAGE
);
1065 tbreak_command (line_no
, from_tty
);
1066 jump_command (line_no
, from_tty
);
1071 /* Continue program giving it specified signal. */
1074 signal_command (char *signum_exp
, int from_tty
)
1076 enum target_signal oursig
;
1079 dont_repeat (); /* Too dangerous. */
1081 ensure_not_running ();
1083 /* Find out whether we must run in the background. */
1084 if (signum_exp
!= NULL
)
1085 async_exec
= strip_bg_char (&signum_exp
);
1087 /* If we must run in the background, but the target can't do it,
1089 if (async_exec
&& !target_can_async_p ())
1090 error (_("Asynchronous execution not supported on this target."));
1092 /* If we are not asked to run in the bg, then prepare to run in the
1093 foreground, synchronously. */
1094 if (!async_exec
&& target_can_async_p ())
1096 /* Simulate synchronous execution. */
1097 async_disable_stdin ();
1101 error_no_arg (_("signal number"));
1103 /* It would be even slicker to make signal names be valid expressions,
1104 (the type could be "enum $signal" or some such), then the user could
1105 assign them to convenience variables. */
1106 oursig
= target_signal_from_name (signum_exp
);
1108 if (oursig
== TARGET_SIGNAL_UNKNOWN
)
1110 /* No, try numeric. */
1111 int num
= parse_and_eval_long (signum_exp
);
1114 oursig
= TARGET_SIGNAL_0
;
1116 oursig
= target_signal_from_command (num
);
1121 if (oursig
== TARGET_SIGNAL_0
)
1122 printf_filtered (_("Continuing with no signal.\n"));
1124 printf_filtered (_("Continuing with signal %s.\n"),
1125 target_signal_to_name (oursig
));
1128 clear_proceed_status ();
1129 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1130 FIXME: Neither should "signal foo" but when I tried passing
1131 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1132 tried to track down yet. */
1133 proceed (oursig
== TARGET_SIGNAL_0
? (CORE_ADDR
) -1 : stop_pc
, oursig
, 0);
1136 /* Proceed until we reach a different source line with pc greater than
1137 our current one or exit the function. We skip calls in both cases.
1139 Note that eventually this command should probably be changed so
1140 that only source lines are printed out when we hit the breakpoint
1141 we set. This may involve changes to wait_for_inferior and the
1142 proceed status code. */
1145 until_next_command (int from_tty
)
1147 struct frame_info
*frame
;
1149 struct symbol
*func
;
1150 struct symtab_and_line sal
;
1151 struct thread_info
*tp
= inferior_thread ();
1153 clear_proceed_status ();
1155 frame
= get_current_frame ();
1157 /* Step until either exited from this function or greater
1158 than the current line (if in symbolic section) or pc (if
1162 func
= find_pc_function (pc
);
1166 struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (pc
);
1168 if (msymbol
== NULL
)
1169 error (_("Execution is not within a known function."));
1171 tp
->step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
1172 tp
->step_range_end
= pc
;
1176 sal
= find_pc_line (pc
, 0);
1178 tp
->step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
1179 tp
->step_range_end
= sal
.end
;
1182 tp
->step_over_calls
= STEP_OVER_ALL
;
1183 tp
->step_frame_id
= get_frame_id (frame
);
1185 step_multi
= 0; /* Only one call to proceed */
1187 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
1191 until_command (char *arg
, int from_tty
)
1195 if (!target_has_execution
)
1196 error (_("The program is not running."));
1198 /* Find out whether we must run in the background. */
1200 async_exec
= strip_bg_char (&arg
);
1202 /* If we must run in the background, but the target can't do it,
1204 if (async_exec
&& !target_can_async_p ())
1205 error (_("Asynchronous execution not supported on this target."));
1207 /* If we are not asked to run in the bg, then prepare to run in the
1208 foreground, synchronously. */
1209 if (!async_exec
&& target_can_async_p ())
1211 /* Simulate synchronous execution */
1212 async_disable_stdin ();
1216 until_break_command (arg
, from_tty
, 0);
1218 until_next_command (from_tty
);
1222 advance_command (char *arg
, int from_tty
)
1226 if (!target_has_execution
)
1227 error (_("The program is not running."));
1230 error_no_arg (_("a location"));
1232 /* Find out whether we must run in the background. */
1234 async_exec
= strip_bg_char (&arg
);
1236 /* If we must run in the background, but the target can't do it,
1238 if (async_exec
&& !target_can_async_p ())
1239 error (_("Asynchronous execution not supported on this target."));
1241 /* If we are not asked to run in the bg, then prepare to run in the
1242 foreground, synchronously. */
1243 if (!async_exec
&& target_can_async_p ())
1245 /* Simulate synchronous execution. */
1246 async_disable_stdin ();
1249 until_break_command (arg
, from_tty
, 1);
1252 /* Print the result of a function at the end of a 'finish' command. */
1255 print_return_value (struct type
*func_type
, struct type
*value_type
)
1257 struct gdbarch
*gdbarch
= current_gdbarch
;
1258 struct cleanup
*old_chain
;
1259 struct ui_stream
*stb
;
1260 struct value
*value
;
1262 CHECK_TYPEDEF (value_type
);
1263 gdb_assert (TYPE_CODE (value_type
) != TYPE_CODE_VOID
);
1265 /* FIXME: 2003-09-27: When returning from a nested inferior function
1266 call, it's possible (with no help from the architecture vector)
1267 to locate and return/print a "struct return" value. This is just
1268 a more complicated case of what is already being done in in the
1269 inferior function call code. In fact, when inferior function
1270 calls are made async, this will likely be made the norm. */
1272 switch (gdbarch_return_value (gdbarch
, func_type
, value_type
,
1275 case RETURN_VALUE_REGISTER_CONVENTION
:
1276 case RETURN_VALUE_ABI_RETURNS_ADDRESS
:
1277 case RETURN_VALUE_ABI_PRESERVES_ADDRESS
:
1278 value
= allocate_value (value_type
);
1279 gdbarch_return_value (gdbarch
, func_type
, value_type
, stop_registers
,
1280 value_contents_raw (value
), NULL
);
1282 case RETURN_VALUE_STRUCT_CONVENTION
:
1286 internal_error (__FILE__
, __LINE__
, _("bad switch"));
1292 stb
= ui_out_stream_new (uiout
);
1293 old_chain
= make_cleanup_ui_out_stream_delete (stb
);
1294 ui_out_text (uiout
, "Value returned is ");
1295 ui_out_field_fmt (uiout
, "gdb-result-var", "$%d",
1296 record_latest_value (value
));
1297 ui_out_text (uiout
, " = ");
1298 value_print (value
, stb
->stream
, 0, Val_no_prettyprint
);
1299 ui_out_field_stream (uiout
, "return-value", stb
);
1300 ui_out_text (uiout
, "\n");
1301 do_cleanups (old_chain
);
1305 ui_out_text (uiout
, "Value returned has type: ");
1306 ui_out_field_string (uiout
, "return-type", TYPE_NAME (value_type
));
1307 ui_out_text (uiout
, ".");
1308 ui_out_text (uiout
, " Cannot determine contents\n");
1312 /* Stuff that needs to be done by the finish command after the target
1313 has stopped. In asynchronous mode, we wait for the target to stop
1314 in the call to poll or select in the event loop, so it is
1315 impossible to do all the stuff as part of the finish_command
1316 function itself. The only chance we have to complete this command
1317 is in fetch_inferior_event, which is called by the event loop as
1318 soon as it detects that the target has stopped. This function is
1319 called via the cmd_continuation pointer. */
1321 struct finish_command_continuation_args
1323 struct breakpoint
*breakpoint
;
1324 struct symbol
*function
;
1328 finish_command_continuation (void *arg
)
1330 struct finish_command_continuation_args
*a
= arg
;
1334 if (!ptid_equal (inferior_ptid
, null_ptid
)
1335 && target_has_execution
1336 && is_stopped (inferior_ptid
))
1337 bs
= inferior_thread ()->stop_bpstat
;
1339 if (bpstat_find_breakpoint (bs
, a
->breakpoint
) != NULL
1340 && a
->function
!= NULL
)
1342 struct type
*value_type
;
1344 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (a
->function
));
1346 internal_error (__FILE__
, __LINE__
,
1347 _("finish_command: function has no target type"));
1349 if (TYPE_CODE (value_type
) != TYPE_CODE_VOID
)
1350 print_return_value (SYMBOL_TYPE (a
->function
), value_type
);
1353 /* We suppress normal call of normal_stop observer and do it here so
1354 that that *stopped notification includes the return value. */
1355 /* NOTE: This is broken in non-stop mode. There is no guarantee the
1356 next stop will be in the same thread that we started doing a
1357 finish on. This suppressing (or some other replacement means)
1358 should be a thread property. */
1359 observer_notify_normal_stop (bs
);
1360 suppress_stop_observer
= 0;
1361 delete_breakpoint (a
->breakpoint
);
1365 finish_command_continuation_free_arg (void *arg
)
1367 /* NOTE: See finish_command_continuation. This would go away, if
1368 this suppressing is made a thread property. */
1369 suppress_stop_observer
= 0;
1373 /* "finish": Set a temporary breakpoint at the place the selected
1374 frame will return to, then continue. */
1377 finish_command (char *arg
, int from_tty
)
1379 struct symtab_and_line sal
;
1380 struct frame_info
*frame
;
1381 struct symbol
*function
;
1382 struct breakpoint
*breakpoint
;
1383 struct cleanup
*old_chain
;
1384 struct finish_command_continuation_args
*cargs
;
1385 struct thread_info
*tp
;
1389 /* Find out whether we must run in the background. */
1391 async_exec
= strip_bg_char (&arg
);
1393 /* If we must run in the background, but the target can't do it,
1395 if (async_exec
&& !target_can_async_p ())
1396 error (_("Asynchronous execution not supported on this target."));
1398 /* If we are not asked to run in the bg, then prepare to run in the
1399 foreground, synchronously. */
1400 if (!async_exec
&& target_can_async_p ())
1402 /* Simulate synchronous execution. */
1403 async_disable_stdin ();
1407 error (_("The \"finish\" command does not take any arguments."));
1408 if (!target_has_execution
)
1409 error (_("The program is not running."));
1411 frame
= get_prev_frame (get_selected_frame (_("No selected frame.")));
1413 error (_("\"finish\" not meaningful in the outermost frame."));
1415 tp
= inferior_thread ();
1417 clear_proceed_status ();
1419 sal
= find_pc_line (get_frame_pc (frame
), 0);
1420 sal
.pc
= get_frame_pc (frame
);
1422 breakpoint
= set_momentary_breakpoint (sal
, get_frame_id (frame
), bp_finish
);
1424 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1426 /* Find the function we will return from. */
1428 function
= find_pc_function (get_frame_pc (get_selected_frame (NULL
)));
1430 /* Print info on the selected frame, including level number but not
1434 printf_filtered (_("Run till exit from "));
1435 print_stack_frame (get_selected_frame (NULL
), 1, LOCATION
);
1438 tp
->proceed_to_finish
= 1; /* We want stop_registers, please... */
1439 make_cleanup_restore_integer (&suppress_stop_observer
);
1440 suppress_stop_observer
= 1;
1441 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1443 cargs
= xmalloc (sizeof (*cargs
));
1445 cargs
->breakpoint
= breakpoint
;
1446 cargs
->function
= function
;
1447 add_continuation (finish_command_continuation
, cargs
,
1448 finish_command_continuation_free_arg
);
1450 discard_cleanups (old_chain
);
1451 if (!target_can_async_p ())
1452 do_all_continuations ();
1457 program_info (char *args
, int from_tty
)
1461 struct thread_info
*tp
;
1464 if (!target_has_execution
)
1466 printf_filtered (_("The program being debugged is not being run.\n"));
1471 ptid
= inferior_ptid
;
1474 struct target_waitstatus ws
;
1475 get_last_target_status (&ptid
, &ws
);
1478 if (ptid_equal (ptid
, null_ptid
) || is_exited (ptid
))
1479 error (_("Invalid selected thread."));
1480 else if (is_running (ptid
))
1481 error (_("Selected thread is running."));
1483 tp
= find_thread_pid (ptid
);
1484 bs
= tp
->stop_bpstat
;
1485 stat
= bpstat_num (&bs
, &num
);
1487 target_files_info ();
1488 printf_filtered (_("Program stopped at %s.\n"),
1489 hex_string ((unsigned long) stop_pc
));
1491 printf_filtered (_("It stopped after being stepped.\n"));
1494 /* There may be several breakpoints in the same place, so this
1495 isn't as strange as it seems. */
1500 printf_filtered (_("\
1501 It stopped at a breakpoint that has since been deleted.\n"));
1504 printf_filtered (_("It stopped at breakpoint %d.\n"), num
);
1505 stat
= bpstat_num (&bs
, &num
);
1508 else if (stop_signal
!= TARGET_SIGNAL_0
)
1510 printf_filtered (_("It stopped with signal %s, %s.\n"),
1511 target_signal_to_name (stop_signal
),
1512 target_signal_to_string (stop_signal
));
1517 printf_filtered (_("\
1518 Type \"info stack\" or \"info registers\" for more information.\n"));
1523 environment_info (char *var
, int from_tty
)
1527 char *val
= get_in_environ (inferior_environ
, var
);
1530 puts_filtered (var
);
1531 puts_filtered (" = ");
1532 puts_filtered (val
);
1533 puts_filtered ("\n");
1537 puts_filtered ("Environment variable \"");
1538 puts_filtered (var
);
1539 puts_filtered ("\" not defined.\n");
1544 char **vector
= environ_vector (inferior_environ
);
1547 puts_filtered (*vector
++);
1548 puts_filtered ("\n");
1554 set_environment_command (char *arg
, int from_tty
)
1556 char *p
, *val
, *var
;
1560 error_no_arg (_("environment variable and value"));
1562 /* Find seperation between variable name and value */
1563 p
= (char *) strchr (arg
, '=');
1564 val
= (char *) strchr (arg
, ' ');
1566 if (p
!= 0 && val
!= 0)
1568 /* We have both a space and an equals. If the space is before the
1569 equals, walk forward over the spaces til we see a nonspace
1570 (possibly the equals). */
1575 /* Now if the = is after the char following the spaces,
1576 take the char following the spaces. */
1580 else if (val
!= 0 && p
== 0)
1584 error_no_arg (_("environment variable to set"));
1586 if (p
== 0 || p
[1] == 0)
1590 p
= arg
+ strlen (arg
); /* So that savestring below will work */
1594 /* Not setting variable value to null */
1596 while (*val
== ' ' || *val
== '\t')
1600 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t'))
1603 var
= savestring (arg
, p
- arg
);
1606 printf_filtered (_("\
1607 Setting environment variable \"%s\" to null value.\n"),
1609 set_in_environ (inferior_environ
, var
, "");
1612 set_in_environ (inferior_environ
, var
, val
);
1617 unset_environment_command (char *var
, int from_tty
)
1621 /* If there is no argument, delete all environment variables.
1622 Ask for confirmation if reading from the terminal. */
1623 if (!from_tty
|| query (_("Delete all environment variables? ")))
1625 free_environ (inferior_environ
);
1626 inferior_environ
= make_environ ();
1630 unset_in_environ (inferior_environ
, var
);
1633 /* Handle the execution path (PATH variable) */
1635 static const char path_var_name
[] = "PATH";
1638 path_info (char *args
, int from_tty
)
1640 puts_filtered ("Executable and object file path: ");
1641 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
1642 puts_filtered ("\n");
1645 /* Add zero or more directories to the front of the execution path. */
1648 path_command (char *dirname
, int from_tty
)
1653 env
= get_in_environ (inferior_environ
, path_var_name
);
1654 /* Can be null if path is not set */
1657 exec_path
= xstrdup (env
);
1658 mod_path (dirname
, &exec_path
);
1659 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
1662 path_info ((char *) NULL
, from_tty
);
1666 /* Print out the machine register regnum. If regnum is -1, print all
1667 registers (print_all == 1) or all non-float and non-vector
1668 registers (print_all == 0).
1670 For most machines, having all_registers_info() print the
1671 register(s) one per line is good enough. If a different format is
1672 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1673 regs), or there is an existing convention for showing all the
1674 registers, define the architecture method PRINT_REGISTERS_INFO to
1675 provide that format. */
1678 default_print_registers_info (struct gdbarch
*gdbarch
,
1679 struct ui_file
*file
,
1680 struct frame_info
*frame
,
1681 int regnum
, int print_all
)
1684 const int numregs
= gdbarch_num_regs (gdbarch
)
1685 + gdbarch_num_pseudo_regs (gdbarch
);
1686 gdb_byte buffer
[MAX_REGISTER_SIZE
];
1688 for (i
= 0; i
< numregs
; i
++)
1690 /* Decide between printing all regs, non-float / vector regs, or
1696 if (!gdbarch_register_reggroup_p (gdbarch
, i
, all_reggroup
))
1701 if (!gdbarch_register_reggroup_p (gdbarch
, i
, general_reggroup
))
1711 /* If the register name is empty, it is undefined for this
1712 processor, so don't display anything. */
1713 if (gdbarch_register_name (gdbarch
, i
) == NULL
1714 || *(gdbarch_register_name (gdbarch
, i
)) == '\0')
1717 fputs_filtered (gdbarch_register_name (gdbarch
, i
), file
);
1718 print_spaces_filtered (15 - strlen (gdbarch_register_name
1719 (gdbarch
, i
)), file
);
1721 /* Get the data in raw format. */
1722 if (! frame_register_read (frame
, i
, buffer
))
1724 fprintf_filtered (file
, "*value not available*\n");
1728 /* If virtual format is floating, print it that way, and in raw
1730 if (TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_FLT
1731 || TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_DECFLOAT
)
1735 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1736 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1738 fprintf_filtered (file
, "\t(raw 0x");
1739 for (j
= 0; j
< register_size (gdbarch
, i
); j
++)
1742 if (gdbarch_byte_order (gdbarch
) == BFD_ENDIAN_BIG
)
1745 idx
= register_size (gdbarch
, i
) - 1 - j
;
1746 fprintf_filtered (file
, "%02x", (unsigned char) buffer
[idx
]);
1748 fprintf_filtered (file
, ")");
1752 /* Print the register in hex. */
1753 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1754 file
, 'x', 1, 0, Val_pretty_default
, current_language
);
1755 /* If not a vector register, print it also according to its
1757 if (TYPE_VECTOR (register_type (gdbarch
, i
)) == 0)
1759 fprintf_filtered (file
, "\t");
1760 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1761 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1765 fprintf_filtered (file
, "\n");
1770 registers_info (char *addr_exp
, int fpregs
)
1772 struct frame_info
*frame
;
1773 struct gdbarch
*gdbarch
;
1774 int regnum
, numregs
;
1777 if (!target_has_registers
)
1778 error (_("The program has no registers now."));
1779 frame
= get_selected_frame (NULL
);
1780 gdbarch
= get_frame_arch (frame
);
1784 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1789 while (*addr_exp
!= '\0')
1794 /* Keep skipping leading white space. */
1795 if (isspace ((*addr_exp
)))
1801 /* Discard any leading ``$''. Check that there is something
1802 resembling a register following it. */
1803 if (addr_exp
[0] == '$')
1805 if (isspace ((*addr_exp
)) || (*addr_exp
) == '\0')
1806 error (_("Missing register name"));
1808 /* Find the start/end of this register name/num/group. */
1810 while ((*addr_exp
) != '\0' && !isspace ((*addr_exp
)))
1814 /* Figure out what we've found and display it. */
1816 /* A register name? */
1818 int regnum
= user_reg_map_name_to_regnum (gdbarch
, start
, end
- start
);
1821 /* User registers lie completely outside of the range of
1822 normal registers. Catch them early so that the target
1824 if (regnum
>= gdbarch_num_regs (gdbarch
)
1825 + gdbarch_num_pseudo_regs (gdbarch
))
1827 struct value
*val
= value_of_user_reg (regnum
, frame
);
1829 printf_filtered ("%s: ", start
);
1830 print_scalar_formatted (value_contents (val
),
1831 check_typedef (value_type (val
)),
1832 'x', 0, gdb_stdout
);
1833 printf_filtered ("\n");
1836 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1837 frame
, regnum
, fpregs
);
1842 /* A register number? (how portable is this one?). */
1845 int regnum
= strtol (start
, &endptr
, 0);
1848 && regnum
< gdbarch_num_regs (gdbarch
)
1849 + gdbarch_num_pseudo_regs (gdbarch
))
1851 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1852 frame
, regnum
, fpregs
);
1857 /* A register group? */
1859 struct reggroup
*group
;
1860 for (group
= reggroup_next (gdbarch
, NULL
);
1862 group
= reggroup_next (gdbarch
, group
))
1864 /* Don't bother with a length check. Should the user
1865 enter a short register group name, go with the first
1866 group that matches. */
1867 if (strncmp (start
, reggroup_name (group
), end
- start
) == 0)
1874 regnum
< gdbarch_num_regs (gdbarch
)
1875 + gdbarch_num_pseudo_regs (gdbarch
);
1878 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
1879 gdbarch_print_registers_info (gdbarch
,
1887 /* Nothing matched. */
1888 error (_("Invalid register `%.*s'"), (int) (end
- start
), start
);
1893 all_registers_info (char *addr_exp
, int from_tty
)
1895 registers_info (addr_exp
, 1);
1899 nofp_registers_info (char *addr_exp
, int from_tty
)
1901 registers_info (addr_exp
, 0);
1905 print_vector_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
1906 struct frame_info
*frame
, const char *args
)
1908 if (gdbarch_print_vector_info_p (gdbarch
))
1909 gdbarch_print_vector_info (gdbarch
, file
, frame
, args
);
1913 int printed_something
= 0;
1916 regnum
< gdbarch_num_regs (gdbarch
)
1917 + gdbarch_num_pseudo_regs (gdbarch
);
1920 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, vector_reggroup
))
1922 printed_something
= 1;
1923 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
1926 if (!printed_something
)
1927 fprintf_filtered (file
, "No vector information\n");
1932 vector_info (char *args
, int from_tty
)
1934 if (!target_has_registers
)
1935 error (_("The program has no registers now."));
1937 print_vector_info (current_gdbarch
, gdb_stdout
,
1938 get_selected_frame (NULL
), args
);
1944 * Should save/restore the tty state since it might be that the
1945 * program to be debugged was started on this tty and it wants
1946 * the tty in some state other than what we want. If it's running
1947 * on another terminal or without a terminal, then saving and
1948 * restoring the tty state is a harmless no-op.
1949 * This only needs to be done if we are attaching to a process.
1954 takes a program started up outside of gdb and ``attaches'' to it.
1955 This stops it cold in its tracks and allows us to start debugging it.
1956 and wait for the trace-trap that results from attaching. */
1959 attach_command_post_wait (char *args
, int from_tty
, int async_exec
)
1962 char *full_exec_path
= NULL
;
1964 stop_soon
= NO_STOP_QUIETLY
;
1966 /* If no exec file is yet known, try to determine it from the
1968 exec_file
= (char *) get_exec_file (0);
1971 exec_file
= target_pid_to_exec_file (PIDGET (inferior_ptid
));
1974 /* It's possible we don't have a full path, but rather just a
1975 filename. Some targets, such as HP-UX, don't provide the
1978 Attempt to qualify the filename against the source path.
1979 (If that fails, we'll just fall back on the original
1980 filename. Not much more we can do...)
1982 if (!source_full_path_of (exec_file
, &full_exec_path
))
1983 full_exec_path
= savestring (exec_file
, strlen (exec_file
));
1985 exec_file_attach (full_exec_path
, from_tty
);
1986 symbol_file_add_main (full_exec_path
, from_tty
);
1991 reopen_exec_file ();
1995 /* Take any necessary post-attaching actions for this platform. */
1996 target_post_attach (PIDGET (inferior_ptid
));
1998 post_create_inferior (¤t_target
, from_tty
);
2000 /* Install inferior's terminal modes. */
2001 target_terminal_inferior ();
2004 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
2007 if (target_can_async_p ())
2008 async_enable_stdin ();
2010 if (deprecated_attach_hook
)
2011 deprecated_attach_hook ();
2015 struct attach_command_continuation_args
2023 attach_command_continuation (void *args
)
2025 struct attach_command_continuation_args
*a
= args
;
2026 attach_command_post_wait (a
->args
, a
->from_tty
, a
->async_exec
);
2030 attach_command_continuation_free_args (void *args
)
2032 struct attach_command_continuation_args
*a
= args
;
2038 attach_command (char *args
, int from_tty
)
2041 char *full_exec_path
= NULL
;
2044 dont_repeat (); /* Not for the faint of heart */
2046 if (target_has_execution
)
2048 if (query ("A program is being debugged already. Kill it? "))
2051 error (_("Not killed."));
2054 /* Clean up any leftovers from other runs. Some other things from
2055 this function should probably be moved into target_pre_inferior. */
2056 target_pre_inferior (from_tty
);
2058 if (non_stop
&& !target_supports_non_stop ())
2059 error (_("Cannot attach to this target in non-stop mode"));
2063 async_exec
= strip_bg_char (&args
);
2065 /* If we get a request for running in the bg but the target
2066 doesn't support it, error out. */
2067 if (async_exec
&& !target_can_async_p ())
2068 error (_("Asynchronous execution not supported on this target."));
2071 /* If we don't get a request of running in the bg, then we need
2072 to simulate synchronous (fg) execution. */
2073 if (!async_exec
&& target_can_async_p ())
2075 /* Simulate synchronous execution */
2076 async_disable_stdin ();
2079 target_attach (args
, from_tty
);
2081 /* Set up the "saved terminal modes" of the inferior
2082 based on what modes we are starting it with. */
2083 target_terminal_init ();
2085 /* Set up execution context to know that we should return from
2086 wait_for_inferior as soon as the target reports a stop. */
2087 init_wait_for_inferior ();
2088 clear_proceed_status ();
2090 /* Some system don't generate traps when attaching to inferior.
2091 E.g. Mach 3 or GNU hurd. */
2092 if (!target_attach_no_wait
)
2094 /* Careful here. See comments in inferior.h. Basically some
2095 OSes don't ignore SIGSTOPs on continue requests anymore. We
2096 need a way for handle_inferior_event to reset the stop_signal
2097 variable after an attach, and this is what
2098 STOP_QUIETLY_NO_SIGSTOP is for. */
2099 stop_soon
= STOP_QUIETLY_NO_SIGSTOP
;
2101 if (target_can_async_p ())
2103 /* sync_execution mode. Wait for stop. */
2104 struct attach_command_continuation_args
*a
;
2106 a
= xmalloc (sizeof (*a
));
2107 a
->args
= xstrdup (args
);
2108 a
->from_tty
= from_tty
;
2109 a
->async_exec
= async_exec
;
2110 add_continuation (attach_command_continuation
, a
,
2111 attach_command_continuation_free_args
);
2115 wait_for_inferior (0);
2118 attach_command_post_wait (args
, from_tty
, async_exec
);
2123 * takes a program previously attached to and detaches it.
2124 * The program resumes execution and will no longer stop
2125 * on signals, etc. We better not have left any breakpoints
2126 * in the program or it'll die when it hits one. For this
2127 * to work, it may be necessary for the process to have been
2128 * previously attached. It *might* work if the program was
2129 * started via the normal ptrace (PTRACE_TRACEME).
2133 detach_command (char *args
, int from_tty
)
2135 dont_repeat (); /* Not for the faint of heart. */
2136 target_detach (args
, from_tty
);
2137 no_shared_libraries (NULL
, from_tty
);
2138 init_thread_list ();
2139 if (deprecated_detach_hook
)
2140 deprecated_detach_hook ();
2143 /* Disconnect from the current target without resuming it (leaving it
2144 waiting for a debugger).
2146 We'd better not have left any breakpoints in the program or the
2147 next debugger will get confused. Currently only supported for some
2148 remote targets, since the normal attach mechanisms don't work on
2149 stopped processes on some native platforms (e.g. GNU/Linux). */
2152 disconnect_command (char *args
, int from_tty
)
2154 dont_repeat (); /* Not for the faint of heart */
2155 target_disconnect (args
, from_tty
);
2156 no_shared_libraries (NULL
, from_tty
);
2157 init_thread_list ();
2158 if (deprecated_detach_hook
)
2159 deprecated_detach_hook ();
2163 interrupt_target_1 (int all_threads
)
2167 ptid
= minus_one_ptid
;
2169 ptid
= inferior_ptid
;
2173 /* Stop the execution of the target while running in async mode, in
2174 the backgound. In all-stop, stop the whole process. In non-stop
2175 mode, stop the current thread only by default, or stop all threads
2176 if the `-a' switch is used. */
2178 /* interrupt [-a] */
2180 interrupt_target_command (char *args
, int from_tty
)
2182 if (target_can_async_p ())
2184 int all_threads
= 0;
2186 dont_repeat (); /* Not for the faint of heart */
2189 && strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
2192 if (!non_stop
&& all_threads
)
2193 error (_("-a is meaningless in all-stop mode."));
2195 interrupt_target_1 (all_threads
);
2200 print_float_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
2201 struct frame_info
*frame
, const char *args
)
2203 if (gdbarch_print_float_info_p (gdbarch
))
2204 gdbarch_print_float_info (gdbarch
, file
, frame
, args
);
2208 int printed_something
= 0;
2211 regnum
< gdbarch_num_regs (gdbarch
)
2212 + gdbarch_num_pseudo_regs (gdbarch
);
2215 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, float_reggroup
))
2217 printed_something
= 1;
2218 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2221 if (!printed_something
)
2222 fprintf_filtered (file
, "\
2223 No floating-point info available for this processor.\n");
2228 float_info (char *args
, int from_tty
)
2230 if (!target_has_registers
)
2231 error (_("The program has no registers now."));
2233 print_float_info (current_gdbarch
, gdb_stdout
,
2234 get_selected_frame (NULL
), args
);
2238 unset_command (char *args
, int from_tty
)
2240 printf_filtered (_("\
2241 \"unset\" must be followed by the name of an unset subcommand.\n"));
2242 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
2246 _initialize_infcmd (void)
2248 struct cmd_list_element
*c
= NULL
;
2250 /* add the filename of the terminal connected to inferior I/O */
2251 add_setshow_filename_cmd ("inferior-tty", class_run
,
2252 &inferior_io_terminal
, _("\
2253 Set terminal for future runs of program being debugged."), _("\
2254 Show terminal for future runs of program being debugged."), _("\
2255 Usage: set inferior-tty /dev/pts/1"), NULL
, NULL
, &setlist
, &showlist
);
2256 add_com_alias ("tty", "set inferior-tty", class_alias
, 0);
2258 add_setshow_optional_filename_cmd ("args", class_run
,
2259 &inferior_args
, _("\
2260 Set argument list to give program being debugged when it is started."), _("\
2261 Show argument list to give program being debugged when it is started."), _("\
2262 Follow this command with any number of args, to be passed to the program."),
2265 &setlist
, &showlist
);
2267 c
= add_cmd ("environment", no_class
, environment_info
, _("\
2268 The environment to give the program, or one variable's value.\n\
2269 With an argument VAR, prints the value of environment variable VAR to\n\
2270 give the program being debugged. With no arguments, prints the entire\n\
2271 environment to be given to the program."), &showlist
);
2272 set_cmd_completer (c
, noop_completer
);
2274 add_prefix_cmd ("unset", no_class
, unset_command
,
2275 _("Complement to certain \"set\" commands."),
2276 &unsetlist
, "unset ", 0, &cmdlist
);
2278 c
= add_cmd ("environment", class_run
, unset_environment_command
, _("\
2279 Cancel environment variable VAR for the program.\n\
2280 This does not affect the program until the next \"run\" command."),
2282 set_cmd_completer (c
, noop_completer
);
2284 c
= add_cmd ("environment", class_run
, set_environment_command
, _("\
2285 Set environment variable value to give the program.\n\
2286 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2287 VALUES of environment variables are uninterpreted strings.\n\
2288 This does not affect the program until the next \"run\" command."),
2290 set_cmd_completer (c
, noop_completer
);
2292 c
= add_com ("path", class_files
, path_command
, _("\
2293 Add directory DIR(s) to beginning of search path for object files.\n\
2294 $cwd in the path means the current working directory.\n\
2295 This path is equivalent to the $PATH shell variable. It is a list of\n\
2296 directories, separated by colons. These directories are searched to find\n\
2297 fully linked executable files and separately compiled object files as needed."));
2298 set_cmd_completer (c
, filename_completer
);
2300 c
= add_cmd ("paths", no_class
, path_info
, _("\
2301 Current search path for finding object files.\n\
2302 $cwd in the path means the current working directory.\n\
2303 This path is equivalent to the $PATH shell variable. It is a list of\n\
2304 directories, separated by colons. These directories are searched to find\n\
2305 fully linked executable files and separately compiled object files as needed."),
2307 set_cmd_completer (c
, noop_completer
);
2309 add_com ("attach", class_run
, attach_command
, _("\
2310 Attach to a process or file outside of GDB.\n\
2311 This command attaches to another target, of the same type as your last\n\
2312 \"target\" command (\"info files\" will show your target stack).\n\
2313 The command may take as argument a process id or a device file.\n\
2314 For a process id, you must have permission to send the process a signal,\n\
2315 and it must have the same effective uid as the debugger.\n\
2316 When using \"attach\" with a process id, the debugger finds the\n\
2317 program running in the process, looking first in the current working\n\
2318 directory, or (if not found there) using the source file search path\n\
2319 (see the \"directory\" command). You can also use the \"file\" command\n\
2320 to specify the program, and to load its symbol table."));
2322 add_prefix_cmd ("detach", class_run
, detach_command
, _("\
2323 Detach a process or file previously attached.\n\
2324 If a process, it is no longer traced, and it continues its execution. If\n\
2325 you were debugging a file, the file is closed and gdb no longer accesses it."),
2326 &detachlist
, "detach ", 0, &cmdlist
);
2328 add_com ("disconnect", class_run
, disconnect_command
, _("\
2329 Disconnect from a target.\n\
2330 The target will wait for another debugger to connect. Not available for\n\
2333 add_com ("signal", class_run
, signal_command
, _("\
2334 Continue program giving it signal specified by the argument.\n\
2335 An argument of \"0\" means continue program without giving it a signal."));
2337 add_com ("stepi", class_run
, stepi_command
, _("\
2338 Step one instruction exactly.\n\
2339 Argument N means do this N times (or till program stops for another reason)."));
2340 add_com_alias ("si", "stepi", class_alias
, 0);
2342 add_com ("nexti", class_run
, nexti_command
, _("\
2343 Step one instruction, but proceed through subroutine calls.\n\
2344 Argument N means do this N times (or till program stops for another reason)."));
2345 add_com_alias ("ni", "nexti", class_alias
, 0);
2347 add_com ("finish", class_run
, finish_command
, _("\
2348 Execute until selected stack frame returns.\n\
2349 Upon return, the value returned is printed and put in the value history."));
2350 add_com_alias ("fin", "finish", class_run
, 1);
2352 add_com ("next", class_run
, next_command
, _("\
2353 Step program, proceeding through subroutine calls.\n\
2354 Like the \"step\" command as long as subroutine calls do not happen;\n\
2355 when they do, the call is treated as one instruction.\n\
2356 Argument N means do this N times (or till program stops for another reason)."));
2357 add_com_alias ("n", "next", class_run
, 1);
2359 add_com_alias ("S", "next", class_run
, 1);
2361 add_com ("step", class_run
, step_command
, _("\
2362 Step program until it reaches a different source line.\n\
2363 Argument N means do this N times (or till program stops for another reason)."));
2364 add_com_alias ("s", "step", class_run
, 1);
2366 c
= add_com ("until", class_run
, until_command
, _("\
2367 Execute until the program reaches a source line greater than the current\n\
2368 or a specified location (same args as break command) within the current frame."));
2369 set_cmd_completer (c
, location_completer
);
2370 add_com_alias ("u", "until", class_run
, 1);
2372 c
= add_com ("advance", class_run
, advance_command
, _("\
2373 Continue the program up to the given location (same form as args for break command).\n\
2374 Execution will also stop upon exit from the current stack frame."));
2375 set_cmd_completer (c
, location_completer
);
2377 c
= add_com ("jump", class_run
, jump_command
, _("\
2378 Continue program being debugged at specified line or address.\n\
2379 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2380 for an address to start at."));
2381 set_cmd_completer (c
, location_completer
);
2385 c
= add_com ("go", class_run
, go_command
, _("\
2386 Usage: go <location>\n\
2387 Continue program being debugged, stopping at specified line or \n\
2389 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2390 expression for an address to start at.\n\
2391 This command is a combination of tbreak and jump."));
2392 set_cmd_completer (c
, location_completer
);
2396 add_com_alias ("g", "go", class_run
, 1);
2398 c
= add_com ("continue", class_run
, continue_command
, _("\
2399 Continue program being debugged, after signal or breakpoint.\n\
2400 If proceeding from breakpoint, a number N may be used as an argument,\n\
2401 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2402 the breakpoint won't break until the Nth time it is reached).\n\
2404 If non-stop mode is enabled, continue only the current thread,\n\
2405 otherwise all the threads in the program are continued. To \n\
2406 continue all stopped threads in non-stop mode, use the -a option.\n\
2407 Specifying -a and an ignore count simultaneously is an error."));
2408 add_com_alias ("c", "cont", class_run
, 1);
2409 add_com_alias ("fg", "cont", class_run
, 1);
2411 c
= add_com ("run", class_run
, run_command
, _("\
2412 Start debugged program. You may specify arguments to give it.\n\
2413 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2414 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2415 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2416 To cancel previous arguments and run with no arguments,\n\
2417 use \"set args\" without arguments."));
2418 set_cmd_completer (c
, filename_completer
);
2419 add_com_alias ("r", "run", class_run
, 1);
2421 add_com ("R", class_run
, run_no_args_command
,
2422 _("Start debugged program with no arguments."));
2424 c
= add_com ("start", class_run
, start_command
, _("\
2425 Run the debugged program until the beginning of the main procedure.\n\
2426 You may specify arguments to give to your program, just as with the\n\
2427 \"run\" command."));
2428 set_cmd_completer (c
, filename_completer
);
2430 c
= add_com ("interrupt", class_run
, interrupt_target_command
,
2431 _("Interrupt the execution of the debugged program.\n\
2432 If non-stop mode is enabled, interrupt only the current thread,\n\
2433 otherwise all the threads in the program are stopped. To \n\
2434 interrupt all running threads in non-stop mode, use the -a option."));
2436 add_info ("registers", nofp_registers_info
, _("\
2437 List of integer registers and their contents, for selected stack frame.\n\
2438 Register name as argument means describe only that register."));
2439 add_info_alias ("r", "registers", 1);
2442 add_com ("lr", class_info
, nofp_registers_info
, _("\
2443 List of integer registers and their contents, for selected stack frame.\n\
2444 Register name as argument means describe only that register."));
2445 add_info ("all-registers", all_registers_info
, _("\
2446 List of all registers and their contents, for selected stack frame.\n\
2447 Register name as argument means describe only that register."));
2449 add_info ("program", program_info
,
2450 _("Execution status of the program."));
2452 add_info ("float", float_info
,
2453 _("Print the status of the floating point unit\n"));
2455 add_info ("vector", vector_info
,
2456 _("Print the status of the vector unit\n"));
2458 inferior_environ
= make_environ ();
2459 init_environ (inferior_environ
);