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 /* Range to single step within.
181 If this is nonzero, respond to a single-step signal
182 by continuing to step if the pc is in this range. */
184 CORE_ADDR step_range_start
; /* Inclusive */
185 CORE_ADDR step_range_end
; /* Exclusive */
187 /* Stack frame address as of when stepping command was issued.
188 This is how we know when we step into a subroutine call,
189 and how to set the frame for the breakpoint used to step out. */
191 struct frame_id step_frame_id
;
193 enum step_over_calls_kind step_over_calls
;
195 /* If stepping, nonzero means step count is > 1
196 so don't print frame next time inferior stops
197 if it stops due to stepping. */
201 /* Environment to use for running inferior,
202 in format described in environ.h. */
204 struct gdb_environ
*inferior_environ
;
206 /* When set, no calls to target_resumed observer will be made. */
207 int suppress_resume_observer
= 0;
208 /* When set, normal_stop will not call the normal_stop observer. */
209 int suppress_stop_observer
= 0;
211 /* Accessor routines. */
214 set_inferior_io_terminal (const char *terminal_name
)
216 if (inferior_io_terminal
)
217 xfree (inferior_io_terminal
);
220 inferior_io_terminal
= NULL
;
222 inferior_io_terminal
= savestring (terminal_name
, strlen (terminal_name
));
226 get_inferior_io_terminal (void)
228 return inferior_io_terminal
;
232 get_inferior_args (void)
234 if (inferior_argc
!= 0)
238 n
= gdbarch_construct_inferior_arguments (current_gdbarch
,
239 inferior_argc
, inferior_argv
);
240 old
= set_inferior_args (n
);
244 if (inferior_args
== NULL
)
245 inferior_args
= xstrdup ("");
247 return inferior_args
;
251 set_inferior_args (char *newargs
)
253 char *saved_args
= inferior_args
;
255 inferior_args
= newargs
;
263 set_inferior_args_vector (int argc
, char **argv
)
265 inferior_argc
= argc
;
266 inferior_argv
= argv
;
269 /* Notice when `set args' is run. */
271 notice_args_set (char *args
, int from_tty
, struct cmd_list_element
*c
)
277 /* Notice when `show args' is run. */
279 notice_args_read (struct ui_file
*file
, int from_tty
,
280 struct cmd_list_element
*c
, const char *value
)
282 /* Note that we ignore the passed-in value in favor of computing it
284 deprecated_show_value_hack (file
, from_tty
, c
, get_inferior_args ());
288 /* Compute command-line string given argument vector. This does the
289 same shell processing as fork_inferior. */
291 construct_inferior_arguments (struct gdbarch
*gdbarch
, int argc
, char **argv
)
295 if (STARTUP_WITH_SHELL
)
297 /* This holds all the characters considered special to the
298 typical Unix shells. We include `^' because the SunOS
299 /bin/sh treats it as a synonym for `|'. */
300 char *special
= "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
305 /* We over-compute the size. It shouldn't matter. */
306 for (i
= 0; i
< argc
; ++i
)
307 length
+= 2 * strlen (argv
[i
]) + 1 + 2 * (argv
[i
][0] == '\0');
309 result
= (char *) xmalloc (length
);
312 for (i
= 0; i
< argc
; ++i
)
317 /* Need to handle empty arguments specially. */
318 if (argv
[i
][0] == '\0')
325 for (cp
= argv
[i
]; *cp
; ++cp
)
327 if (strchr (special
, *cp
) != NULL
)
337 /* In this case we can't handle arguments that contain spaces,
338 tabs, or newlines -- see breakup_args(). */
342 for (i
= 0; i
< argc
; ++i
)
344 char *cp
= strchr (argv
[i
], ' ');
346 cp
= strchr (argv
[i
], '\t');
348 cp
= strchr (argv
[i
], '\n');
350 error (_("can't handle command-line argument containing whitespace"));
351 length
+= strlen (argv
[i
]) + 1;
354 result
= (char *) xmalloc (length
);
356 for (i
= 0; i
< argc
; ++i
)
359 strcat (result
, " ");
360 strcat (result
, argv
[i
]);
368 /* This function detects whether or not a '&' character (indicating
369 background execution) has been added as *the last* of the arguments ARGS
370 of a command. If it has, it removes it and returns 1. Otherwise it
371 does nothing and returns 0. */
373 strip_bg_char (char **args
)
377 p
= strchr (*args
, '&');
381 if (p
== (*args
+ strlen (*args
) - 1))
383 if (strlen (*args
) > 1)
387 while (*p
== ' ' || *p
== '\t');
399 tty_command (char *file
, int from_tty
)
402 error_no_arg (_("terminal name for running target process"));
404 set_inferior_io_terminal (file
);
407 /* Common actions to take after creating any sort of inferior, by any
408 means (running, attaching, connecting, et cetera). The target
409 should be stopped. */
412 post_create_inferior (struct target_ops
*target
, int from_tty
)
414 /* Be sure we own the terminal in case write operations are performed. */
415 target_terminal_ours ();
417 /* If the target hasn't taken care of this already, do it now.
418 Targets which need to access registers during to_open,
419 to_create_inferior, or to_attach should do it earlier; but many
421 target_find_description ();
425 /* Sometimes the platform-specific hook loads initial shared
426 libraries, and sometimes it doesn't. Try to do so first, so
427 that we can add them with the correct value for FROM_TTY.
428 If we made all the inferior hook methods consistent,
429 this call could be removed. */
431 SOLIB_ADD (NULL
, from_tty
, target
, auto_solib_add
);
433 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
436 /* Create the hooks to handle shared library load and unload
438 #ifdef SOLIB_CREATE_INFERIOR_HOOK
439 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid
));
441 solib_create_inferior_hook ();
445 observer_notify_inferior_created (target
, from_tty
);
448 /* Kill the inferior if already running. This function is designed
449 to be called when we are about to start the execution of the program
450 from the beginning. Ask the user to confirm that he wants to restart
451 the program being debugged when FROM_TTY is non-null. */
454 kill_if_already_running (int from_tty
)
456 if (! ptid_equal (inferior_ptid
, null_ptid
) && target_has_execution
)
458 /* Bail out before killing the program if we will not be able to
460 target_require_runnable ();
463 && !query ("The program being debugged has been started already.\n\
464 Start it from the beginning? "))
465 error (_("Program not restarted."));
467 no_shared_libraries (NULL
, from_tty
);
468 init_wait_for_inferior ();
472 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
473 a temporary breakpoint at the begining of the main program before
474 running the program. */
477 run_command_1 (char *args
, int from_tty
, int tbreak_at_main
)
483 kill_if_already_running (from_tty
);
484 clear_breakpoint_hit_counts ();
486 /* Clean up any leftovers from other runs. Some other things from
487 this function should probably be moved into target_pre_inferior. */
488 target_pre_inferior (from_tty
);
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 if (non_stop
&& !target_supports_non_stop ())
507 error (_("The target does not support running in non-stop mode."));
509 /* We keep symbols from add-symbol-file, on the grounds that the
510 user might want to add some symbols before running the program
511 (right?). But sometimes (dynamic loading where the user manually
512 introduces the new symbols with add-symbol-file), the code which
513 the symbols describe does not persist between runs. Currently
514 the user has to manually nuke all symbols between runs if they
515 want them to go away (PR 2207). This is probably reasonable. */
519 if (target_can_async_p ())
520 async_disable_stdin ();
524 int async_exec
= strip_bg_char (&args
);
526 /* If we get a request for running in the bg but the target
527 doesn't support it, error out. */
528 if (async_exec
&& !target_can_async_p ())
529 error (_("Asynchronous execution not supported on this target."));
531 /* If we don't get a request of running in the bg, then we need
532 to simulate synchronous (fg) execution. */
533 if (!async_exec
&& target_can_async_p ())
535 /* Simulate synchronous execution */
536 async_disable_stdin ();
539 /* If there were other args, beside '&', process them. */
542 char *old_args
= set_inferior_args (xstrdup (args
));
549 ui_out_field_string (uiout
, NULL
, "Starting program");
550 ui_out_text (uiout
, ": ");
552 ui_out_field_string (uiout
, "execfile", exec_file
);
553 ui_out_spaces (uiout
, 1);
554 /* We call get_inferior_args() because we might need to compute
556 ui_out_field_string (uiout
, "infargs", get_inferior_args ());
557 ui_out_text (uiout
, "\n");
558 ui_out_flush (uiout
);
561 /* We call get_inferior_args() because we might need to compute
563 target_create_inferior (exec_file
, get_inferior_args (),
564 environ_vector (inferior_environ
), from_tty
);
566 /* Pass zero for FROM_TTY, because at this point the "run" command
567 has done its thing; now we are setting up the running program. */
568 post_create_inferior (¤t_target
, 0);
570 /* Start the target running. */
571 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
576 run_command (char *args
, int from_tty
)
578 run_command_1 (args
, from_tty
, 0);
582 run_no_args_command (char *args
, int from_tty
)
584 char *old_args
= set_inferior_args (xstrdup (""));
589 /* Start the execution of the program up until the beginning of the main
593 start_command (char *args
, int from_tty
)
595 /* Some languages such as Ada need to search inside the program
596 minimal symbols for the location where to put the temporary
597 breakpoint before starting. */
598 if (!have_minimal_symbols ())
599 error (_("No symbol table loaded. Use the \"file\" command."));
601 /* Run the program until reaching the main procedure... */
602 run_command_1 (args
, from_tty
, 1);
606 proceed_thread_callback (struct thread_info
*thread
, void *arg
)
608 if (!is_stopped (thread
->ptid
))
611 context_switch_to (thread
->ptid
);
612 clear_proceed_status ();
613 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
618 continue_1 (int all_threads
)
622 if (non_stop
&& all_threads
)
624 /* Don't error out if the current thread is running, because
625 there may be other stopped threads. */
626 struct cleanup
*old_chain
;
628 /* Backup current thread and selected frame. */
629 old_chain
= make_cleanup_restore_current_thread ();
631 iterate_over_threads (proceed_thread_callback
, NULL
);
633 /* Restore selected ptid. */
634 do_cleanups (old_chain
);
638 ensure_not_running ();
639 clear_proceed_status ();
640 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
644 /* continue [-a] [proceed-count] [&] */
646 continue_command (char *args
, int from_tty
)
652 /* Find out whether we must run in the background. */
654 async_exec
= strip_bg_char (&args
);
656 /* If we must run in the background, but the target can't do it,
658 if (async_exec
&& !target_can_async_p ())
659 error (_("Asynchronous execution not supported on this target."));
661 /* If we are not asked to run in the bg, then prepare to run in the
662 foreground, synchronously. */
663 if (!async_exec
&& target_can_async_p ())
665 /* Simulate synchronous execution */
666 async_disable_stdin ();
671 if (strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
674 args
+= sizeof ("-a") - 1;
680 if (!non_stop
&& all_threads
)
681 error (_("`-a' is meaningless in all-stop mode."));
683 if (args
!= NULL
&& all_threads
)
685 Can't resume all threads and specify proceed count simultaneously."));
687 /* If we have an argument left, set proceed count of breakpoint we
691 bpstat bs
= stop_bpstat
;
695 while ((stat
= bpstat_num (&bs
, &num
)) != 0)
698 set_ignore_count (num
,
699 parse_and_eval_long (args
) - 1,
701 /* set_ignore_count prints a message ending with a period.
702 So print two spaces before "Continuing.". */
704 printf_filtered (" ");
708 if (!stopped
&& from_tty
)
711 ("Not stopped at any breakpoint; argument ignored.\n");
716 printf_filtered (_("Continuing.\n"));
718 continue_1 (all_threads
);
721 /* Step until outside of current statement. */
724 step_command (char *count_string
, int from_tty
)
726 step_1 (0, 0, count_string
);
729 /* Likewise, but skip over subroutine calls as if single instructions. */
732 next_command (char *count_string
, int from_tty
)
734 step_1 (1, 0, count_string
);
737 /* Likewise, but step only one instruction. */
740 stepi_command (char *count_string
, int from_tty
)
742 step_1 (0, 1, count_string
);
746 nexti_command (char *count_string
, int from_tty
)
748 step_1 (1, 1, count_string
);
752 delete_longjmp_breakpoint_cleanup (void *arg
)
754 int thread
= * (int *) arg
;
755 delete_longjmp_breakpoint (thread
);
759 step_1 (int skip_subroutines
, int single_inst
, char *count_string
)
762 struct frame_info
*frame
;
763 struct cleanup
*cleanups
= make_cleanup (null_cleanup
, NULL
);
768 ensure_not_running ();
771 async_exec
= strip_bg_char (&count_string
);
773 /* If we get a request for running in the bg but the target
774 doesn't support it, error out. */
775 if (async_exec
&& !target_can_async_p ())
776 error (_("Asynchronous execution not supported on this target."));
778 /* If we don't get a request of running in the bg, then we need
779 to simulate synchronous (fg) execution. */
780 if (!async_exec
&& target_can_async_p ())
782 /* Simulate synchronous execution */
783 async_disable_stdin ();
786 count
= count_string
? parse_and_eval_long (count_string
) : 1;
788 if (!single_inst
|| skip_subroutines
) /* leave si command alone */
790 if (in_thread_list (inferior_ptid
))
791 thread
= pid_to_thread_id (inferior_ptid
);
793 set_longjmp_breakpoint ();
795 make_cleanup (delete_longjmp_breakpoint_cleanup
, &thread
);
798 /* In synchronous case, all is well, just use the regular for loop. */
799 if (!target_can_async_p ())
801 for (; count
> 0; count
--)
803 clear_proceed_status ();
805 frame
= get_current_frame ();
806 if (!frame
) /* Avoid coredump here. Why tho? */
807 error (_("No current frame"));
808 step_frame_id
= get_frame_id (frame
);
812 find_pc_line_pc_range (stop_pc
, &step_range_start
, &step_range_end
);
813 if (step_range_end
== 0)
816 if (find_pc_partial_function (stop_pc
, &name
, &step_range_start
,
817 &step_range_end
) == 0)
818 error (_("Cannot find bounds of current function"));
820 target_terminal_ours ();
821 printf_filtered (_("\
822 Single stepping until exit from function %s, \n\
823 which has no line number information.\n"), name
);
828 /* Say we are stepping, but stop after one insn whatever it does. */
829 step_range_start
= step_range_end
= 1;
830 if (!skip_subroutines
)
832 Don't step over function calls, not even to functions lacking
834 step_over_calls
= STEP_OVER_NONE
;
837 if (skip_subroutines
)
838 step_over_calls
= STEP_OVER_ALL
;
840 step_multi
= (count
> 1);
841 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
847 do_cleanups (cleanups
);
850 /* In case of asynchronous target things get complicated, do only
851 one step for now, before returning control to the event loop. Let
852 the continuation figure out how many other steps we need to do,
853 and handle them one at the time, through step_once(). */
856 step_once (skip_subroutines
, single_inst
, count
, thread
);
857 /* We are running, and the continuation is installed. It will
858 disable the longjmp breakpoint as appropriate. */
859 discard_cleanups (cleanups
);
863 struct step_1_continuation_args
866 int skip_subroutines
;
871 /* Called after we are done with one step operation, to check whether
872 we need to step again, before we print the prompt and return control
873 to the user. If count is > 1, we will need to do one more call to
874 proceed(), via step_once(). Basically it is like step_once and
875 step_1_continuation are co-recursive. */
877 step_1_continuation (void *args
)
879 struct step_1_continuation_args
*a
= args
;
881 if (!step_multi
|| !stop_step
)
883 /* If we stopped for some reason that is not stepping there are
884 no further steps to make. Cleanup. */
885 if (!a
->single_inst
|| a
->skip_subroutines
)
886 delete_longjmp_breakpoint (a
->thread
);
890 step_once (a
->skip_subroutines
, a
->single_inst
, a
->count
- 1, a
->thread
);
893 /* Do just one step operation. If count >1 we will have to set up a
894 continuation to be done after the target stops (after this one
895 step). This is useful to implement the 'step n' kind of commands, in
896 case of asynchronous targets. We had to split step_1 into two parts,
897 one to be done before proceed() and one afterwards. This function is
898 called in case of step n with n>1, after the first step operation has
901 step_once (int skip_subroutines
, int single_inst
, int count
, int thread
)
903 struct frame_info
*frame
;
904 struct step_1_continuation_args
*args
;
908 clear_proceed_status ();
910 frame
= get_current_frame ();
911 if (!frame
) /* Avoid coredump here. Why tho? */
912 error (_("No current frame"));
913 step_frame_id
= get_frame_id (frame
);
917 find_pc_line_pc_range (stop_pc
, &step_range_start
, &step_range_end
);
919 /* If we have no line info, switch to stepi mode. */
920 if (step_range_end
== 0 && step_stop_if_no_debug
)
922 step_range_start
= step_range_end
= 1;
924 else if (step_range_end
== 0)
927 if (find_pc_partial_function (stop_pc
, &name
, &step_range_start
,
928 &step_range_end
) == 0)
929 error (_("Cannot find bounds of current function"));
931 target_terminal_ours ();
932 printf_filtered (_("\
933 Single stepping until exit from function %s, \n\
934 which has no line number information.\n"), name
);
939 /* Say we are stepping, but stop after one insn whatever it does. */
940 step_range_start
= step_range_end
= 1;
941 if (!skip_subroutines
)
943 Don't step over function calls, not even to functions lacking
945 step_over_calls
= STEP_OVER_NONE
;
948 if (skip_subroutines
)
949 step_over_calls
= STEP_OVER_ALL
;
951 step_multi
= (count
> 1);
952 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
954 args
= xmalloc (sizeof (*args
));
955 args
->skip_subroutines
= skip_subroutines
;
956 args
->single_inst
= single_inst
;
958 args
->thread
= thread
;
959 add_intermediate_continuation (step_1_continuation
, args
, xfree
);
964 /* Continue program at specified address. */
967 jump_command (char *arg
, int from_tty
)
970 struct symtabs_and_lines sals
;
971 struct symtab_and_line sal
;
977 ensure_not_running ();
979 /* Find out whether we must run in the background. */
981 async_exec
= strip_bg_char (&arg
);
983 /* If we must run in the background, but the target can't do it,
985 if (async_exec
&& !target_can_async_p ())
986 error (_("Asynchronous execution not supported on this target."));
989 error_no_arg (_("starting address"));
991 sals
= decode_line_spec_1 (arg
, 1);
994 error (_("Unreasonable jump request"));
1000 if (sal
.symtab
== 0 && sal
.pc
== 0)
1001 error (_("No source file has been specified."));
1003 resolve_sal_pc (&sal
); /* May error out */
1005 /* See if we are trying to jump to another function. */
1006 fn
= get_frame_function (get_current_frame ());
1007 sfn
= find_pc_function (sal
.pc
);
1008 if (fn
!= NULL
&& sfn
!= fn
)
1010 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal
.line
,
1011 SYMBOL_PRINT_NAME (fn
)))
1013 error (_("Not confirmed."));
1020 fixup_symbol_section (sfn
, 0);
1021 if (section_is_overlay (SYMBOL_BFD_SECTION (sfn
)) &&
1022 !section_is_mapped (SYMBOL_BFD_SECTION (sfn
)))
1024 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
1026 error (_("Not confirmed."));
1036 printf_filtered (_("Continuing at "));
1037 fputs_filtered (paddress (addr
), gdb_stdout
);
1038 printf_filtered (".\n");
1041 /* If we are not asked to run in the bg, then prepare to run in the
1042 foreground, synchronously. */
1043 if (!async_exec
&& target_can_async_p ())
1045 /* Simulate synchronous execution */
1046 async_disable_stdin ();
1049 clear_proceed_status ();
1050 proceed (addr
, TARGET_SIGNAL_0
, 0);
1054 /* Go to line or address in current procedure */
1056 go_command (char *line_no
, int from_tty
)
1058 if (line_no
== (char *) NULL
|| !*line_no
)
1059 printf_filtered (GO_USAGE
);
1062 tbreak_command (line_no
, from_tty
);
1063 jump_command (line_no
, from_tty
);
1068 /* Continue program giving it specified signal. */
1071 signal_command (char *signum_exp
, int from_tty
)
1073 enum target_signal oursig
;
1076 dont_repeat (); /* Too dangerous. */
1078 ensure_not_running ();
1080 /* Find out whether we must run in the background. */
1081 if (signum_exp
!= NULL
)
1082 async_exec
= strip_bg_char (&signum_exp
);
1084 /* If we must run in the background, but the target can't do it,
1086 if (async_exec
&& !target_can_async_p ())
1087 error (_("Asynchronous execution not supported on this target."));
1089 /* If we are not asked to run in the bg, then prepare to run in the
1090 foreground, synchronously. */
1091 if (!async_exec
&& target_can_async_p ())
1093 /* Simulate synchronous execution. */
1094 async_disable_stdin ();
1098 error_no_arg (_("signal number"));
1100 /* It would be even slicker to make signal names be valid expressions,
1101 (the type could be "enum $signal" or some such), then the user could
1102 assign them to convenience variables. */
1103 oursig
= target_signal_from_name (signum_exp
);
1105 if (oursig
== TARGET_SIGNAL_UNKNOWN
)
1107 /* No, try numeric. */
1108 int num
= parse_and_eval_long (signum_exp
);
1111 oursig
= TARGET_SIGNAL_0
;
1113 oursig
= target_signal_from_command (num
);
1118 if (oursig
== TARGET_SIGNAL_0
)
1119 printf_filtered (_("Continuing with no signal.\n"));
1121 printf_filtered (_("Continuing with signal %s.\n"),
1122 target_signal_to_name (oursig
));
1125 clear_proceed_status ();
1126 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1127 FIXME: Neither should "signal foo" but when I tried passing
1128 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1129 tried to track down yet. */
1130 proceed (oursig
== TARGET_SIGNAL_0
? (CORE_ADDR
) -1 : stop_pc
, oursig
, 0);
1133 /* Proceed until we reach a different source line with pc greater than
1134 our current one or exit the function. We skip calls in both cases.
1136 Note that eventually this command should probably be changed so
1137 that only source lines are printed out when we hit the breakpoint
1138 we set. This may involve changes to wait_for_inferior and the
1139 proceed status code. */
1142 until_next_command (int from_tty
)
1144 struct frame_info
*frame
;
1146 struct symbol
*func
;
1147 struct symtab_and_line sal
;
1149 clear_proceed_status ();
1151 frame
= get_current_frame ();
1153 /* Step until either exited from this function or greater
1154 than the current line (if in symbolic section) or pc (if
1158 func
= find_pc_function (pc
);
1162 struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (pc
);
1164 if (msymbol
== NULL
)
1165 error (_("Execution is not within a known function."));
1167 step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
1168 step_range_end
= pc
;
1172 sal
= find_pc_line (pc
, 0);
1174 step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
1175 step_range_end
= sal
.end
;
1178 step_over_calls
= STEP_OVER_ALL
;
1179 step_frame_id
= get_frame_id (frame
);
1181 step_multi
= 0; /* Only one call to proceed */
1183 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
1187 until_command (char *arg
, int from_tty
)
1191 if (!target_has_execution
)
1192 error (_("The program is not running."));
1194 /* Find out whether we must run in the background. */
1196 async_exec
= strip_bg_char (&arg
);
1198 /* If we must run in the background, but the target can't do it,
1200 if (async_exec
&& !target_can_async_p ())
1201 error (_("Asynchronous execution not supported on this target."));
1203 /* If we are not asked to run in the bg, then prepare to run in the
1204 foreground, synchronously. */
1205 if (!async_exec
&& target_can_async_p ())
1207 /* Simulate synchronous execution */
1208 async_disable_stdin ();
1212 until_break_command (arg
, from_tty
, 0);
1214 until_next_command (from_tty
);
1218 advance_command (char *arg
, int from_tty
)
1222 if (!target_has_execution
)
1223 error (_("The program is not running."));
1226 error_no_arg (_("a location"));
1228 /* Find out whether we must run in the background. */
1230 async_exec
= strip_bg_char (&arg
);
1232 /* If we must run in the background, but the target can't do it,
1234 if (async_exec
&& !target_can_async_p ())
1235 error (_("Asynchronous execution not supported on this target."));
1237 /* If we are not asked to run in the bg, then prepare to run in the
1238 foreground, synchronously. */
1239 if (!async_exec
&& target_can_async_p ())
1241 /* Simulate synchronous execution. */
1242 async_disable_stdin ();
1245 until_break_command (arg
, from_tty
, 1);
1248 /* Print the result of a function at the end of a 'finish' command. */
1251 print_return_value (struct type
*func_type
, struct type
*value_type
)
1253 struct gdbarch
*gdbarch
= current_gdbarch
;
1254 struct cleanup
*old_chain
;
1255 struct ui_stream
*stb
;
1256 struct value
*value
;
1258 CHECK_TYPEDEF (value_type
);
1259 gdb_assert (TYPE_CODE (value_type
) != TYPE_CODE_VOID
);
1261 /* FIXME: 2003-09-27: When returning from a nested inferior function
1262 call, it's possible (with no help from the architecture vector)
1263 to locate and return/print a "struct return" value. This is just
1264 a more complicated case of what is already being done in in the
1265 inferior function call code. In fact, when inferior function
1266 calls are made async, this will likely be made the norm. */
1268 switch (gdbarch_return_value (gdbarch
, func_type
, value_type
,
1271 case RETURN_VALUE_REGISTER_CONVENTION
:
1272 case RETURN_VALUE_ABI_RETURNS_ADDRESS
:
1273 case RETURN_VALUE_ABI_PRESERVES_ADDRESS
:
1274 value
= allocate_value (value_type
);
1275 gdbarch_return_value (gdbarch
, func_type
, value_type
, stop_registers
,
1276 value_contents_raw (value
), NULL
);
1278 case RETURN_VALUE_STRUCT_CONVENTION
:
1282 internal_error (__FILE__
, __LINE__
, _("bad switch"));
1288 stb
= ui_out_stream_new (uiout
);
1289 old_chain
= make_cleanup_ui_out_stream_delete (stb
);
1290 ui_out_text (uiout
, "Value returned is ");
1291 ui_out_field_fmt (uiout
, "gdb-result-var", "$%d",
1292 record_latest_value (value
));
1293 ui_out_text (uiout
, " = ");
1294 value_print (value
, stb
->stream
, 0, Val_no_prettyprint
);
1295 ui_out_field_stream (uiout
, "return-value", stb
);
1296 ui_out_text (uiout
, "\n");
1297 do_cleanups (old_chain
);
1301 ui_out_text (uiout
, "Value returned has type: ");
1302 ui_out_field_string (uiout
, "return-type", TYPE_NAME (value_type
));
1303 ui_out_text (uiout
, ".");
1304 ui_out_text (uiout
, " Cannot determine contents\n");
1308 /* Stuff that needs to be done by the finish command after the target
1309 has stopped. In asynchronous mode, we wait for the target to stop
1310 in the call to poll or select in the event loop, so it is
1311 impossible to do all the stuff as part of the finish_command
1312 function itself. The only chance we have to complete this command
1313 is in fetch_inferior_event, which is called by the event loop as
1314 soon as it detects that the target has stopped. This function is
1315 called via the cmd_continuation pointer. */
1317 struct finish_command_continuation_args
1319 struct breakpoint
*breakpoint
;
1320 struct symbol
*function
;
1324 finish_command_continuation (void *arg
)
1326 struct finish_command_continuation_args
*a
= arg
;
1328 if (bpstat_find_breakpoint (stop_bpstat
, a
->breakpoint
) != NULL
1329 && a
->function
!= NULL
)
1331 struct type
*value_type
;
1333 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (a
->function
));
1335 internal_error (__FILE__
, __LINE__
,
1336 _("finish_command: function has no target type"));
1338 if (TYPE_CODE (value_type
) != TYPE_CODE_VOID
)
1339 print_return_value (SYMBOL_TYPE (a
->function
), value_type
);
1342 /* We suppress normal call of normal_stop observer and do it here so
1343 that that *stopped notification includes the return value. */
1344 /* NOTE: This is broken in non-stop mode. There is no guarantee the
1345 next stop will be in the same thread that we started doing a
1346 finish on. This suppressing (or some other replacement means)
1347 should be a thread property. */
1348 observer_notify_normal_stop (stop_bpstat
);
1349 suppress_stop_observer
= 0;
1350 delete_breakpoint (a
->breakpoint
);
1354 finish_command_continuation_free_arg (void *arg
)
1356 /* NOTE: See finish_command_continuation. This would go away, if
1357 this suppressing is made a thread property. */
1358 suppress_stop_observer
= 0;
1362 /* "finish": Set a temporary breakpoint at the place the selected
1363 frame will return to, then continue. */
1366 finish_command (char *arg
, int from_tty
)
1368 struct symtab_and_line sal
;
1369 struct frame_info
*frame
;
1370 struct symbol
*function
;
1371 struct breakpoint
*breakpoint
;
1372 struct cleanup
*old_chain
;
1373 struct finish_command_continuation_args
*cargs
;
1377 /* Find out whether we must run in the background. */
1379 async_exec
= strip_bg_char (&arg
);
1381 /* If we must run in the background, but the target can't do it,
1383 if (async_exec
&& !target_can_async_p ())
1384 error (_("Asynchronous execution not supported on this target."));
1386 /* If we are not asked to run in the bg, then prepare to run in the
1387 foreground, synchronously. */
1388 if (!async_exec
&& target_can_async_p ())
1390 /* Simulate synchronous execution. */
1391 async_disable_stdin ();
1395 error (_("The \"finish\" command does not take any arguments."));
1396 if (!target_has_execution
)
1397 error (_("The program is not running."));
1399 frame
= get_prev_frame (get_selected_frame (_("No selected frame.")));
1401 error (_("\"finish\" not meaningful in the outermost frame."));
1403 clear_proceed_status ();
1405 sal
= find_pc_line (get_frame_pc (frame
), 0);
1406 sal
.pc
= get_frame_pc (frame
);
1408 breakpoint
= set_momentary_breakpoint (sal
, get_frame_id (frame
), bp_finish
);
1410 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1412 /* Find the function we will return from. */
1414 function
= find_pc_function (get_frame_pc (get_selected_frame (NULL
)));
1416 /* Print info on the selected frame, including level number but not
1420 printf_filtered (_("Run till exit from "));
1421 print_stack_frame (get_selected_frame (NULL
), 1, LOCATION
);
1424 proceed_to_finish
= 1; /* We want stop_registers, please... */
1425 make_cleanup_restore_integer (&suppress_stop_observer
);
1426 suppress_stop_observer
= 1;
1427 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1429 cargs
= xmalloc (sizeof (*cargs
));
1431 cargs
->breakpoint
= breakpoint
;
1432 cargs
->function
= function
;
1433 add_continuation (finish_command_continuation
, cargs
,
1434 finish_command_continuation_free_arg
);
1436 discard_cleanups (old_chain
);
1437 if (!target_can_async_p ())
1438 do_all_continuations ();
1443 program_info (char *args
, int from_tty
)
1445 bpstat bs
= stop_bpstat
;
1447 int stat
= bpstat_num (&bs
, &num
);
1449 if (!target_has_execution
)
1451 printf_filtered (_("The program being debugged is not being run.\n"));
1455 target_files_info ();
1456 printf_filtered (_("Program stopped at %s.\n"),
1457 hex_string ((unsigned long) stop_pc
));
1459 printf_filtered (_("It stopped after being stepped.\n"));
1462 /* There may be several breakpoints in the same place, so this
1463 isn't as strange as it seems. */
1468 printf_filtered (_("\
1469 It stopped at a breakpoint that has since been deleted.\n"));
1472 printf_filtered (_("It stopped at breakpoint %d.\n"), num
);
1473 stat
= bpstat_num (&bs
, &num
);
1476 else if (stop_signal
!= TARGET_SIGNAL_0
)
1478 printf_filtered (_("It stopped with signal %s, %s.\n"),
1479 target_signal_to_name (stop_signal
),
1480 target_signal_to_string (stop_signal
));
1485 printf_filtered (_("\
1486 Type \"info stack\" or \"info registers\" for more information.\n"));
1491 environment_info (char *var
, int from_tty
)
1495 char *val
= get_in_environ (inferior_environ
, var
);
1498 puts_filtered (var
);
1499 puts_filtered (" = ");
1500 puts_filtered (val
);
1501 puts_filtered ("\n");
1505 puts_filtered ("Environment variable \"");
1506 puts_filtered (var
);
1507 puts_filtered ("\" not defined.\n");
1512 char **vector
= environ_vector (inferior_environ
);
1515 puts_filtered (*vector
++);
1516 puts_filtered ("\n");
1522 set_environment_command (char *arg
, int from_tty
)
1524 char *p
, *val
, *var
;
1528 error_no_arg (_("environment variable and value"));
1530 /* Find seperation between variable name and value */
1531 p
= (char *) strchr (arg
, '=');
1532 val
= (char *) strchr (arg
, ' ');
1534 if (p
!= 0 && val
!= 0)
1536 /* We have both a space and an equals. If the space is before the
1537 equals, walk forward over the spaces til we see a nonspace
1538 (possibly the equals). */
1543 /* Now if the = is after the char following the spaces,
1544 take the char following the spaces. */
1548 else if (val
!= 0 && p
== 0)
1552 error_no_arg (_("environment variable to set"));
1554 if (p
== 0 || p
[1] == 0)
1558 p
= arg
+ strlen (arg
); /* So that savestring below will work */
1562 /* Not setting variable value to null */
1564 while (*val
== ' ' || *val
== '\t')
1568 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t'))
1571 var
= savestring (arg
, p
- arg
);
1574 printf_filtered (_("\
1575 Setting environment variable \"%s\" to null value.\n"),
1577 set_in_environ (inferior_environ
, var
, "");
1580 set_in_environ (inferior_environ
, var
, val
);
1585 unset_environment_command (char *var
, int from_tty
)
1589 /* If there is no argument, delete all environment variables.
1590 Ask for confirmation if reading from the terminal. */
1591 if (!from_tty
|| query (_("Delete all environment variables? ")))
1593 free_environ (inferior_environ
);
1594 inferior_environ
= make_environ ();
1598 unset_in_environ (inferior_environ
, var
);
1601 /* Handle the execution path (PATH variable) */
1603 static const char path_var_name
[] = "PATH";
1606 path_info (char *args
, int from_tty
)
1608 puts_filtered ("Executable and object file path: ");
1609 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
1610 puts_filtered ("\n");
1613 /* Add zero or more directories to the front of the execution path. */
1616 path_command (char *dirname
, int from_tty
)
1621 env
= get_in_environ (inferior_environ
, path_var_name
);
1622 /* Can be null if path is not set */
1625 exec_path
= xstrdup (env
);
1626 mod_path (dirname
, &exec_path
);
1627 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
1630 path_info ((char *) NULL
, from_tty
);
1634 /* Print out the machine register regnum. If regnum is -1, print all
1635 registers (print_all == 1) or all non-float and non-vector
1636 registers (print_all == 0).
1638 For most machines, having all_registers_info() print the
1639 register(s) one per line is good enough. If a different format is
1640 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1641 regs), or there is an existing convention for showing all the
1642 registers, define the architecture method PRINT_REGISTERS_INFO to
1643 provide that format. */
1646 default_print_registers_info (struct gdbarch
*gdbarch
,
1647 struct ui_file
*file
,
1648 struct frame_info
*frame
,
1649 int regnum
, int print_all
)
1652 const int numregs
= gdbarch_num_regs (gdbarch
)
1653 + gdbarch_num_pseudo_regs (gdbarch
);
1654 gdb_byte buffer
[MAX_REGISTER_SIZE
];
1656 for (i
= 0; i
< numregs
; i
++)
1658 /* Decide between printing all regs, non-float / vector regs, or
1664 if (!gdbarch_register_reggroup_p (gdbarch
, i
, all_reggroup
))
1669 if (!gdbarch_register_reggroup_p (gdbarch
, i
, general_reggroup
))
1679 /* If the register name is empty, it is undefined for this
1680 processor, so don't display anything. */
1681 if (gdbarch_register_name (gdbarch
, i
) == NULL
1682 || *(gdbarch_register_name (gdbarch
, i
)) == '\0')
1685 fputs_filtered (gdbarch_register_name (gdbarch
, i
), file
);
1686 print_spaces_filtered (15 - strlen (gdbarch_register_name
1687 (gdbarch
, i
)), file
);
1689 /* Get the data in raw format. */
1690 if (! frame_register_read (frame
, i
, buffer
))
1692 fprintf_filtered (file
, "*value not available*\n");
1696 /* If virtual format is floating, print it that way, and in raw
1698 if (TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_FLT
1699 || TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_DECFLOAT
)
1703 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1704 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1706 fprintf_filtered (file
, "\t(raw 0x");
1707 for (j
= 0; j
< register_size (gdbarch
, i
); j
++)
1710 if (gdbarch_byte_order (gdbarch
) == BFD_ENDIAN_BIG
)
1713 idx
= register_size (gdbarch
, i
) - 1 - j
;
1714 fprintf_filtered (file
, "%02x", (unsigned char) buffer
[idx
]);
1716 fprintf_filtered (file
, ")");
1720 /* Print the register in hex. */
1721 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1722 file
, 'x', 1, 0, Val_pretty_default
, current_language
);
1723 /* If not a vector register, print it also according to its
1725 if (TYPE_VECTOR (register_type (gdbarch
, i
)) == 0)
1727 fprintf_filtered (file
, "\t");
1728 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1729 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1733 fprintf_filtered (file
, "\n");
1738 registers_info (char *addr_exp
, int fpregs
)
1740 struct frame_info
*frame
;
1741 struct gdbarch
*gdbarch
;
1742 int regnum
, numregs
;
1745 if (!target_has_registers
)
1746 error (_("The program has no registers now."));
1747 frame
= get_selected_frame (NULL
);
1748 gdbarch
= get_frame_arch (frame
);
1752 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1757 while (*addr_exp
!= '\0')
1762 /* Keep skipping leading white space. */
1763 if (isspace ((*addr_exp
)))
1769 /* Discard any leading ``$''. Check that there is something
1770 resembling a register following it. */
1771 if (addr_exp
[0] == '$')
1773 if (isspace ((*addr_exp
)) || (*addr_exp
) == '\0')
1774 error (_("Missing register name"));
1776 /* Find the start/end of this register name/num/group. */
1778 while ((*addr_exp
) != '\0' && !isspace ((*addr_exp
)))
1782 /* Figure out what we've found and display it. */
1784 /* A register name? */
1786 int regnum
= user_reg_map_name_to_regnum (gdbarch
, start
, end
- start
);
1789 /* User registers lie completely outside of the range of
1790 normal registers. Catch them early so that the target
1792 if (regnum
>= gdbarch_num_regs (gdbarch
)
1793 + gdbarch_num_pseudo_regs (gdbarch
))
1795 struct value
*val
= value_of_user_reg (regnum
, frame
);
1797 printf_filtered ("%s: ", start
);
1798 print_scalar_formatted (value_contents (val
),
1799 check_typedef (value_type (val
)),
1800 'x', 0, gdb_stdout
);
1801 printf_filtered ("\n");
1804 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1805 frame
, regnum
, fpregs
);
1810 /* A register number? (how portable is this one?). */
1813 int regnum
= strtol (start
, &endptr
, 0);
1816 && regnum
< gdbarch_num_regs (gdbarch
)
1817 + gdbarch_num_pseudo_regs (gdbarch
))
1819 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1820 frame
, regnum
, fpregs
);
1825 /* A register group? */
1827 struct reggroup
*group
;
1828 for (group
= reggroup_next (gdbarch
, NULL
);
1830 group
= reggroup_next (gdbarch
, group
))
1832 /* Don't bother with a length check. Should the user
1833 enter a short register group name, go with the first
1834 group that matches. */
1835 if (strncmp (start
, reggroup_name (group
), end
- start
) == 0)
1842 regnum
< gdbarch_num_regs (gdbarch
)
1843 + gdbarch_num_pseudo_regs (gdbarch
);
1846 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
1847 gdbarch_print_registers_info (gdbarch
,
1855 /* Nothing matched. */
1856 error (_("Invalid register `%.*s'"), (int) (end
- start
), start
);
1861 all_registers_info (char *addr_exp
, int from_tty
)
1863 registers_info (addr_exp
, 1);
1867 nofp_registers_info (char *addr_exp
, int from_tty
)
1869 registers_info (addr_exp
, 0);
1873 print_vector_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
1874 struct frame_info
*frame
, const char *args
)
1876 if (gdbarch_print_vector_info_p (gdbarch
))
1877 gdbarch_print_vector_info (gdbarch
, file
, frame
, args
);
1881 int printed_something
= 0;
1884 regnum
< gdbarch_num_regs (gdbarch
)
1885 + gdbarch_num_pseudo_regs (gdbarch
);
1888 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, vector_reggroup
))
1890 printed_something
= 1;
1891 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
1894 if (!printed_something
)
1895 fprintf_filtered (file
, "No vector information\n");
1900 vector_info (char *args
, int from_tty
)
1902 if (!target_has_registers
)
1903 error (_("The program has no registers now."));
1905 print_vector_info (current_gdbarch
, gdb_stdout
,
1906 get_selected_frame (NULL
), args
);
1912 * Should save/restore the tty state since it might be that the
1913 * program to be debugged was started on this tty and it wants
1914 * the tty in some state other than what we want. If it's running
1915 * on another terminal or without a terminal, then saving and
1916 * restoring the tty state is a harmless no-op.
1917 * This only needs to be done if we are attaching to a process.
1922 takes a program started up outside of gdb and ``attaches'' to it.
1923 This stops it cold in its tracks and allows us to start debugging it.
1924 and wait for the trace-trap that results from attaching. */
1927 attach_command_post_wait (char *args
, int from_tty
, int async_exec
)
1930 char *full_exec_path
= NULL
;
1932 stop_soon
= NO_STOP_QUIETLY
;
1934 /* If no exec file is yet known, try to determine it from the
1936 exec_file
= (char *) get_exec_file (0);
1939 exec_file
= target_pid_to_exec_file (PIDGET (inferior_ptid
));
1942 /* It's possible we don't have a full path, but rather just a
1943 filename. Some targets, such as HP-UX, don't provide the
1946 Attempt to qualify the filename against the source path.
1947 (If that fails, we'll just fall back on the original
1948 filename. Not much more we can do...)
1950 if (!source_full_path_of (exec_file
, &full_exec_path
))
1951 full_exec_path
= savestring (exec_file
, strlen (exec_file
));
1953 exec_file_attach (full_exec_path
, from_tty
);
1954 symbol_file_add_main (full_exec_path
, from_tty
);
1959 reopen_exec_file ();
1963 /* Take any necessary post-attaching actions for this platform. */
1964 target_post_attach (PIDGET (inferior_ptid
));
1966 post_create_inferior (¤t_target
, from_tty
);
1968 /* Install inferior's terminal modes. */
1969 target_terminal_inferior ();
1972 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
1975 if (target_can_async_p ())
1976 async_enable_stdin ();
1978 if (deprecated_attach_hook
)
1979 deprecated_attach_hook ();
1983 struct attach_command_continuation_args
1991 attach_command_continuation (void *args
)
1993 struct attach_command_continuation_args
*a
= args
;
1994 attach_command_post_wait (a
->args
, a
->from_tty
, a
->async_exec
);
1998 attach_command_continuation_free_args (void *args
)
2000 struct attach_command_continuation_args
*a
= args
;
2006 attach_command (char *args
, int from_tty
)
2009 char *full_exec_path
= NULL
;
2012 dont_repeat (); /* Not for the faint of heart */
2014 if (target_has_execution
)
2016 if (query ("A program is being debugged already. Kill it? "))
2019 error (_("Not killed."));
2022 /* Clean up any leftovers from other runs. Some other things from
2023 this function should probably be moved into target_pre_inferior. */
2024 target_pre_inferior (from_tty
);
2026 if (non_stop
&& !target_supports_non_stop ())
2027 error (_("Cannot attach to this target in non-stop mode"));
2031 async_exec
= strip_bg_char (&args
);
2033 /* If we get a request for running in the bg but the target
2034 doesn't support it, error out. */
2035 if (async_exec
&& !target_can_async_p ())
2036 error (_("Asynchronous execution not supported on this target."));
2039 /* If we don't get a request of running in the bg, then we need
2040 to simulate synchronous (fg) execution. */
2041 if (!async_exec
&& target_can_async_p ())
2043 /* Simulate synchronous execution */
2044 async_disable_stdin ();
2047 target_attach (args
, from_tty
);
2049 /* Set up the "saved terminal modes" of the inferior
2050 based on what modes we are starting it with. */
2051 target_terminal_init ();
2053 /* Set up execution context to know that we should return from
2054 wait_for_inferior as soon as the target reports a stop. */
2055 init_wait_for_inferior ();
2056 clear_proceed_status ();
2058 /* Some system don't generate traps when attaching to inferior.
2059 E.g. Mach 3 or GNU hurd. */
2060 if (!target_attach_no_wait
)
2062 /* Careful here. See comments in inferior.h. Basically some
2063 OSes don't ignore SIGSTOPs on continue requests anymore. We
2064 need a way for handle_inferior_event to reset the stop_signal
2065 variable after an attach, and this is what
2066 STOP_QUIETLY_NO_SIGSTOP is for. */
2067 stop_soon
= STOP_QUIETLY_NO_SIGSTOP
;
2069 if (target_can_async_p ())
2071 /* sync_execution mode. Wait for stop. */
2072 struct attach_command_continuation_args
*a
;
2074 a
= xmalloc (sizeof (*a
));
2075 a
->args
= xstrdup (args
);
2076 a
->from_tty
= from_tty
;
2077 a
->async_exec
= async_exec
;
2078 add_continuation (attach_command_continuation
, a
,
2079 attach_command_continuation_free_args
);
2083 wait_for_inferior (0);
2086 attach_command_post_wait (args
, from_tty
, async_exec
);
2091 * takes a program previously attached to and detaches it.
2092 * The program resumes execution and will no longer stop
2093 * on signals, etc. We better not have left any breakpoints
2094 * in the program or it'll die when it hits one. For this
2095 * to work, it may be necessary for the process to have been
2096 * previously attached. It *might* work if the program was
2097 * started via the normal ptrace (PTRACE_TRACEME).
2101 detach_command (char *args
, int from_tty
)
2103 dont_repeat (); /* Not for the faint of heart. */
2104 target_detach (args
, from_tty
);
2105 no_shared_libraries (NULL
, from_tty
);
2106 init_thread_list ();
2107 if (deprecated_detach_hook
)
2108 deprecated_detach_hook ();
2111 /* Disconnect from the current target without resuming it (leaving it
2112 waiting for a debugger).
2114 We'd better not have left any breakpoints in the program or the
2115 next debugger will get confused. Currently only supported for some
2116 remote targets, since the normal attach mechanisms don't work on
2117 stopped processes on some native platforms (e.g. GNU/Linux). */
2120 disconnect_command (char *args
, int from_tty
)
2122 dont_repeat (); /* Not for the faint of heart */
2123 target_disconnect (args
, from_tty
);
2124 no_shared_libraries (NULL
, from_tty
);
2125 init_thread_list ();
2126 if (deprecated_detach_hook
)
2127 deprecated_detach_hook ();
2131 interrupt_target_1 (int all_threads
)
2135 ptid
= minus_one_ptid
;
2137 ptid
= inferior_ptid
;
2141 /* Stop the execution of the target while running in async mode, in
2142 the backgound. In all-stop, stop the whole process. In non-stop
2143 mode, stop the current thread only by default, or stop all threads
2144 if the `-a' switch is used. */
2146 /* interrupt [-a] */
2148 interrupt_target_command (char *args
, int from_tty
)
2150 if (target_can_async_p ())
2152 int all_threads
= 0;
2154 dont_repeat (); /* Not for the faint of heart */
2157 && strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
2160 if (!non_stop
&& all_threads
)
2161 error (_("-a is meaningless in all-stop mode."));
2163 interrupt_target_1 (all_threads
);
2168 print_float_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
2169 struct frame_info
*frame
, const char *args
)
2171 if (gdbarch_print_float_info_p (gdbarch
))
2172 gdbarch_print_float_info (gdbarch
, file
, frame
, args
);
2176 int printed_something
= 0;
2179 regnum
< gdbarch_num_regs (gdbarch
)
2180 + gdbarch_num_pseudo_regs (gdbarch
);
2183 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, float_reggroup
))
2185 printed_something
= 1;
2186 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2189 if (!printed_something
)
2190 fprintf_filtered (file
, "\
2191 No floating-point info available for this processor.\n");
2196 float_info (char *args
, int from_tty
)
2198 if (!target_has_registers
)
2199 error (_("The program has no registers now."));
2201 print_float_info (current_gdbarch
, gdb_stdout
,
2202 get_selected_frame (NULL
), args
);
2206 unset_command (char *args
, int from_tty
)
2208 printf_filtered (_("\
2209 \"unset\" must be followed by the name of an unset subcommand.\n"));
2210 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
2214 _initialize_infcmd (void)
2216 struct cmd_list_element
*c
= NULL
;
2218 /* add the filename of the terminal connected to inferior I/O */
2219 add_setshow_filename_cmd ("inferior-tty", class_run
,
2220 &inferior_io_terminal
, _("\
2221 Set terminal for future runs of program being debugged."), _("\
2222 Show terminal for future runs of program being debugged."), _("\
2223 Usage: set inferior-tty /dev/pts/1"), NULL
, NULL
, &setlist
, &showlist
);
2224 add_com_alias ("tty", "set inferior-tty", class_alias
, 0);
2226 add_setshow_optional_filename_cmd ("args", class_run
,
2227 &inferior_args
, _("\
2228 Set argument list to give program being debugged when it is started."), _("\
2229 Show argument list to give program being debugged when it is started."), _("\
2230 Follow this command with any number of args, to be passed to the program."),
2233 &setlist
, &showlist
);
2235 c
= add_cmd ("environment", no_class
, environment_info
, _("\
2236 The environment to give the program, or one variable's value.\n\
2237 With an argument VAR, prints the value of environment variable VAR to\n\
2238 give the program being debugged. With no arguments, prints the entire\n\
2239 environment to be given to the program."), &showlist
);
2240 set_cmd_completer (c
, noop_completer
);
2242 add_prefix_cmd ("unset", no_class
, unset_command
,
2243 _("Complement to certain \"set\" commands."),
2244 &unsetlist
, "unset ", 0, &cmdlist
);
2246 c
= add_cmd ("environment", class_run
, unset_environment_command
, _("\
2247 Cancel environment variable VAR for the program.\n\
2248 This does not affect the program until the next \"run\" command."),
2250 set_cmd_completer (c
, noop_completer
);
2252 c
= add_cmd ("environment", class_run
, set_environment_command
, _("\
2253 Set environment variable value to give the program.\n\
2254 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2255 VALUES of environment variables are uninterpreted strings.\n\
2256 This does not affect the program until the next \"run\" command."),
2258 set_cmd_completer (c
, noop_completer
);
2260 c
= add_com ("path", class_files
, path_command
, _("\
2261 Add directory DIR(s) to beginning of search path for object files.\n\
2262 $cwd in the path means the current working directory.\n\
2263 This path is equivalent to the $PATH shell variable. It is a list of\n\
2264 directories, separated by colons. These directories are searched to find\n\
2265 fully linked executable files and separately compiled object files as needed."));
2266 set_cmd_completer (c
, filename_completer
);
2268 c
= add_cmd ("paths", no_class
, path_info
, _("\
2269 Current search path for finding object files.\n\
2270 $cwd in the path means the current working directory.\n\
2271 This path is equivalent to the $PATH shell variable. It is a list of\n\
2272 directories, separated by colons. These directories are searched to find\n\
2273 fully linked executable files and separately compiled object files as needed."),
2275 set_cmd_completer (c
, noop_completer
);
2277 add_com ("attach", class_run
, attach_command
, _("\
2278 Attach to a process or file outside of GDB.\n\
2279 This command attaches to another target, of the same type as your last\n\
2280 \"target\" command (\"info files\" will show your target stack).\n\
2281 The command may take as argument a process id or a device file.\n\
2282 For a process id, you must have permission to send the process a signal,\n\
2283 and it must have the same effective uid as the debugger.\n\
2284 When using \"attach\" with a process id, the debugger finds the\n\
2285 program running in the process, looking first in the current working\n\
2286 directory, or (if not found there) using the source file search path\n\
2287 (see the \"directory\" command). You can also use the \"file\" command\n\
2288 to specify the program, and to load its symbol table."));
2290 add_prefix_cmd ("detach", class_run
, detach_command
, _("\
2291 Detach a process or file previously attached.\n\
2292 If a process, it is no longer traced, and it continues its execution. If\n\
2293 you were debugging a file, the file is closed and gdb no longer accesses it."),
2294 &detachlist
, "detach ", 0, &cmdlist
);
2296 add_com ("disconnect", class_run
, disconnect_command
, _("\
2297 Disconnect from a target.\n\
2298 The target will wait for another debugger to connect. Not available for\n\
2301 add_com ("signal", class_run
, signal_command
, _("\
2302 Continue program giving it signal specified by the argument.\n\
2303 An argument of \"0\" means continue program without giving it a signal."));
2305 add_com ("stepi", class_run
, stepi_command
, _("\
2306 Step one instruction exactly.\n\
2307 Argument N means do this N times (or till program stops for another reason)."));
2308 add_com_alias ("si", "stepi", class_alias
, 0);
2310 add_com ("nexti", class_run
, nexti_command
, _("\
2311 Step one instruction, but proceed through subroutine calls.\n\
2312 Argument N means do this N times (or till program stops for another reason)."));
2313 add_com_alias ("ni", "nexti", class_alias
, 0);
2315 add_com ("finish", class_run
, finish_command
, _("\
2316 Execute until selected stack frame returns.\n\
2317 Upon return, the value returned is printed and put in the value history."));
2318 add_com_alias ("fin", "finish", class_run
, 1);
2320 add_com ("next", class_run
, next_command
, _("\
2321 Step program, proceeding through subroutine calls.\n\
2322 Like the \"step\" command as long as subroutine calls do not happen;\n\
2323 when they do, the call is treated as one instruction.\n\
2324 Argument N means do this N times (or till program stops for another reason)."));
2325 add_com_alias ("n", "next", class_run
, 1);
2327 add_com_alias ("S", "next", class_run
, 1);
2329 add_com ("step", class_run
, step_command
, _("\
2330 Step program until it reaches a different source line.\n\
2331 Argument N means do this N times (or till program stops for another reason)."));
2332 add_com_alias ("s", "step", class_run
, 1);
2334 c
= add_com ("until", class_run
, until_command
, _("\
2335 Execute until the program reaches a source line greater than the current\n\
2336 or a specified location (same args as break command) within the current frame."));
2337 set_cmd_completer (c
, location_completer
);
2338 add_com_alias ("u", "until", class_run
, 1);
2340 c
= add_com ("advance", class_run
, advance_command
, _("\
2341 Continue the program up to the given location (same form as args for break command).\n\
2342 Execution will also stop upon exit from the current stack frame."));
2343 set_cmd_completer (c
, location_completer
);
2345 c
= add_com ("jump", class_run
, jump_command
, _("\
2346 Continue program being debugged at specified line or address.\n\
2347 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2348 for an address to start at."));
2349 set_cmd_completer (c
, location_completer
);
2353 c
= add_com ("go", class_run
, go_command
, _("\
2354 Usage: go <location>\n\
2355 Continue program being debugged, stopping at specified line or \n\
2357 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2358 expression for an address to start at.\n\
2359 This command is a combination of tbreak and jump."));
2360 set_cmd_completer (c
, location_completer
);
2364 add_com_alias ("g", "go", class_run
, 1);
2366 c
= add_com ("continue", class_run
, continue_command
, _("\
2367 Continue program being debugged, after signal or breakpoint.\n\
2368 If proceeding from breakpoint, a number N may be used as an argument,\n\
2369 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2370 the breakpoint won't break until the Nth time it is reached).\n\
2372 If non-stop mode is enabled, continue only the current thread,\n\
2373 otherwise all the threads in the program are continued. To \n\
2374 continue all stopped threads in non-stop mode, use the -a option.\n\
2375 Specifying -a and an ignore count simultaneously is an error."));
2376 add_com_alias ("c", "cont", class_run
, 1);
2377 add_com_alias ("fg", "cont", class_run
, 1);
2379 c
= add_com ("run", class_run
, run_command
, _("\
2380 Start debugged program. You may specify arguments to give it.\n\
2381 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2382 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2383 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2384 To cancel previous arguments and run with no arguments,\n\
2385 use \"set args\" without arguments."));
2386 set_cmd_completer (c
, filename_completer
);
2387 add_com_alias ("r", "run", class_run
, 1);
2389 add_com ("R", class_run
, run_no_args_command
,
2390 _("Start debugged program with no arguments."));
2392 c
= add_com ("start", class_run
, start_command
, _("\
2393 Run the debugged program until the beginning of the main procedure.\n\
2394 You may specify arguments to give to your program, just as with the\n\
2395 \"run\" command."));
2396 set_cmd_completer (c
, filename_completer
);
2398 c
= add_com ("interrupt", class_run
, interrupt_target_command
,
2399 _("Interrupt the execution of the debugged program.\n\
2400 If non-stop mode is enabled, interrupt only the current thread,\n\
2401 otherwise all the threads in the program are stopped. To \n\
2402 interrupt all running threads in non-stop mode, use the -a option."));
2404 add_info ("registers", nofp_registers_info
, _("\
2405 List of integer registers and their contents, for selected stack frame.\n\
2406 Register name as argument means describe only that register."));
2407 add_info_alias ("r", "registers", 1);
2410 add_com ("lr", class_info
, nofp_registers_info
, _("\
2411 List of integer registers and their contents, for selected stack frame.\n\
2412 Register name as argument means describe only that register."));
2413 add_info ("all-registers", all_registers_info
, _("\
2414 List of all registers and their contents, for selected stack frame.\n\
2415 Register name as argument means describe only that register."));
2417 add_info ("program", program_info
,
2418 _("Execution status of the program."));
2420 add_info ("float", float_info
,
2421 _("Print the status of the floating point unit\n"));
2423 add_info ("vector", vector_info
,
2424 _("Print the status of the vector unit\n"));
2426 inferior_environ
= make_environ ();
2427 init_environ (inferior_environ
);