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 /* Chain containing status of breakpoint(s) that we have stopped at. */
162 /* Flag indicating that a command has proceeded the inferior past the
163 current breakpoint. */
165 int breakpoint_proceeded
;
167 /* Nonzero if stopped due to a step command. */
171 /* Nonzero if stopped due to completion of a stack dummy routine. */
173 int stop_stack_dummy
;
175 /* Nonzero if stopped due to a random (unexpected) signal in inferior
178 int stopped_by_random_signal
;
180 enum step_over_calls_kind step_over_calls
;
182 /* If stepping, nonzero means step count is > 1
183 so don't print frame next time inferior stops
184 if it stops due to stepping. */
188 /* Environment to use for running inferior,
189 in format described in environ.h. */
191 struct gdb_environ
*inferior_environ
;
193 /* When set, no calls to target_resumed observer will be made. */
194 int suppress_resume_observer
= 0;
195 /* When set, normal_stop will not call the normal_stop observer. */
196 int suppress_stop_observer
= 0;
198 /* Accessor routines. */
201 set_inferior_io_terminal (const char *terminal_name
)
203 if (inferior_io_terminal
)
204 xfree (inferior_io_terminal
);
207 inferior_io_terminal
= NULL
;
209 inferior_io_terminal
= savestring (terminal_name
, strlen (terminal_name
));
213 get_inferior_io_terminal (void)
215 return inferior_io_terminal
;
219 get_inferior_args (void)
221 if (inferior_argc
!= 0)
225 n
= gdbarch_construct_inferior_arguments (current_gdbarch
,
226 inferior_argc
, inferior_argv
);
227 old
= set_inferior_args (n
);
231 if (inferior_args
== NULL
)
232 inferior_args
= xstrdup ("");
234 return inferior_args
;
238 set_inferior_args (char *newargs
)
240 char *saved_args
= inferior_args
;
242 inferior_args
= newargs
;
250 set_inferior_args_vector (int argc
, char **argv
)
252 inferior_argc
= argc
;
253 inferior_argv
= argv
;
256 /* Notice when `set args' is run. */
258 notice_args_set (char *args
, int from_tty
, struct cmd_list_element
*c
)
264 /* Notice when `show args' is run. */
266 notice_args_read (struct ui_file
*file
, int from_tty
,
267 struct cmd_list_element
*c
, const char *value
)
269 /* Note that we ignore the passed-in value in favor of computing it
271 deprecated_show_value_hack (file
, from_tty
, c
, get_inferior_args ());
275 /* Compute command-line string given argument vector. This does the
276 same shell processing as fork_inferior. */
278 construct_inferior_arguments (struct gdbarch
*gdbarch
, int argc
, char **argv
)
282 if (STARTUP_WITH_SHELL
)
284 /* This holds all the characters considered special to the
285 typical Unix shells. We include `^' because the SunOS
286 /bin/sh treats it as a synonym for `|'. */
287 char *special
= "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
292 /* We over-compute the size. It shouldn't matter. */
293 for (i
= 0; i
< argc
; ++i
)
294 length
+= 2 * strlen (argv
[i
]) + 1 + 2 * (argv
[i
][0] == '\0');
296 result
= (char *) xmalloc (length
);
299 for (i
= 0; i
< argc
; ++i
)
304 /* Need to handle empty arguments specially. */
305 if (argv
[i
][0] == '\0')
312 for (cp
= argv
[i
]; *cp
; ++cp
)
314 if (strchr (special
, *cp
) != NULL
)
324 /* In this case we can't handle arguments that contain spaces,
325 tabs, or newlines -- see breakup_args(). */
329 for (i
= 0; i
< argc
; ++i
)
331 char *cp
= strchr (argv
[i
], ' ');
333 cp
= strchr (argv
[i
], '\t');
335 cp
= strchr (argv
[i
], '\n');
337 error (_("can't handle command-line argument containing whitespace"));
338 length
+= strlen (argv
[i
]) + 1;
341 result
= (char *) xmalloc (length
);
343 for (i
= 0; i
< argc
; ++i
)
346 strcat (result
, " ");
347 strcat (result
, argv
[i
]);
355 /* This function detects whether or not a '&' character (indicating
356 background execution) has been added as *the last* of the arguments ARGS
357 of a command. If it has, it removes it and returns 1. Otherwise it
358 does nothing and returns 0. */
360 strip_bg_char (char **args
)
364 p
= strchr (*args
, '&');
368 if (p
== (*args
+ strlen (*args
) - 1))
370 if (strlen (*args
) > 1)
374 while (*p
== ' ' || *p
== '\t');
386 tty_command (char *file
, int from_tty
)
389 error_no_arg (_("terminal name for running target process"));
391 set_inferior_io_terminal (file
);
394 /* Common actions to take after creating any sort of inferior, by any
395 means (running, attaching, connecting, et cetera). The target
396 should be stopped. */
399 post_create_inferior (struct target_ops
*target
, int from_tty
)
401 /* Be sure we own the terminal in case write operations are performed. */
402 target_terminal_ours ();
404 /* If the target hasn't taken care of this already, do it now.
405 Targets which need to access registers during to_open,
406 to_create_inferior, or to_attach should do it earlier; but many
408 target_find_description ();
412 /* Sometimes the platform-specific hook loads initial shared
413 libraries, and sometimes it doesn't. Try to do so first, so
414 that we can add them with the correct value for FROM_TTY.
415 If we made all the inferior hook methods consistent,
416 this call could be removed. */
418 SOLIB_ADD (NULL
, from_tty
, target
, auto_solib_add
);
420 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
423 /* Create the hooks to handle shared library load and unload
425 #ifdef SOLIB_CREATE_INFERIOR_HOOK
426 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid
));
428 solib_create_inferior_hook ();
432 observer_notify_inferior_created (target
, from_tty
);
435 /* Kill the inferior if already running. This function is designed
436 to be called when we are about to start the execution of the program
437 from the beginning. Ask the user to confirm that he wants to restart
438 the program being debugged when FROM_TTY is non-null. */
441 kill_if_already_running (int from_tty
)
443 if (! ptid_equal (inferior_ptid
, null_ptid
) && target_has_execution
)
445 /* Bail out before killing the program if we will not be able to
447 target_require_runnable ();
450 && !query ("The program being debugged has been started already.\n\
451 Start it from the beginning? "))
452 error (_("Program not restarted."));
454 no_shared_libraries (NULL
, from_tty
);
455 init_wait_for_inferior ();
459 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
460 a temporary breakpoint at the begining of the main program before
461 running the program. */
464 run_command_1 (char *args
, int from_tty
, int tbreak_at_main
)
470 kill_if_already_running (from_tty
);
471 clear_breakpoint_hit_counts ();
473 /* Clean up any leftovers from other runs. Some other things from
474 this function should probably be moved into target_pre_inferior. */
475 target_pre_inferior (from_tty
);
477 /* The comment here used to read, "The exec file is re-read every
478 time we do a generic_mourn_inferior, so we just have to worry
479 about the symbol file." The `generic_mourn_inferior' function
480 gets called whenever the program exits. However, suppose the
481 program exits, and *then* the executable file changes? We need
482 to check again here. Since reopen_exec_file doesn't do anything
483 if the timestamp hasn't changed, I don't see the harm. */
487 /* Insert the temporary breakpoint if a location was specified. */
489 tbreak_command (main_name (), 0);
491 exec_file
= (char *) get_exec_file (0);
493 if (non_stop
&& !target_supports_non_stop ())
494 error (_("The target does not support running in non-stop mode."));
496 /* We keep symbols from add-symbol-file, on the grounds that the
497 user might want to add some symbols before running the program
498 (right?). But sometimes (dynamic loading where the user manually
499 introduces the new symbols with add-symbol-file), the code which
500 the symbols describe does not persist between runs. Currently
501 the user has to manually nuke all symbols between runs if they
502 want them to go away (PR 2207). This is probably reasonable. */
506 if (target_can_async_p ())
507 async_disable_stdin ();
511 int async_exec
= strip_bg_char (&args
);
513 /* If we get a request for running in the bg but the target
514 doesn't support it, error out. */
515 if (async_exec
&& !target_can_async_p ())
516 error (_("Asynchronous execution not supported on this target."));
518 /* If we don't get a request of running in the bg, then we need
519 to simulate synchronous (fg) execution. */
520 if (!async_exec
&& target_can_async_p ())
522 /* Simulate synchronous execution */
523 async_disable_stdin ();
526 /* If there were other args, beside '&', process them. */
529 char *old_args
= set_inferior_args (xstrdup (args
));
536 ui_out_field_string (uiout
, NULL
, "Starting program");
537 ui_out_text (uiout
, ": ");
539 ui_out_field_string (uiout
, "execfile", exec_file
);
540 ui_out_spaces (uiout
, 1);
541 /* We call get_inferior_args() because we might need to compute
543 ui_out_field_string (uiout
, "infargs", get_inferior_args ());
544 ui_out_text (uiout
, "\n");
545 ui_out_flush (uiout
);
548 /* We call get_inferior_args() because we might need to compute
550 target_create_inferior (exec_file
, get_inferior_args (),
551 environ_vector (inferior_environ
), from_tty
);
553 /* Pass zero for FROM_TTY, because at this point the "run" command
554 has done its thing; now we are setting up the running program. */
555 post_create_inferior (¤t_target
, 0);
557 /* Start the target running. */
558 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
563 run_command (char *args
, int from_tty
)
565 run_command_1 (args
, from_tty
, 0);
569 run_no_args_command (char *args
, int from_tty
)
571 char *old_args
= set_inferior_args (xstrdup (""));
576 /* Start the execution of the program up until the beginning of the main
580 start_command (char *args
, int from_tty
)
582 /* Some languages such as Ada need to search inside the program
583 minimal symbols for the location where to put the temporary
584 breakpoint before starting. */
585 if (!have_minimal_symbols ())
586 error (_("No symbol table loaded. Use the \"file\" command."));
588 /* Run the program until reaching the main procedure... */
589 run_command_1 (args
, from_tty
, 1);
593 proceed_thread_callback (struct thread_info
*thread
, void *arg
)
595 if (!is_stopped (thread
->ptid
))
598 context_switch_to (thread
->ptid
);
599 clear_proceed_status ();
600 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
605 continue_1 (int all_threads
)
609 if (non_stop
&& all_threads
)
611 /* Don't error out if the current thread is running, because
612 there may be other stopped threads. */
613 struct cleanup
*old_chain
;
615 /* Backup current thread and selected frame. */
616 old_chain
= make_cleanup_restore_current_thread ();
618 iterate_over_threads (proceed_thread_callback
, NULL
);
620 /* Restore selected ptid. */
621 do_cleanups (old_chain
);
625 ensure_not_running ();
626 clear_proceed_status ();
627 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
631 /* continue [-a] [proceed-count] [&] */
633 continue_command (char *args
, int from_tty
)
639 /* Find out whether we must run in the background. */
641 async_exec
= strip_bg_char (&args
);
643 /* If we must run in the background, but the target can't do it,
645 if (async_exec
&& !target_can_async_p ())
646 error (_("Asynchronous execution not supported on this target."));
648 /* If we are not asked to run in the bg, then prepare to run in the
649 foreground, synchronously. */
650 if (!async_exec
&& target_can_async_p ())
652 /* Simulate synchronous execution */
653 async_disable_stdin ();
658 if (strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
661 args
+= sizeof ("-a") - 1;
667 if (!non_stop
&& all_threads
)
668 error (_("`-a' is meaningless in all-stop mode."));
670 if (args
!= NULL
&& all_threads
)
672 Can't resume all threads and specify proceed count simultaneously."));
674 /* If we have an argument left, set proceed count of breakpoint we
678 bpstat bs
= stop_bpstat
;
682 while ((stat
= bpstat_num (&bs
, &num
)) != 0)
685 set_ignore_count (num
,
686 parse_and_eval_long (args
) - 1,
688 /* set_ignore_count prints a message ending with a period.
689 So print two spaces before "Continuing.". */
691 printf_filtered (" ");
695 if (!stopped
&& from_tty
)
698 ("Not stopped at any breakpoint; argument ignored.\n");
703 printf_filtered (_("Continuing.\n"));
705 continue_1 (all_threads
);
708 /* Step until outside of current statement. */
711 step_command (char *count_string
, int from_tty
)
713 step_1 (0, 0, count_string
);
716 /* Likewise, but skip over subroutine calls as if single instructions. */
719 next_command (char *count_string
, int from_tty
)
721 step_1 (1, 0, count_string
);
724 /* Likewise, but step only one instruction. */
727 stepi_command (char *count_string
, int from_tty
)
729 step_1 (0, 1, count_string
);
733 nexti_command (char *count_string
, int from_tty
)
735 step_1 (1, 1, count_string
);
739 delete_longjmp_breakpoint_cleanup (void *arg
)
741 int thread
= * (int *) arg
;
742 delete_longjmp_breakpoint (thread
);
746 step_1 (int skip_subroutines
, int single_inst
, char *count_string
)
749 struct frame_info
*frame
;
750 struct cleanup
*cleanups
= make_cleanup (null_cleanup
, NULL
);
755 ensure_not_running ();
758 async_exec
= strip_bg_char (&count_string
);
760 /* If we get a request for running in the bg but the target
761 doesn't support it, error out. */
762 if (async_exec
&& !target_can_async_p ())
763 error (_("Asynchronous execution not supported on this target."));
765 /* If we don't get a request of running in the bg, then we need
766 to simulate synchronous (fg) execution. */
767 if (!async_exec
&& target_can_async_p ())
769 /* Simulate synchronous execution */
770 async_disable_stdin ();
773 count
= count_string
? parse_and_eval_long (count_string
) : 1;
775 if (!single_inst
|| skip_subroutines
) /* leave si command alone */
777 if (in_thread_list (inferior_ptid
))
778 thread
= pid_to_thread_id (inferior_ptid
);
780 set_longjmp_breakpoint ();
782 make_cleanup (delete_longjmp_breakpoint_cleanup
, &thread
);
785 /* In synchronous case, all is well, just use the regular for loop. */
786 if (!target_can_async_p ())
788 for (; count
> 0; count
--)
790 struct thread_info
*tp
= inferior_thread ();
791 clear_proceed_status ();
793 frame
= get_current_frame ();
794 tp
->step_frame_id
= get_frame_id (frame
);
798 find_pc_line_pc_range (stop_pc
,
799 &tp
->step_range_start
, &tp
->step_range_end
);
800 if (tp
->step_range_end
== 0)
803 if (find_pc_partial_function (stop_pc
, &name
,
804 &tp
->step_range_start
,
805 &tp
->step_range_end
) == 0)
806 error (_("Cannot find bounds of current function"));
808 target_terminal_ours ();
809 printf_filtered (_("\
810 Single stepping until exit from function %s, \n\
811 which has no line number information.\n"), name
);
816 /* Say we are stepping, but stop after one insn whatever it does. */
817 tp
->step_range_start
= tp
->step_range_end
= 1;
818 if (!skip_subroutines
)
820 Don't step over function calls, not even to functions lacking
822 step_over_calls
= STEP_OVER_NONE
;
825 if (skip_subroutines
)
826 step_over_calls
= STEP_OVER_ALL
;
828 step_multi
= (count
> 1);
829 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
835 do_cleanups (cleanups
);
838 /* In case of asynchronous target things get complicated, do only
839 one step for now, before returning control to the event loop. Let
840 the continuation figure out how many other steps we need to do,
841 and handle them one at the time, through step_once(). */
844 step_once (skip_subroutines
, single_inst
, count
, thread
);
845 /* We are running, and the continuation is installed. It will
846 disable the longjmp breakpoint as appropriate. */
847 discard_cleanups (cleanups
);
851 struct step_1_continuation_args
854 int skip_subroutines
;
859 /* Called after we are done with one step operation, to check whether
860 we need to step again, before we print the prompt and return control
861 to the user. If count is > 1, we will need to do one more call to
862 proceed(), via step_once(). Basically it is like step_once and
863 step_1_continuation are co-recursive. */
865 step_1_continuation (void *args
)
867 struct step_1_continuation_args
*a
= args
;
869 if (!step_multi
|| !stop_step
)
871 /* If we stopped for some reason that is not stepping there are
872 no further steps to make. Cleanup. */
873 if (!a
->single_inst
|| a
->skip_subroutines
)
874 delete_longjmp_breakpoint (a
->thread
);
878 step_once (a
->skip_subroutines
, a
->single_inst
, a
->count
- 1, a
->thread
);
881 /* Do just one step operation. If count >1 we will have to set up a
882 continuation to be done after the target stops (after this one
883 step). This is useful to implement the 'step n' kind of commands, in
884 case of asynchronous targets. We had to split step_1 into two parts,
885 one to be done before proceed() and one afterwards. This function is
886 called in case of step n with n>1, after the first step operation has
889 step_once (int skip_subroutines
, int single_inst
, int count
, int thread
)
891 struct frame_info
*frame
;
892 struct step_1_continuation_args
*args
;
896 /* Don't assume THREAD is a valid thread id. It is set to -1 if
897 the longjmp breakpoint was not required. Use the
898 INFERIOR_PTID thread instead, which is the same thread when
900 struct thread_info
*tp
= inferior_thread ();
901 clear_proceed_status ();
903 frame
= get_current_frame ();
904 if (!frame
) /* Avoid coredump here. Why tho? */
905 error (_("No current frame"));
906 tp
->step_frame_id
= get_frame_id (frame
);
910 find_pc_line_pc_range (stop_pc
,
911 &tp
->step_range_start
, &tp
->step_range_end
);
913 /* If we have no line info, switch to stepi mode. */
914 if (tp
->step_range_end
== 0 && step_stop_if_no_debug
)
916 tp
->step_range_start
= tp
->step_range_end
= 1;
918 else if (tp
->step_range_end
== 0)
921 if (find_pc_partial_function (stop_pc
, &name
,
922 &tp
->step_range_start
,
923 &tp
->step_range_end
) == 0)
924 error (_("Cannot find bounds of current function"));
926 target_terminal_ours ();
927 printf_filtered (_("\
928 Single stepping until exit from function %s, \n\
929 which has no line number information.\n"), name
);
934 /* Say we are stepping, but stop after one insn whatever it does. */
935 tp
->step_range_start
= tp
->step_range_end
= 1;
936 if (!skip_subroutines
)
938 Don't step over function calls, not even to functions lacking
940 step_over_calls
= STEP_OVER_NONE
;
943 if (skip_subroutines
)
944 step_over_calls
= STEP_OVER_ALL
;
946 step_multi
= (count
> 1);
947 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
949 args
= xmalloc (sizeof (*args
));
950 args
->skip_subroutines
= skip_subroutines
;
951 args
->single_inst
= single_inst
;
953 args
->thread
= thread
;
954 add_intermediate_continuation (step_1_continuation
, args
, xfree
);
959 /* Continue program at specified address. */
962 jump_command (char *arg
, int from_tty
)
965 struct symtabs_and_lines sals
;
966 struct symtab_and_line sal
;
972 ensure_not_running ();
974 /* Find out whether we must run in the background. */
976 async_exec
= strip_bg_char (&arg
);
978 /* If we must run in the background, but the target can't do it,
980 if (async_exec
&& !target_can_async_p ())
981 error (_("Asynchronous execution not supported on this target."));
984 error_no_arg (_("starting address"));
986 sals
= decode_line_spec_1 (arg
, 1);
989 error (_("Unreasonable jump request"));
995 if (sal
.symtab
== 0 && sal
.pc
== 0)
996 error (_("No source file has been specified."));
998 resolve_sal_pc (&sal
); /* May error out */
1000 /* See if we are trying to jump to another function. */
1001 fn
= get_frame_function (get_current_frame ());
1002 sfn
= find_pc_function (sal
.pc
);
1003 if (fn
!= NULL
&& sfn
!= fn
)
1005 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal
.line
,
1006 SYMBOL_PRINT_NAME (fn
)))
1008 error (_("Not confirmed."));
1015 fixup_symbol_section (sfn
, 0);
1016 if (section_is_overlay (SYMBOL_OBJ_SECTION (sfn
)) &&
1017 !section_is_mapped (SYMBOL_OBJ_SECTION (sfn
)))
1019 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
1021 error (_("Not confirmed."));
1031 printf_filtered (_("Continuing at "));
1032 fputs_filtered (paddress (addr
), gdb_stdout
);
1033 printf_filtered (".\n");
1036 /* If we are not asked to run in the bg, then prepare to run in the
1037 foreground, synchronously. */
1038 if (!async_exec
&& target_can_async_p ())
1040 /* Simulate synchronous execution */
1041 async_disable_stdin ();
1044 clear_proceed_status ();
1045 proceed (addr
, TARGET_SIGNAL_0
, 0);
1049 /* Go to line or address in current procedure */
1051 go_command (char *line_no
, int from_tty
)
1053 if (line_no
== (char *) NULL
|| !*line_no
)
1054 printf_filtered (GO_USAGE
);
1057 tbreak_command (line_no
, from_tty
);
1058 jump_command (line_no
, from_tty
);
1063 /* Continue program giving it specified signal. */
1066 signal_command (char *signum_exp
, int from_tty
)
1068 enum target_signal oursig
;
1071 dont_repeat (); /* Too dangerous. */
1073 ensure_not_running ();
1075 /* Find out whether we must run in the background. */
1076 if (signum_exp
!= NULL
)
1077 async_exec
= strip_bg_char (&signum_exp
);
1079 /* If we must run in the background, but the target can't do it,
1081 if (async_exec
&& !target_can_async_p ())
1082 error (_("Asynchronous execution not supported on this target."));
1084 /* If we are not asked to run in the bg, then prepare to run in the
1085 foreground, synchronously. */
1086 if (!async_exec
&& target_can_async_p ())
1088 /* Simulate synchronous execution. */
1089 async_disable_stdin ();
1093 error_no_arg (_("signal number"));
1095 /* It would be even slicker to make signal names be valid expressions,
1096 (the type could be "enum $signal" or some such), then the user could
1097 assign them to convenience variables. */
1098 oursig
= target_signal_from_name (signum_exp
);
1100 if (oursig
== TARGET_SIGNAL_UNKNOWN
)
1102 /* No, try numeric. */
1103 int num
= parse_and_eval_long (signum_exp
);
1106 oursig
= TARGET_SIGNAL_0
;
1108 oursig
= target_signal_from_command (num
);
1113 if (oursig
== TARGET_SIGNAL_0
)
1114 printf_filtered (_("Continuing with no signal.\n"));
1116 printf_filtered (_("Continuing with signal %s.\n"),
1117 target_signal_to_name (oursig
));
1120 clear_proceed_status ();
1121 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1122 FIXME: Neither should "signal foo" but when I tried passing
1123 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1124 tried to track down yet. */
1125 proceed (oursig
== TARGET_SIGNAL_0
? (CORE_ADDR
) -1 : stop_pc
, oursig
, 0);
1128 /* Proceed until we reach a different source line with pc greater than
1129 our current one or exit the function. We skip calls in both cases.
1131 Note that eventually this command should probably be changed so
1132 that only source lines are printed out when we hit the breakpoint
1133 we set. This may involve changes to wait_for_inferior and the
1134 proceed status code. */
1137 until_next_command (int from_tty
)
1139 struct frame_info
*frame
;
1141 struct symbol
*func
;
1142 struct symtab_and_line sal
;
1143 struct thread_info
*tp
= inferior_thread ();
1145 clear_proceed_status ();
1147 frame
= get_current_frame ();
1149 /* Step until either exited from this function or greater
1150 than the current line (if in symbolic section) or pc (if
1154 func
= find_pc_function (pc
);
1158 struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (pc
);
1160 if (msymbol
== NULL
)
1161 error (_("Execution is not within a known function."));
1163 tp
->step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
1164 tp
->step_range_end
= pc
;
1168 sal
= find_pc_line (pc
, 0);
1170 tp
->step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
1171 tp
->step_range_end
= sal
.end
;
1174 step_over_calls
= STEP_OVER_ALL
;
1175 tp
->step_frame_id
= get_frame_id (frame
);
1177 step_multi
= 0; /* Only one call to proceed */
1179 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
1183 until_command (char *arg
, int from_tty
)
1187 if (!target_has_execution
)
1188 error (_("The program is not running."));
1190 /* Find out whether we must run in the background. */
1192 async_exec
= strip_bg_char (&arg
);
1194 /* If we must run in the background, but the target can't do it,
1196 if (async_exec
&& !target_can_async_p ())
1197 error (_("Asynchronous execution not supported on this target."));
1199 /* If we are not asked to run in the bg, then prepare to run in the
1200 foreground, synchronously. */
1201 if (!async_exec
&& target_can_async_p ())
1203 /* Simulate synchronous execution */
1204 async_disable_stdin ();
1208 until_break_command (arg
, from_tty
, 0);
1210 until_next_command (from_tty
);
1214 advance_command (char *arg
, int from_tty
)
1218 if (!target_has_execution
)
1219 error (_("The program is not running."));
1222 error_no_arg (_("a location"));
1224 /* Find out whether we must run in the background. */
1226 async_exec
= strip_bg_char (&arg
);
1228 /* If we must run in the background, but the target can't do it,
1230 if (async_exec
&& !target_can_async_p ())
1231 error (_("Asynchronous execution not supported on this target."));
1233 /* If we are not asked to run in the bg, then prepare to run in the
1234 foreground, synchronously. */
1235 if (!async_exec
&& target_can_async_p ())
1237 /* Simulate synchronous execution. */
1238 async_disable_stdin ();
1241 until_break_command (arg
, from_tty
, 1);
1244 /* Print the result of a function at the end of a 'finish' command. */
1247 print_return_value (struct type
*func_type
, struct type
*value_type
)
1249 struct gdbarch
*gdbarch
= current_gdbarch
;
1250 struct cleanup
*old_chain
;
1251 struct ui_stream
*stb
;
1252 struct value
*value
;
1254 CHECK_TYPEDEF (value_type
);
1255 gdb_assert (TYPE_CODE (value_type
) != TYPE_CODE_VOID
);
1257 /* FIXME: 2003-09-27: When returning from a nested inferior function
1258 call, it's possible (with no help from the architecture vector)
1259 to locate and return/print a "struct return" value. This is just
1260 a more complicated case of what is already being done in in the
1261 inferior function call code. In fact, when inferior function
1262 calls are made async, this will likely be made the norm. */
1264 switch (gdbarch_return_value (gdbarch
, func_type
, value_type
,
1267 case RETURN_VALUE_REGISTER_CONVENTION
:
1268 case RETURN_VALUE_ABI_RETURNS_ADDRESS
:
1269 case RETURN_VALUE_ABI_PRESERVES_ADDRESS
:
1270 value
= allocate_value (value_type
);
1271 gdbarch_return_value (gdbarch
, func_type
, value_type
, stop_registers
,
1272 value_contents_raw (value
), NULL
);
1274 case RETURN_VALUE_STRUCT_CONVENTION
:
1278 internal_error (__FILE__
, __LINE__
, _("bad switch"));
1284 stb
= ui_out_stream_new (uiout
);
1285 old_chain
= make_cleanup_ui_out_stream_delete (stb
);
1286 ui_out_text (uiout
, "Value returned is ");
1287 ui_out_field_fmt (uiout
, "gdb-result-var", "$%d",
1288 record_latest_value (value
));
1289 ui_out_text (uiout
, " = ");
1290 value_print (value
, stb
->stream
, 0, Val_no_prettyprint
);
1291 ui_out_field_stream (uiout
, "return-value", stb
);
1292 ui_out_text (uiout
, "\n");
1293 do_cleanups (old_chain
);
1297 ui_out_text (uiout
, "Value returned has type: ");
1298 ui_out_field_string (uiout
, "return-type", TYPE_NAME (value_type
));
1299 ui_out_text (uiout
, ".");
1300 ui_out_text (uiout
, " Cannot determine contents\n");
1304 /* Stuff that needs to be done by the finish command after the target
1305 has stopped. In asynchronous mode, we wait for the target to stop
1306 in the call to poll or select in the event loop, so it is
1307 impossible to do all the stuff as part of the finish_command
1308 function itself. The only chance we have to complete this command
1309 is in fetch_inferior_event, which is called by the event loop as
1310 soon as it detects that the target has stopped. This function is
1311 called via the cmd_continuation pointer. */
1313 struct finish_command_continuation_args
1315 struct breakpoint
*breakpoint
;
1316 struct symbol
*function
;
1320 finish_command_continuation (void *arg
)
1322 struct finish_command_continuation_args
*a
= arg
;
1324 if (bpstat_find_breakpoint (stop_bpstat
, a
->breakpoint
) != NULL
1325 && a
->function
!= NULL
)
1327 struct type
*value_type
;
1329 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (a
->function
));
1331 internal_error (__FILE__
, __LINE__
,
1332 _("finish_command: function has no target type"));
1334 if (TYPE_CODE (value_type
) != TYPE_CODE_VOID
)
1335 print_return_value (SYMBOL_TYPE (a
->function
), value_type
);
1338 /* We suppress normal call of normal_stop observer and do it here so
1339 that that *stopped notification includes the return value. */
1340 /* NOTE: This is broken in non-stop mode. There is no guarantee the
1341 next stop will be in the same thread that we started doing a
1342 finish on. This suppressing (or some other replacement means)
1343 should be a thread property. */
1344 observer_notify_normal_stop (stop_bpstat
);
1345 suppress_stop_observer
= 0;
1346 delete_breakpoint (a
->breakpoint
);
1350 finish_command_continuation_free_arg (void *arg
)
1352 /* NOTE: See finish_command_continuation. This would go away, if
1353 this suppressing is made a thread property. */
1354 suppress_stop_observer
= 0;
1358 /* "finish": Set a temporary breakpoint at the place the selected
1359 frame will return to, then continue. */
1362 finish_command (char *arg
, int from_tty
)
1364 struct symtab_and_line sal
;
1365 struct frame_info
*frame
;
1366 struct symbol
*function
;
1367 struct breakpoint
*breakpoint
;
1368 struct cleanup
*old_chain
;
1369 struct finish_command_continuation_args
*cargs
;
1373 /* Find out whether we must run in the background. */
1375 async_exec
= strip_bg_char (&arg
);
1377 /* If we must run in the background, but the target can't do it,
1379 if (async_exec
&& !target_can_async_p ())
1380 error (_("Asynchronous execution not supported on this target."));
1382 /* If we are not asked to run in the bg, then prepare to run in the
1383 foreground, synchronously. */
1384 if (!async_exec
&& target_can_async_p ())
1386 /* Simulate synchronous execution. */
1387 async_disable_stdin ();
1391 error (_("The \"finish\" command does not take any arguments."));
1392 if (!target_has_execution
)
1393 error (_("The program is not running."));
1395 frame
= get_prev_frame (get_selected_frame (_("No selected frame.")));
1397 error (_("\"finish\" not meaningful in the outermost frame."));
1399 clear_proceed_status ();
1401 sal
= find_pc_line (get_frame_pc (frame
), 0);
1402 sal
.pc
= get_frame_pc (frame
);
1404 breakpoint
= set_momentary_breakpoint (sal
, get_frame_id (frame
), bp_finish
);
1406 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1408 /* Find the function we will return from. */
1410 function
= find_pc_function (get_frame_pc (get_selected_frame (NULL
)));
1412 /* Print info on the selected frame, including level number but not
1416 printf_filtered (_("Run till exit from "));
1417 print_stack_frame (get_selected_frame (NULL
), 1, LOCATION
);
1420 proceed_to_finish
= 1; /* We want stop_registers, please... */
1421 make_cleanup_restore_integer (&suppress_stop_observer
);
1422 suppress_stop_observer
= 1;
1423 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1425 cargs
= xmalloc (sizeof (*cargs
));
1427 cargs
->breakpoint
= breakpoint
;
1428 cargs
->function
= function
;
1429 add_continuation (finish_command_continuation
, cargs
,
1430 finish_command_continuation_free_arg
);
1432 discard_cleanups (old_chain
);
1433 if (!target_can_async_p ())
1434 do_all_continuations ();
1439 program_info (char *args
, int from_tty
)
1441 bpstat bs
= stop_bpstat
;
1443 int stat
= bpstat_num (&bs
, &num
);
1445 if (!target_has_execution
)
1447 printf_filtered (_("The program being debugged is not being run.\n"));
1451 target_files_info ();
1452 printf_filtered (_("Program stopped at %s.\n"),
1453 hex_string ((unsigned long) stop_pc
));
1455 printf_filtered (_("It stopped after being stepped.\n"));
1458 /* There may be several breakpoints in the same place, so this
1459 isn't as strange as it seems. */
1464 printf_filtered (_("\
1465 It stopped at a breakpoint that has since been deleted.\n"));
1468 printf_filtered (_("It stopped at breakpoint %d.\n"), num
);
1469 stat
= bpstat_num (&bs
, &num
);
1472 else if (stop_signal
!= TARGET_SIGNAL_0
)
1474 printf_filtered (_("It stopped with signal %s, %s.\n"),
1475 target_signal_to_name (stop_signal
),
1476 target_signal_to_string (stop_signal
));
1481 printf_filtered (_("\
1482 Type \"info stack\" or \"info registers\" for more information.\n"));
1487 environment_info (char *var
, int from_tty
)
1491 char *val
= get_in_environ (inferior_environ
, var
);
1494 puts_filtered (var
);
1495 puts_filtered (" = ");
1496 puts_filtered (val
);
1497 puts_filtered ("\n");
1501 puts_filtered ("Environment variable \"");
1502 puts_filtered (var
);
1503 puts_filtered ("\" not defined.\n");
1508 char **vector
= environ_vector (inferior_environ
);
1511 puts_filtered (*vector
++);
1512 puts_filtered ("\n");
1518 set_environment_command (char *arg
, int from_tty
)
1520 char *p
, *val
, *var
;
1524 error_no_arg (_("environment variable and value"));
1526 /* Find seperation between variable name and value */
1527 p
= (char *) strchr (arg
, '=');
1528 val
= (char *) strchr (arg
, ' ');
1530 if (p
!= 0 && val
!= 0)
1532 /* We have both a space and an equals. If the space is before the
1533 equals, walk forward over the spaces til we see a nonspace
1534 (possibly the equals). */
1539 /* Now if the = is after the char following the spaces,
1540 take the char following the spaces. */
1544 else if (val
!= 0 && p
== 0)
1548 error_no_arg (_("environment variable to set"));
1550 if (p
== 0 || p
[1] == 0)
1554 p
= arg
+ strlen (arg
); /* So that savestring below will work */
1558 /* Not setting variable value to null */
1560 while (*val
== ' ' || *val
== '\t')
1564 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t'))
1567 var
= savestring (arg
, p
- arg
);
1570 printf_filtered (_("\
1571 Setting environment variable \"%s\" to null value.\n"),
1573 set_in_environ (inferior_environ
, var
, "");
1576 set_in_environ (inferior_environ
, var
, val
);
1581 unset_environment_command (char *var
, int from_tty
)
1585 /* If there is no argument, delete all environment variables.
1586 Ask for confirmation if reading from the terminal. */
1587 if (!from_tty
|| query (_("Delete all environment variables? ")))
1589 free_environ (inferior_environ
);
1590 inferior_environ
= make_environ ();
1594 unset_in_environ (inferior_environ
, var
);
1597 /* Handle the execution path (PATH variable) */
1599 static const char path_var_name
[] = "PATH";
1602 path_info (char *args
, int from_tty
)
1604 puts_filtered ("Executable and object file path: ");
1605 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
1606 puts_filtered ("\n");
1609 /* Add zero or more directories to the front of the execution path. */
1612 path_command (char *dirname
, int from_tty
)
1617 env
= get_in_environ (inferior_environ
, path_var_name
);
1618 /* Can be null if path is not set */
1621 exec_path
= xstrdup (env
);
1622 mod_path (dirname
, &exec_path
);
1623 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
1626 path_info ((char *) NULL
, from_tty
);
1630 /* Print out the machine register regnum. If regnum is -1, print all
1631 registers (print_all == 1) or all non-float and non-vector
1632 registers (print_all == 0).
1634 For most machines, having all_registers_info() print the
1635 register(s) one per line is good enough. If a different format is
1636 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1637 regs), or there is an existing convention for showing all the
1638 registers, define the architecture method PRINT_REGISTERS_INFO to
1639 provide that format. */
1642 default_print_registers_info (struct gdbarch
*gdbarch
,
1643 struct ui_file
*file
,
1644 struct frame_info
*frame
,
1645 int regnum
, int print_all
)
1648 const int numregs
= gdbarch_num_regs (gdbarch
)
1649 + gdbarch_num_pseudo_regs (gdbarch
);
1650 gdb_byte buffer
[MAX_REGISTER_SIZE
];
1652 for (i
= 0; i
< numregs
; i
++)
1654 /* Decide between printing all regs, non-float / vector regs, or
1660 if (!gdbarch_register_reggroup_p (gdbarch
, i
, all_reggroup
))
1665 if (!gdbarch_register_reggroup_p (gdbarch
, i
, general_reggroup
))
1675 /* If the register name is empty, it is undefined for this
1676 processor, so don't display anything. */
1677 if (gdbarch_register_name (gdbarch
, i
) == NULL
1678 || *(gdbarch_register_name (gdbarch
, i
)) == '\0')
1681 fputs_filtered (gdbarch_register_name (gdbarch
, i
), file
);
1682 print_spaces_filtered (15 - strlen (gdbarch_register_name
1683 (gdbarch
, i
)), file
);
1685 /* Get the data in raw format. */
1686 if (! frame_register_read (frame
, i
, buffer
))
1688 fprintf_filtered (file
, "*value not available*\n");
1692 /* If virtual format is floating, print it that way, and in raw
1694 if (TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_FLT
1695 || TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_DECFLOAT
)
1699 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1700 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1702 fprintf_filtered (file
, "\t(raw 0x");
1703 for (j
= 0; j
< register_size (gdbarch
, i
); j
++)
1706 if (gdbarch_byte_order (gdbarch
) == BFD_ENDIAN_BIG
)
1709 idx
= register_size (gdbarch
, i
) - 1 - j
;
1710 fprintf_filtered (file
, "%02x", (unsigned char) buffer
[idx
]);
1712 fprintf_filtered (file
, ")");
1716 /* Print the register in hex. */
1717 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1718 file
, 'x', 1, 0, Val_pretty_default
, current_language
);
1719 /* If not a vector register, print it also according to its
1721 if (TYPE_VECTOR (register_type (gdbarch
, i
)) == 0)
1723 fprintf_filtered (file
, "\t");
1724 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1725 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1729 fprintf_filtered (file
, "\n");
1734 registers_info (char *addr_exp
, int fpregs
)
1736 struct frame_info
*frame
;
1737 struct gdbarch
*gdbarch
;
1738 int regnum
, numregs
;
1741 if (!target_has_registers
)
1742 error (_("The program has no registers now."));
1743 frame
= get_selected_frame (NULL
);
1744 gdbarch
= get_frame_arch (frame
);
1748 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1753 while (*addr_exp
!= '\0')
1758 /* Keep skipping leading white space. */
1759 if (isspace ((*addr_exp
)))
1765 /* Discard any leading ``$''. Check that there is something
1766 resembling a register following it. */
1767 if (addr_exp
[0] == '$')
1769 if (isspace ((*addr_exp
)) || (*addr_exp
) == '\0')
1770 error (_("Missing register name"));
1772 /* Find the start/end of this register name/num/group. */
1774 while ((*addr_exp
) != '\0' && !isspace ((*addr_exp
)))
1778 /* Figure out what we've found and display it. */
1780 /* A register name? */
1782 int regnum
= user_reg_map_name_to_regnum (gdbarch
, start
, end
- start
);
1785 /* User registers lie completely outside of the range of
1786 normal registers. Catch them early so that the target
1788 if (regnum
>= gdbarch_num_regs (gdbarch
)
1789 + gdbarch_num_pseudo_regs (gdbarch
))
1791 struct value
*val
= value_of_user_reg (regnum
, frame
);
1793 printf_filtered ("%s: ", start
);
1794 print_scalar_formatted (value_contents (val
),
1795 check_typedef (value_type (val
)),
1796 'x', 0, gdb_stdout
);
1797 printf_filtered ("\n");
1800 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1801 frame
, regnum
, fpregs
);
1806 /* A register number? (how portable is this one?). */
1809 int regnum
= strtol (start
, &endptr
, 0);
1812 && regnum
< gdbarch_num_regs (gdbarch
)
1813 + gdbarch_num_pseudo_regs (gdbarch
))
1815 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1816 frame
, regnum
, fpregs
);
1821 /* A register group? */
1823 struct reggroup
*group
;
1824 for (group
= reggroup_next (gdbarch
, NULL
);
1826 group
= reggroup_next (gdbarch
, group
))
1828 /* Don't bother with a length check. Should the user
1829 enter a short register group name, go with the first
1830 group that matches. */
1831 if (strncmp (start
, reggroup_name (group
), end
- start
) == 0)
1838 regnum
< gdbarch_num_regs (gdbarch
)
1839 + gdbarch_num_pseudo_regs (gdbarch
);
1842 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
1843 gdbarch_print_registers_info (gdbarch
,
1851 /* Nothing matched. */
1852 error (_("Invalid register `%.*s'"), (int) (end
- start
), start
);
1857 all_registers_info (char *addr_exp
, int from_tty
)
1859 registers_info (addr_exp
, 1);
1863 nofp_registers_info (char *addr_exp
, int from_tty
)
1865 registers_info (addr_exp
, 0);
1869 print_vector_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
1870 struct frame_info
*frame
, const char *args
)
1872 if (gdbarch_print_vector_info_p (gdbarch
))
1873 gdbarch_print_vector_info (gdbarch
, file
, frame
, args
);
1877 int printed_something
= 0;
1880 regnum
< gdbarch_num_regs (gdbarch
)
1881 + gdbarch_num_pseudo_regs (gdbarch
);
1884 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, vector_reggroup
))
1886 printed_something
= 1;
1887 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
1890 if (!printed_something
)
1891 fprintf_filtered (file
, "No vector information\n");
1896 vector_info (char *args
, int from_tty
)
1898 if (!target_has_registers
)
1899 error (_("The program has no registers now."));
1901 print_vector_info (current_gdbarch
, gdb_stdout
,
1902 get_selected_frame (NULL
), args
);
1908 * Should save/restore the tty state since it might be that the
1909 * program to be debugged was started on this tty and it wants
1910 * the tty in some state other than what we want. If it's running
1911 * on another terminal or without a terminal, then saving and
1912 * restoring the tty state is a harmless no-op.
1913 * This only needs to be done if we are attaching to a process.
1918 takes a program started up outside of gdb and ``attaches'' to it.
1919 This stops it cold in its tracks and allows us to start debugging it.
1920 and wait for the trace-trap that results from attaching. */
1923 attach_command_post_wait (char *args
, int from_tty
, int async_exec
)
1926 char *full_exec_path
= NULL
;
1928 stop_soon
= NO_STOP_QUIETLY
;
1930 /* If no exec file is yet known, try to determine it from the
1932 exec_file
= (char *) get_exec_file (0);
1935 exec_file
= target_pid_to_exec_file (PIDGET (inferior_ptid
));
1938 /* It's possible we don't have a full path, but rather just a
1939 filename. Some targets, such as HP-UX, don't provide the
1942 Attempt to qualify the filename against the source path.
1943 (If that fails, we'll just fall back on the original
1944 filename. Not much more we can do...)
1946 if (!source_full_path_of (exec_file
, &full_exec_path
))
1947 full_exec_path
= savestring (exec_file
, strlen (exec_file
));
1949 exec_file_attach (full_exec_path
, from_tty
);
1950 symbol_file_add_main (full_exec_path
, from_tty
);
1955 reopen_exec_file ();
1959 /* Take any necessary post-attaching actions for this platform. */
1960 target_post_attach (PIDGET (inferior_ptid
));
1962 post_create_inferior (¤t_target
, from_tty
);
1964 /* Install inferior's terminal modes. */
1965 target_terminal_inferior ();
1968 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
1971 if (target_can_async_p ())
1972 async_enable_stdin ();
1974 if (deprecated_attach_hook
)
1975 deprecated_attach_hook ();
1979 struct attach_command_continuation_args
1987 attach_command_continuation (void *args
)
1989 struct attach_command_continuation_args
*a
= args
;
1990 attach_command_post_wait (a
->args
, a
->from_tty
, a
->async_exec
);
1994 attach_command_continuation_free_args (void *args
)
1996 struct attach_command_continuation_args
*a
= args
;
2002 attach_command (char *args
, int from_tty
)
2005 char *full_exec_path
= NULL
;
2008 dont_repeat (); /* Not for the faint of heart */
2010 if (target_has_execution
)
2012 if (query ("A program is being debugged already. Kill it? "))
2015 error (_("Not killed."));
2018 /* Clean up any leftovers from other runs. Some other things from
2019 this function should probably be moved into target_pre_inferior. */
2020 target_pre_inferior (from_tty
);
2022 if (non_stop
&& !target_supports_non_stop ())
2023 error (_("Cannot attach to this target in non-stop mode"));
2027 async_exec
= strip_bg_char (&args
);
2029 /* If we get a request for running in the bg but the target
2030 doesn't support it, error out. */
2031 if (async_exec
&& !target_can_async_p ())
2032 error (_("Asynchronous execution not supported on this target."));
2035 /* If we don't get a request of running in the bg, then we need
2036 to simulate synchronous (fg) execution. */
2037 if (!async_exec
&& target_can_async_p ())
2039 /* Simulate synchronous execution */
2040 async_disable_stdin ();
2043 target_attach (args
, from_tty
);
2045 /* Set up the "saved terminal modes" of the inferior
2046 based on what modes we are starting it with. */
2047 target_terminal_init ();
2049 /* Set up execution context to know that we should return from
2050 wait_for_inferior as soon as the target reports a stop. */
2051 init_wait_for_inferior ();
2052 clear_proceed_status ();
2054 /* Some system don't generate traps when attaching to inferior.
2055 E.g. Mach 3 or GNU hurd. */
2056 if (!target_attach_no_wait
)
2058 /* Careful here. See comments in inferior.h. Basically some
2059 OSes don't ignore SIGSTOPs on continue requests anymore. We
2060 need a way for handle_inferior_event to reset the stop_signal
2061 variable after an attach, and this is what
2062 STOP_QUIETLY_NO_SIGSTOP is for. */
2063 stop_soon
= STOP_QUIETLY_NO_SIGSTOP
;
2065 if (target_can_async_p ())
2067 /* sync_execution mode. Wait for stop. */
2068 struct attach_command_continuation_args
*a
;
2070 a
= xmalloc (sizeof (*a
));
2071 a
->args
= xstrdup (args
);
2072 a
->from_tty
= from_tty
;
2073 a
->async_exec
= async_exec
;
2074 add_continuation (attach_command_continuation
, a
,
2075 attach_command_continuation_free_args
);
2079 wait_for_inferior (0);
2082 attach_command_post_wait (args
, from_tty
, async_exec
);
2087 * takes a program previously attached to and detaches it.
2088 * The program resumes execution and will no longer stop
2089 * on signals, etc. We better not have left any breakpoints
2090 * in the program or it'll die when it hits one. For this
2091 * to work, it may be necessary for the process to have been
2092 * previously attached. It *might* work if the program was
2093 * started via the normal ptrace (PTRACE_TRACEME).
2097 detach_command (char *args
, int from_tty
)
2099 dont_repeat (); /* Not for the faint of heart. */
2100 target_detach (args
, from_tty
);
2101 no_shared_libraries (NULL
, from_tty
);
2102 init_thread_list ();
2103 if (deprecated_detach_hook
)
2104 deprecated_detach_hook ();
2107 /* Disconnect from the current target without resuming it (leaving it
2108 waiting for a debugger).
2110 We'd better not have left any breakpoints in the program or the
2111 next debugger will get confused. Currently only supported for some
2112 remote targets, since the normal attach mechanisms don't work on
2113 stopped processes on some native platforms (e.g. GNU/Linux). */
2116 disconnect_command (char *args
, int from_tty
)
2118 dont_repeat (); /* Not for the faint of heart */
2119 target_disconnect (args
, from_tty
);
2120 no_shared_libraries (NULL
, from_tty
);
2121 init_thread_list ();
2122 if (deprecated_detach_hook
)
2123 deprecated_detach_hook ();
2127 interrupt_target_1 (int all_threads
)
2131 ptid
= minus_one_ptid
;
2133 ptid
= inferior_ptid
;
2137 /* Stop the execution of the target while running in async mode, in
2138 the backgound. In all-stop, stop the whole process. In non-stop
2139 mode, stop the current thread only by default, or stop all threads
2140 if the `-a' switch is used. */
2142 /* interrupt [-a] */
2144 interrupt_target_command (char *args
, int from_tty
)
2146 if (target_can_async_p ())
2148 int all_threads
= 0;
2150 dont_repeat (); /* Not for the faint of heart */
2153 && strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
2156 if (!non_stop
&& all_threads
)
2157 error (_("-a is meaningless in all-stop mode."));
2159 interrupt_target_1 (all_threads
);
2164 print_float_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
2165 struct frame_info
*frame
, const char *args
)
2167 if (gdbarch_print_float_info_p (gdbarch
))
2168 gdbarch_print_float_info (gdbarch
, file
, frame
, args
);
2172 int printed_something
= 0;
2175 regnum
< gdbarch_num_regs (gdbarch
)
2176 + gdbarch_num_pseudo_regs (gdbarch
);
2179 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, float_reggroup
))
2181 printed_something
= 1;
2182 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2185 if (!printed_something
)
2186 fprintf_filtered (file
, "\
2187 No floating-point info available for this processor.\n");
2192 float_info (char *args
, int from_tty
)
2194 if (!target_has_registers
)
2195 error (_("The program has no registers now."));
2197 print_float_info (current_gdbarch
, gdb_stdout
,
2198 get_selected_frame (NULL
), args
);
2202 unset_command (char *args
, int from_tty
)
2204 printf_filtered (_("\
2205 \"unset\" must be followed by the name of an unset subcommand.\n"));
2206 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
2210 _initialize_infcmd (void)
2212 struct cmd_list_element
*c
= NULL
;
2214 /* add the filename of the terminal connected to inferior I/O */
2215 add_setshow_filename_cmd ("inferior-tty", class_run
,
2216 &inferior_io_terminal
, _("\
2217 Set terminal for future runs of program being debugged."), _("\
2218 Show terminal for future runs of program being debugged."), _("\
2219 Usage: set inferior-tty /dev/pts/1"), NULL
, NULL
, &setlist
, &showlist
);
2220 add_com_alias ("tty", "set inferior-tty", class_alias
, 0);
2222 add_setshow_optional_filename_cmd ("args", class_run
,
2223 &inferior_args
, _("\
2224 Set argument list to give program being debugged when it is started."), _("\
2225 Show argument list to give program being debugged when it is started."), _("\
2226 Follow this command with any number of args, to be passed to the program."),
2229 &setlist
, &showlist
);
2231 c
= add_cmd ("environment", no_class
, environment_info
, _("\
2232 The environment to give the program, or one variable's value.\n\
2233 With an argument VAR, prints the value of environment variable VAR to\n\
2234 give the program being debugged. With no arguments, prints the entire\n\
2235 environment to be given to the program."), &showlist
);
2236 set_cmd_completer (c
, noop_completer
);
2238 add_prefix_cmd ("unset", no_class
, unset_command
,
2239 _("Complement to certain \"set\" commands."),
2240 &unsetlist
, "unset ", 0, &cmdlist
);
2242 c
= add_cmd ("environment", class_run
, unset_environment_command
, _("\
2243 Cancel environment variable VAR for the program.\n\
2244 This does not affect the program until the next \"run\" command."),
2246 set_cmd_completer (c
, noop_completer
);
2248 c
= add_cmd ("environment", class_run
, set_environment_command
, _("\
2249 Set environment variable value to give the program.\n\
2250 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2251 VALUES of environment variables are uninterpreted strings.\n\
2252 This does not affect the program until the next \"run\" command."),
2254 set_cmd_completer (c
, noop_completer
);
2256 c
= add_com ("path", class_files
, path_command
, _("\
2257 Add directory DIR(s) to beginning of search path for object files.\n\
2258 $cwd in the path means the current working directory.\n\
2259 This path is equivalent to the $PATH shell variable. It is a list of\n\
2260 directories, separated by colons. These directories are searched to find\n\
2261 fully linked executable files and separately compiled object files as needed."));
2262 set_cmd_completer (c
, filename_completer
);
2264 c
= add_cmd ("paths", no_class
, path_info
, _("\
2265 Current search path for finding object files.\n\
2266 $cwd in the path means the current working directory.\n\
2267 This path is equivalent to the $PATH shell variable. It is a list of\n\
2268 directories, separated by colons. These directories are searched to find\n\
2269 fully linked executable files and separately compiled object files as needed."),
2271 set_cmd_completer (c
, noop_completer
);
2273 add_com ("attach", class_run
, attach_command
, _("\
2274 Attach to a process or file outside of GDB.\n\
2275 This command attaches to another target, of the same type as your last\n\
2276 \"target\" command (\"info files\" will show your target stack).\n\
2277 The command may take as argument a process id or a device file.\n\
2278 For a process id, you must have permission to send the process a signal,\n\
2279 and it must have the same effective uid as the debugger.\n\
2280 When using \"attach\" with a process id, the debugger finds the\n\
2281 program running in the process, looking first in the current working\n\
2282 directory, or (if not found there) using the source file search path\n\
2283 (see the \"directory\" command). You can also use the \"file\" command\n\
2284 to specify the program, and to load its symbol table."));
2286 add_prefix_cmd ("detach", class_run
, detach_command
, _("\
2287 Detach a process or file previously attached.\n\
2288 If a process, it is no longer traced, and it continues its execution. If\n\
2289 you were debugging a file, the file is closed and gdb no longer accesses it."),
2290 &detachlist
, "detach ", 0, &cmdlist
);
2292 add_com ("disconnect", class_run
, disconnect_command
, _("\
2293 Disconnect from a target.\n\
2294 The target will wait for another debugger to connect. Not available for\n\
2297 add_com ("signal", class_run
, signal_command
, _("\
2298 Continue program giving it signal specified by the argument.\n\
2299 An argument of \"0\" means continue program without giving it a signal."));
2301 add_com ("stepi", class_run
, stepi_command
, _("\
2302 Step one instruction exactly.\n\
2303 Argument N means do this N times (or till program stops for another reason)."));
2304 add_com_alias ("si", "stepi", class_alias
, 0);
2306 add_com ("nexti", class_run
, nexti_command
, _("\
2307 Step one instruction, but proceed through subroutine calls.\n\
2308 Argument N means do this N times (or till program stops for another reason)."));
2309 add_com_alias ("ni", "nexti", class_alias
, 0);
2311 add_com ("finish", class_run
, finish_command
, _("\
2312 Execute until selected stack frame returns.\n\
2313 Upon return, the value returned is printed and put in the value history."));
2314 add_com_alias ("fin", "finish", class_run
, 1);
2316 add_com ("next", class_run
, next_command
, _("\
2317 Step program, proceeding through subroutine calls.\n\
2318 Like the \"step\" command as long as subroutine calls do not happen;\n\
2319 when they do, the call is treated as one instruction.\n\
2320 Argument N means do this N times (or till program stops for another reason)."));
2321 add_com_alias ("n", "next", class_run
, 1);
2323 add_com_alias ("S", "next", class_run
, 1);
2325 add_com ("step", class_run
, step_command
, _("\
2326 Step program until it reaches a different source line.\n\
2327 Argument N means do this N times (or till program stops for another reason)."));
2328 add_com_alias ("s", "step", class_run
, 1);
2330 c
= add_com ("until", class_run
, until_command
, _("\
2331 Execute until the program reaches a source line greater than the current\n\
2332 or a specified location (same args as break command) within the current frame."));
2333 set_cmd_completer (c
, location_completer
);
2334 add_com_alias ("u", "until", class_run
, 1);
2336 c
= add_com ("advance", class_run
, advance_command
, _("\
2337 Continue the program up to the given location (same form as args for break command).\n\
2338 Execution will also stop upon exit from the current stack frame."));
2339 set_cmd_completer (c
, location_completer
);
2341 c
= add_com ("jump", class_run
, jump_command
, _("\
2342 Continue program being debugged at specified line or address.\n\
2343 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2344 for an address to start at."));
2345 set_cmd_completer (c
, location_completer
);
2349 c
= add_com ("go", class_run
, go_command
, _("\
2350 Usage: go <location>\n\
2351 Continue program being debugged, stopping at specified line or \n\
2353 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2354 expression for an address to start at.\n\
2355 This command is a combination of tbreak and jump."));
2356 set_cmd_completer (c
, location_completer
);
2360 add_com_alias ("g", "go", class_run
, 1);
2362 c
= add_com ("continue", class_run
, continue_command
, _("\
2363 Continue program being debugged, after signal or breakpoint.\n\
2364 If proceeding from breakpoint, a number N may be used as an argument,\n\
2365 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2366 the breakpoint won't break until the Nth time it is reached).\n\
2368 If non-stop mode is enabled, continue only the current thread,\n\
2369 otherwise all the threads in the program are continued. To \n\
2370 continue all stopped threads in non-stop mode, use the -a option.\n\
2371 Specifying -a and an ignore count simultaneously is an error."));
2372 add_com_alias ("c", "cont", class_run
, 1);
2373 add_com_alias ("fg", "cont", class_run
, 1);
2375 c
= add_com ("run", class_run
, run_command
, _("\
2376 Start debugged program. You may specify arguments to give it.\n\
2377 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2378 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2379 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2380 To cancel previous arguments and run with no arguments,\n\
2381 use \"set args\" without arguments."));
2382 set_cmd_completer (c
, filename_completer
);
2383 add_com_alias ("r", "run", class_run
, 1);
2385 add_com ("R", class_run
, run_no_args_command
,
2386 _("Start debugged program with no arguments."));
2388 c
= add_com ("start", class_run
, start_command
, _("\
2389 Run the debugged program until the beginning of the main procedure.\n\
2390 You may specify arguments to give to your program, just as with the\n\
2391 \"run\" command."));
2392 set_cmd_completer (c
, filename_completer
);
2394 c
= add_com ("interrupt", class_run
, interrupt_target_command
,
2395 _("Interrupt the execution of the debugged program.\n\
2396 If non-stop mode is enabled, interrupt only the current thread,\n\
2397 otherwise all the threads in the program are stopped. To \n\
2398 interrupt all running threads in non-stop mode, use the -a option."));
2400 add_info ("registers", nofp_registers_info
, _("\
2401 List of integer registers and their contents, for selected stack frame.\n\
2402 Register name as argument means describe only that register."));
2403 add_info_alias ("r", "registers", 1);
2406 add_com ("lr", class_info
, nofp_registers_info
, _("\
2407 List of integer registers and their contents, for selected stack frame.\n\
2408 Register name as argument means describe only that register."));
2409 add_info ("all-registers", all_registers_info
, _("\
2410 List of all registers and their contents, for selected stack frame.\n\
2411 Register name as argument means describe only that register."));
2413 add_info ("program", program_info
,
2414 _("Execution status of the program."));
2416 add_info ("float", float_info
,
2417 _("Print the status of the floating point unit\n"));
2419 add_info ("vector", vector_info
,
2420 _("Print the status of the vector unit\n"));
2422 inferior_environ
= make_environ ();
2423 init_environ (inferior_environ
);