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 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"
51 /* Functions exported for general use, in inferior.h: */
53 void all_registers_info (char *, int);
55 void registers_info (char *, int);
57 void nexti_command (char *, int);
59 void stepi_command (char *, int);
61 void continue_command (char *, int);
63 void interrupt_target_command (char *args
, int from_tty
);
65 /* Local functions: */
67 static void nofp_registers_info (char *, int);
69 static void print_return_value (int struct_return
, struct type
*value_type
);
71 static void finish_command_continuation (struct continuation_arg
*);
73 static void until_next_command (int);
75 static void until_command (char *, int);
77 static void path_info (char *, int);
79 static void path_command (char *, int);
81 static void unset_command (char *, int);
83 static void float_info (char *, int);
85 static void detach_command (char *, int);
87 static void disconnect_command (char *, int);
89 static void unset_environment_command (char *, int);
91 static void set_environment_command (char *, int);
93 static void environment_info (char *, int);
95 static void program_info (char *, int);
97 static void finish_command (char *, int);
99 static void signal_command (char *, int);
101 static void jump_command (char *, int);
103 static void step_1 (int, int, char *);
104 static void step_once (int skip_subroutines
, int single_inst
, int count
);
105 static void step_1_continuation (struct continuation_arg
*arg
);
107 static void next_command (char *, int);
109 static void step_command (char *, int);
111 static void run_command (char *, int);
113 static void run_no_args_command (char *args
, int from_tty
);
115 static void go_command (char *line_no
, int from_tty
);
117 static int strip_bg_char (char **);
119 void _initialize_infcmd (void);
121 #define GO_USAGE "Usage: go <location>\n"
123 #define ERROR_NO_INFERIOR \
124 if (!target_has_execution) error (_("The program is not being run."));
126 /* String containing arguments to give to the program, separated by spaces.
127 Empty string (pointer to '\0') means no args. */
129 static char *inferior_args
;
131 /* The inferior arguments as a vector. If INFERIOR_ARGC is nonzero,
132 then we must compute INFERIOR_ARGS from this (via the target). */
134 static int inferior_argc
;
135 static char **inferior_argv
;
137 /* File name for default use for standard in/out in the inferior. */
139 static char *inferior_io_terminal
;
141 /* Pid of our debugged inferior, or 0 if no inferior now.
142 Since various parts of infrun.c test this to see whether there is a program
143 being debugged it should be nonzero (currently 3 is used) for remote
146 ptid_t inferior_ptid
;
148 /* Last signal that the inferior received (why it stopped). */
150 enum target_signal stop_signal
;
152 /* Address at which inferior stopped. */
156 /* Chain containing status of breakpoint(s) that we have stopped at. */
160 /* Flag indicating that a command has proceeded the inferior past the
161 current breakpoint. */
163 int breakpoint_proceeded
;
165 /* Nonzero if stopped due to a step command. */
169 /* Nonzero if stopped due to completion of a stack dummy routine. */
171 int stop_stack_dummy
;
173 /* Nonzero if stopped due to a random (unexpected) signal in inferior
176 int stopped_by_random_signal
;
178 /* Range to single step within.
179 If this is nonzero, respond to a single-step signal
180 by continuing to step if the pc is in this range. */
182 CORE_ADDR step_range_start
; /* Inclusive */
183 CORE_ADDR step_range_end
; /* Exclusive */
185 /* Stack frame address as of when stepping command was issued.
186 This is how we know when we step into a subroutine call,
187 and how to set the frame for the breakpoint used to step out. */
189 struct frame_id step_frame_id
;
191 enum step_over_calls_kind step_over_calls
;
193 /* If stepping, nonzero means step count is > 1
194 so don't print frame next time inferior stops
195 if it stops due to stepping. */
199 /* Environment to use for running inferior,
200 in format described in environ.h. */
202 struct gdb_environ
*inferior_environ
;
204 /* Accessor routines. */
207 set_inferior_io_terminal (const char *terminal_name
)
209 if (inferior_io_terminal
)
210 xfree (inferior_io_terminal
);
213 inferior_io_terminal
= NULL
;
215 inferior_io_terminal
= savestring (terminal_name
, strlen (terminal_name
));
219 get_inferior_io_terminal (void)
221 return inferior_io_terminal
;
225 get_inferior_args (void)
227 if (inferior_argc
!= 0)
231 n
= gdbarch_construct_inferior_arguments (current_gdbarch
,
232 inferior_argc
, inferior_argv
);
233 old
= set_inferior_args (n
);
237 if (inferior_args
== NULL
)
238 inferior_args
= xstrdup ("");
240 return inferior_args
;
244 set_inferior_args (char *newargs
)
246 char *saved_args
= inferior_args
;
248 inferior_args
= newargs
;
256 set_inferior_args_vector (int argc
, char **argv
)
258 inferior_argc
= argc
;
259 inferior_argv
= argv
;
262 /* Notice when `set args' is run. */
264 notice_args_set (char *args
, int from_tty
, struct cmd_list_element
*c
)
270 /* Notice when `show args' is run. */
272 notice_args_read (struct ui_file
*file
, int from_tty
,
273 struct cmd_list_element
*c
, const char *value
)
275 deprecated_show_value_hack (file
, from_tty
, c
, value
);
276 /* Might compute the value. */
277 get_inferior_args ();
281 /* Compute command-line string given argument vector. This does the
282 same shell processing as fork_inferior. */
284 construct_inferior_arguments (struct gdbarch
*gdbarch
, int argc
, char **argv
)
288 if (STARTUP_WITH_SHELL
)
290 /* This holds all the characters considered special to the
291 typical Unix shells. We include `^' because the SunOS
292 /bin/sh treats it as a synonym for `|'. */
293 char *special
= "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
298 /* We over-compute the size. It shouldn't matter. */
299 for (i
= 0; i
< argc
; ++i
)
300 length
+= 2 * strlen (argv
[i
]) + 1 + 2 * (argv
[i
][0] == '\0');
302 result
= (char *) xmalloc (length
);
305 for (i
= 0; i
< argc
; ++i
)
310 /* Need to handle empty arguments specially. */
311 if (argv
[i
][0] == '\0')
318 for (cp
= argv
[i
]; *cp
; ++cp
)
320 if (strchr (special
, *cp
) != NULL
)
330 /* In this case we can't handle arguments that contain spaces,
331 tabs, or newlines -- see breakup_args(). */
335 for (i
= 0; i
< argc
; ++i
)
337 char *cp
= strchr (argv
[i
], ' ');
339 cp
= strchr (argv
[i
], '\t');
341 cp
= strchr (argv
[i
], '\n');
343 error (_("can't handle command-line argument containing whitespace"));
344 length
+= strlen (argv
[i
]) + 1;
347 result
= (char *) xmalloc (length
);
349 for (i
= 0; i
< argc
; ++i
)
352 strcat (result
, " ");
353 strcat (result
, argv
[i
]);
361 /* This function detects whether or not a '&' character (indicating
362 background execution) has been added as *the last* of the arguments ARGS
363 of a command. If it has, it removes it and returns 1. Otherwise it
364 does nothing and returns 0. */
366 strip_bg_char (char **args
)
370 p
= strchr (*args
, '&');
374 if (p
== (*args
+ strlen (*args
) - 1))
376 if (strlen (*args
) > 1)
380 while (*p
== ' ' || *p
== '\t');
392 tty_command (char *file
, int from_tty
)
395 error_no_arg (_("terminal name for running target process"));
397 set_inferior_io_terminal (file
);
400 /* Common actions to take after creating any sort of inferior, by any
401 means (running, attaching, connecting, et cetera). The target
402 should be stopped. */
405 post_create_inferior (struct target_ops
*target
, int from_tty
)
407 /* Be sure we own the terminal in case write operations are performed. */
408 target_terminal_ours ();
410 /* If the target hasn't taken care of this already, do it now.
411 Targets which need to access registers during to_open,
412 to_create_inferior, or to_attach should do it earlier; but many
414 target_find_description ();
418 /* Sometimes the platform-specific hook loads initial shared
419 libraries, and sometimes it doesn't. Try to do so first, so
420 that we can add them with the correct value for FROM_TTY.
421 If we made all the inferior hook methods consistent,
422 this call could be removed. */
424 SOLIB_ADD (NULL
, from_tty
, target
, auto_solib_add
);
426 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
429 /* Create the hooks to handle shared library load and unload
431 #ifdef SOLIB_CREATE_INFERIOR_HOOK
432 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid
));
434 solib_create_inferior_hook ();
437 /* Enable any breakpoints which were disabled when the
438 underlying shared library was deleted. */
439 re_enable_breakpoints_in_shlibs ();
442 observer_notify_inferior_created (target
, from_tty
);
445 /* Kill the inferior if already running. This function is designed
446 to be called when we are about to start the execution of the program
447 from the beginning. Ask the user to confirm that he wants to restart
448 the program being debugged when FROM_TTY is non-null. */
451 kill_if_already_running (int from_tty
)
453 if (! ptid_equal (inferior_ptid
, null_ptid
) && target_has_execution
)
456 && !query ("The program being debugged has been started already.\n\
457 Start it from the beginning? "))
458 error (_("Program not restarted."));
460 #if defined(SOLIB_RESTART)
463 init_wait_for_inferior ();
467 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
468 a temporary breakpoint at the begining of the main program before
469 running the program. */
472 run_command_1 (char *args
, int from_tty
, int tbreak_at_main
)
478 kill_if_already_running (from_tty
);
479 clear_breakpoint_hit_counts ();
481 /* Clean up any leftovers from other runs. Some other things from
482 this function should probably be moved into target_pre_inferior. */
483 target_pre_inferior (from_tty
);
485 /* Purge old solib objfiles. */
486 objfile_purge_solibs ();
488 do_run_cleanups (NULL
);
490 /* The comment here used to read, "The exec file is re-read every
491 time we do a generic_mourn_inferior, so we just have to worry
492 about the symbol file." The `generic_mourn_inferior' function
493 gets called whenever the program exits. However, suppose the
494 program exits, and *then* the executable file changes? We need
495 to check again here. Since reopen_exec_file doesn't do anything
496 if the timestamp hasn't changed, I don't see the harm. */
500 /* Insert the temporary breakpoint if a location was specified. */
502 tbreak_command (main_name (), 0);
504 exec_file
= (char *) get_exec_file (0);
506 /* We keep symbols from add-symbol-file, on the grounds that the
507 user might want to add some symbols before running the program
508 (right?). But sometimes (dynamic loading where the user manually
509 introduces the new symbols with add-symbol-file), the code which
510 the symbols describe does not persist between runs. Currently
511 the user has to manually nuke all symbols between runs if they
512 want them to go away (PR 2207). This is probably reasonable. */
516 if (target_can_async_p ())
517 async_disable_stdin ();
521 int async_exec
= strip_bg_char (&args
);
523 /* If we get a request for running in the bg but the target
524 doesn't support it, error out. */
525 if (async_exec
&& !target_can_async_p ())
526 error (_("Asynchronous execution not supported on this target."));
528 /* If we don't get a request of running in the bg, then we need
529 to simulate synchronous (fg) execution. */
530 if (!async_exec
&& target_can_async_p ())
532 /* Simulate synchronous execution */
533 async_disable_stdin ();
536 /* If there were other args, beside '&', process them. */
539 char *old_args
= set_inferior_args (xstrdup (args
));
546 ui_out_field_string (uiout
, NULL
, "Starting program");
547 ui_out_text (uiout
, ": ");
549 ui_out_field_string (uiout
, "execfile", exec_file
);
550 ui_out_spaces (uiout
, 1);
551 /* We call get_inferior_args() because we might need to compute
553 ui_out_field_string (uiout
, "infargs", get_inferior_args ());
554 ui_out_text (uiout
, "\n");
555 ui_out_flush (uiout
);
558 /* We call get_inferior_args() because we might need to compute
560 target_create_inferior (exec_file
, get_inferior_args (),
561 environ_vector (inferior_environ
), from_tty
);
563 /* Pass zero for FROM_TTY, because at this point the "run" command
564 has done its thing; now we are setting up the running program. */
565 post_create_inferior (¤t_target
, 0);
567 /* Start the target running. */
568 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
573 run_command (char *args
, int from_tty
)
575 run_command_1 (args
, from_tty
, 0);
579 run_no_args_command (char *args
, int from_tty
)
581 char *old_args
= set_inferior_args (xstrdup (""));
586 /* Start the execution of the program up until the beginning of the main
590 start_command (char *args
, int from_tty
)
592 /* Some languages such as Ada need to search inside the program
593 minimal symbols for the location where to put the temporary
594 breakpoint before starting. */
595 if (!have_minimal_symbols ())
596 error (_("No symbol table loaded. Use the \"file\" command."));
598 /* Run the program until reaching the main procedure... */
599 run_command_1 (args
, from_tty
, 1);
603 continue_command (char *proc_count_exp
, int from_tty
)
608 /* Find out whether we must run in the background. */
609 if (proc_count_exp
!= NULL
)
610 async_exec
= strip_bg_char (&proc_count_exp
);
612 /* If we must run in the background, but the target can't do it,
614 if (async_exec
&& !target_can_async_p ())
615 error (_("Asynchronous execution not supported on this target."));
617 /* If we are not asked to run in the bg, then prepare to run in the
618 foreground, synchronously. */
619 if (!async_exec
&& target_can_async_p ())
621 /* Simulate synchronous execution */
622 async_disable_stdin ();
625 /* If have argument (besides '&'), set proceed count of breakpoint
627 if (proc_count_exp
!= NULL
)
629 bpstat bs
= stop_bpstat
;
633 while ((stat
= bpstat_num (&bs
, &num
)) != 0)
636 set_ignore_count (num
,
637 parse_and_eval_long (proc_count_exp
) - 1,
639 /* set_ignore_count prints a message ending with a period.
640 So print two spaces before "Continuing.". */
642 printf_filtered (" ");
646 if (!stopped
&& from_tty
)
649 ("Not stopped at any breakpoint; argument ignored.\n");
654 printf_filtered (_("Continuing.\n"));
656 clear_proceed_status ();
658 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
661 /* Step until outside of current statement. */
664 step_command (char *count_string
, int from_tty
)
666 step_1 (0, 0, count_string
);
669 /* Likewise, but skip over subroutine calls as if single instructions. */
672 next_command (char *count_string
, int from_tty
)
674 step_1 (1, 0, count_string
);
677 /* Likewise, but step only one instruction. */
680 stepi_command (char *count_string
, int from_tty
)
682 step_1 (0, 1, count_string
);
686 nexti_command (char *count_string
, int from_tty
)
688 step_1 (1, 1, count_string
);
692 disable_longjmp_breakpoint_cleanup (void *ignore
)
694 disable_longjmp_breakpoint ();
698 step_1 (int skip_subroutines
, int single_inst
, char *count_string
)
701 struct frame_info
*frame
;
702 struct cleanup
*cleanups
= 0;
708 async_exec
= strip_bg_char (&count_string
);
710 /* If we get a request for running in the bg but the target
711 doesn't support it, error out. */
712 if (async_exec
&& !target_can_async_p ())
713 error (_("Asynchronous execution not supported on this target."));
715 /* If we don't get a request of running in the bg, then we need
716 to simulate synchronous (fg) execution. */
717 if (!async_exec
&& target_can_async_p ())
719 /* Simulate synchronous execution */
720 async_disable_stdin ();
723 count
= count_string
? parse_and_eval_long (count_string
) : 1;
725 if (!single_inst
|| skip_subroutines
) /* leave si command alone */
727 enable_longjmp_breakpoint ();
728 if (!target_can_async_p ())
729 cleanups
= make_cleanup (disable_longjmp_breakpoint_cleanup
, 0 /*ignore*/);
731 make_exec_cleanup (disable_longjmp_breakpoint_cleanup
, 0 /*ignore*/);
734 /* In synchronous case, all is well, just use the regular for loop. */
735 if (!target_can_async_p ())
737 for (; count
> 0; count
--)
739 clear_proceed_status ();
741 frame
= get_current_frame ();
742 if (!frame
) /* Avoid coredump here. Why tho? */
743 error (_("No current frame"));
744 step_frame_id
= get_frame_id (frame
);
748 find_pc_line_pc_range (stop_pc
, &step_range_start
, &step_range_end
);
749 if (step_range_end
== 0)
752 if (find_pc_partial_function (stop_pc
, &name
, &step_range_start
,
753 &step_range_end
) == 0)
754 error (_("Cannot find bounds of current function"));
756 target_terminal_ours ();
757 printf_filtered (_("\
758 Single stepping until exit from function %s, \n\
759 which has no line number information.\n"), name
);
764 /* Say we are stepping, but stop after one insn whatever it does. */
765 step_range_start
= step_range_end
= 1;
766 if (!skip_subroutines
)
768 Don't step over function calls, not even to functions lacking
770 step_over_calls
= STEP_OVER_NONE
;
773 if (skip_subroutines
)
774 step_over_calls
= STEP_OVER_ALL
;
776 step_multi
= (count
> 1);
777 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
783 if (!single_inst
|| skip_subroutines
)
784 do_cleanups (cleanups
);
787 /* In case of asynchronous target things get complicated, do only
788 one step for now, before returning control to the event loop. Let
789 the continuation figure out how many other steps we need to do,
790 and handle them one at the time, through step_once(). */
793 if (target_can_async_p ())
794 step_once (skip_subroutines
, single_inst
, count
);
798 /* Called after we are done with one step operation, to check whether
799 we need to step again, before we print the prompt and return control
800 to the user. If count is > 1, we will need to do one more call to
801 proceed(), via step_once(). Basically it is like step_once and
802 step_1_continuation are co-recursive. */
804 step_1_continuation (struct continuation_arg
*arg
)
807 int skip_subroutines
;
810 skip_subroutines
= arg
->data
.integer
;
811 single_inst
= arg
->next
->data
.integer
;
812 count
= arg
->next
->next
->data
.integer
;
815 step_once (skip_subroutines
, single_inst
, count
- 1);
817 if (!single_inst
|| skip_subroutines
)
818 do_exec_cleanups (ALL_CLEANUPS
);
821 /* Do just one step operation. If count >1 we will have to set up a
822 continuation to be done after the target stops (after this one
823 step). This is useful to implement the 'step n' kind of commands, in
824 case of asynchronous targets. We had to split step_1 into two parts,
825 one to be done before proceed() and one afterwards. This function is
826 called in case of step n with n>1, after the first step operation has
829 step_once (int skip_subroutines
, int single_inst
, int count
)
831 struct continuation_arg
*arg1
;
832 struct continuation_arg
*arg2
;
833 struct continuation_arg
*arg3
;
834 struct frame_info
*frame
;
838 clear_proceed_status ();
840 frame
= get_current_frame ();
841 if (!frame
) /* Avoid coredump here. Why tho? */
842 error (_("No current frame"));
843 step_frame_id
= get_frame_id (frame
);
847 find_pc_line_pc_range (stop_pc
, &step_range_start
, &step_range_end
);
849 /* If we have no line info, switch to stepi mode. */
850 if (step_range_end
== 0 && step_stop_if_no_debug
)
852 step_range_start
= step_range_end
= 1;
854 else if (step_range_end
== 0)
857 if (find_pc_partial_function (stop_pc
, &name
, &step_range_start
,
858 &step_range_end
) == 0)
859 error (_("Cannot find bounds of current function"));
861 target_terminal_ours ();
862 printf_filtered (_("\
863 Single stepping until exit from function %s, \n\
864 which has no line number information.\n"), name
);
869 /* Say we are stepping, but stop after one insn whatever it does. */
870 step_range_start
= step_range_end
= 1;
871 if (!skip_subroutines
)
873 Don't step over function calls, not even to functions lacking
875 step_over_calls
= STEP_OVER_NONE
;
878 if (skip_subroutines
)
879 step_over_calls
= STEP_OVER_ALL
;
881 step_multi
= (count
> 1);
883 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
885 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
887 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
889 arg1
->data
.integer
= skip_subroutines
;
891 arg2
->data
.integer
= single_inst
;
893 arg3
->data
.integer
= count
;
894 add_intermediate_continuation (step_1_continuation
, arg1
);
895 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
900 /* Continue program at specified address. */
903 jump_command (char *arg
, int from_tty
)
906 struct symtabs_and_lines sals
;
907 struct symtab_and_line sal
;
914 /* Find out whether we must run in the background. */
916 async_exec
= strip_bg_char (&arg
);
918 /* If we must run in the background, but the target can't do it,
920 if (async_exec
&& !target_can_async_p ())
921 error (_("Asynchronous execution not supported on this target."));
923 /* If we are not asked to run in the bg, then prepare to run in the
924 foreground, synchronously. */
925 if (!async_exec
&& target_can_async_p ())
927 /* Simulate synchronous execution */
928 async_disable_stdin ();
932 error_no_arg (_("starting address"));
934 sals
= decode_line_spec_1 (arg
, 1);
937 error (_("Unreasonable jump request"));
943 if (sal
.symtab
== 0 && sal
.pc
== 0)
944 error (_("No source file has been specified."));
946 resolve_sal_pc (&sal
); /* May error out */
948 /* See if we are trying to jump to another function. */
949 fn
= get_frame_function (get_current_frame ());
950 sfn
= find_pc_function (sal
.pc
);
951 if (fn
!= NULL
&& sfn
!= fn
)
953 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal
.line
,
954 SYMBOL_PRINT_NAME (fn
)))
956 error (_("Not confirmed."));
963 fixup_symbol_section (sfn
, 0);
964 if (section_is_overlay (SYMBOL_BFD_SECTION (sfn
)) &&
965 !section_is_mapped (SYMBOL_BFD_SECTION (sfn
)))
967 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
969 error (_("Not confirmed."));
979 printf_filtered (_("Continuing at "));
980 deprecated_print_address_numeric (addr
, 1, gdb_stdout
);
981 printf_filtered (".\n");
984 clear_proceed_status ();
985 proceed (addr
, TARGET_SIGNAL_0
, 0);
989 /* Go to line or address in current procedure */
991 go_command (char *line_no
, int from_tty
)
993 if (line_no
== (char *) NULL
|| !*line_no
)
994 printf_filtered (GO_USAGE
);
997 tbreak_command (line_no
, from_tty
);
998 jump_command (line_no
, from_tty
);
1003 /* Continue program giving it specified signal. */
1006 signal_command (char *signum_exp
, int from_tty
)
1008 enum target_signal oursig
;
1010 dont_repeat (); /* Too dangerous. */
1014 error_no_arg (_("signal number"));
1016 /* It would be even slicker to make signal names be valid expressions,
1017 (the type could be "enum $signal" or some such), then the user could
1018 assign them to convenience variables. */
1019 oursig
= target_signal_from_name (signum_exp
);
1021 if (oursig
== TARGET_SIGNAL_UNKNOWN
)
1023 /* No, try numeric. */
1024 int num
= parse_and_eval_long (signum_exp
);
1027 oursig
= TARGET_SIGNAL_0
;
1029 oursig
= target_signal_from_command (num
);
1034 if (oursig
== TARGET_SIGNAL_0
)
1035 printf_filtered (_("Continuing with no signal.\n"));
1037 printf_filtered (_("Continuing with signal %s.\n"),
1038 target_signal_to_name (oursig
));
1041 clear_proceed_status ();
1042 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1043 FIXME: Neither should "signal foo" but when I tried passing
1044 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1045 tried to track down yet. */
1046 proceed (oursig
== TARGET_SIGNAL_0
? (CORE_ADDR
) -1 : stop_pc
, oursig
, 0);
1049 /* Proceed until we reach a different source line with pc greater than
1050 our current one or exit the function. We skip calls in both cases.
1052 Note that eventually this command should probably be changed so
1053 that only source lines are printed out when we hit the breakpoint
1054 we set. This may involve changes to wait_for_inferior and the
1055 proceed status code. */
1058 until_next_command (int from_tty
)
1060 struct frame_info
*frame
;
1062 struct symbol
*func
;
1063 struct symtab_and_line sal
;
1065 clear_proceed_status ();
1067 frame
= get_current_frame ();
1069 /* Step until either exited from this function or greater
1070 than the current line (if in symbolic section) or pc (if
1074 func
= find_pc_function (pc
);
1078 struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (pc
);
1080 if (msymbol
== NULL
)
1081 error (_("Execution is not within a known function."));
1083 step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
1084 step_range_end
= pc
;
1088 sal
= find_pc_line (pc
, 0);
1090 step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
1091 step_range_end
= sal
.end
;
1094 step_over_calls
= STEP_OVER_ALL
;
1095 step_frame_id
= get_frame_id (frame
);
1097 step_multi
= 0; /* Only one call to proceed */
1099 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
1103 until_command (char *arg
, int from_tty
)
1107 if (!target_has_execution
)
1108 error (_("The program is not running."));
1110 /* Find out whether we must run in the background. */
1112 async_exec
= strip_bg_char (&arg
);
1114 /* If we must run in the background, but the target can't do it,
1116 if (async_exec
&& !target_can_async_p ())
1117 error (_("Asynchronous execution not supported on this target."));
1119 /* If we are not asked to run in the bg, then prepare to run in the
1120 foreground, synchronously. */
1121 if (!async_exec
&& target_can_async_p ())
1123 /* Simulate synchronous execution */
1124 async_disable_stdin ();
1128 until_break_command (arg
, from_tty
, 0);
1130 until_next_command (from_tty
);
1134 advance_command (char *arg
, int from_tty
)
1138 if (!target_has_execution
)
1139 error (_("The program is not running."));
1142 error_no_arg (_("a location"));
1144 /* Find out whether we must run in the background. */
1146 async_exec
= strip_bg_char (&arg
);
1148 /* If we must run in the background, but the target can't do it,
1150 if (async_exec
&& !target_can_async_p ())
1151 error (_("Asynchronous execution not supported on this target."));
1153 /* If we are not asked to run in the bg, then prepare to run in the
1154 foreground, synchronously. */
1155 if (!async_exec
&& target_can_async_p ())
1157 /* Simulate synchronous execution. */
1158 async_disable_stdin ();
1161 until_break_command (arg
, from_tty
, 1);
1164 /* Print the result of a function at the end of a 'finish' command. */
1167 print_return_value (int struct_return
, struct type
*value_type
)
1169 struct gdbarch
*gdbarch
= current_gdbarch
;
1170 struct cleanup
*old_chain
;
1171 struct ui_stream
*stb
;
1172 struct value
*value
;
1174 CHECK_TYPEDEF (value_type
);
1175 gdb_assert (TYPE_CODE (value_type
) != TYPE_CODE_VOID
);
1177 /* FIXME: 2003-09-27: When returning from a nested inferior function
1178 call, it's possible (with no help from the architecture vector)
1179 to locate and return/print a "struct return" value. This is just
1180 a more complicated case of what is already being done in in the
1181 inferior function call code. In fact, when inferior function
1182 calls are made async, this will likely be made the norm. */
1184 switch (gdbarch_return_value (gdbarch
, value_type
, NULL
, NULL
, NULL
))
1186 case RETURN_VALUE_REGISTER_CONVENTION
:
1187 case RETURN_VALUE_ABI_RETURNS_ADDRESS
:
1188 case RETURN_VALUE_ABI_PRESERVES_ADDRESS
:
1189 value
= allocate_value (value_type
);
1190 gdbarch_return_value (current_gdbarch
, value_type
, stop_registers
,
1191 value_contents_raw (value
), NULL
);
1193 case RETURN_VALUE_STRUCT_CONVENTION
:
1197 internal_error (__FILE__
, __LINE__
, _("bad switch"));
1203 stb
= ui_out_stream_new (uiout
);
1204 old_chain
= make_cleanup_ui_out_stream_delete (stb
);
1205 ui_out_text (uiout
, "Value returned is ");
1206 ui_out_field_fmt (uiout
, "gdb-result-var", "$%d",
1207 record_latest_value (value
));
1208 ui_out_text (uiout
, " = ");
1209 value_print (value
, stb
->stream
, 0, Val_no_prettyprint
);
1210 ui_out_field_stream (uiout
, "return-value", stb
);
1211 ui_out_text (uiout
, "\n");
1212 do_cleanups (old_chain
);
1216 ui_out_text (uiout
, "Value returned has type: ");
1217 ui_out_field_string (uiout
, "return-type", TYPE_NAME (value_type
));
1218 ui_out_text (uiout
, ".");
1219 ui_out_text (uiout
, " Cannot determine contents\n");
1223 /* Stuff that needs to be done by the finish command after the target
1224 has stopped. In asynchronous mode, we wait for the target to stop
1225 in the call to poll or select in the event loop, so it is
1226 impossible to do all the stuff as part of the finish_command
1227 function itself. The only chance we have to complete this command
1228 is in fetch_inferior_event, which is called by the event loop as
1229 soon as it detects that the target has stopped. This function is
1230 called via the cmd_continuation pointer. */
1233 finish_command_continuation (struct continuation_arg
*arg
)
1235 struct symbol
*function
;
1236 struct breakpoint
*breakpoint
;
1237 struct cleanup
*cleanups
;
1239 breakpoint
= (struct breakpoint
*) arg
->data
.pointer
;
1240 function
= (struct symbol
*) arg
->next
->data
.pointer
;
1241 cleanups
= (struct cleanup
*) arg
->next
->next
->data
.pointer
;
1243 if (bpstat_find_breakpoint (stop_bpstat
, breakpoint
) != NULL
1244 && function
!= NULL
)
1246 struct type
*value_type
;
1250 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (function
));
1252 internal_error (__FILE__
, __LINE__
,
1253 _("finish_command: function has no target type"));
1255 if (TYPE_CODE (value_type
) == TYPE_CODE_VOID
)
1257 do_exec_cleanups (cleanups
);
1261 CHECK_TYPEDEF (value_type
);
1262 gcc_compiled
= BLOCK_GCC_COMPILED (SYMBOL_BLOCK_VALUE (function
));
1263 struct_return
= using_struct_return (value_type
, gcc_compiled
);
1265 print_return_value (struct_return
, value_type
);
1268 do_exec_cleanups (cleanups
);
1271 /* "finish": Set a temporary breakpoint at the place the selected
1272 frame will return to, then continue. */
1275 finish_command (char *arg
, int from_tty
)
1277 struct symtab_and_line sal
;
1278 struct frame_info
*frame
;
1279 struct symbol
*function
;
1280 struct breakpoint
*breakpoint
;
1281 struct cleanup
*old_chain
;
1282 struct continuation_arg
*arg1
, *arg2
, *arg3
;
1286 /* Find out whether we must run in the background. */
1288 async_exec
= strip_bg_char (&arg
);
1290 /* If we must run in the background, but the target can't do it,
1292 if (async_exec
&& !target_can_async_p ())
1293 error (_("Asynchronous execution not supported on this target."));
1295 /* If we are not asked to run in the bg, then prepare to run in the
1296 foreground, synchronously. */
1297 if (!async_exec
&& target_can_async_p ())
1299 /* Simulate synchronous execution. */
1300 async_disable_stdin ();
1304 error (_("The \"finish\" command does not take any arguments."));
1305 if (!target_has_execution
)
1306 error (_("The program is not running."));
1308 frame
= get_prev_frame (get_selected_frame (_("No selected frame.")));
1310 error (_("\"finish\" not meaningful in the outermost frame."));
1312 clear_proceed_status ();
1314 sal
= find_pc_line (get_frame_pc (frame
), 0);
1315 sal
.pc
= get_frame_pc (frame
);
1317 breakpoint
= set_momentary_breakpoint (sal
, get_frame_id (frame
), bp_finish
);
1319 if (!target_can_async_p ())
1320 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1322 old_chain
= make_exec_cleanup_delete_breakpoint (breakpoint
);
1324 /* Find the function we will return from. */
1326 function
= find_pc_function (get_frame_pc (get_selected_frame (NULL
)));
1328 /* Print info on the selected frame, including level number but not
1332 printf_filtered (_("Run till exit from "));
1333 print_stack_frame (get_selected_frame (NULL
), 1, LOCATION
);
1336 /* If running asynchronously and the target support asynchronous
1337 execution, set things up for the rest of the finish command to be
1338 completed later on, when gdb has detected that the target has
1339 stopped, in fetch_inferior_event. */
1340 if (target_can_async_p ())
1343 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
1345 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
1347 (struct continuation_arg
*) xmalloc (sizeof (struct continuation_arg
));
1351 arg1
->data
.pointer
= breakpoint
;
1352 arg2
->data
.pointer
= function
;
1353 arg3
->data
.pointer
= old_chain
;
1354 add_continuation (finish_command_continuation
, arg1
);
1357 proceed_to_finish
= 1; /* We want stop_registers, please... */
1358 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1360 /* Do this only if not running asynchronously or if the target
1361 cannot do async execution. Otherwise, complete this command when
1362 the target actually stops, in fetch_inferior_event. */
1363 if (!target_can_async_p ())
1365 /* Did we stop at our breakpoint? */
1366 if (bpstat_find_breakpoint (stop_bpstat
, breakpoint
) != NULL
1367 && function
!= NULL
)
1369 struct type
*value_type
;
1373 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (function
));
1375 internal_error (__FILE__
, __LINE__
,
1376 _("finish_command: function has no target type"));
1378 /* FIXME: Shouldn't we do the cleanups before returning? */
1379 if (TYPE_CODE (value_type
) == TYPE_CODE_VOID
)
1382 CHECK_TYPEDEF (value_type
);
1383 gcc_compiled
= BLOCK_GCC_COMPILED (SYMBOL_BLOCK_VALUE (function
));
1384 struct_return
= using_struct_return (value_type
, gcc_compiled
);
1386 print_return_value (struct_return
, value_type
);
1389 do_cleanups (old_chain
);
1395 program_info (char *args
, int from_tty
)
1397 bpstat bs
= stop_bpstat
;
1399 int stat
= bpstat_num (&bs
, &num
);
1401 if (!target_has_execution
)
1403 printf_filtered (_("The program being debugged is not being run.\n"));
1407 target_files_info ();
1408 printf_filtered (_("Program stopped at %s.\n"),
1409 hex_string ((unsigned long) stop_pc
));
1411 printf_filtered (_("It stopped after being stepped.\n"));
1414 /* There may be several breakpoints in the same place, so this
1415 isn't as strange as it seems. */
1420 printf_filtered (_("\
1421 It stopped at a breakpoint that has since been deleted.\n"));
1424 printf_filtered (_("It stopped at breakpoint %d.\n"), num
);
1425 stat
= bpstat_num (&bs
, &num
);
1428 else if (stop_signal
!= TARGET_SIGNAL_0
)
1430 printf_filtered (_("It stopped with signal %s, %s.\n"),
1431 target_signal_to_name (stop_signal
),
1432 target_signal_to_string (stop_signal
));
1437 printf_filtered (_("\
1438 Type \"info stack\" or \"info registers\" for more information.\n"));
1443 environment_info (char *var
, int from_tty
)
1447 char *val
= get_in_environ (inferior_environ
, var
);
1450 puts_filtered (var
);
1451 puts_filtered (" = ");
1452 puts_filtered (val
);
1453 puts_filtered ("\n");
1457 puts_filtered ("Environment variable \"");
1458 puts_filtered (var
);
1459 puts_filtered ("\" not defined.\n");
1464 char **vector
= environ_vector (inferior_environ
);
1467 puts_filtered (*vector
++);
1468 puts_filtered ("\n");
1474 set_environment_command (char *arg
, int from_tty
)
1476 char *p
, *val
, *var
;
1480 error_no_arg (_("environment variable and value"));
1482 /* Find seperation between variable name and value */
1483 p
= (char *) strchr (arg
, '=');
1484 val
= (char *) strchr (arg
, ' ');
1486 if (p
!= 0 && val
!= 0)
1488 /* We have both a space and an equals. If the space is before the
1489 equals, walk forward over the spaces til we see a nonspace
1490 (possibly the equals). */
1495 /* Now if the = is after the char following the spaces,
1496 take the char following the spaces. */
1500 else if (val
!= 0 && p
== 0)
1504 error_no_arg (_("environment variable to set"));
1506 if (p
== 0 || p
[1] == 0)
1510 p
= arg
+ strlen (arg
); /* So that savestring below will work */
1514 /* Not setting variable value to null */
1516 while (*val
== ' ' || *val
== '\t')
1520 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t'))
1523 var
= savestring (arg
, p
- arg
);
1526 printf_filtered (_("\
1527 Setting environment variable \"%s\" to null value.\n"),
1529 set_in_environ (inferior_environ
, var
, "");
1532 set_in_environ (inferior_environ
, var
, val
);
1537 unset_environment_command (char *var
, int from_tty
)
1541 /* If there is no argument, delete all environment variables.
1542 Ask for confirmation if reading from the terminal. */
1543 if (!from_tty
|| query (_("Delete all environment variables? ")))
1545 free_environ (inferior_environ
);
1546 inferior_environ
= make_environ ();
1550 unset_in_environ (inferior_environ
, var
);
1553 /* Handle the execution path (PATH variable) */
1555 static const char path_var_name
[] = "PATH";
1558 path_info (char *args
, int from_tty
)
1560 puts_filtered ("Executable and object file path: ");
1561 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
1562 puts_filtered ("\n");
1565 /* Add zero or more directories to the front of the execution path. */
1568 path_command (char *dirname
, int from_tty
)
1573 env
= get_in_environ (inferior_environ
, path_var_name
);
1574 /* Can be null if path is not set */
1577 exec_path
= xstrdup (env
);
1578 mod_path (dirname
, &exec_path
);
1579 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
1582 path_info ((char *) NULL
, from_tty
);
1586 /* Print out the machine register regnum. If regnum is -1, print all
1587 registers (print_all == 1) or all non-float and non-vector
1588 registers (print_all == 0).
1590 For most machines, having all_registers_info() print the
1591 register(s) one per line is good enough. If a different format is
1592 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1593 regs), or there is an existing convention for showing all the
1594 registers, define the architecture method PRINT_REGISTERS_INFO to
1595 provide that format. */
1598 default_print_registers_info (struct gdbarch
*gdbarch
,
1599 struct ui_file
*file
,
1600 struct frame_info
*frame
,
1601 int regnum
, int print_all
)
1604 const int numregs
= gdbarch_num_regs (current_gdbarch
)
1605 + gdbarch_num_pseudo_regs (current_gdbarch
);
1606 gdb_byte buffer
[MAX_REGISTER_SIZE
];
1608 for (i
= 0; i
< numregs
; i
++)
1610 /* Decide between printing all regs, non-float / vector regs, or
1616 if (!gdbarch_register_reggroup_p (gdbarch
, i
, all_reggroup
))
1621 if (!gdbarch_register_reggroup_p (gdbarch
, i
, general_reggroup
))
1631 /* If the register name is empty, it is undefined for this
1632 processor, so don't display anything. */
1633 if (gdbarch_register_name (current_gdbarch
, i
) == NULL
1634 || *(gdbarch_register_name (current_gdbarch
, i
)) == '\0')
1637 fputs_filtered (gdbarch_register_name (current_gdbarch
, i
), file
);
1638 print_spaces_filtered (15 - strlen (gdbarch_register_name
1639 (current_gdbarch
, i
)), file
);
1641 /* Get the data in raw format. */
1642 if (! frame_register_read (frame
, i
, buffer
))
1644 fprintf_filtered (file
, "*value not available*\n");
1648 /* If virtual format is floating, print it that way, and in raw
1650 if (TYPE_CODE (register_type (current_gdbarch
, i
)) == TYPE_CODE_FLT
)
1654 val_print (register_type (current_gdbarch
, i
), buffer
, 0, 0,
1655 file
, 0, 1, 0, Val_pretty_default
);
1657 fprintf_filtered (file
, "\t(raw 0x");
1658 for (j
= 0; j
< register_size (current_gdbarch
, i
); j
++)
1661 if (gdbarch_byte_order (current_gdbarch
) == BFD_ENDIAN_BIG
)
1664 idx
= register_size (current_gdbarch
, i
) - 1 - j
;
1665 fprintf_filtered (file
, "%02x", (unsigned char) buffer
[idx
]);
1667 fprintf_filtered (file
, ")");
1671 /* Print the register in hex. */
1672 val_print (register_type (current_gdbarch
, i
), buffer
, 0, 0,
1673 file
, 'x', 1, 0, Val_pretty_default
);
1674 /* If not a vector register, print it also according to its
1676 if (TYPE_VECTOR (register_type (current_gdbarch
, i
)) == 0)
1678 fprintf_filtered (file
, "\t");
1679 val_print (register_type (current_gdbarch
, i
), buffer
, 0, 0,
1680 file
, 0, 1, 0, Val_pretty_default
);
1684 fprintf_filtered (file
, "\n");
1689 registers_info (char *addr_exp
, int fpregs
)
1691 struct frame_info
*frame
;
1692 int regnum
, numregs
;
1695 if (!target_has_registers
)
1696 error (_("The program has no registers now."));
1697 frame
= get_selected_frame (NULL
);
1701 gdbarch_print_registers_info (current_gdbarch
, gdb_stdout
,
1706 while (*addr_exp
!= '\0')
1711 /* Keep skipping leading white space. */
1712 if (isspace ((*addr_exp
)))
1718 /* Discard any leading ``$''. Check that there is something
1719 resembling a register following it. */
1720 if (addr_exp
[0] == '$')
1722 if (isspace ((*addr_exp
)) || (*addr_exp
) == '\0')
1723 error (_("Missing register name"));
1725 /* Find the start/end of this register name/num/group. */
1727 while ((*addr_exp
) != '\0' && !isspace ((*addr_exp
)))
1731 /* Figure out what we've found and display it. */
1733 /* A register name? */
1735 int regnum
= frame_map_name_to_regnum (frame
,
1736 start
, end
- start
);
1739 gdbarch_print_registers_info (current_gdbarch
, gdb_stdout
,
1740 frame
, regnum
, fpregs
);
1745 /* A register number? (how portable is this one?). */
1748 int regnum
= strtol (start
, &endptr
, 0);
1751 && regnum
< gdbarch_num_regs (current_gdbarch
)
1752 + gdbarch_num_pseudo_regs (current_gdbarch
))
1754 gdbarch_print_registers_info (current_gdbarch
, gdb_stdout
,
1755 frame
, regnum
, fpregs
);
1760 /* A register group? */
1762 struct reggroup
*group
;
1763 for (group
= reggroup_next (current_gdbarch
, NULL
);
1765 group
= reggroup_next (current_gdbarch
, group
))
1767 /* Don't bother with a length check. Should the user
1768 enter a short register group name, go with the first
1769 group that matches. */
1770 if (strncmp (start
, reggroup_name (group
), end
- start
) == 0)
1777 regnum
< gdbarch_num_regs (current_gdbarch
)
1778 + gdbarch_num_pseudo_regs (current_gdbarch
);
1781 if (gdbarch_register_reggroup_p (current_gdbarch
, regnum
,
1783 gdbarch_print_registers_info (current_gdbarch
,
1791 /* Nothing matched. */
1792 error (_("Invalid register `%.*s'"), (int) (end
- start
), start
);
1797 all_registers_info (char *addr_exp
, int from_tty
)
1799 registers_info (addr_exp
, 1);
1803 nofp_registers_info (char *addr_exp
, int from_tty
)
1805 registers_info (addr_exp
, 0);
1809 print_vector_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
1810 struct frame_info
*frame
, const char *args
)
1812 if (gdbarch_print_vector_info_p (gdbarch
))
1813 gdbarch_print_vector_info (gdbarch
, file
, frame
, args
);
1817 int printed_something
= 0;
1820 regnum
< gdbarch_num_regs (current_gdbarch
)
1821 + gdbarch_num_pseudo_regs (current_gdbarch
);
1824 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, vector_reggroup
))
1826 printed_something
= 1;
1827 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
1830 if (!printed_something
)
1831 fprintf_filtered (file
, "No vector information\n");
1836 vector_info (char *args
, int from_tty
)
1838 if (!target_has_registers
)
1839 error (_("The program has no registers now."));
1841 print_vector_info (current_gdbarch
, gdb_stdout
,
1842 get_selected_frame (NULL
), args
);
1848 * Should save/restore the tty state since it might be that the
1849 * program to be debugged was started on this tty and it wants
1850 * the tty in some state other than what we want. If it's running
1851 * on another terminal or without a terminal, then saving and
1852 * restoring the tty state is a harmless no-op.
1853 * This only needs to be done if we are attaching to a process.
1858 takes a program started up outside of gdb and ``attaches'' to it.
1859 This stops it cold in its tracks and allows us to start debugging it.
1860 and wait for the trace-trap that results from attaching. */
1863 attach_command (char *args
, int from_tty
)
1866 char *full_exec_path
= NULL
;
1868 dont_repeat (); /* Not for the faint of heart */
1870 if (target_has_execution
)
1872 if (query ("A program is being debugged already. Kill it? "))
1875 error (_("Not killed."));
1878 /* Clean up any leftovers from other runs. Some other things from
1879 this function should probably be moved into target_pre_inferior. */
1880 target_pre_inferior (from_tty
);
1882 /* Clear out solib state. Otherwise the solib state of the previous
1883 inferior might have survived and is entirely wrong for the new
1884 target. This has been observed on GNU/Linux using glibc 2.3. How
1896 Cannot access memory at address 0xdeadbeef
1904 target_attach (args
, from_tty
);
1906 /* Set up the "saved terminal modes" of the inferior
1907 based on what modes we are starting it with. */
1908 target_terminal_init ();
1910 /* Set up execution context to know that we should return from
1911 wait_for_inferior as soon as the target reports a stop. */
1912 init_wait_for_inferior ();
1913 clear_proceed_status ();
1915 /* No traps are generated when attaching to inferior under Mach 3
1917 #ifndef ATTACH_NO_WAIT
1918 /* Careful here. See comments in inferior.h. Basically some OSes
1919 don't ignore SIGSTOPs on continue requests anymore. We need a
1920 way for handle_inferior_event to reset the stop_signal variable
1921 after an attach, and this is what STOP_QUIETLY_NO_SIGSTOP is for. */
1922 stop_soon
= STOP_QUIETLY_NO_SIGSTOP
;
1923 wait_for_inferior ();
1924 stop_soon
= NO_STOP_QUIETLY
;
1928 * If no exec file is yet known, try to determine it from the
1931 exec_file
= (char *) get_exec_file (0);
1934 exec_file
= target_pid_to_exec_file (PIDGET (inferior_ptid
));
1937 /* It's possible we don't have a full path, but rather just a
1938 filename. Some targets, such as HP-UX, don't provide the
1941 Attempt to qualify the filename against the source path.
1942 (If that fails, we'll just fall back on the original
1943 filename. Not much more we can do...)
1945 if (!source_full_path_of (exec_file
, &full_exec_path
))
1946 full_exec_path
= savestring (exec_file
, strlen (exec_file
));
1948 exec_file_attach (full_exec_path
, from_tty
);
1949 symbol_file_add_main (full_exec_path
, from_tty
);
1954 reopen_exec_file ();
1958 /* 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 ();
1969 if (deprecated_attach_hook
)
1970 deprecated_attach_hook ();
1975 * takes a program previously attached to and detaches it.
1976 * The program resumes execution and will no longer stop
1977 * on signals, etc. We better not have left any breakpoints
1978 * in the program or it'll die when it hits one. For this
1979 * to work, it may be necessary for the process to have been
1980 * previously attached. It *might* work if the program was
1981 * started via the normal ptrace (PTRACE_TRACEME).
1985 detach_command (char *args
, int from_tty
)
1987 dont_repeat (); /* Not for the faint of heart. */
1988 target_detach (args
, from_tty
);
1989 #if defined(SOLIB_RESTART)
1992 if (deprecated_detach_hook
)
1993 deprecated_detach_hook ();
1996 /* Disconnect from the current target without resuming it (leaving it
1997 waiting for a debugger).
1999 We'd better not have left any breakpoints in the program or the
2000 next debugger will get confused. Currently only supported for some
2001 remote targets, since the normal attach mechanisms don't work on
2002 stopped processes on some native platforms (e.g. GNU/Linux). */
2005 disconnect_command (char *args
, int from_tty
)
2007 dont_repeat (); /* Not for the faint of heart */
2008 target_disconnect (args
, from_tty
);
2009 #if defined(SOLIB_RESTART)
2012 if (deprecated_detach_hook
)
2013 deprecated_detach_hook ();
2016 /* Stop the execution of the target while running in async mode, in
2019 interrupt_target_command (char *args
, int from_tty
)
2021 if (target_can_async_p ())
2023 dont_repeat (); /* Not for the faint of heart */
2029 print_float_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
2030 struct frame_info
*frame
, const char *args
)
2032 if (gdbarch_print_float_info_p (gdbarch
))
2033 gdbarch_print_float_info (gdbarch
, file
, frame
, args
);
2037 int printed_something
= 0;
2040 regnum
< gdbarch_num_regs (current_gdbarch
)
2041 + gdbarch_num_pseudo_regs (current_gdbarch
);
2044 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, float_reggroup
))
2046 printed_something
= 1;
2047 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2050 if (!printed_something
)
2051 fprintf_filtered (file
, "\
2052 No floating-point info available for this processor.\n");
2057 float_info (char *args
, int from_tty
)
2059 if (!target_has_registers
)
2060 error (_("The program has no registers now."));
2062 print_float_info (current_gdbarch
, gdb_stdout
,
2063 get_selected_frame (NULL
), args
);
2067 unset_command (char *args
, int from_tty
)
2069 printf_filtered (_("\
2070 \"unset\" must be followed by the name of an unset subcommand.\n"));
2071 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
2075 _initialize_infcmd (void)
2077 struct cmd_list_element
*c
= NULL
;
2079 /* add the filename of the terminal connected to inferior I/O */
2080 add_setshow_filename_cmd ("inferior-tty", class_run
,
2081 &inferior_io_terminal
, _("\
2082 Set terminal for future runs of program being debugged."), _("\
2083 Show terminal for future runs of program being debugged."), _("\
2084 Usage: set inferior-tty /dev/pts/1"), NULL
, NULL
, &setlist
, &showlist
);
2085 add_com_alias ("tty", "set inferior-tty", class_alias
, 0);
2087 add_setshow_optional_filename_cmd ("args", class_run
,
2088 &inferior_args
, _("\
2089 Set argument list to give program being debugged when it is started."), _("\
2090 Show argument list to give program being debugged when it is started."), _("\
2091 Follow this command with any number of args, to be passed to the program."),
2094 &setlist
, &showlist
);
2096 c
= add_cmd ("environment", no_class
, environment_info
, _("\
2097 The environment to give the program, or one variable's value.\n\
2098 With an argument VAR, prints the value of environment variable VAR to\n\
2099 give the program being debugged. With no arguments, prints the entire\n\
2100 environment to be given to the program."), &showlist
);
2101 set_cmd_completer (c
, noop_completer
);
2103 add_prefix_cmd ("unset", no_class
, unset_command
,
2104 _("Complement to certain \"set\" commands."),
2105 &unsetlist
, "unset ", 0, &cmdlist
);
2107 c
= add_cmd ("environment", class_run
, unset_environment_command
, _("\
2108 Cancel environment variable VAR for the program.\n\
2109 This does not affect the program until the next \"run\" command."),
2111 set_cmd_completer (c
, noop_completer
);
2113 c
= add_cmd ("environment", class_run
, set_environment_command
, _("\
2114 Set environment variable value to give the program.\n\
2115 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2116 VALUES of environment variables are uninterpreted strings.\n\
2117 This does not affect the program until the next \"run\" command."),
2119 set_cmd_completer (c
, noop_completer
);
2121 c
= add_com ("path", class_files
, path_command
, _("\
2122 Add directory DIR(s) to beginning of search path for object files.\n\
2123 $cwd in the path means the current working directory.\n\
2124 This path is equivalent to the $PATH shell variable. It is a list of\n\
2125 directories, separated by colons. These directories are searched to find\n\
2126 fully linked executable files and separately compiled object files as needed."));
2127 set_cmd_completer (c
, filename_completer
);
2129 c
= add_cmd ("paths", no_class
, path_info
, _("\
2130 Current search path for finding object files.\n\
2131 $cwd in the path means the current working directory.\n\
2132 This path is equivalent to the $PATH shell variable. It is a list of\n\
2133 directories, separated by colons. These directories are searched to find\n\
2134 fully linked executable files and separately compiled object files as needed."),
2136 set_cmd_completer (c
, noop_completer
);
2138 add_com ("attach", class_run
, attach_command
, _("\
2139 Attach to a process or file outside of GDB.\n\
2140 This command attaches to another target, of the same type as your last\n\
2141 \"target\" command (\"info files\" will show your target stack).\n\
2142 The command may take as argument a process id or a device file.\n\
2143 For a process id, you must have permission to send the process a signal,\n\
2144 and it must have the same effective uid as the debugger.\n\
2145 When using \"attach\" with a process id, the debugger finds the\n\
2146 program running in the process, looking first in the current working\n\
2147 directory, or (if not found there) using the source file search path\n\
2148 (see the \"directory\" command). You can also use the \"file\" command\n\
2149 to specify the program, and to load its symbol table."));
2151 add_prefix_cmd ("detach", class_run
, detach_command
, _("\
2152 Detach a process or file previously attached.\n\
2153 If a process, it is no longer traced, and it continues its execution. If\n\
2154 you were debugging a file, the file is closed and gdb no longer accesses it."),
2155 &detachlist
, "detach ", 0, &cmdlist
);
2157 add_com ("disconnect", class_run
, disconnect_command
, _("\
2158 Disconnect from a target.\n\
2159 The target will wait for another debugger to connect. Not available for\n\
2162 add_com ("signal", class_run
, signal_command
, _("\
2163 Continue program giving it signal specified by the argument.\n\
2164 An argument of \"0\" means continue program without giving it a signal."));
2166 add_com ("stepi", class_run
, stepi_command
, _("\
2167 Step one instruction exactly.\n\
2168 Argument N means do this N times (or till program stops for another reason)."));
2169 add_com_alias ("si", "stepi", class_alias
, 0);
2171 add_com ("nexti", class_run
, nexti_command
, _("\
2172 Step one instruction, but proceed through subroutine calls.\n\
2173 Argument N means do this N times (or till program stops for another reason)."));
2174 add_com_alias ("ni", "nexti", class_alias
, 0);
2176 add_com ("finish", class_run
, finish_command
, _("\
2177 Execute until selected stack frame returns.\n\
2178 Upon return, the value returned is printed and put in the value history."));
2180 add_com ("next", class_run
, next_command
, _("\
2181 Step program, proceeding through subroutine calls.\n\
2182 Like the \"step\" command as long as subroutine calls do not happen;\n\
2183 when they do, the call is treated as one instruction.\n\
2184 Argument N means do this N times (or till program stops for another reason)."));
2185 add_com_alias ("n", "next", class_run
, 1);
2187 add_com_alias ("S", "next", class_run
, 1);
2189 add_com ("step", class_run
, step_command
, _("\
2190 Step program until it reaches a different source line.\n\
2191 Argument N means do this N times (or till program stops for another reason)."));
2192 add_com_alias ("s", "step", class_run
, 1);
2194 c
= add_com ("until", class_run
, until_command
, _("\
2195 Execute until the program reaches a source line greater than the current\n\
2196 or a specified location (same args as break command) within the current frame."));
2197 set_cmd_completer (c
, location_completer
);
2198 add_com_alias ("u", "until", class_run
, 1);
2200 c
= add_com ("advance", class_run
, advance_command
, _("\
2201 Continue the program up to the given location (same form as args for break command).\n\
2202 Execution will also stop upon exit from the current stack frame."));
2203 set_cmd_completer (c
, location_completer
);
2205 c
= add_com ("jump", class_run
, jump_command
, _("\
2206 Continue program being debugged at specified line or address.\n\
2207 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2208 for an address to start at."));
2209 set_cmd_completer (c
, location_completer
);
2213 c
= add_com ("go", class_run
, go_command
, _("\
2214 Usage: go <location>\n\
2215 Continue program being debugged, stopping at specified line or \n\
2217 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2218 expression for an address to start at.\n\
2219 This command is a combination of tbreak and jump."));
2220 set_cmd_completer (c
, location_completer
);
2224 add_com_alias ("g", "go", class_run
, 1);
2226 add_com ("continue", class_run
, continue_command
, _("\
2227 Continue program being debugged, after signal or breakpoint.\n\
2228 If proceeding from breakpoint, a number N may be used as an argument,\n\
2229 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2230 the breakpoint won't break until the Nth time it is reached)."));
2231 add_com_alias ("c", "cont", class_run
, 1);
2232 add_com_alias ("fg", "cont", class_run
, 1);
2234 c
= add_com ("run", class_run
, run_command
, _("\
2235 Start debugged program. You may specify arguments to give it.\n\
2236 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2237 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2238 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2239 To cancel previous arguments and run with no arguments,\n\
2240 use \"set args\" without arguments."));
2241 set_cmd_completer (c
, filename_completer
);
2242 add_com_alias ("r", "run", class_run
, 1);
2244 add_com ("R", class_run
, run_no_args_command
,
2245 _("Start debugged program with no arguments."));
2247 c
= add_com ("start", class_run
, start_command
, _("\
2248 Run the debugged program until the beginning of the main procedure.\n\
2249 You may specify arguments to give to your program, just as with the\n\
2250 \"run\" command."));
2251 set_cmd_completer (c
, filename_completer
);
2253 add_com ("interrupt", class_run
, interrupt_target_command
,
2254 _("Interrupt the execution of the debugged program."));
2256 add_info ("registers", nofp_registers_info
, _("\
2257 List of integer registers and their contents, for selected stack frame.\n\
2258 Register name as argument means describe only that register."));
2259 add_info_alias ("r", "registers", 1);
2262 add_com ("lr", class_info
, nofp_registers_info
, _("\
2263 List of integer registers and their contents, for selected stack frame.\n\
2264 Register name as argument means describe only that register."));
2265 add_info ("all-registers", all_registers_info
, _("\
2266 List of all registers and their contents, for selected stack frame.\n\
2267 Register name as argument means describe only that register."));
2269 add_info ("program", program_info
,
2270 _("Execution status of the program."));
2272 add_info ("float", float_info
,
2273 _("Print the status of the floating point unit\n"));
2275 add_info ("vector", vector_info
,
2276 _("Print the status of the vector unit\n"));
2278 inferior_environ
= make_environ ();
2279 init_environ (inferior_environ
);