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 /* Address at which inferior stopped. */
154 /* Flag indicating that a command has proceeded the inferior past the
155 current breakpoint. */
157 int breakpoint_proceeded
;
159 /* Nonzero if stopped due to completion of a stack dummy routine. */
161 int stop_stack_dummy
;
163 /* Nonzero if stopped due to a random (unexpected) signal in inferior
166 int stopped_by_random_signal
;
168 /* Environment to use for running inferior,
169 in format described in environ.h. */
171 struct gdb_environ
*inferior_environ
;
173 /* When set, no calls to target_resumed observer will be made. */
174 int suppress_resume_observer
= 0;
175 /* When set, normal_stop will not call the normal_stop observer. */
176 int suppress_stop_observer
= 0;
178 /* Accessor routines. */
181 set_inferior_io_terminal (const char *terminal_name
)
183 if (inferior_io_terminal
)
184 xfree (inferior_io_terminal
);
187 inferior_io_terminal
= NULL
;
189 inferior_io_terminal
= savestring (terminal_name
, strlen (terminal_name
));
193 get_inferior_io_terminal (void)
195 return inferior_io_terminal
;
199 get_inferior_args (void)
201 if (inferior_argc
!= 0)
205 n
= gdbarch_construct_inferior_arguments (current_gdbarch
,
206 inferior_argc
, inferior_argv
);
207 old
= set_inferior_args (n
);
211 if (inferior_args
== NULL
)
212 inferior_args
= xstrdup ("");
214 return inferior_args
;
218 set_inferior_args (char *newargs
)
220 char *saved_args
= inferior_args
;
222 inferior_args
= newargs
;
230 set_inferior_args_vector (int argc
, char **argv
)
232 inferior_argc
= argc
;
233 inferior_argv
= argv
;
236 /* Notice when `set args' is run. */
238 notice_args_set (char *args
, int from_tty
, struct cmd_list_element
*c
)
244 /* Notice when `show args' is run. */
246 notice_args_read (struct ui_file
*file
, int from_tty
,
247 struct cmd_list_element
*c
, const char *value
)
249 /* Note that we ignore the passed-in value in favor of computing it
251 deprecated_show_value_hack (file
, from_tty
, c
, get_inferior_args ());
255 /* Compute command-line string given argument vector. This does the
256 same shell processing as fork_inferior. */
258 construct_inferior_arguments (struct gdbarch
*gdbarch
, int argc
, char **argv
)
262 if (STARTUP_WITH_SHELL
)
264 /* This holds all the characters considered special to the
265 typical Unix shells. We include `^' because the SunOS
266 /bin/sh treats it as a synonym for `|'. */
267 char *special
= "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
272 /* We over-compute the size. It shouldn't matter. */
273 for (i
= 0; i
< argc
; ++i
)
274 length
+= 2 * strlen (argv
[i
]) + 1 + 2 * (argv
[i
][0] == '\0');
276 result
= (char *) xmalloc (length
);
279 for (i
= 0; i
< argc
; ++i
)
284 /* Need to handle empty arguments specially. */
285 if (argv
[i
][0] == '\0')
292 for (cp
= argv
[i
]; *cp
; ++cp
)
294 if (strchr (special
, *cp
) != NULL
)
304 /* In this case we can't handle arguments that contain spaces,
305 tabs, or newlines -- see breakup_args(). */
309 for (i
= 0; i
< argc
; ++i
)
311 char *cp
= strchr (argv
[i
], ' ');
313 cp
= strchr (argv
[i
], '\t');
315 cp
= strchr (argv
[i
], '\n');
317 error (_("can't handle command-line argument containing whitespace"));
318 length
+= strlen (argv
[i
]) + 1;
321 result
= (char *) xmalloc (length
);
323 for (i
= 0; i
< argc
; ++i
)
326 strcat (result
, " ");
327 strcat (result
, argv
[i
]);
335 /* This function detects whether or not a '&' character (indicating
336 background execution) has been added as *the last* of the arguments ARGS
337 of a command. If it has, it removes it and returns 1. Otherwise it
338 does nothing and returns 0. */
340 strip_bg_char (char **args
)
344 p
= strchr (*args
, '&');
348 if (p
== (*args
+ strlen (*args
) - 1))
350 if (strlen (*args
) > 1)
354 while (*p
== ' ' || *p
== '\t');
366 tty_command (char *file
, int from_tty
)
369 error_no_arg (_("terminal name for running target process"));
371 set_inferior_io_terminal (file
);
374 /* Common actions to take after creating any sort of inferior, by any
375 means (running, attaching, connecting, et cetera). The target
376 should be stopped. */
379 post_create_inferior (struct target_ops
*target
, int from_tty
)
381 /* Be sure we own the terminal in case write operations are performed. */
382 target_terminal_ours ();
384 /* If the target hasn't taken care of this already, do it now.
385 Targets which need to access registers during to_open,
386 to_create_inferior, or to_attach should do it earlier; but many
388 target_find_description ();
392 /* Sometimes the platform-specific hook loads initial shared
393 libraries, and sometimes it doesn't. Try to do so first, so
394 that we can add them with the correct value for FROM_TTY.
395 If we made all the inferior hook methods consistent,
396 this call could be removed. */
398 SOLIB_ADD (NULL
, from_tty
, target
, auto_solib_add
);
400 solib_add (NULL
, from_tty
, target
, auto_solib_add
);
403 /* Create the hooks to handle shared library load and unload
405 #ifdef SOLIB_CREATE_INFERIOR_HOOK
406 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid
));
408 solib_create_inferior_hook ();
412 observer_notify_inferior_created (target
, from_tty
);
415 /* Kill the inferior if already running. This function is designed
416 to be called when we are about to start the execution of the program
417 from the beginning. Ask the user to confirm that he wants to restart
418 the program being debugged when FROM_TTY is non-null. */
421 kill_if_already_running (int from_tty
)
423 if (! ptid_equal (inferior_ptid
, null_ptid
) && target_has_execution
)
425 /* Bail out before killing the program if we will not be able to
427 target_require_runnable ();
430 && !query ("The program being debugged has been started already.\n\
431 Start it from the beginning? "))
432 error (_("Program not restarted."));
437 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
438 a temporary breakpoint at the begining of the main program before
439 running the program. */
442 run_command_1 (char *args
, int from_tty
, int tbreak_at_main
)
448 kill_if_already_running (from_tty
);
450 init_wait_for_inferior ();
451 clear_breakpoint_hit_counts ();
453 /* Clean up any leftovers from other runs. Some other things from
454 this function should probably be moved into target_pre_inferior. */
455 target_pre_inferior (from_tty
);
457 /* The comment here used to read, "The exec file is re-read every
458 time we do a generic_mourn_inferior, so we just have to worry
459 about the symbol file." The `generic_mourn_inferior' function
460 gets called whenever the program exits. However, suppose the
461 program exits, and *then* the executable file changes? We need
462 to check again here. Since reopen_exec_file doesn't do anything
463 if the timestamp hasn't changed, I don't see the harm. */
467 /* Insert the temporary breakpoint if a location was specified. */
469 tbreak_command (main_name (), 0);
471 exec_file
= (char *) get_exec_file (0);
473 if (non_stop
&& !target_supports_non_stop ())
474 error (_("The target does not support running in non-stop mode."));
476 /* We keep symbols from add-symbol-file, on the grounds that the
477 user might want to add some symbols before running the program
478 (right?). But sometimes (dynamic loading where the user manually
479 introduces the new symbols with add-symbol-file), the code which
480 the symbols describe does not persist between runs. Currently
481 the user has to manually nuke all symbols between runs if they
482 want them to go away (PR 2207). This is probably reasonable. */
486 if (target_can_async_p ())
487 async_disable_stdin ();
491 int async_exec
= strip_bg_char (&args
);
493 /* If we get a request for running in the bg but the target
494 doesn't support it, error out. */
495 if (async_exec
&& !target_can_async_p ())
496 error (_("Asynchronous execution not supported on this target."));
498 /* If we don't get a request of running in the bg, then we need
499 to simulate synchronous (fg) execution. */
500 if (!async_exec
&& target_can_async_p ())
502 /* Simulate synchronous execution */
503 async_disable_stdin ();
506 /* If there were other args, beside '&', process them. */
509 char *old_args
= set_inferior_args (xstrdup (args
));
516 ui_out_field_string (uiout
, NULL
, "Starting program");
517 ui_out_text (uiout
, ": ");
519 ui_out_field_string (uiout
, "execfile", exec_file
);
520 ui_out_spaces (uiout
, 1);
521 /* We call get_inferior_args() because we might need to compute
523 ui_out_field_string (uiout
, "infargs", get_inferior_args ());
524 ui_out_text (uiout
, "\n");
525 ui_out_flush (uiout
);
528 /* We call get_inferior_args() because we might need to compute
530 target_create_inferior (exec_file
, get_inferior_args (),
531 environ_vector (inferior_environ
), from_tty
);
533 /* Pass zero for FROM_TTY, because at this point the "run" command
534 has done its thing; now we are setting up the running program. */
535 post_create_inferior (¤t_target
, 0);
537 /* Start the target running. */
538 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
543 run_command (char *args
, int from_tty
)
545 run_command_1 (args
, from_tty
, 0);
549 run_no_args_command (char *args
, int from_tty
)
551 char *old_args
= set_inferior_args (xstrdup (""));
556 /* Start the execution of the program up until the beginning of the main
560 start_command (char *args
, int from_tty
)
562 /* Some languages such as Ada need to search inside the program
563 minimal symbols for the location where to put the temporary
564 breakpoint before starting. */
565 if (!have_minimal_symbols ())
566 error (_("No symbol table loaded. Use the \"file\" command."));
568 /* Run the program until reaching the main procedure... */
569 run_command_1 (args
, from_tty
, 1);
573 proceed_thread_callback (struct thread_info
*thread
, void *arg
)
575 if (!is_stopped (thread
->ptid
))
578 switch_to_thread (thread
->ptid
);
579 clear_proceed_status ();
580 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
585 continue_1 (int all_threads
)
589 if (non_stop
&& all_threads
)
591 /* Don't error out if the current thread is running, because
592 there may be other stopped threads. */
593 struct cleanup
*old_chain
;
595 /* Backup current thread and selected frame. */
596 old_chain
= make_cleanup_restore_current_thread ();
598 iterate_over_threads (proceed_thread_callback
, NULL
);
600 /* Restore selected ptid. */
601 do_cleanups (old_chain
);
605 ensure_not_running ();
606 clear_proceed_status ();
607 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
611 /* continue [-a] [proceed-count] [&] */
613 continue_command (char *args
, int from_tty
)
619 /* Find out whether we must run in the background. */
621 async_exec
= strip_bg_char (&args
);
623 /* If we must run in the background, but the target can't do it,
625 if (async_exec
&& !target_can_async_p ())
626 error (_("Asynchronous execution not supported on this target."));
628 /* If we are not asked to run in the bg, then prepare to run in the
629 foreground, synchronously. */
630 if (!async_exec
&& target_can_async_p ())
632 /* Simulate synchronous execution */
633 async_disable_stdin ();
638 if (strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
641 args
+= sizeof ("-a") - 1;
647 if (!non_stop
&& all_threads
)
648 error (_("`-a' is meaningless in all-stop mode."));
650 if (args
!= NULL
&& all_threads
)
652 Can't resume all threads and specify proceed count simultaneously."));
654 /* If we have an argument left, set proceed count of breakpoint we
661 struct thread_info
*tp
;
664 tp
= find_thread_pid (inferior_ptid
);
668 struct target_waitstatus ws
;
670 get_last_target_status (&last_ptid
, &ws
);
671 tp
= find_thread_pid (last_ptid
);
674 bs
= tp
->stop_bpstat
;
676 while ((stat
= bpstat_num (&bs
, &num
)) != 0)
679 set_ignore_count (num
,
680 parse_and_eval_long (args
) - 1,
682 /* set_ignore_count prints a message ending with a period.
683 So print two spaces before "Continuing.". */
685 printf_filtered (" ");
689 if (!stopped
&& from_tty
)
692 ("Not stopped at any breakpoint; argument ignored.\n");
697 printf_filtered (_("Continuing.\n"));
699 continue_1 (all_threads
);
702 /* Step until outside of current statement. */
705 step_command (char *count_string
, int from_tty
)
707 step_1 (0, 0, count_string
);
710 /* Likewise, but skip over subroutine calls as if single instructions. */
713 next_command (char *count_string
, int from_tty
)
715 step_1 (1, 0, count_string
);
718 /* Likewise, but step only one instruction. */
721 stepi_command (char *count_string
, int from_tty
)
723 step_1 (0, 1, count_string
);
727 nexti_command (char *count_string
, int from_tty
)
729 step_1 (1, 1, count_string
);
733 delete_longjmp_breakpoint_cleanup (void *arg
)
735 int thread
= * (int *) arg
;
736 delete_longjmp_breakpoint (thread
);
740 step_1 (int skip_subroutines
, int single_inst
, char *count_string
)
743 struct frame_info
*frame
;
744 struct cleanup
*cleanups
= make_cleanup (null_cleanup
, NULL
);
749 ensure_not_running ();
752 async_exec
= strip_bg_char (&count_string
);
754 /* If we get a request for running in the bg but the target
755 doesn't support it, error out. */
756 if (async_exec
&& !target_can_async_p ())
757 error (_("Asynchronous execution not supported on this target."));
759 /* If we don't get a request of running in the bg, then we need
760 to simulate synchronous (fg) execution. */
761 if (!async_exec
&& target_can_async_p ())
763 /* Simulate synchronous execution */
764 async_disable_stdin ();
767 count
= count_string
? parse_and_eval_long (count_string
) : 1;
769 if (!single_inst
|| skip_subroutines
) /* leave si command alone */
771 if (in_thread_list (inferior_ptid
))
772 thread
= pid_to_thread_id (inferior_ptid
);
774 set_longjmp_breakpoint ();
776 make_cleanup (delete_longjmp_breakpoint_cleanup
, &thread
);
779 /* In synchronous case, all is well, just use the regular for loop. */
780 if (!target_can_async_p ())
782 for (; count
> 0; count
--)
784 struct thread_info
*tp
= inferior_thread ();
785 clear_proceed_status ();
787 frame
= get_current_frame ();
788 tp
->step_frame_id
= get_frame_id (frame
);
792 find_pc_line_pc_range (stop_pc
,
793 &tp
->step_range_start
, &tp
->step_range_end
);
794 if (tp
->step_range_end
== 0)
797 if (find_pc_partial_function (stop_pc
, &name
,
798 &tp
->step_range_start
,
799 &tp
->step_range_end
) == 0)
800 error (_("Cannot find bounds of current function"));
802 target_terminal_ours ();
803 printf_filtered (_("\
804 Single stepping until exit from function %s, \n\
805 which has no line number information.\n"), name
);
810 /* Say we are stepping, but stop after one insn whatever it does. */
811 tp
->step_range_start
= tp
->step_range_end
= 1;
812 if (!skip_subroutines
)
814 Don't step over function calls, not even to functions lacking
816 tp
->step_over_calls
= STEP_OVER_NONE
;
819 if (skip_subroutines
)
820 tp
->step_over_calls
= STEP_OVER_ALL
;
822 tp
->step_multi
= (count
> 1);
823 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
825 if (!target_has_execution
826 || !inferior_thread ()->stop_step
)
830 do_cleanups (cleanups
);
833 /* In case of asynchronous target things get complicated, do only
834 one step for now, before returning control to the event loop. Let
835 the continuation figure out how many other steps we need to do,
836 and handle them one at the time, through step_once(). */
839 step_once (skip_subroutines
, single_inst
, count
, thread
);
840 /* We are running, and the continuation is installed. It will
841 disable the longjmp breakpoint as appropriate. */
842 discard_cleanups (cleanups
);
846 struct step_1_continuation_args
849 int skip_subroutines
;
854 /* Called after we are done with one step operation, to check whether
855 we need to step again, before we print the prompt and return control
856 to the user. If count is > 1, we will need to do one more call to
857 proceed(), via step_once(). Basically it is like step_once and
858 step_1_continuation are co-recursive. */
860 step_1_continuation (void *args
)
862 struct step_1_continuation_args
*a
= args
;
864 if (target_has_execution
)
866 struct thread_info
*tp
;
868 tp
= inferior_thread ();
869 if (tp
->step_multi
&& tp
->stop_step
)
871 /* There are more steps to make, and we did stop due to
872 ending a stepping range. Do another step. */
873 step_once (a
->skip_subroutines
, a
->single_inst
, a
->count
- 1, a
->thread
);
879 /* We either stopped for some reason that is not stepping, or there
880 are no further steps to make. Cleanup. */
881 if (!a
->single_inst
|| a
->skip_subroutines
)
882 delete_longjmp_breakpoint (a
->thread
);
885 /* Do just one step operation. If count >1 we will have to set up a
886 continuation to be done after the target stops (after this one
887 step). This is useful to implement the 'step n' kind of commands, in
888 case of asynchronous targets. We had to split step_1 into two parts,
889 one to be done before proceed() and one afterwards. This function is
890 called in case of step n with n>1, after the first step operation has
893 step_once (int skip_subroutines
, int single_inst
, int count
, int thread
)
895 struct frame_info
*frame
;
896 struct step_1_continuation_args
*args
;
900 /* Don't assume THREAD is a valid thread id. It is set to -1 if
901 the longjmp breakpoint was not required. Use the
902 INFERIOR_PTID thread instead, which is the same thread when
904 struct thread_info
*tp
= inferior_thread ();
905 clear_proceed_status ();
907 frame
= get_current_frame ();
908 if (!frame
) /* Avoid coredump here. Why tho? */
909 error (_("No current frame"));
910 tp
->step_frame_id
= get_frame_id (frame
);
914 find_pc_line_pc_range (stop_pc
,
915 &tp
->step_range_start
, &tp
->step_range_end
);
917 /* If we have no line info, switch to stepi mode. */
918 if (tp
->step_range_end
== 0 && step_stop_if_no_debug
)
920 tp
->step_range_start
= tp
->step_range_end
= 1;
922 else if (tp
->step_range_end
== 0)
925 if (find_pc_partial_function (stop_pc
, &name
,
926 &tp
->step_range_start
,
927 &tp
->step_range_end
) == 0)
928 error (_("Cannot find bounds of current function"));
930 target_terminal_ours ();
931 printf_filtered (_("\
932 Single stepping until exit from function %s, \n\
933 which has no line number information.\n"), name
);
938 /* Say we are stepping, but stop after one insn whatever it does. */
939 tp
->step_range_start
= tp
->step_range_end
= 1;
940 if (!skip_subroutines
)
942 Don't step over function calls, not even to functions lacking
944 tp
->step_over_calls
= STEP_OVER_NONE
;
947 if (skip_subroutines
)
948 tp
->step_over_calls
= STEP_OVER_ALL
;
950 tp
->step_multi
= (count
> 1);
951 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
953 args
= xmalloc (sizeof (*args
));
954 args
->skip_subroutines
= skip_subroutines
;
955 args
->single_inst
= single_inst
;
957 args
->thread
= thread
;
958 add_intermediate_continuation (tp
, step_1_continuation
, args
, xfree
);
963 /* Continue program at specified address. */
966 jump_command (char *arg
, int from_tty
)
969 struct symtabs_and_lines sals
;
970 struct symtab_and_line sal
;
976 ensure_not_running ();
978 /* Find out whether we must run in the background. */
980 async_exec
= strip_bg_char (&arg
);
982 /* If we must run in the background, but the target can't do it,
984 if (async_exec
&& !target_can_async_p ())
985 error (_("Asynchronous execution not supported on this target."));
988 error_no_arg (_("starting address"));
990 sals
= decode_line_spec_1 (arg
, 1);
993 error (_("Unreasonable jump request"));
999 if (sal
.symtab
== 0 && sal
.pc
== 0)
1000 error (_("No source file has been specified."));
1002 resolve_sal_pc (&sal
); /* May error out */
1004 /* See if we are trying to jump to another function. */
1005 fn
= get_frame_function (get_current_frame ());
1006 sfn
= find_pc_function (sal
.pc
);
1007 if (fn
!= NULL
&& sfn
!= fn
)
1009 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal
.line
,
1010 SYMBOL_PRINT_NAME (fn
)))
1012 error (_("Not confirmed."));
1019 fixup_symbol_section (sfn
, 0);
1020 if (section_is_overlay (SYMBOL_OBJ_SECTION (sfn
)) &&
1021 !section_is_mapped (SYMBOL_OBJ_SECTION (sfn
)))
1023 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
1025 error (_("Not confirmed."));
1035 printf_filtered (_("Continuing at "));
1036 fputs_filtered (paddress (addr
), gdb_stdout
);
1037 printf_filtered (".\n");
1040 /* If we are not asked to run in the bg, then prepare to run in the
1041 foreground, synchronously. */
1042 if (!async_exec
&& target_can_async_p ())
1044 /* Simulate synchronous execution */
1045 async_disable_stdin ();
1048 clear_proceed_status ();
1049 proceed (addr
, TARGET_SIGNAL_0
, 0);
1053 /* Go to line or address in current procedure */
1055 go_command (char *line_no
, int from_tty
)
1057 if (line_no
== (char *) NULL
|| !*line_no
)
1058 printf_filtered (GO_USAGE
);
1061 tbreak_command (line_no
, from_tty
);
1062 jump_command (line_no
, from_tty
);
1067 /* Continue program giving it specified signal. */
1070 signal_command (char *signum_exp
, int from_tty
)
1072 enum target_signal oursig
;
1075 dont_repeat (); /* Too dangerous. */
1077 ensure_not_running ();
1079 /* Find out whether we must run in the background. */
1080 if (signum_exp
!= NULL
)
1081 async_exec
= strip_bg_char (&signum_exp
);
1083 /* If we must run in the background, but the target can't do it,
1085 if (async_exec
&& !target_can_async_p ())
1086 error (_("Asynchronous execution not supported on this target."));
1088 /* If we are not asked to run in the bg, then prepare to run in the
1089 foreground, synchronously. */
1090 if (!async_exec
&& target_can_async_p ())
1092 /* Simulate synchronous execution. */
1093 async_disable_stdin ();
1097 error_no_arg (_("signal number"));
1099 /* It would be even slicker to make signal names be valid expressions,
1100 (the type could be "enum $signal" or some such), then the user could
1101 assign them to convenience variables. */
1102 oursig
= target_signal_from_name (signum_exp
);
1104 if (oursig
== TARGET_SIGNAL_UNKNOWN
)
1106 /* No, try numeric. */
1107 int num
= parse_and_eval_long (signum_exp
);
1110 oursig
= TARGET_SIGNAL_0
;
1112 oursig
= target_signal_from_command (num
);
1117 if (oursig
== TARGET_SIGNAL_0
)
1118 printf_filtered (_("Continuing with no signal.\n"));
1120 printf_filtered (_("Continuing with signal %s.\n"),
1121 target_signal_to_name (oursig
));
1124 clear_proceed_status ();
1125 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1126 FIXME: Neither should "signal foo" but when I tried passing
1127 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1128 tried to track down yet. */
1129 proceed (oursig
== TARGET_SIGNAL_0
? (CORE_ADDR
) -1 : stop_pc
, oursig
, 0);
1132 /* Proceed until we reach a different source line with pc greater than
1133 our current one or exit the function. We skip calls in both cases.
1135 Note that eventually this command should probably be changed so
1136 that only source lines are printed out when we hit the breakpoint
1137 we set. This may involve changes to wait_for_inferior and the
1138 proceed status code. */
1141 until_next_command (int from_tty
)
1143 struct frame_info
*frame
;
1145 struct symbol
*func
;
1146 struct symtab_and_line sal
;
1147 struct thread_info
*tp
= inferior_thread ();
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 tp
->step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
1168 tp
->step_range_end
= pc
;
1172 sal
= find_pc_line (pc
, 0);
1174 tp
->step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
1175 tp
->step_range_end
= sal
.end
;
1178 tp
->step_over_calls
= STEP_OVER_ALL
;
1179 tp
->step_frame_id
= get_frame_id (frame
);
1181 tp
->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
;
1330 if (!ptid_equal (inferior_ptid
, null_ptid
)
1331 && target_has_execution
1332 && is_stopped (inferior_ptid
))
1333 bs
= inferior_thread ()->stop_bpstat
;
1335 if (bpstat_find_breakpoint (bs
, a
->breakpoint
) != NULL
1336 && a
->function
!= NULL
)
1338 struct type
*value_type
;
1340 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (a
->function
));
1342 internal_error (__FILE__
, __LINE__
,
1343 _("finish_command: function has no target type"));
1345 if (TYPE_CODE (value_type
) != TYPE_CODE_VOID
)
1346 print_return_value (SYMBOL_TYPE (a
->function
), value_type
);
1349 /* We suppress normal call of normal_stop observer and do it here so
1350 that that *stopped notification includes the return value. */
1351 /* NOTE: This is broken in non-stop mode. There is no guarantee the
1352 next stop will be in the same thread that we started doing a
1353 finish on. This suppressing (or some other replacement means)
1354 should be a thread property. */
1355 observer_notify_normal_stop (bs
);
1356 suppress_stop_observer
= 0;
1357 delete_breakpoint (a
->breakpoint
);
1361 finish_command_continuation_free_arg (void *arg
)
1363 /* NOTE: See finish_command_continuation. This would go away, if
1364 this suppressing is made a thread property. */
1365 suppress_stop_observer
= 0;
1369 /* finish_backward -- helper function for finish_command. */
1372 finish_backward (struct symbol
*function
)
1374 struct symtab_and_line sal
;
1375 struct thread_info
*tp
= inferior_thread ();
1376 struct breakpoint
*breakpoint
;
1377 struct cleanup
*old_chain
;
1378 CORE_ADDR func_addr
;
1381 if (find_pc_partial_function (get_frame_pc (get_current_frame ()),
1382 NULL
, &func_addr
, NULL
) == 0)
1383 internal_error (__FILE__
, __LINE__
,
1384 _("Finish: couldn't find function."));
1386 sal
= find_pc_line (func_addr
, 0);
1388 /* We don't need a return value. */
1389 tp
->proceed_to_finish
= 0;
1390 /* Special case: if we're sitting at the function entry point,
1391 then all we need to do is take a reverse singlestep. We
1392 don't need to set a breakpoint, and indeed it would do us
1395 Note that this can only happen at frame #0, since there's
1396 no way that a function up the stack can have a return address
1397 that's equal to its entry point. */
1399 if (sal
.pc
!= read_pc ())
1401 /* Set breakpoint and continue. */
1403 set_momentary_breakpoint (sal
,
1404 get_frame_id (get_selected_frame (NULL
)),
1406 /* Tell the breakpoint to keep quiet. We won't be done
1407 until we've done another reverse single-step. */
1408 make_breakpoint_silent (breakpoint
);
1409 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1410 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1411 /* We will be stopped when proceed returns. */
1412 back_up
= bpstat_find_breakpoint (tp
->stop_bpstat
, breakpoint
) != NULL
;
1413 do_cleanups (old_chain
);
1419 /* If in fact we hit the step-resume breakpoint (and not
1420 some other breakpoint), then we're almost there --
1421 we just need to back up by one more single-step. */
1422 tp
->step_range_start
= tp
->step_range_end
= 1;
1423 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
1428 /* finish_forward -- helper function for finish_command. */
1431 finish_forward (struct symbol
*function
, struct frame_info
*frame
)
1433 struct symtab_and_line sal
;
1434 struct thread_info
*tp
= inferior_thread ();
1435 struct breakpoint
*breakpoint
;
1436 struct cleanup
*old_chain
;
1437 struct finish_command_continuation_args
*cargs
;
1439 sal
= find_pc_line (get_frame_pc (frame
), 0);
1440 sal
.pc
= get_frame_pc (frame
);
1442 breakpoint
= set_momentary_breakpoint (sal
, get_frame_id (frame
),
1445 old_chain
= make_cleanup_delete_breakpoint (breakpoint
);
1447 tp
->proceed_to_finish
= 1; /* We want stop_registers, please... */
1448 make_cleanup_restore_integer (&suppress_stop_observer
);
1449 suppress_stop_observer
= 1;
1450 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
1452 cargs
= xmalloc (sizeof (*cargs
));
1454 cargs
->breakpoint
= breakpoint
;
1455 cargs
->function
= function
;
1456 add_continuation (tp
, finish_command_continuation
, cargs
,
1457 finish_command_continuation_free_arg
);
1459 discard_cleanups (old_chain
);
1460 if (!target_can_async_p ())
1461 do_all_continuations ();
1464 /* "finish": Set a temporary breakpoint at the place the selected
1465 frame will return to, then continue. */
1468 finish_command (char *arg
, int from_tty
)
1470 struct frame_info
*frame
;
1471 struct symbol
*function
;
1475 /* Find out whether we must run in the background. */
1477 async_exec
= strip_bg_char (&arg
);
1479 /* If we must run in the background, but the target can't do it,
1481 if (async_exec
&& !target_can_async_p ())
1482 error (_("Asynchronous execution not supported on this target."));
1484 /* Don't try to async in reverse. */
1485 if (async_exec
&& execution_direction
== EXEC_REVERSE
)
1486 error (_("Asynchronous 'finish' not supported in reverse."));
1488 /* If we are not asked to run in the bg, then prepare to run in the
1489 foreground, synchronously. */
1490 if (!async_exec
&& target_can_async_p ())
1492 /* Simulate synchronous execution. */
1493 async_disable_stdin ();
1497 error (_("The \"finish\" command does not take any arguments."));
1498 if (!target_has_execution
)
1499 error (_("The program is not running."));
1501 frame
= get_prev_frame (get_selected_frame (_("No selected frame.")));
1503 error (_("\"finish\" not meaningful in the outermost frame."));
1505 clear_proceed_status ();
1507 /* Find the function we will return from. */
1509 function
= find_pc_function (get_frame_pc (get_selected_frame (NULL
)));
1511 /* Print info on the selected frame, including level number but not
1515 if (execution_direction
== EXEC_REVERSE
)
1516 printf_filtered (_("Run back to call of "));
1518 printf_filtered (_("Run till exit from "));
1520 print_stack_frame (get_selected_frame (NULL
), 1, LOCATION
);
1523 if (execution_direction
== EXEC_REVERSE
)
1524 finish_backward (function
);
1526 finish_forward (function
, frame
);
1531 program_info (char *args
, int from_tty
)
1535 struct thread_info
*tp
;
1538 if (!target_has_execution
)
1540 printf_filtered (_("The program being debugged is not being run.\n"));
1545 ptid
= inferior_ptid
;
1548 struct target_waitstatus ws
;
1549 get_last_target_status (&ptid
, &ws
);
1552 if (ptid_equal (ptid
, null_ptid
) || is_exited (ptid
))
1553 error (_("Invalid selected thread."));
1554 else if (is_running (ptid
))
1555 error (_("Selected thread is running."));
1557 tp
= find_thread_pid (ptid
);
1558 bs
= tp
->stop_bpstat
;
1559 stat
= bpstat_num (&bs
, &num
);
1561 target_files_info ();
1562 printf_filtered (_("Program stopped at %s.\n"),
1563 hex_string ((unsigned long) stop_pc
));
1565 printf_filtered (_("It stopped after being stepped.\n"));
1568 /* There may be several breakpoints in the same place, so this
1569 isn't as strange as it seems. */
1574 printf_filtered (_("\
1575 It stopped at a breakpoint that has since been deleted.\n"));
1578 printf_filtered (_("It stopped at breakpoint %d.\n"), num
);
1579 stat
= bpstat_num (&bs
, &num
);
1582 else if (tp
->stop_signal
!= TARGET_SIGNAL_0
)
1584 printf_filtered (_("It stopped with signal %s, %s.\n"),
1585 target_signal_to_name (tp
->stop_signal
),
1586 target_signal_to_string (tp
->stop_signal
));
1591 printf_filtered (_("\
1592 Type \"info stack\" or \"info registers\" for more information.\n"));
1597 environment_info (char *var
, int from_tty
)
1601 char *val
= get_in_environ (inferior_environ
, var
);
1604 puts_filtered (var
);
1605 puts_filtered (" = ");
1606 puts_filtered (val
);
1607 puts_filtered ("\n");
1611 puts_filtered ("Environment variable \"");
1612 puts_filtered (var
);
1613 puts_filtered ("\" not defined.\n");
1618 char **vector
= environ_vector (inferior_environ
);
1621 puts_filtered (*vector
++);
1622 puts_filtered ("\n");
1628 set_environment_command (char *arg
, int from_tty
)
1630 char *p
, *val
, *var
;
1634 error_no_arg (_("environment variable and value"));
1636 /* Find seperation between variable name and value */
1637 p
= (char *) strchr (arg
, '=');
1638 val
= (char *) strchr (arg
, ' ');
1640 if (p
!= 0 && val
!= 0)
1642 /* We have both a space and an equals. If the space is before the
1643 equals, walk forward over the spaces til we see a nonspace
1644 (possibly the equals). */
1649 /* Now if the = is after the char following the spaces,
1650 take the char following the spaces. */
1654 else if (val
!= 0 && p
== 0)
1658 error_no_arg (_("environment variable to set"));
1660 if (p
== 0 || p
[1] == 0)
1664 p
= arg
+ strlen (arg
); /* So that savestring below will work */
1668 /* Not setting variable value to null */
1670 while (*val
== ' ' || *val
== '\t')
1674 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t'))
1677 var
= savestring (arg
, p
- arg
);
1680 printf_filtered (_("\
1681 Setting environment variable \"%s\" to null value.\n"),
1683 set_in_environ (inferior_environ
, var
, "");
1686 set_in_environ (inferior_environ
, var
, val
);
1691 unset_environment_command (char *var
, int from_tty
)
1695 /* If there is no argument, delete all environment variables.
1696 Ask for confirmation if reading from the terminal. */
1697 if (!from_tty
|| query (_("Delete all environment variables? ")))
1699 free_environ (inferior_environ
);
1700 inferior_environ
= make_environ ();
1704 unset_in_environ (inferior_environ
, var
);
1707 /* Handle the execution path (PATH variable) */
1709 static const char path_var_name
[] = "PATH";
1712 path_info (char *args
, int from_tty
)
1714 puts_filtered ("Executable and object file path: ");
1715 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
1716 puts_filtered ("\n");
1719 /* Add zero or more directories to the front of the execution path. */
1722 path_command (char *dirname
, int from_tty
)
1727 env
= get_in_environ (inferior_environ
, path_var_name
);
1728 /* Can be null if path is not set */
1731 exec_path
= xstrdup (env
);
1732 mod_path (dirname
, &exec_path
);
1733 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
1736 path_info ((char *) NULL
, from_tty
);
1740 /* Print out the machine register regnum. If regnum is -1, print all
1741 registers (print_all == 1) or all non-float and non-vector
1742 registers (print_all == 0).
1744 For most machines, having all_registers_info() print the
1745 register(s) one per line is good enough. If a different format is
1746 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1747 regs), or there is an existing convention for showing all the
1748 registers, define the architecture method PRINT_REGISTERS_INFO to
1749 provide that format. */
1752 default_print_registers_info (struct gdbarch
*gdbarch
,
1753 struct ui_file
*file
,
1754 struct frame_info
*frame
,
1755 int regnum
, int print_all
)
1758 const int numregs
= gdbarch_num_regs (gdbarch
)
1759 + gdbarch_num_pseudo_regs (gdbarch
);
1760 gdb_byte buffer
[MAX_REGISTER_SIZE
];
1762 for (i
= 0; i
< numregs
; i
++)
1764 /* Decide between printing all regs, non-float / vector regs, or
1770 if (!gdbarch_register_reggroup_p (gdbarch
, i
, all_reggroup
))
1775 if (!gdbarch_register_reggroup_p (gdbarch
, i
, general_reggroup
))
1785 /* If the register name is empty, it is undefined for this
1786 processor, so don't display anything. */
1787 if (gdbarch_register_name (gdbarch
, i
) == NULL
1788 || *(gdbarch_register_name (gdbarch
, i
)) == '\0')
1791 fputs_filtered (gdbarch_register_name (gdbarch
, i
), file
);
1792 print_spaces_filtered (15 - strlen (gdbarch_register_name
1793 (gdbarch
, i
)), file
);
1795 /* Get the data in raw format. */
1796 if (! frame_register_read (frame
, i
, buffer
))
1798 fprintf_filtered (file
, "*value not available*\n");
1802 /* If virtual format is floating, print it that way, and in raw
1804 if (TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_FLT
1805 || TYPE_CODE (register_type (gdbarch
, i
)) == TYPE_CODE_DECFLOAT
)
1809 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1810 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1812 fprintf_filtered (file
, "\t(raw 0x");
1813 for (j
= 0; j
< register_size (gdbarch
, i
); j
++)
1816 if (gdbarch_byte_order (gdbarch
) == BFD_ENDIAN_BIG
)
1819 idx
= register_size (gdbarch
, i
) - 1 - j
;
1820 fprintf_filtered (file
, "%02x", (unsigned char) buffer
[idx
]);
1822 fprintf_filtered (file
, ")");
1826 /* Print the register in hex. */
1827 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1828 file
, 'x', 1, 0, Val_pretty_default
, current_language
);
1829 /* If not a vector register, print it also according to its
1831 if (TYPE_VECTOR (register_type (gdbarch
, i
)) == 0)
1833 fprintf_filtered (file
, "\t");
1834 val_print (register_type (gdbarch
, i
), buffer
, 0, 0,
1835 file
, 0, 1, 0, Val_pretty_default
, current_language
);
1839 fprintf_filtered (file
, "\n");
1844 registers_info (char *addr_exp
, int fpregs
)
1846 struct frame_info
*frame
;
1847 struct gdbarch
*gdbarch
;
1848 int regnum
, numregs
;
1851 if (!target_has_registers
)
1852 error (_("The program has no registers now."));
1853 frame
= get_selected_frame (NULL
);
1854 gdbarch
= get_frame_arch (frame
);
1858 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1863 while (*addr_exp
!= '\0')
1868 /* Keep skipping leading white space. */
1869 if (isspace ((*addr_exp
)))
1875 /* Discard any leading ``$''. Check that there is something
1876 resembling a register following it. */
1877 if (addr_exp
[0] == '$')
1879 if (isspace ((*addr_exp
)) || (*addr_exp
) == '\0')
1880 error (_("Missing register name"));
1882 /* Find the start/end of this register name/num/group. */
1884 while ((*addr_exp
) != '\0' && !isspace ((*addr_exp
)))
1888 /* Figure out what we've found and display it. */
1890 /* A register name? */
1892 int regnum
= user_reg_map_name_to_regnum (gdbarch
, start
, end
- start
);
1895 /* User registers lie completely outside of the range of
1896 normal registers. Catch them early so that the target
1898 if (regnum
>= gdbarch_num_regs (gdbarch
)
1899 + gdbarch_num_pseudo_regs (gdbarch
))
1901 struct value
*val
= value_of_user_reg (regnum
, frame
);
1903 printf_filtered ("%s: ", start
);
1904 print_scalar_formatted (value_contents (val
),
1905 check_typedef (value_type (val
)),
1906 'x', 0, gdb_stdout
);
1907 printf_filtered ("\n");
1910 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1911 frame
, regnum
, fpregs
);
1916 /* A register number? (how portable is this one?). */
1919 int regnum
= strtol (start
, &endptr
, 0);
1922 && regnum
< gdbarch_num_regs (gdbarch
)
1923 + gdbarch_num_pseudo_regs (gdbarch
))
1925 gdbarch_print_registers_info (gdbarch
, gdb_stdout
,
1926 frame
, regnum
, fpregs
);
1931 /* A register group? */
1933 struct reggroup
*group
;
1934 for (group
= reggroup_next (gdbarch
, NULL
);
1936 group
= reggroup_next (gdbarch
, group
))
1938 /* Don't bother with a length check. Should the user
1939 enter a short register group name, go with the first
1940 group that matches. */
1941 if (strncmp (start
, reggroup_name (group
), end
- start
) == 0)
1948 regnum
< gdbarch_num_regs (gdbarch
)
1949 + gdbarch_num_pseudo_regs (gdbarch
);
1952 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
1953 gdbarch_print_registers_info (gdbarch
,
1961 /* Nothing matched. */
1962 error (_("Invalid register `%.*s'"), (int) (end
- start
), start
);
1967 all_registers_info (char *addr_exp
, int from_tty
)
1969 registers_info (addr_exp
, 1);
1973 nofp_registers_info (char *addr_exp
, int from_tty
)
1975 registers_info (addr_exp
, 0);
1979 print_vector_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
1980 struct frame_info
*frame
, const char *args
)
1982 if (gdbarch_print_vector_info_p (gdbarch
))
1983 gdbarch_print_vector_info (gdbarch
, file
, frame
, args
);
1987 int printed_something
= 0;
1990 regnum
< gdbarch_num_regs (gdbarch
)
1991 + gdbarch_num_pseudo_regs (gdbarch
);
1994 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, vector_reggroup
))
1996 printed_something
= 1;
1997 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2000 if (!printed_something
)
2001 fprintf_filtered (file
, "No vector information\n");
2006 vector_info (char *args
, int from_tty
)
2008 if (!target_has_registers
)
2009 error (_("The program has no registers now."));
2011 print_vector_info (current_gdbarch
, gdb_stdout
,
2012 get_selected_frame (NULL
), args
);
2018 * Should save/restore the tty state since it might be that the
2019 * program to be debugged was started on this tty and it wants
2020 * the tty in some state other than what we want. If it's running
2021 * on another terminal or without a terminal, then saving and
2022 * restoring the tty state is a harmless no-op.
2023 * This only needs to be done if we are attaching to a process.
2028 takes a program started up outside of gdb and ``attaches'' to it.
2029 This stops it cold in its tracks and allows us to start debugging it.
2030 and wait for the trace-trap that results from attaching. */
2033 attach_command_post_wait (char *args
, int from_tty
, int async_exec
)
2036 char *full_exec_path
= NULL
;
2037 struct inferior
*inferior
;
2039 inferior
= current_inferior ();
2040 inferior
->stop_soon
= NO_STOP_QUIETLY
;
2042 /* If no exec file is yet known, try to determine it from the
2044 exec_file
= (char *) get_exec_file (0);
2047 exec_file
= target_pid_to_exec_file (PIDGET (inferior_ptid
));
2050 /* It's possible we don't have a full path, but rather just a
2051 filename. Some targets, such as HP-UX, don't provide the
2054 Attempt to qualify the filename against the source path.
2055 (If that fails, we'll just fall back on the original
2056 filename. Not much more we can do...)
2058 if (!source_full_path_of (exec_file
, &full_exec_path
))
2059 full_exec_path
= savestring (exec_file
, strlen (exec_file
));
2061 exec_file_attach (full_exec_path
, from_tty
);
2062 symbol_file_add_main (full_exec_path
, from_tty
);
2067 reopen_exec_file ();
2071 /* Take any necessary post-attaching actions for this platform. */
2072 target_post_attach (PIDGET (inferior_ptid
));
2074 post_create_inferior (¤t_target
, from_tty
);
2076 /* Install inferior's terminal modes. */
2077 target_terminal_inferior ();
2080 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_0
, 0);
2083 if (target_can_async_p ())
2084 async_enable_stdin ();
2086 if (deprecated_attach_hook
)
2087 deprecated_attach_hook ();
2091 struct attach_command_continuation_args
2099 attach_command_continuation (void *args
)
2101 struct attach_command_continuation_args
*a
= args
;
2102 attach_command_post_wait (a
->args
, a
->from_tty
, a
->async_exec
);
2106 attach_command_continuation_free_args (void *args
)
2108 struct attach_command_continuation_args
*a
= args
;
2114 attach_command (char *args
, int from_tty
)
2117 char *full_exec_path
= NULL
;
2120 dont_repeat (); /* Not for the faint of heart */
2122 if (target_has_execution
)
2124 if (query ("A program is being debugged already. Kill it? "))
2127 error (_("Not killed."));
2130 /* Clean up any leftovers from other runs. Some other things from
2131 this function should probably be moved into target_pre_inferior. */
2132 target_pre_inferior (from_tty
);
2134 if (non_stop
&& !target_supports_non_stop ())
2135 error (_("Cannot attach to this target in non-stop mode"));
2139 async_exec
= strip_bg_char (&args
);
2141 /* If we get a request for running in the bg but the target
2142 doesn't support it, error out. */
2143 if (async_exec
&& !target_can_async_p ())
2144 error (_("Asynchronous execution not supported on this target."));
2147 /* If we don't get a request of running in the bg, then we need
2148 to simulate synchronous (fg) execution. */
2149 if (!async_exec
&& target_can_async_p ())
2151 /* Simulate synchronous execution */
2152 async_disable_stdin ();
2155 target_attach (args
, from_tty
);
2157 /* Set up the "saved terminal modes" of the inferior
2158 based on what modes we are starting it with. */
2159 target_terminal_init ();
2161 /* Set up execution context to know that we should return from
2162 wait_for_inferior as soon as the target reports a stop. */
2163 init_wait_for_inferior ();
2164 clear_proceed_status ();
2166 /* Some system don't generate traps when attaching to inferior.
2167 E.g. Mach 3 or GNU hurd. */
2168 if (!target_attach_no_wait
)
2170 struct inferior
*inferior
= current_inferior ();
2172 /* Careful here. See comments in inferior.h. Basically some
2173 OSes don't ignore SIGSTOPs on continue requests anymore. We
2174 need a way for handle_inferior_event to reset the stop_signal
2175 variable after an attach, and this is what
2176 STOP_QUIETLY_NO_SIGSTOP is for. */
2177 inferior
->stop_soon
= STOP_QUIETLY_NO_SIGSTOP
;
2179 if (target_can_async_p ())
2181 /* sync_execution mode. Wait for stop. */
2182 struct attach_command_continuation_args
*a
;
2184 a
= xmalloc (sizeof (*a
));
2185 a
->args
= xstrdup (args
);
2186 a
->from_tty
= from_tty
;
2187 a
->async_exec
= async_exec
;
2188 add_continuation (inferior_thread (),
2189 attach_command_continuation
, a
,
2190 attach_command_continuation_free_args
);
2194 wait_for_inferior (0);
2197 attach_command_post_wait (args
, from_tty
, async_exec
);
2202 * takes a program previously attached to and detaches it.
2203 * The program resumes execution and will no longer stop
2204 * on signals, etc. We better not have left any breakpoints
2205 * in the program or it'll die when it hits one. For this
2206 * to work, it may be necessary for the process to have been
2207 * previously attached. It *might* work if the program was
2208 * started via the normal ptrace (PTRACE_TRACEME).
2212 detach_command (char *args
, int from_tty
)
2214 dont_repeat (); /* Not for the faint of heart. */
2215 target_detach (args
, from_tty
);
2216 no_shared_libraries (NULL
, from_tty
);
2217 init_thread_list ();
2218 if (deprecated_detach_hook
)
2219 deprecated_detach_hook ();
2222 /* Disconnect from the current target without resuming it (leaving it
2223 waiting for a debugger).
2225 We'd better not have left any breakpoints in the program or the
2226 next debugger will get confused. Currently only supported for some
2227 remote targets, since the normal attach mechanisms don't work on
2228 stopped processes on some native platforms (e.g. GNU/Linux). */
2231 disconnect_command (char *args
, int from_tty
)
2233 dont_repeat (); /* Not for the faint of heart */
2234 target_disconnect (args
, from_tty
);
2235 no_shared_libraries (NULL
, from_tty
);
2236 init_thread_list ();
2237 if (deprecated_detach_hook
)
2238 deprecated_detach_hook ();
2242 interrupt_target_1 (int all_threads
)
2246 ptid
= minus_one_ptid
;
2248 ptid
= inferior_ptid
;
2252 /* Stop the execution of the target while running in async mode, in
2253 the backgound. In all-stop, stop the whole process. In non-stop
2254 mode, stop the current thread only by default, or stop all threads
2255 if the `-a' switch is used. */
2257 /* interrupt [-a] */
2259 interrupt_target_command (char *args
, int from_tty
)
2261 if (target_can_async_p ())
2263 int all_threads
= 0;
2265 dont_repeat (); /* Not for the faint of heart */
2268 && strncmp (args
, "-a", sizeof ("-a") - 1) == 0)
2271 if (!non_stop
&& all_threads
)
2272 error (_("-a is meaningless in all-stop mode."));
2274 interrupt_target_1 (all_threads
);
2279 print_float_info (struct gdbarch
*gdbarch
, struct ui_file
*file
,
2280 struct frame_info
*frame
, const char *args
)
2282 if (gdbarch_print_float_info_p (gdbarch
))
2283 gdbarch_print_float_info (gdbarch
, file
, frame
, args
);
2287 int printed_something
= 0;
2290 regnum
< gdbarch_num_regs (gdbarch
)
2291 + gdbarch_num_pseudo_regs (gdbarch
);
2294 if (gdbarch_register_reggroup_p (gdbarch
, regnum
, float_reggroup
))
2296 printed_something
= 1;
2297 gdbarch_print_registers_info (gdbarch
, file
, frame
, regnum
, 1);
2300 if (!printed_something
)
2301 fprintf_filtered (file
, "\
2302 No floating-point info available for this processor.\n");
2307 float_info (char *args
, int from_tty
)
2309 if (!target_has_registers
)
2310 error (_("The program has no registers now."));
2312 print_float_info (current_gdbarch
, gdb_stdout
,
2313 get_selected_frame (NULL
), args
);
2317 unset_command (char *args
, int from_tty
)
2319 printf_filtered (_("\
2320 \"unset\" must be followed by the name of an unset subcommand.\n"));
2321 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
2325 _initialize_infcmd (void)
2327 struct cmd_list_element
*c
= NULL
;
2329 /* add the filename of the terminal connected to inferior I/O */
2330 add_setshow_filename_cmd ("inferior-tty", class_run
,
2331 &inferior_io_terminal
, _("\
2332 Set terminal for future runs of program being debugged."), _("\
2333 Show terminal for future runs of program being debugged."), _("\
2334 Usage: set inferior-tty /dev/pts/1"), NULL
, NULL
, &setlist
, &showlist
);
2335 add_com_alias ("tty", "set inferior-tty", class_alias
, 0);
2337 add_setshow_optional_filename_cmd ("args", class_run
,
2338 &inferior_args
, _("\
2339 Set argument list to give program being debugged when it is started."), _("\
2340 Show argument list to give program being debugged when it is started."), _("\
2341 Follow this command with any number of args, to be passed to the program."),
2344 &setlist
, &showlist
);
2346 c
= add_cmd ("environment", no_class
, environment_info
, _("\
2347 The environment to give the program, or one variable's value.\n\
2348 With an argument VAR, prints the value of environment variable VAR to\n\
2349 give the program being debugged. With no arguments, prints the entire\n\
2350 environment to be given to the program."), &showlist
);
2351 set_cmd_completer (c
, noop_completer
);
2353 add_prefix_cmd ("unset", no_class
, unset_command
,
2354 _("Complement to certain \"set\" commands."),
2355 &unsetlist
, "unset ", 0, &cmdlist
);
2357 c
= add_cmd ("environment", class_run
, unset_environment_command
, _("\
2358 Cancel environment variable VAR for the program.\n\
2359 This does not affect the program until the next \"run\" command."),
2361 set_cmd_completer (c
, noop_completer
);
2363 c
= add_cmd ("environment", class_run
, set_environment_command
, _("\
2364 Set environment variable value to give the program.\n\
2365 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2366 VALUES of environment variables are uninterpreted strings.\n\
2367 This does not affect the program until the next \"run\" command."),
2369 set_cmd_completer (c
, noop_completer
);
2371 c
= add_com ("path", class_files
, path_command
, _("\
2372 Add directory DIR(s) to beginning of search path for object files.\n\
2373 $cwd in the path means the current working directory.\n\
2374 This path is equivalent to the $PATH shell variable. It is a list of\n\
2375 directories, separated by colons. These directories are searched to find\n\
2376 fully linked executable files and separately compiled object files as needed."));
2377 set_cmd_completer (c
, filename_completer
);
2379 c
= add_cmd ("paths", no_class
, path_info
, _("\
2380 Current search path for finding object files.\n\
2381 $cwd in the path means the current working directory.\n\
2382 This path is equivalent to the $PATH shell variable. It is a list of\n\
2383 directories, separated by colons. These directories are searched to find\n\
2384 fully linked executable files and separately compiled object files as needed."),
2386 set_cmd_completer (c
, noop_completer
);
2388 add_com ("attach", class_run
, attach_command
, _("\
2389 Attach to a process or file outside of GDB.\n\
2390 This command attaches to another target, of the same type as your last\n\
2391 \"target\" command (\"info files\" will show your target stack).\n\
2392 The command may take as argument a process id or a device file.\n\
2393 For a process id, you must have permission to send the process a signal,\n\
2394 and it must have the same effective uid as the debugger.\n\
2395 When using \"attach\" with a process id, the debugger finds the\n\
2396 program running in the process, looking first in the current working\n\
2397 directory, or (if not found there) using the source file search path\n\
2398 (see the \"directory\" command). You can also use the \"file\" command\n\
2399 to specify the program, and to load its symbol table."));
2401 add_prefix_cmd ("detach", class_run
, detach_command
, _("\
2402 Detach a process or file previously attached.\n\
2403 If a process, it is no longer traced, and it continues its execution. If\n\
2404 you were debugging a file, the file is closed and gdb no longer accesses it."),
2405 &detachlist
, "detach ", 0, &cmdlist
);
2407 add_com ("disconnect", class_run
, disconnect_command
, _("\
2408 Disconnect from a target.\n\
2409 The target will wait for another debugger to connect. Not available for\n\
2412 add_com ("signal", class_run
, signal_command
, _("\
2413 Continue program giving it signal specified by the argument.\n\
2414 An argument of \"0\" means continue program without giving it a signal."));
2416 add_com ("stepi", class_run
, stepi_command
, _("\
2417 Step one instruction exactly.\n\
2418 Argument N means do this N times (or till program stops for another reason)."));
2419 add_com_alias ("si", "stepi", class_alias
, 0);
2421 add_com ("nexti", class_run
, nexti_command
, _("\
2422 Step one instruction, but proceed through subroutine calls.\n\
2423 Argument N means do this N times (or till program stops for another reason)."));
2424 add_com_alias ("ni", "nexti", class_alias
, 0);
2426 add_com ("finish", class_run
, finish_command
, _("\
2427 Execute until selected stack frame returns.\n\
2428 Upon return, the value returned is printed and put in the value history."));
2429 add_com_alias ("fin", "finish", class_run
, 1);
2431 add_com ("next", class_run
, next_command
, _("\
2432 Step program, proceeding through subroutine calls.\n\
2433 Like the \"step\" command as long as subroutine calls do not happen;\n\
2434 when they do, the call is treated as one instruction.\n\
2435 Argument N means do this N times (or till program stops for another reason)."));
2436 add_com_alias ("n", "next", class_run
, 1);
2438 add_com_alias ("S", "next", class_run
, 1);
2440 add_com ("step", class_run
, step_command
, _("\
2441 Step program until it reaches a different source line.\n\
2442 Argument N means do this N times (or till program stops for another reason)."));
2443 add_com_alias ("s", "step", class_run
, 1);
2445 c
= add_com ("until", class_run
, until_command
, _("\
2446 Execute until the program reaches a source line greater than the current\n\
2447 or a specified location (same args as break command) within the current frame."));
2448 set_cmd_completer (c
, location_completer
);
2449 add_com_alias ("u", "until", class_run
, 1);
2451 c
= add_com ("advance", class_run
, advance_command
, _("\
2452 Continue the program up to the given location (same form as args for break command).\n\
2453 Execution will also stop upon exit from the current stack frame."));
2454 set_cmd_completer (c
, location_completer
);
2456 c
= add_com ("jump", class_run
, jump_command
, _("\
2457 Continue program being debugged at specified line or address.\n\
2458 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2459 for an address to start at."));
2460 set_cmd_completer (c
, location_completer
);
2464 c
= add_com ("go", class_run
, go_command
, _("\
2465 Usage: go <location>\n\
2466 Continue program being debugged, stopping at specified line or \n\
2468 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2469 expression for an address to start at.\n\
2470 This command is a combination of tbreak and jump."));
2471 set_cmd_completer (c
, location_completer
);
2475 add_com_alias ("g", "go", class_run
, 1);
2477 c
= add_com ("continue", class_run
, continue_command
, _("\
2478 Continue program being debugged, after signal or breakpoint.\n\
2479 If proceeding from breakpoint, a number N may be used as an argument,\n\
2480 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2481 the breakpoint won't break until the Nth time it is reached).\n\
2483 If non-stop mode is enabled, continue only the current thread,\n\
2484 otherwise all the threads in the program are continued. To \n\
2485 continue all stopped threads in non-stop mode, use the -a option.\n\
2486 Specifying -a and an ignore count simultaneously is an error."));
2487 add_com_alias ("c", "cont", class_run
, 1);
2488 add_com_alias ("fg", "cont", class_run
, 1);
2490 c
= add_com ("run", class_run
, run_command
, _("\
2491 Start debugged program. You may specify arguments to give it.\n\
2492 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2493 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2494 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2495 To cancel previous arguments and run with no arguments,\n\
2496 use \"set args\" without arguments."));
2497 set_cmd_completer (c
, filename_completer
);
2498 add_com_alias ("r", "run", class_run
, 1);
2500 add_com ("R", class_run
, run_no_args_command
,
2501 _("Start debugged program with no arguments."));
2503 c
= add_com ("start", class_run
, start_command
, _("\
2504 Run the debugged program until the beginning of the main procedure.\n\
2505 You may specify arguments to give to your program, just as with the\n\
2506 \"run\" command."));
2507 set_cmd_completer (c
, filename_completer
);
2509 c
= add_com ("interrupt", class_run
, interrupt_target_command
,
2510 _("Interrupt the execution of the debugged program.\n\
2511 If non-stop mode is enabled, interrupt only the current thread,\n\
2512 otherwise all the threads in the program are stopped. To \n\
2513 interrupt all running threads in non-stop mode, use the -a option."));
2515 add_info ("registers", nofp_registers_info
, _("\
2516 List of integer registers and their contents, for selected stack frame.\n\
2517 Register name as argument means describe only that register."));
2518 add_info_alias ("r", "registers", 1);
2521 add_com ("lr", class_info
, nofp_registers_info
, _("\
2522 List of integer registers and their contents, for selected stack frame.\n\
2523 Register name as argument means describe only that register."));
2524 add_info ("all-registers", all_registers_info
, _("\
2525 List of all registers and their contents, for selected stack frame.\n\
2526 Register name as argument means describe only that register."));
2528 add_info ("program", program_info
,
2529 _("Execution status of the program."));
2531 add_info ("float", float_info
,
2532 _("Print the status of the floating point unit\n"));
2534 add_info ("vector", vector_info
,
2535 _("Print the status of the vector unit\n"));
2537 inferior_environ
= make_environ ();
2538 init_environ (inferior_environ
);