* inferior.h (stop_bpstat): Delete.
[binutils-gdb.git] / gdb / infcmd.c
1 /* Memory-access and commands for "inferior" process, for GDB.
2
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.
6
7 This file is part of GDB.
8
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.
13
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.
18
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/>. */
21
22 #include "defs.h"
23 #include <signal.h>
24 #include "gdb_string.h"
25 #include "symtab.h"
26 #include "gdbtypes.h"
27 #include "frame.h"
28 #include "inferior.h"
29 #include "environ.h"
30 #include "value.h"
31 #include "gdbcmd.h"
32 #include "symfile.h"
33 #include "gdbcore.h"
34 #include "target.h"
35 #include "language.h"
36 #include "symfile.h"
37 #include "objfiles.h"
38 #include "completer.h"
39 #include "ui-out.h"
40 #include "event-top.h"
41 #include "parser-defs.h"
42 #include "regcache.h"
43 #include "reggroups.h"
44 #include "block.h"
45 #include "solib.h"
46 #include <ctype.h>
47 #include "gdb_assert.h"
48 #include "observer.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"
54
55 /* Functions exported for general use, in inferior.h: */
56
57 void all_registers_info (char *, int);
58
59 void registers_info (char *, int);
60
61 void nexti_command (char *, int);
62
63 void stepi_command (char *, int);
64
65 void continue_command (char *, int);
66
67 void interrupt_target_command (char *args, int from_tty);
68
69 /* Local functions: */
70
71 static void nofp_registers_info (char *, int);
72
73 static void print_return_value (struct type *func_type,
74 struct type *value_type);
75
76 static void until_next_command (int);
77
78 static void until_command (char *, int);
79
80 static void path_info (char *, int);
81
82 static void path_command (char *, int);
83
84 static void unset_command (char *, int);
85
86 static void float_info (char *, int);
87
88 static void detach_command (char *, int);
89
90 static void disconnect_command (char *, int);
91
92 static void unset_environment_command (char *, int);
93
94 static void set_environment_command (char *, int);
95
96 static void environment_info (char *, int);
97
98 static void program_info (char *, int);
99
100 static void finish_command (char *, int);
101
102 static void signal_command (char *, int);
103
104 static void jump_command (char *, int);
105
106 static void step_1 (int, int, char *);
107 static void step_once (int skip_subroutines, int single_inst, int count, int thread);
108
109 static void next_command (char *, int);
110
111 static void step_command (char *, int);
112
113 static void run_command (char *, int);
114
115 static void run_no_args_command (char *args, int from_tty);
116
117 static void go_command (char *line_no, int from_tty);
118
119 static int strip_bg_char (char **);
120
121 void _initialize_infcmd (void);
122
123 #define GO_USAGE "Usage: go <location>\n"
124
125 #define ERROR_NO_INFERIOR \
126 if (!target_has_execution) error (_("The program is not being run."));
127
128 /* String containing arguments to give to the program, separated by spaces.
129 Empty string (pointer to '\0') means no args. */
130
131 static char *inferior_args;
132
133 /* The inferior arguments as a vector. If INFERIOR_ARGC is nonzero,
134 then we must compute INFERIOR_ARGS from this (via the target). */
135
136 static int inferior_argc;
137 static char **inferior_argv;
138
139 /* File name for default use for standard in/out in the inferior. */
140
141 static char *inferior_io_terminal;
142
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
146 debugging. */
147
148 ptid_t inferior_ptid;
149
150 /* Last signal that the inferior received (why it stopped). */
151
152 enum target_signal stop_signal;
153
154 /* Address at which inferior stopped. */
155
156 CORE_ADDR stop_pc;
157
158 /* Flag indicating that a command has proceeded the inferior past the
159 current breakpoint. */
160
161 int breakpoint_proceeded;
162
163 /* Nonzero if stopped due to a step command. */
164
165 int stop_step;
166
167 /* Nonzero if stopped due to completion of a stack dummy routine. */
168
169 int stop_stack_dummy;
170
171 /* Nonzero if stopped due to a random (unexpected) signal in inferior
172 process. */
173
174 int stopped_by_random_signal;
175
176 /* If stepping, nonzero means step count is > 1
177 so don't print frame next time inferior stops
178 if it stops due to stepping. */
179
180 int step_multi;
181
182 /* Environment to use for running inferior,
183 in format described in environ.h. */
184
185 struct gdb_environ *inferior_environ;
186
187 /* When set, no calls to target_resumed observer will be made. */
188 int suppress_resume_observer = 0;
189 /* When set, normal_stop will not call the normal_stop observer. */
190 int suppress_stop_observer = 0;
191 \f
192 /* Accessor routines. */
193
194 void
195 set_inferior_io_terminal (const char *terminal_name)
196 {
197 if (inferior_io_terminal)
198 xfree (inferior_io_terminal);
199
200 if (!terminal_name)
201 inferior_io_terminal = NULL;
202 else
203 inferior_io_terminal = savestring (terminal_name, strlen (terminal_name));
204 }
205
206 const char *
207 get_inferior_io_terminal (void)
208 {
209 return inferior_io_terminal;
210 }
211
212 char *
213 get_inferior_args (void)
214 {
215 if (inferior_argc != 0)
216 {
217 char *n, *old;
218
219 n = gdbarch_construct_inferior_arguments (current_gdbarch,
220 inferior_argc, inferior_argv);
221 old = set_inferior_args (n);
222 xfree (old);
223 }
224
225 if (inferior_args == NULL)
226 inferior_args = xstrdup ("");
227
228 return inferior_args;
229 }
230
231 char *
232 set_inferior_args (char *newargs)
233 {
234 char *saved_args = inferior_args;
235
236 inferior_args = newargs;
237 inferior_argc = 0;
238 inferior_argv = 0;
239
240 return saved_args;
241 }
242
243 void
244 set_inferior_args_vector (int argc, char **argv)
245 {
246 inferior_argc = argc;
247 inferior_argv = argv;
248 }
249
250 /* Notice when `set args' is run. */
251 static void
252 notice_args_set (char *args, int from_tty, struct cmd_list_element *c)
253 {
254 inferior_argc = 0;
255 inferior_argv = 0;
256 }
257
258 /* Notice when `show args' is run. */
259 static void
260 notice_args_read (struct ui_file *file, int from_tty,
261 struct cmd_list_element *c, const char *value)
262 {
263 /* Note that we ignore the passed-in value in favor of computing it
264 directly. */
265 deprecated_show_value_hack (file, from_tty, c, get_inferior_args ());
266 }
267
268 \f
269 /* Compute command-line string given argument vector. This does the
270 same shell processing as fork_inferior. */
271 char *
272 construct_inferior_arguments (struct gdbarch *gdbarch, int argc, char **argv)
273 {
274 char *result;
275
276 if (STARTUP_WITH_SHELL)
277 {
278 /* This holds all the characters considered special to the
279 typical Unix shells. We include `^' because the SunOS
280 /bin/sh treats it as a synonym for `|'. */
281 char *special = "\"!#$&*()\\|[]{}<>?'\"`~^; \t\n";
282 int i;
283 int length = 0;
284 char *out, *cp;
285
286 /* We over-compute the size. It shouldn't matter. */
287 for (i = 0; i < argc; ++i)
288 length += 2 * strlen (argv[i]) + 1 + 2 * (argv[i][0] == '\0');
289
290 result = (char *) xmalloc (length);
291 out = result;
292
293 for (i = 0; i < argc; ++i)
294 {
295 if (i > 0)
296 *out++ = ' ';
297
298 /* Need to handle empty arguments specially. */
299 if (argv[i][0] == '\0')
300 {
301 *out++ = '\'';
302 *out++ = '\'';
303 }
304 else
305 {
306 for (cp = argv[i]; *cp; ++cp)
307 {
308 if (strchr (special, *cp) != NULL)
309 *out++ = '\\';
310 *out++ = *cp;
311 }
312 }
313 }
314 *out = '\0';
315 }
316 else
317 {
318 /* In this case we can't handle arguments that contain spaces,
319 tabs, or newlines -- see breakup_args(). */
320 int i;
321 int length = 0;
322
323 for (i = 0; i < argc; ++i)
324 {
325 char *cp = strchr (argv[i], ' ');
326 if (cp == NULL)
327 cp = strchr (argv[i], '\t');
328 if (cp == NULL)
329 cp = strchr (argv[i], '\n');
330 if (cp != NULL)
331 error (_("can't handle command-line argument containing whitespace"));
332 length += strlen (argv[i]) + 1;
333 }
334
335 result = (char *) xmalloc (length);
336 result[0] = '\0';
337 for (i = 0; i < argc; ++i)
338 {
339 if (i > 0)
340 strcat (result, " ");
341 strcat (result, argv[i]);
342 }
343 }
344
345 return result;
346 }
347 \f
348
349 /* This function detects whether or not a '&' character (indicating
350 background execution) has been added as *the last* of the arguments ARGS
351 of a command. If it has, it removes it and returns 1. Otherwise it
352 does nothing and returns 0. */
353 static int
354 strip_bg_char (char **args)
355 {
356 char *p = NULL;
357
358 p = strchr (*args, '&');
359
360 if (p)
361 {
362 if (p == (*args + strlen (*args) - 1))
363 {
364 if (strlen (*args) > 1)
365 {
366 do
367 p--;
368 while (*p == ' ' || *p == '\t');
369 *(p + 1) = '\0';
370 }
371 else
372 *args = 0;
373 return 1;
374 }
375 }
376 return 0;
377 }
378
379 void
380 tty_command (char *file, int from_tty)
381 {
382 if (file == 0)
383 error_no_arg (_("terminal name for running target process"));
384
385 set_inferior_io_terminal (file);
386 }
387
388 /* Common actions to take after creating any sort of inferior, by any
389 means (running, attaching, connecting, et cetera). The target
390 should be stopped. */
391
392 void
393 post_create_inferior (struct target_ops *target, int from_tty)
394 {
395 /* Be sure we own the terminal in case write operations are performed. */
396 target_terminal_ours ();
397
398 /* If the target hasn't taken care of this already, do it now.
399 Targets which need to access registers during to_open,
400 to_create_inferior, or to_attach should do it earlier; but many
401 don't need to. */
402 target_find_description ();
403
404 if (exec_bfd)
405 {
406 /* Sometimes the platform-specific hook loads initial shared
407 libraries, and sometimes it doesn't. Try to do so first, so
408 that we can add them with the correct value for FROM_TTY.
409 If we made all the inferior hook methods consistent,
410 this call could be removed. */
411 #ifdef SOLIB_ADD
412 SOLIB_ADD (NULL, from_tty, target, auto_solib_add);
413 #else
414 solib_add (NULL, from_tty, target, auto_solib_add);
415 #endif
416
417 /* Create the hooks to handle shared library load and unload
418 events. */
419 #ifdef SOLIB_CREATE_INFERIOR_HOOK
420 SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid));
421 #else
422 solib_create_inferior_hook ();
423 #endif
424 }
425
426 observer_notify_inferior_created (target, from_tty);
427 }
428
429 /* Kill the inferior if already running. This function is designed
430 to be called when we are about to start the execution of the program
431 from the beginning. Ask the user to confirm that he wants to restart
432 the program being debugged when FROM_TTY is non-null. */
433
434 static void
435 kill_if_already_running (int from_tty)
436 {
437 if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
438 {
439 /* Bail out before killing the program if we will not be able to
440 restart it. */
441 target_require_runnable ();
442
443 if (from_tty
444 && !query ("The program being debugged has been started already.\n\
445 Start it from the beginning? "))
446 error (_("Program not restarted."));
447 target_kill ();
448 no_shared_libraries (NULL, from_tty);
449 init_wait_for_inferior ();
450 }
451 }
452
453 /* Implement the "run" command. If TBREAK_AT_MAIN is set, then insert
454 a temporary breakpoint at the begining of the main program before
455 running the program. */
456
457 static void
458 run_command_1 (char *args, int from_tty, int tbreak_at_main)
459 {
460 char *exec_file;
461
462 dont_repeat ();
463
464 kill_if_already_running (from_tty);
465 clear_breakpoint_hit_counts ();
466
467 /* Clean up any leftovers from other runs. Some other things from
468 this function should probably be moved into target_pre_inferior. */
469 target_pre_inferior (from_tty);
470
471 /* The comment here used to read, "The exec file is re-read every
472 time we do a generic_mourn_inferior, so we just have to worry
473 about the symbol file." The `generic_mourn_inferior' function
474 gets called whenever the program exits. However, suppose the
475 program exits, and *then* the executable file changes? We need
476 to check again here. Since reopen_exec_file doesn't do anything
477 if the timestamp hasn't changed, I don't see the harm. */
478 reopen_exec_file ();
479 reread_symbols ();
480
481 /* Insert the temporary breakpoint if a location was specified. */
482 if (tbreak_at_main)
483 tbreak_command (main_name (), 0);
484
485 exec_file = (char *) get_exec_file (0);
486
487 if (non_stop && !target_supports_non_stop ())
488 error (_("The target does not support running in non-stop mode."));
489
490 /* We keep symbols from add-symbol-file, on the grounds that the
491 user might want to add some symbols before running the program
492 (right?). But sometimes (dynamic loading where the user manually
493 introduces the new symbols with add-symbol-file), the code which
494 the symbols describe does not persist between runs. Currently
495 the user has to manually nuke all symbols between runs if they
496 want them to go away (PR 2207). This is probably reasonable. */
497
498 if (!args)
499 {
500 if (target_can_async_p ())
501 async_disable_stdin ();
502 }
503 else
504 {
505 int async_exec = strip_bg_char (&args);
506
507 /* If we get a request for running in the bg but the target
508 doesn't support it, error out. */
509 if (async_exec && !target_can_async_p ())
510 error (_("Asynchronous execution not supported on this target."));
511
512 /* If we don't get a request of running in the bg, then we need
513 to simulate synchronous (fg) execution. */
514 if (!async_exec && target_can_async_p ())
515 {
516 /* Simulate synchronous execution */
517 async_disable_stdin ();
518 }
519
520 /* If there were other args, beside '&', process them. */
521 if (args)
522 {
523 char *old_args = set_inferior_args (xstrdup (args));
524 xfree (old_args);
525 }
526 }
527
528 if (from_tty)
529 {
530 ui_out_field_string (uiout, NULL, "Starting program");
531 ui_out_text (uiout, ": ");
532 if (exec_file)
533 ui_out_field_string (uiout, "execfile", exec_file);
534 ui_out_spaces (uiout, 1);
535 /* We call get_inferior_args() because we might need to compute
536 the value now. */
537 ui_out_field_string (uiout, "infargs", get_inferior_args ());
538 ui_out_text (uiout, "\n");
539 ui_out_flush (uiout);
540 }
541
542 /* We call get_inferior_args() because we might need to compute
543 the value now. */
544 target_create_inferior (exec_file, get_inferior_args (),
545 environ_vector (inferior_environ), from_tty);
546
547 /* Pass zero for FROM_TTY, because at this point the "run" command
548 has done its thing; now we are setting up the running program. */
549 post_create_inferior (&current_target, 0);
550
551 /* Start the target running. */
552 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_0, 0);
553 }
554
555
556 static void
557 run_command (char *args, int from_tty)
558 {
559 run_command_1 (args, from_tty, 0);
560 }
561
562 static void
563 run_no_args_command (char *args, int from_tty)
564 {
565 char *old_args = set_inferior_args (xstrdup (""));
566 xfree (old_args);
567 }
568 \f
569
570 /* Start the execution of the program up until the beginning of the main
571 program. */
572
573 static void
574 start_command (char *args, int from_tty)
575 {
576 /* Some languages such as Ada need to search inside the program
577 minimal symbols for the location where to put the temporary
578 breakpoint before starting. */
579 if (!have_minimal_symbols ())
580 error (_("No symbol table loaded. Use the \"file\" command."));
581
582 /* Run the program until reaching the main procedure... */
583 run_command_1 (args, from_tty, 1);
584 }
585
586 static int
587 proceed_thread_callback (struct thread_info *thread, void *arg)
588 {
589 if (!is_stopped (thread->ptid))
590 return 0;
591
592 context_switch_to (thread->ptid);
593 clear_proceed_status ();
594 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
595 return 0;
596 }
597
598 void
599 continue_1 (int all_threads)
600 {
601 ERROR_NO_INFERIOR;
602
603 if (non_stop && all_threads)
604 {
605 /* Don't error out if the current thread is running, because
606 there may be other stopped threads. */
607 struct cleanup *old_chain;
608
609 /* Backup current thread and selected frame. */
610 old_chain = make_cleanup_restore_current_thread ();
611
612 iterate_over_threads (proceed_thread_callback, NULL);
613
614 /* Restore selected ptid. */
615 do_cleanups (old_chain);
616 }
617 else
618 {
619 ensure_not_running ();
620 clear_proceed_status ();
621 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
622 }
623 }
624
625 /* continue [-a] [proceed-count] [&] */
626 void
627 continue_command (char *args, int from_tty)
628 {
629 int async_exec = 0;
630 int all_threads = 0;
631 ERROR_NO_INFERIOR;
632
633 /* Find out whether we must run in the background. */
634 if (args != NULL)
635 async_exec = strip_bg_char (&args);
636
637 /* If we must run in the background, but the target can't do it,
638 error out. */
639 if (async_exec && !target_can_async_p ())
640 error (_("Asynchronous execution not supported on this target."));
641
642 /* If we are not asked to run in the bg, then prepare to run in the
643 foreground, synchronously. */
644 if (!async_exec && target_can_async_p ())
645 {
646 /* Simulate synchronous execution */
647 async_disable_stdin ();
648 }
649
650 if (args != NULL)
651 {
652 if (strncmp (args, "-a", sizeof ("-a") - 1) == 0)
653 {
654 all_threads = 1;
655 args += sizeof ("-a") - 1;
656 if (*args == '\0')
657 args = NULL;
658 }
659 }
660
661 if (!non_stop && all_threads)
662 error (_("`-a' is meaningless in all-stop mode."));
663
664 if (args != NULL && all_threads)
665 error (_("\
666 Can't resume all threads and specify proceed count simultaneously."));
667
668 /* If we have an argument left, set proceed count of breakpoint we
669 stopped at. */
670 if (args != NULL)
671 {
672 bpstat bs = NULL;
673 int num, stat;
674 int stopped = 0;
675 struct thread_info *tp;
676
677 if (non_stop)
678 tp = find_thread_pid (inferior_ptid);
679 else
680 {
681 ptid_t last_ptid;
682 struct target_waitstatus ws;
683
684 get_last_target_status (&last_ptid, &ws);
685 tp = find_thread_pid (last_ptid);
686 }
687 if (tp != NULL)
688 bs = tp->stop_bpstat;
689
690 while ((stat = bpstat_num (&bs, &num)) != 0)
691 if (stat > 0)
692 {
693 set_ignore_count (num,
694 parse_and_eval_long (args) - 1,
695 from_tty);
696 /* set_ignore_count prints a message ending with a period.
697 So print two spaces before "Continuing.". */
698 if (from_tty)
699 printf_filtered (" ");
700 stopped = 1;
701 }
702
703 if (!stopped && from_tty)
704 {
705 printf_filtered
706 ("Not stopped at any breakpoint; argument ignored.\n");
707 }
708 }
709
710 if (from_tty)
711 printf_filtered (_("Continuing.\n"));
712
713 continue_1 (all_threads);
714 }
715 \f
716 /* Step until outside of current statement. */
717
718 static void
719 step_command (char *count_string, int from_tty)
720 {
721 step_1 (0, 0, count_string);
722 }
723
724 /* Likewise, but skip over subroutine calls as if single instructions. */
725
726 static void
727 next_command (char *count_string, int from_tty)
728 {
729 step_1 (1, 0, count_string);
730 }
731
732 /* Likewise, but step only one instruction. */
733
734 void
735 stepi_command (char *count_string, int from_tty)
736 {
737 step_1 (0, 1, count_string);
738 }
739
740 void
741 nexti_command (char *count_string, int from_tty)
742 {
743 step_1 (1, 1, count_string);
744 }
745
746 static void
747 delete_longjmp_breakpoint_cleanup (void *arg)
748 {
749 int thread = * (int *) arg;
750 delete_longjmp_breakpoint (thread);
751 }
752
753 static void
754 step_1 (int skip_subroutines, int single_inst, char *count_string)
755 {
756 int count = 1;
757 struct frame_info *frame;
758 struct cleanup *cleanups = make_cleanup (null_cleanup, NULL);
759 int async_exec = 0;
760 int thread = -1;
761
762 ERROR_NO_INFERIOR;
763 ensure_not_running ();
764
765 if (count_string)
766 async_exec = strip_bg_char (&count_string);
767
768 /* If we get a request for running in the bg but the target
769 doesn't support it, error out. */
770 if (async_exec && !target_can_async_p ())
771 error (_("Asynchronous execution not supported on this target."));
772
773 /* If we don't get a request of running in the bg, then we need
774 to simulate synchronous (fg) execution. */
775 if (!async_exec && target_can_async_p ())
776 {
777 /* Simulate synchronous execution */
778 async_disable_stdin ();
779 }
780
781 count = count_string ? parse_and_eval_long (count_string) : 1;
782
783 if (!single_inst || skip_subroutines) /* leave si command alone */
784 {
785 if (in_thread_list (inferior_ptid))
786 thread = pid_to_thread_id (inferior_ptid);
787
788 set_longjmp_breakpoint ();
789
790 make_cleanup (delete_longjmp_breakpoint_cleanup, &thread);
791 }
792
793 /* In synchronous case, all is well, just use the regular for loop. */
794 if (!target_can_async_p ())
795 {
796 for (; count > 0; count--)
797 {
798 struct thread_info *tp = inferior_thread ();
799 clear_proceed_status ();
800
801 frame = get_current_frame ();
802 tp->step_frame_id = get_frame_id (frame);
803
804 if (!single_inst)
805 {
806 find_pc_line_pc_range (stop_pc,
807 &tp->step_range_start, &tp->step_range_end);
808 if (tp->step_range_end == 0)
809 {
810 char *name;
811 if (find_pc_partial_function (stop_pc, &name,
812 &tp->step_range_start,
813 &tp->step_range_end) == 0)
814 error (_("Cannot find bounds of current function"));
815
816 target_terminal_ours ();
817 printf_filtered (_("\
818 Single stepping until exit from function %s, \n\
819 which has no line number information.\n"), name);
820 }
821 }
822 else
823 {
824 /* Say we are stepping, but stop after one insn whatever it does. */
825 tp->step_range_start = tp->step_range_end = 1;
826 if (!skip_subroutines)
827 /* It is stepi.
828 Don't step over function calls, not even to functions lacking
829 line numbers. */
830 tp->step_over_calls = STEP_OVER_NONE;
831 }
832
833 if (skip_subroutines)
834 tp->step_over_calls = STEP_OVER_ALL;
835
836 step_multi = (count > 1);
837 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
838
839 if (!stop_step)
840 break;
841 }
842
843 do_cleanups (cleanups);
844 return;
845 }
846 /* In case of asynchronous target things get complicated, do only
847 one step for now, before returning control to the event loop. Let
848 the continuation figure out how many other steps we need to do,
849 and handle them one at the time, through step_once(). */
850 else
851 {
852 step_once (skip_subroutines, single_inst, count, thread);
853 /* We are running, and the continuation is installed. It will
854 disable the longjmp breakpoint as appropriate. */
855 discard_cleanups (cleanups);
856 }
857 }
858
859 struct step_1_continuation_args
860 {
861 int count;
862 int skip_subroutines;
863 int single_inst;
864 int thread;
865 };
866
867 /* Called after we are done with one step operation, to check whether
868 we need to step again, before we print the prompt and return control
869 to the user. If count is > 1, we will need to do one more call to
870 proceed(), via step_once(). Basically it is like step_once and
871 step_1_continuation are co-recursive. */
872 static void
873 step_1_continuation (void *args)
874 {
875 struct step_1_continuation_args *a = args;
876
877 if (!step_multi || !stop_step)
878 {
879 /* If we stopped for some reason that is not stepping there are
880 no further steps to make. Cleanup. */
881 if (!a->single_inst || a->skip_subroutines)
882 delete_longjmp_breakpoint (a->thread);
883 step_multi = 0;
884 }
885 else
886 step_once (a->skip_subroutines, a->single_inst, a->count - 1, a->thread);
887 }
888
889 /* Do just one step operation. If count >1 we will have to set up a
890 continuation to be done after the target stops (after this one
891 step). This is useful to implement the 'step n' kind of commands, in
892 case of asynchronous targets. We had to split step_1 into two parts,
893 one to be done before proceed() and one afterwards. This function is
894 called in case of step n with n>1, after the first step operation has
895 been completed.*/
896 static void
897 step_once (int skip_subroutines, int single_inst, int count, int thread)
898 {
899 struct frame_info *frame;
900 struct step_1_continuation_args *args;
901
902 if (count > 0)
903 {
904 /* Don't assume THREAD is a valid thread id. It is set to -1 if
905 the longjmp breakpoint was not required. Use the
906 INFERIOR_PTID thread instead, which is the same thread when
907 THREAD is set. */
908 struct thread_info *tp = inferior_thread ();
909 clear_proceed_status ();
910
911 frame = get_current_frame ();
912 if (!frame) /* Avoid coredump here. Why tho? */
913 error (_("No current frame"));
914 tp->step_frame_id = get_frame_id (frame);
915
916 if (!single_inst)
917 {
918 find_pc_line_pc_range (stop_pc,
919 &tp->step_range_start, &tp->step_range_end);
920
921 /* If we have no line info, switch to stepi mode. */
922 if (tp->step_range_end == 0 && step_stop_if_no_debug)
923 {
924 tp->step_range_start = tp->step_range_end = 1;
925 }
926 else if (tp->step_range_end == 0)
927 {
928 char *name;
929 if (find_pc_partial_function (stop_pc, &name,
930 &tp->step_range_start,
931 &tp->step_range_end) == 0)
932 error (_("Cannot find bounds of current function"));
933
934 target_terminal_ours ();
935 printf_filtered (_("\
936 Single stepping until exit from function %s, \n\
937 which has no line number information.\n"), name);
938 }
939 }
940 else
941 {
942 /* Say we are stepping, but stop after one insn whatever it does. */
943 tp->step_range_start = tp->step_range_end = 1;
944 if (!skip_subroutines)
945 /* It is stepi.
946 Don't step over function calls, not even to functions lacking
947 line numbers. */
948 tp->step_over_calls = STEP_OVER_NONE;
949 }
950
951 if (skip_subroutines)
952 tp->step_over_calls = STEP_OVER_ALL;
953
954 step_multi = (count > 1);
955 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
956
957 args = xmalloc (sizeof (*args));
958 args->skip_subroutines = skip_subroutines;
959 args->single_inst = single_inst;
960 args->count = count;
961 args->thread = thread;
962 add_intermediate_continuation (step_1_continuation, args, xfree);
963 }
964 }
965
966 \f
967 /* Continue program at specified address. */
968
969 static void
970 jump_command (char *arg, int from_tty)
971 {
972 CORE_ADDR addr;
973 struct symtabs_and_lines sals;
974 struct symtab_and_line sal;
975 struct symbol *fn;
976 struct symbol *sfn;
977 int async_exec = 0;
978
979 ERROR_NO_INFERIOR;
980 ensure_not_running ();
981
982 /* Find out whether we must run in the background. */
983 if (arg != NULL)
984 async_exec = strip_bg_char (&arg);
985
986 /* If we must run in the background, but the target can't do it,
987 error out. */
988 if (async_exec && !target_can_async_p ())
989 error (_("Asynchronous execution not supported on this target."));
990
991 if (!arg)
992 error_no_arg (_("starting address"));
993
994 sals = decode_line_spec_1 (arg, 1);
995 if (sals.nelts != 1)
996 {
997 error (_("Unreasonable jump request"));
998 }
999
1000 sal = sals.sals[0];
1001 xfree (sals.sals);
1002
1003 if (sal.symtab == 0 && sal.pc == 0)
1004 error (_("No source file has been specified."));
1005
1006 resolve_sal_pc (&sal); /* May error out */
1007
1008 /* See if we are trying to jump to another function. */
1009 fn = get_frame_function (get_current_frame ());
1010 sfn = find_pc_function (sal.pc);
1011 if (fn != NULL && sfn != fn)
1012 {
1013 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal.line,
1014 SYMBOL_PRINT_NAME (fn)))
1015 {
1016 error (_("Not confirmed."));
1017 /* NOTREACHED */
1018 }
1019 }
1020
1021 if (sfn != NULL)
1022 {
1023 fixup_symbol_section (sfn, 0);
1024 if (section_is_overlay (SYMBOL_OBJ_SECTION (sfn)) &&
1025 !section_is_mapped (SYMBOL_OBJ_SECTION (sfn)))
1026 {
1027 if (!query ("WARNING!!! Destination is in unmapped overlay! Jump anyway? "))
1028 {
1029 error (_("Not confirmed."));
1030 /* NOTREACHED */
1031 }
1032 }
1033 }
1034
1035 addr = sal.pc;
1036
1037 if (from_tty)
1038 {
1039 printf_filtered (_("Continuing at "));
1040 fputs_filtered (paddress (addr), gdb_stdout);
1041 printf_filtered (".\n");
1042 }
1043
1044 /* If we are not asked to run in the bg, then prepare to run in the
1045 foreground, synchronously. */
1046 if (!async_exec && target_can_async_p ())
1047 {
1048 /* Simulate synchronous execution */
1049 async_disable_stdin ();
1050 }
1051
1052 clear_proceed_status ();
1053 proceed (addr, TARGET_SIGNAL_0, 0);
1054 }
1055 \f
1056
1057 /* Go to line or address in current procedure */
1058 static void
1059 go_command (char *line_no, int from_tty)
1060 {
1061 if (line_no == (char *) NULL || !*line_no)
1062 printf_filtered (GO_USAGE);
1063 else
1064 {
1065 tbreak_command (line_no, from_tty);
1066 jump_command (line_no, from_tty);
1067 }
1068 }
1069 \f
1070
1071 /* Continue program giving it specified signal. */
1072
1073 static void
1074 signal_command (char *signum_exp, int from_tty)
1075 {
1076 enum target_signal oursig;
1077 int async_exec = 0;
1078
1079 dont_repeat (); /* Too dangerous. */
1080 ERROR_NO_INFERIOR;
1081 ensure_not_running ();
1082
1083 /* Find out whether we must run in the background. */
1084 if (signum_exp != NULL)
1085 async_exec = strip_bg_char (&signum_exp);
1086
1087 /* If we must run in the background, but the target can't do it,
1088 error out. */
1089 if (async_exec && !target_can_async_p ())
1090 error (_("Asynchronous execution not supported on this target."));
1091
1092 /* If we are not asked to run in the bg, then prepare to run in the
1093 foreground, synchronously. */
1094 if (!async_exec && target_can_async_p ())
1095 {
1096 /* Simulate synchronous execution. */
1097 async_disable_stdin ();
1098 }
1099
1100 if (!signum_exp)
1101 error_no_arg (_("signal number"));
1102
1103 /* It would be even slicker to make signal names be valid expressions,
1104 (the type could be "enum $signal" or some such), then the user could
1105 assign them to convenience variables. */
1106 oursig = target_signal_from_name (signum_exp);
1107
1108 if (oursig == TARGET_SIGNAL_UNKNOWN)
1109 {
1110 /* No, try numeric. */
1111 int num = parse_and_eval_long (signum_exp);
1112
1113 if (num == 0)
1114 oursig = TARGET_SIGNAL_0;
1115 else
1116 oursig = target_signal_from_command (num);
1117 }
1118
1119 if (from_tty)
1120 {
1121 if (oursig == TARGET_SIGNAL_0)
1122 printf_filtered (_("Continuing with no signal.\n"));
1123 else
1124 printf_filtered (_("Continuing with signal %s.\n"),
1125 target_signal_to_name (oursig));
1126 }
1127
1128 clear_proceed_status ();
1129 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
1130 FIXME: Neither should "signal foo" but when I tried passing
1131 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
1132 tried to track down yet. */
1133 proceed (oursig == TARGET_SIGNAL_0 ? (CORE_ADDR) -1 : stop_pc, oursig, 0);
1134 }
1135
1136 /* Proceed until we reach a different source line with pc greater than
1137 our current one or exit the function. We skip calls in both cases.
1138
1139 Note that eventually this command should probably be changed so
1140 that only source lines are printed out when we hit the breakpoint
1141 we set. This may involve changes to wait_for_inferior and the
1142 proceed status code. */
1143
1144 static void
1145 until_next_command (int from_tty)
1146 {
1147 struct frame_info *frame;
1148 CORE_ADDR pc;
1149 struct symbol *func;
1150 struct symtab_and_line sal;
1151 struct thread_info *tp = inferior_thread ();
1152
1153 clear_proceed_status ();
1154
1155 frame = get_current_frame ();
1156
1157 /* Step until either exited from this function or greater
1158 than the current line (if in symbolic section) or pc (if
1159 not). */
1160
1161 pc = read_pc ();
1162 func = find_pc_function (pc);
1163
1164 if (!func)
1165 {
1166 struct minimal_symbol *msymbol = lookup_minimal_symbol_by_pc (pc);
1167
1168 if (msymbol == NULL)
1169 error (_("Execution is not within a known function."));
1170
1171 tp->step_range_start = SYMBOL_VALUE_ADDRESS (msymbol);
1172 tp->step_range_end = pc;
1173 }
1174 else
1175 {
1176 sal = find_pc_line (pc, 0);
1177
1178 tp->step_range_start = BLOCK_START (SYMBOL_BLOCK_VALUE (func));
1179 tp->step_range_end = sal.end;
1180 }
1181
1182 tp->step_over_calls = STEP_OVER_ALL;
1183 tp->step_frame_id = get_frame_id (frame);
1184
1185 step_multi = 0; /* Only one call to proceed */
1186
1187 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
1188 }
1189
1190 static void
1191 until_command (char *arg, int from_tty)
1192 {
1193 int async_exec = 0;
1194
1195 if (!target_has_execution)
1196 error (_("The program is not running."));
1197
1198 /* Find out whether we must run in the background. */
1199 if (arg != NULL)
1200 async_exec = strip_bg_char (&arg);
1201
1202 /* If we must run in the background, but the target can't do it,
1203 error out. */
1204 if (async_exec && !target_can_async_p ())
1205 error (_("Asynchronous execution not supported on this target."));
1206
1207 /* If we are not asked to run in the bg, then prepare to run in the
1208 foreground, synchronously. */
1209 if (!async_exec && target_can_async_p ())
1210 {
1211 /* Simulate synchronous execution */
1212 async_disable_stdin ();
1213 }
1214
1215 if (arg)
1216 until_break_command (arg, from_tty, 0);
1217 else
1218 until_next_command (from_tty);
1219 }
1220
1221 static void
1222 advance_command (char *arg, int from_tty)
1223 {
1224 int async_exec = 0;
1225
1226 if (!target_has_execution)
1227 error (_("The program is not running."));
1228
1229 if (arg == NULL)
1230 error_no_arg (_("a location"));
1231
1232 /* Find out whether we must run in the background. */
1233 if (arg != NULL)
1234 async_exec = strip_bg_char (&arg);
1235
1236 /* If we must run in the background, but the target can't do it,
1237 error out. */
1238 if (async_exec && !target_can_async_p ())
1239 error (_("Asynchronous execution not supported on this target."));
1240
1241 /* If we are not asked to run in the bg, then prepare to run in the
1242 foreground, synchronously. */
1243 if (!async_exec && target_can_async_p ())
1244 {
1245 /* Simulate synchronous execution. */
1246 async_disable_stdin ();
1247 }
1248
1249 until_break_command (arg, from_tty, 1);
1250 }
1251 \f
1252 /* Print the result of a function at the end of a 'finish' command. */
1253
1254 static void
1255 print_return_value (struct type *func_type, struct type *value_type)
1256 {
1257 struct gdbarch *gdbarch = current_gdbarch;
1258 struct cleanup *old_chain;
1259 struct ui_stream *stb;
1260 struct value *value;
1261
1262 CHECK_TYPEDEF (value_type);
1263 gdb_assert (TYPE_CODE (value_type) != TYPE_CODE_VOID);
1264
1265 /* FIXME: 2003-09-27: When returning from a nested inferior function
1266 call, it's possible (with no help from the architecture vector)
1267 to locate and return/print a "struct return" value. This is just
1268 a more complicated case of what is already being done in in the
1269 inferior function call code. In fact, when inferior function
1270 calls are made async, this will likely be made the norm. */
1271
1272 switch (gdbarch_return_value (gdbarch, func_type, value_type,
1273 NULL, NULL, NULL))
1274 {
1275 case RETURN_VALUE_REGISTER_CONVENTION:
1276 case RETURN_VALUE_ABI_RETURNS_ADDRESS:
1277 case RETURN_VALUE_ABI_PRESERVES_ADDRESS:
1278 value = allocate_value (value_type);
1279 gdbarch_return_value (gdbarch, func_type, value_type, stop_registers,
1280 value_contents_raw (value), NULL);
1281 break;
1282 case RETURN_VALUE_STRUCT_CONVENTION:
1283 value = NULL;
1284 break;
1285 default:
1286 internal_error (__FILE__, __LINE__, _("bad switch"));
1287 }
1288
1289 if (value)
1290 {
1291 /* Print it. */
1292 stb = ui_out_stream_new (uiout);
1293 old_chain = make_cleanup_ui_out_stream_delete (stb);
1294 ui_out_text (uiout, "Value returned is ");
1295 ui_out_field_fmt (uiout, "gdb-result-var", "$%d",
1296 record_latest_value (value));
1297 ui_out_text (uiout, " = ");
1298 value_print (value, stb->stream, 0, Val_no_prettyprint);
1299 ui_out_field_stream (uiout, "return-value", stb);
1300 ui_out_text (uiout, "\n");
1301 do_cleanups (old_chain);
1302 }
1303 else
1304 {
1305 ui_out_text (uiout, "Value returned has type: ");
1306 ui_out_field_string (uiout, "return-type", TYPE_NAME (value_type));
1307 ui_out_text (uiout, ".");
1308 ui_out_text (uiout, " Cannot determine contents\n");
1309 }
1310 }
1311
1312 /* Stuff that needs to be done by the finish command after the target
1313 has stopped. In asynchronous mode, we wait for the target to stop
1314 in the call to poll or select in the event loop, so it is
1315 impossible to do all the stuff as part of the finish_command
1316 function itself. The only chance we have to complete this command
1317 is in fetch_inferior_event, which is called by the event loop as
1318 soon as it detects that the target has stopped. This function is
1319 called via the cmd_continuation pointer. */
1320
1321 struct finish_command_continuation_args
1322 {
1323 struct breakpoint *breakpoint;
1324 struct symbol *function;
1325 };
1326
1327 static void
1328 finish_command_continuation (void *arg)
1329 {
1330 struct finish_command_continuation_args *a = arg;
1331
1332 bpstat bs = NULL;
1333
1334 if (!ptid_equal (inferior_ptid, null_ptid)
1335 && target_has_execution
1336 && is_stopped (inferior_ptid))
1337 bs = inferior_thread ()->stop_bpstat;
1338
1339 if (bpstat_find_breakpoint (bs, a->breakpoint) != NULL
1340 && a->function != NULL)
1341 {
1342 struct type *value_type;
1343
1344 value_type = TYPE_TARGET_TYPE (SYMBOL_TYPE (a->function));
1345 if (!value_type)
1346 internal_error (__FILE__, __LINE__,
1347 _("finish_command: function has no target type"));
1348
1349 if (TYPE_CODE (value_type) != TYPE_CODE_VOID)
1350 print_return_value (SYMBOL_TYPE (a->function), value_type);
1351 }
1352
1353 /* We suppress normal call of normal_stop observer and do it here so
1354 that that *stopped notification includes the return value. */
1355 /* NOTE: This is broken in non-stop mode. There is no guarantee the
1356 next stop will be in the same thread that we started doing a
1357 finish on. This suppressing (or some other replacement means)
1358 should be a thread property. */
1359 observer_notify_normal_stop (bs);
1360 suppress_stop_observer = 0;
1361 delete_breakpoint (a->breakpoint);
1362 }
1363
1364 static void
1365 finish_command_continuation_free_arg (void *arg)
1366 {
1367 /* NOTE: See finish_command_continuation. This would go away, if
1368 this suppressing is made a thread property. */
1369 suppress_stop_observer = 0;
1370 xfree (arg);
1371 }
1372
1373 /* "finish": Set a temporary breakpoint at the place the selected
1374 frame will return to, then continue. */
1375
1376 static void
1377 finish_command (char *arg, int from_tty)
1378 {
1379 struct symtab_and_line sal;
1380 struct frame_info *frame;
1381 struct symbol *function;
1382 struct breakpoint *breakpoint;
1383 struct cleanup *old_chain;
1384 struct finish_command_continuation_args *cargs;
1385
1386 int async_exec = 0;
1387
1388 /* Find out whether we must run in the background. */
1389 if (arg != NULL)
1390 async_exec = strip_bg_char (&arg);
1391
1392 /* If we must run in the background, but the target can't do it,
1393 error out. */
1394 if (async_exec && !target_can_async_p ())
1395 error (_("Asynchronous execution not supported on this target."));
1396
1397 /* If we are not asked to run in the bg, then prepare to run in the
1398 foreground, synchronously. */
1399 if (!async_exec && target_can_async_p ())
1400 {
1401 /* Simulate synchronous execution. */
1402 async_disable_stdin ();
1403 }
1404
1405 if (arg)
1406 error (_("The \"finish\" command does not take any arguments."));
1407 if (!target_has_execution)
1408 error (_("The program is not running."));
1409
1410 frame = get_prev_frame (get_selected_frame (_("No selected frame.")));
1411 if (frame == 0)
1412 error (_("\"finish\" not meaningful in the outermost frame."));
1413
1414 clear_proceed_status ();
1415
1416 sal = find_pc_line (get_frame_pc (frame), 0);
1417 sal.pc = get_frame_pc (frame);
1418
1419 breakpoint = set_momentary_breakpoint (sal, get_frame_id (frame), bp_finish);
1420
1421 old_chain = make_cleanup_delete_breakpoint (breakpoint);
1422
1423 /* Find the function we will return from. */
1424
1425 function = find_pc_function (get_frame_pc (get_selected_frame (NULL)));
1426
1427 /* Print info on the selected frame, including level number but not
1428 source. */
1429 if (from_tty)
1430 {
1431 printf_filtered (_("Run till exit from "));
1432 print_stack_frame (get_selected_frame (NULL), 1, LOCATION);
1433 }
1434
1435 proceed_to_finish = 1; /* We want stop_registers, please... */
1436 make_cleanup_restore_integer (&suppress_stop_observer);
1437 suppress_stop_observer = 1;
1438 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
1439
1440 cargs = xmalloc (sizeof (*cargs));
1441
1442 cargs->breakpoint = breakpoint;
1443 cargs->function = function;
1444 add_continuation (finish_command_continuation, cargs,
1445 finish_command_continuation_free_arg);
1446
1447 discard_cleanups (old_chain);
1448 if (!target_can_async_p ())
1449 do_all_continuations ();
1450 }
1451 \f
1452
1453 static void
1454 program_info (char *args, int from_tty)
1455 {
1456 bpstat bs;
1457 int num, stat;
1458 struct thread_info *tp;
1459 ptid_t ptid;
1460
1461 if (!target_has_execution)
1462 {
1463 printf_filtered (_("The program being debugged is not being run.\n"));
1464 return;
1465 }
1466
1467 if (non_stop)
1468 ptid = inferior_ptid;
1469 else
1470 {
1471 struct target_waitstatus ws;
1472 get_last_target_status (&ptid, &ws);
1473 }
1474
1475 if (ptid_equal (ptid, null_ptid) || is_exited (ptid))
1476 error (_("Invalid selected thread."));
1477 else if (is_running (ptid))
1478 error (_("Selected thread is running."));
1479
1480 tp = find_thread_pid (ptid);
1481 bs = tp->stop_bpstat;
1482 stat = bpstat_num (&bs, &num);
1483
1484 target_files_info ();
1485 printf_filtered (_("Program stopped at %s.\n"),
1486 hex_string ((unsigned long) stop_pc));
1487 if (stop_step)
1488 printf_filtered (_("It stopped after being stepped.\n"));
1489 else if (stat != 0)
1490 {
1491 /* There may be several breakpoints in the same place, so this
1492 isn't as strange as it seems. */
1493 while (stat != 0)
1494 {
1495 if (stat < 0)
1496 {
1497 printf_filtered (_("\
1498 It stopped at a breakpoint that has since been deleted.\n"));
1499 }
1500 else
1501 printf_filtered (_("It stopped at breakpoint %d.\n"), num);
1502 stat = bpstat_num (&bs, &num);
1503 }
1504 }
1505 else if (stop_signal != TARGET_SIGNAL_0)
1506 {
1507 printf_filtered (_("It stopped with signal %s, %s.\n"),
1508 target_signal_to_name (stop_signal),
1509 target_signal_to_string (stop_signal));
1510 }
1511
1512 if (!from_tty)
1513 {
1514 printf_filtered (_("\
1515 Type \"info stack\" or \"info registers\" for more information.\n"));
1516 }
1517 }
1518 \f
1519 static void
1520 environment_info (char *var, int from_tty)
1521 {
1522 if (var)
1523 {
1524 char *val = get_in_environ (inferior_environ, var);
1525 if (val)
1526 {
1527 puts_filtered (var);
1528 puts_filtered (" = ");
1529 puts_filtered (val);
1530 puts_filtered ("\n");
1531 }
1532 else
1533 {
1534 puts_filtered ("Environment variable \"");
1535 puts_filtered (var);
1536 puts_filtered ("\" not defined.\n");
1537 }
1538 }
1539 else
1540 {
1541 char **vector = environ_vector (inferior_environ);
1542 while (*vector)
1543 {
1544 puts_filtered (*vector++);
1545 puts_filtered ("\n");
1546 }
1547 }
1548 }
1549
1550 static void
1551 set_environment_command (char *arg, int from_tty)
1552 {
1553 char *p, *val, *var;
1554 int nullset = 0;
1555
1556 if (arg == 0)
1557 error_no_arg (_("environment variable and value"));
1558
1559 /* Find seperation between variable name and value */
1560 p = (char *) strchr (arg, '=');
1561 val = (char *) strchr (arg, ' ');
1562
1563 if (p != 0 && val != 0)
1564 {
1565 /* We have both a space and an equals. If the space is before the
1566 equals, walk forward over the spaces til we see a nonspace
1567 (possibly the equals). */
1568 if (p > val)
1569 while (*val == ' ')
1570 val++;
1571
1572 /* Now if the = is after the char following the spaces,
1573 take the char following the spaces. */
1574 if (p > val)
1575 p = val - 1;
1576 }
1577 else if (val != 0 && p == 0)
1578 p = val;
1579
1580 if (p == arg)
1581 error_no_arg (_("environment variable to set"));
1582
1583 if (p == 0 || p[1] == 0)
1584 {
1585 nullset = 1;
1586 if (p == 0)
1587 p = arg + strlen (arg); /* So that savestring below will work */
1588 }
1589 else
1590 {
1591 /* Not setting variable value to null */
1592 val = p + 1;
1593 while (*val == ' ' || *val == '\t')
1594 val++;
1595 }
1596
1597 while (p != arg && (p[-1] == ' ' || p[-1] == '\t'))
1598 p--;
1599
1600 var = savestring (arg, p - arg);
1601 if (nullset)
1602 {
1603 printf_filtered (_("\
1604 Setting environment variable \"%s\" to null value.\n"),
1605 var);
1606 set_in_environ (inferior_environ, var, "");
1607 }
1608 else
1609 set_in_environ (inferior_environ, var, val);
1610 xfree (var);
1611 }
1612
1613 static void
1614 unset_environment_command (char *var, int from_tty)
1615 {
1616 if (var == 0)
1617 {
1618 /* If there is no argument, delete all environment variables.
1619 Ask for confirmation if reading from the terminal. */
1620 if (!from_tty || query (_("Delete all environment variables? ")))
1621 {
1622 free_environ (inferior_environ);
1623 inferior_environ = make_environ ();
1624 }
1625 }
1626 else
1627 unset_in_environ (inferior_environ, var);
1628 }
1629
1630 /* Handle the execution path (PATH variable) */
1631
1632 static const char path_var_name[] = "PATH";
1633
1634 static void
1635 path_info (char *args, int from_tty)
1636 {
1637 puts_filtered ("Executable and object file path: ");
1638 puts_filtered (get_in_environ (inferior_environ, path_var_name));
1639 puts_filtered ("\n");
1640 }
1641
1642 /* Add zero or more directories to the front of the execution path. */
1643
1644 static void
1645 path_command (char *dirname, int from_tty)
1646 {
1647 char *exec_path;
1648 char *env;
1649 dont_repeat ();
1650 env = get_in_environ (inferior_environ, path_var_name);
1651 /* Can be null if path is not set */
1652 if (!env)
1653 env = "";
1654 exec_path = xstrdup (env);
1655 mod_path (dirname, &exec_path);
1656 set_in_environ (inferior_environ, path_var_name, exec_path);
1657 xfree (exec_path);
1658 if (from_tty)
1659 path_info ((char *) NULL, from_tty);
1660 }
1661 \f
1662
1663 /* Print out the machine register regnum. If regnum is -1, print all
1664 registers (print_all == 1) or all non-float and non-vector
1665 registers (print_all == 0).
1666
1667 For most machines, having all_registers_info() print the
1668 register(s) one per line is good enough. If a different format is
1669 required, (eg, for MIPS or Pyramid 90x, which both have lots of
1670 regs), or there is an existing convention for showing all the
1671 registers, define the architecture method PRINT_REGISTERS_INFO to
1672 provide that format. */
1673
1674 void
1675 default_print_registers_info (struct gdbarch *gdbarch,
1676 struct ui_file *file,
1677 struct frame_info *frame,
1678 int regnum, int print_all)
1679 {
1680 int i;
1681 const int numregs = gdbarch_num_regs (gdbarch)
1682 + gdbarch_num_pseudo_regs (gdbarch);
1683 gdb_byte buffer[MAX_REGISTER_SIZE];
1684
1685 for (i = 0; i < numregs; i++)
1686 {
1687 /* Decide between printing all regs, non-float / vector regs, or
1688 specific reg. */
1689 if (regnum == -1)
1690 {
1691 if (print_all)
1692 {
1693 if (!gdbarch_register_reggroup_p (gdbarch, i, all_reggroup))
1694 continue;
1695 }
1696 else
1697 {
1698 if (!gdbarch_register_reggroup_p (gdbarch, i, general_reggroup))
1699 continue;
1700 }
1701 }
1702 else
1703 {
1704 if (i != regnum)
1705 continue;
1706 }
1707
1708 /* If the register name is empty, it is undefined for this
1709 processor, so don't display anything. */
1710 if (gdbarch_register_name (gdbarch, i) == NULL
1711 || *(gdbarch_register_name (gdbarch, i)) == '\0')
1712 continue;
1713
1714 fputs_filtered (gdbarch_register_name (gdbarch, i), file);
1715 print_spaces_filtered (15 - strlen (gdbarch_register_name
1716 (gdbarch, i)), file);
1717
1718 /* Get the data in raw format. */
1719 if (! frame_register_read (frame, i, buffer))
1720 {
1721 fprintf_filtered (file, "*value not available*\n");
1722 continue;
1723 }
1724
1725 /* If virtual format is floating, print it that way, and in raw
1726 hex. */
1727 if (TYPE_CODE (register_type (gdbarch, i)) == TYPE_CODE_FLT
1728 || TYPE_CODE (register_type (gdbarch, i)) == TYPE_CODE_DECFLOAT)
1729 {
1730 int j;
1731
1732 val_print (register_type (gdbarch, i), buffer, 0, 0,
1733 file, 0, 1, 0, Val_pretty_default, current_language);
1734
1735 fprintf_filtered (file, "\t(raw 0x");
1736 for (j = 0; j < register_size (gdbarch, i); j++)
1737 {
1738 int idx;
1739 if (gdbarch_byte_order (gdbarch) == BFD_ENDIAN_BIG)
1740 idx = j;
1741 else
1742 idx = register_size (gdbarch, i) - 1 - j;
1743 fprintf_filtered (file, "%02x", (unsigned char) buffer[idx]);
1744 }
1745 fprintf_filtered (file, ")");
1746 }
1747 else
1748 {
1749 /* Print the register in hex. */
1750 val_print (register_type (gdbarch, i), buffer, 0, 0,
1751 file, 'x', 1, 0, Val_pretty_default, current_language);
1752 /* If not a vector register, print it also according to its
1753 natural format. */
1754 if (TYPE_VECTOR (register_type (gdbarch, i)) == 0)
1755 {
1756 fprintf_filtered (file, "\t");
1757 val_print (register_type (gdbarch, i), buffer, 0, 0,
1758 file, 0, 1, 0, Val_pretty_default, current_language);
1759 }
1760 }
1761
1762 fprintf_filtered (file, "\n");
1763 }
1764 }
1765
1766 void
1767 registers_info (char *addr_exp, int fpregs)
1768 {
1769 struct frame_info *frame;
1770 struct gdbarch *gdbarch;
1771 int regnum, numregs;
1772 char *end;
1773
1774 if (!target_has_registers)
1775 error (_("The program has no registers now."));
1776 frame = get_selected_frame (NULL);
1777 gdbarch = get_frame_arch (frame);
1778
1779 if (!addr_exp)
1780 {
1781 gdbarch_print_registers_info (gdbarch, gdb_stdout,
1782 frame, -1, fpregs);
1783 return;
1784 }
1785
1786 while (*addr_exp != '\0')
1787 {
1788 char *start;
1789 const char *end;
1790
1791 /* Keep skipping leading white space. */
1792 if (isspace ((*addr_exp)))
1793 {
1794 addr_exp++;
1795 continue;
1796 }
1797
1798 /* Discard any leading ``$''. Check that there is something
1799 resembling a register following it. */
1800 if (addr_exp[0] == '$')
1801 addr_exp++;
1802 if (isspace ((*addr_exp)) || (*addr_exp) == '\0')
1803 error (_("Missing register name"));
1804
1805 /* Find the start/end of this register name/num/group. */
1806 start = addr_exp;
1807 while ((*addr_exp) != '\0' && !isspace ((*addr_exp)))
1808 addr_exp++;
1809 end = addr_exp;
1810
1811 /* Figure out what we've found and display it. */
1812
1813 /* A register name? */
1814 {
1815 int regnum = user_reg_map_name_to_regnum (gdbarch, start, end - start);
1816 if (regnum >= 0)
1817 {
1818 /* User registers lie completely outside of the range of
1819 normal registers. Catch them early so that the target
1820 never sees them. */
1821 if (regnum >= gdbarch_num_regs (gdbarch)
1822 + gdbarch_num_pseudo_regs (gdbarch))
1823 {
1824 struct value *val = value_of_user_reg (regnum, frame);
1825
1826 printf_filtered ("%s: ", start);
1827 print_scalar_formatted (value_contents (val),
1828 check_typedef (value_type (val)),
1829 'x', 0, gdb_stdout);
1830 printf_filtered ("\n");
1831 }
1832 else
1833 gdbarch_print_registers_info (gdbarch, gdb_stdout,
1834 frame, regnum, fpregs);
1835 continue;
1836 }
1837 }
1838
1839 /* A register number? (how portable is this one?). */
1840 {
1841 char *endptr;
1842 int regnum = strtol (start, &endptr, 0);
1843 if (endptr == end
1844 && regnum >= 0
1845 && regnum < gdbarch_num_regs (gdbarch)
1846 + gdbarch_num_pseudo_regs (gdbarch))
1847 {
1848 gdbarch_print_registers_info (gdbarch, gdb_stdout,
1849 frame, regnum, fpregs);
1850 continue;
1851 }
1852 }
1853
1854 /* A register group? */
1855 {
1856 struct reggroup *group;
1857 for (group = reggroup_next (gdbarch, NULL);
1858 group != NULL;
1859 group = reggroup_next (gdbarch, group))
1860 {
1861 /* Don't bother with a length check. Should the user
1862 enter a short register group name, go with the first
1863 group that matches. */
1864 if (strncmp (start, reggroup_name (group), end - start) == 0)
1865 break;
1866 }
1867 if (group != NULL)
1868 {
1869 int regnum;
1870 for (regnum = 0;
1871 regnum < gdbarch_num_regs (gdbarch)
1872 + gdbarch_num_pseudo_regs (gdbarch);
1873 regnum++)
1874 {
1875 if (gdbarch_register_reggroup_p (gdbarch, regnum, group))
1876 gdbarch_print_registers_info (gdbarch,
1877 gdb_stdout, frame,
1878 regnum, fpregs);
1879 }
1880 continue;
1881 }
1882 }
1883
1884 /* Nothing matched. */
1885 error (_("Invalid register `%.*s'"), (int) (end - start), start);
1886 }
1887 }
1888
1889 void
1890 all_registers_info (char *addr_exp, int from_tty)
1891 {
1892 registers_info (addr_exp, 1);
1893 }
1894
1895 static void
1896 nofp_registers_info (char *addr_exp, int from_tty)
1897 {
1898 registers_info (addr_exp, 0);
1899 }
1900
1901 static void
1902 print_vector_info (struct gdbarch *gdbarch, struct ui_file *file,
1903 struct frame_info *frame, const char *args)
1904 {
1905 if (gdbarch_print_vector_info_p (gdbarch))
1906 gdbarch_print_vector_info (gdbarch, file, frame, args);
1907 else
1908 {
1909 int regnum;
1910 int printed_something = 0;
1911
1912 for (regnum = 0;
1913 regnum < gdbarch_num_regs (gdbarch)
1914 + gdbarch_num_pseudo_regs (gdbarch);
1915 regnum++)
1916 {
1917 if (gdbarch_register_reggroup_p (gdbarch, regnum, vector_reggroup))
1918 {
1919 printed_something = 1;
1920 gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
1921 }
1922 }
1923 if (!printed_something)
1924 fprintf_filtered (file, "No vector information\n");
1925 }
1926 }
1927
1928 static void
1929 vector_info (char *args, int from_tty)
1930 {
1931 if (!target_has_registers)
1932 error (_("The program has no registers now."));
1933
1934 print_vector_info (current_gdbarch, gdb_stdout,
1935 get_selected_frame (NULL), args);
1936 }
1937 \f
1938
1939 /*
1940 * TODO:
1941 * Should save/restore the tty state since it might be that the
1942 * program to be debugged was started on this tty and it wants
1943 * the tty in some state other than what we want. If it's running
1944 * on another terminal or without a terminal, then saving and
1945 * restoring the tty state is a harmless no-op.
1946 * This only needs to be done if we are attaching to a process.
1947 */
1948
1949 /*
1950 attach_command --
1951 takes a program started up outside of gdb and ``attaches'' to it.
1952 This stops it cold in its tracks and allows us to start debugging it.
1953 and wait for the trace-trap that results from attaching. */
1954
1955 static void
1956 attach_command_post_wait (char *args, int from_tty, int async_exec)
1957 {
1958 char *exec_file;
1959 char *full_exec_path = NULL;
1960
1961 stop_soon = NO_STOP_QUIETLY;
1962
1963 /* If no exec file is yet known, try to determine it from the
1964 process itself. */
1965 exec_file = (char *) get_exec_file (0);
1966 if (!exec_file)
1967 {
1968 exec_file = target_pid_to_exec_file (PIDGET (inferior_ptid));
1969 if (exec_file)
1970 {
1971 /* It's possible we don't have a full path, but rather just a
1972 filename. Some targets, such as HP-UX, don't provide the
1973 full path, sigh.
1974
1975 Attempt to qualify the filename against the source path.
1976 (If that fails, we'll just fall back on the original
1977 filename. Not much more we can do...)
1978 */
1979 if (!source_full_path_of (exec_file, &full_exec_path))
1980 full_exec_path = savestring (exec_file, strlen (exec_file));
1981
1982 exec_file_attach (full_exec_path, from_tty);
1983 symbol_file_add_main (full_exec_path, from_tty);
1984 }
1985 }
1986 else
1987 {
1988 reopen_exec_file ();
1989 reread_symbols ();
1990 }
1991
1992 /* Take any necessary post-attaching actions for this platform. */
1993 target_post_attach (PIDGET (inferior_ptid));
1994
1995 post_create_inferior (&current_target, from_tty);
1996
1997 /* Install inferior's terminal modes. */
1998 target_terminal_inferior ();
1999
2000 if (async_exec)
2001 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_0, 0);
2002 else
2003 {
2004 if (target_can_async_p ())
2005 async_enable_stdin ();
2006 normal_stop ();
2007 if (deprecated_attach_hook)
2008 deprecated_attach_hook ();
2009 }
2010 }
2011
2012 struct attach_command_continuation_args
2013 {
2014 char *args;
2015 int from_tty;
2016 int async_exec;
2017 };
2018
2019 static void
2020 attach_command_continuation (void *args)
2021 {
2022 struct attach_command_continuation_args *a = args;
2023 attach_command_post_wait (a->args, a->from_tty, a->async_exec);
2024 }
2025
2026 static void
2027 attach_command_continuation_free_args (void *args)
2028 {
2029 struct attach_command_continuation_args *a = args;
2030 xfree (a->args);
2031 xfree (a);
2032 }
2033
2034 void
2035 attach_command (char *args, int from_tty)
2036 {
2037 char *exec_file;
2038 char *full_exec_path = NULL;
2039 int async_exec = 0;
2040
2041 dont_repeat (); /* Not for the faint of heart */
2042
2043 if (target_has_execution)
2044 {
2045 if (query ("A program is being debugged already. Kill it? "))
2046 target_kill ();
2047 else
2048 error (_("Not killed."));
2049 }
2050
2051 /* Clean up any leftovers from other runs. Some other things from
2052 this function should probably be moved into target_pre_inferior. */
2053 target_pre_inferior (from_tty);
2054
2055 if (non_stop && !target_supports_non_stop ())
2056 error (_("Cannot attach to this target in non-stop mode"));
2057
2058 if (args)
2059 {
2060 async_exec = strip_bg_char (&args);
2061
2062 /* If we get a request for running in the bg but the target
2063 doesn't support it, error out. */
2064 if (async_exec && !target_can_async_p ())
2065 error (_("Asynchronous execution not supported on this target."));
2066 }
2067
2068 /* If we don't get a request of running in the bg, then we need
2069 to simulate synchronous (fg) execution. */
2070 if (!async_exec && target_can_async_p ())
2071 {
2072 /* Simulate synchronous execution */
2073 async_disable_stdin ();
2074 }
2075
2076 target_attach (args, from_tty);
2077
2078 /* Set up the "saved terminal modes" of the inferior
2079 based on what modes we are starting it with. */
2080 target_terminal_init ();
2081
2082 /* Set up execution context to know that we should return from
2083 wait_for_inferior as soon as the target reports a stop. */
2084 init_wait_for_inferior ();
2085 clear_proceed_status ();
2086
2087 /* Some system don't generate traps when attaching to inferior.
2088 E.g. Mach 3 or GNU hurd. */
2089 if (!target_attach_no_wait)
2090 {
2091 /* Careful here. See comments in inferior.h. Basically some
2092 OSes don't ignore SIGSTOPs on continue requests anymore. We
2093 need a way for handle_inferior_event to reset the stop_signal
2094 variable after an attach, and this is what
2095 STOP_QUIETLY_NO_SIGSTOP is for. */
2096 stop_soon = STOP_QUIETLY_NO_SIGSTOP;
2097
2098 if (target_can_async_p ())
2099 {
2100 /* sync_execution mode. Wait for stop. */
2101 struct attach_command_continuation_args *a;
2102
2103 a = xmalloc (sizeof (*a));
2104 a->args = xstrdup (args);
2105 a->from_tty = from_tty;
2106 a->async_exec = async_exec;
2107 add_continuation (attach_command_continuation, a,
2108 attach_command_continuation_free_args);
2109 return;
2110 }
2111
2112 wait_for_inferior (0);
2113 }
2114
2115 attach_command_post_wait (args, from_tty, async_exec);
2116 }
2117
2118 /*
2119 * detach_command --
2120 * takes a program previously attached to and detaches it.
2121 * The program resumes execution and will no longer stop
2122 * on signals, etc. We better not have left any breakpoints
2123 * in the program or it'll die when it hits one. For this
2124 * to work, it may be necessary for the process to have been
2125 * previously attached. It *might* work if the program was
2126 * started via the normal ptrace (PTRACE_TRACEME).
2127 */
2128
2129 static void
2130 detach_command (char *args, int from_tty)
2131 {
2132 dont_repeat (); /* Not for the faint of heart. */
2133 target_detach (args, from_tty);
2134 no_shared_libraries (NULL, from_tty);
2135 init_thread_list ();
2136 if (deprecated_detach_hook)
2137 deprecated_detach_hook ();
2138 }
2139
2140 /* Disconnect from the current target without resuming it (leaving it
2141 waiting for a debugger).
2142
2143 We'd better not have left any breakpoints in the program or the
2144 next debugger will get confused. Currently only supported for some
2145 remote targets, since the normal attach mechanisms don't work on
2146 stopped processes on some native platforms (e.g. GNU/Linux). */
2147
2148 static void
2149 disconnect_command (char *args, int from_tty)
2150 {
2151 dont_repeat (); /* Not for the faint of heart */
2152 target_disconnect (args, from_tty);
2153 no_shared_libraries (NULL, from_tty);
2154 init_thread_list ();
2155 if (deprecated_detach_hook)
2156 deprecated_detach_hook ();
2157 }
2158
2159 void
2160 interrupt_target_1 (int all_threads)
2161 {
2162 ptid_t ptid;
2163 if (all_threads)
2164 ptid = minus_one_ptid;
2165 else
2166 ptid = inferior_ptid;
2167 target_stop (ptid);
2168 }
2169
2170 /* Stop the execution of the target while running in async mode, in
2171 the backgound. In all-stop, stop the whole process. In non-stop
2172 mode, stop the current thread only by default, or stop all threads
2173 if the `-a' switch is used. */
2174
2175 /* interrupt [-a] */
2176 void
2177 interrupt_target_command (char *args, int from_tty)
2178 {
2179 if (target_can_async_p ())
2180 {
2181 int all_threads = 0;
2182
2183 dont_repeat (); /* Not for the faint of heart */
2184
2185 if (args != NULL
2186 && strncmp (args, "-a", sizeof ("-a") - 1) == 0)
2187 all_threads = 1;
2188
2189 if (!non_stop && all_threads)
2190 error (_("-a is meaningless in all-stop mode."));
2191
2192 interrupt_target_1 (all_threads);
2193 }
2194 }
2195
2196 static void
2197 print_float_info (struct gdbarch *gdbarch, struct ui_file *file,
2198 struct frame_info *frame, const char *args)
2199 {
2200 if (gdbarch_print_float_info_p (gdbarch))
2201 gdbarch_print_float_info (gdbarch, file, frame, args);
2202 else
2203 {
2204 int regnum;
2205 int printed_something = 0;
2206
2207 for (regnum = 0;
2208 regnum < gdbarch_num_regs (gdbarch)
2209 + gdbarch_num_pseudo_regs (gdbarch);
2210 regnum++)
2211 {
2212 if (gdbarch_register_reggroup_p (gdbarch, regnum, float_reggroup))
2213 {
2214 printed_something = 1;
2215 gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
2216 }
2217 }
2218 if (!printed_something)
2219 fprintf_filtered (file, "\
2220 No floating-point info available for this processor.\n");
2221 }
2222 }
2223
2224 static void
2225 float_info (char *args, int from_tty)
2226 {
2227 if (!target_has_registers)
2228 error (_("The program has no registers now."));
2229
2230 print_float_info (current_gdbarch, gdb_stdout,
2231 get_selected_frame (NULL), args);
2232 }
2233 \f
2234 static void
2235 unset_command (char *args, int from_tty)
2236 {
2237 printf_filtered (_("\
2238 \"unset\" must be followed by the name of an unset subcommand.\n"));
2239 help_list (unsetlist, "unset ", -1, gdb_stdout);
2240 }
2241
2242 void
2243 _initialize_infcmd (void)
2244 {
2245 struct cmd_list_element *c = NULL;
2246
2247 /* add the filename of the terminal connected to inferior I/O */
2248 add_setshow_filename_cmd ("inferior-tty", class_run,
2249 &inferior_io_terminal, _("\
2250 Set terminal for future runs of program being debugged."), _("\
2251 Show terminal for future runs of program being debugged."), _("\
2252 Usage: set inferior-tty /dev/pts/1"), NULL, NULL, &setlist, &showlist);
2253 add_com_alias ("tty", "set inferior-tty", class_alias, 0);
2254
2255 add_setshow_optional_filename_cmd ("args", class_run,
2256 &inferior_args, _("\
2257 Set argument list to give program being debugged when it is started."), _("\
2258 Show argument list to give program being debugged when it is started."), _("\
2259 Follow this command with any number of args, to be passed to the program."),
2260 notice_args_set,
2261 notice_args_read,
2262 &setlist, &showlist);
2263
2264 c = add_cmd ("environment", no_class, environment_info, _("\
2265 The environment to give the program, or one variable's value.\n\
2266 With an argument VAR, prints the value of environment variable VAR to\n\
2267 give the program being debugged. With no arguments, prints the entire\n\
2268 environment to be given to the program."), &showlist);
2269 set_cmd_completer (c, noop_completer);
2270
2271 add_prefix_cmd ("unset", no_class, unset_command,
2272 _("Complement to certain \"set\" commands."),
2273 &unsetlist, "unset ", 0, &cmdlist);
2274
2275 c = add_cmd ("environment", class_run, unset_environment_command, _("\
2276 Cancel environment variable VAR for the program.\n\
2277 This does not affect the program until the next \"run\" command."),
2278 &unsetlist);
2279 set_cmd_completer (c, noop_completer);
2280
2281 c = add_cmd ("environment", class_run, set_environment_command, _("\
2282 Set environment variable value to give the program.\n\
2283 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2284 VALUES of environment variables are uninterpreted strings.\n\
2285 This does not affect the program until the next \"run\" command."),
2286 &setlist);
2287 set_cmd_completer (c, noop_completer);
2288
2289 c = add_com ("path", class_files, path_command, _("\
2290 Add directory DIR(s) to beginning of search path for object files.\n\
2291 $cwd in the path means the current working directory.\n\
2292 This path is equivalent to the $PATH shell variable. It is a list of\n\
2293 directories, separated by colons. These directories are searched to find\n\
2294 fully linked executable files and separately compiled object files as needed."));
2295 set_cmd_completer (c, filename_completer);
2296
2297 c = add_cmd ("paths", no_class, path_info, _("\
2298 Current search path for finding object files.\n\
2299 $cwd in the path means the current working directory.\n\
2300 This path is equivalent to the $PATH shell variable. It is a list of\n\
2301 directories, separated by colons. These directories are searched to find\n\
2302 fully linked executable files and separately compiled object files as needed."),
2303 &showlist);
2304 set_cmd_completer (c, noop_completer);
2305
2306 add_com ("attach", class_run, attach_command, _("\
2307 Attach to a process or file outside of GDB.\n\
2308 This command attaches to another target, of the same type as your last\n\
2309 \"target\" command (\"info files\" will show your target stack).\n\
2310 The command may take as argument a process id or a device file.\n\
2311 For a process id, you must have permission to send the process a signal,\n\
2312 and it must have the same effective uid as the debugger.\n\
2313 When using \"attach\" with a process id, the debugger finds the\n\
2314 program running in the process, looking first in the current working\n\
2315 directory, or (if not found there) using the source file search path\n\
2316 (see the \"directory\" command). You can also use the \"file\" command\n\
2317 to specify the program, and to load its symbol table."));
2318
2319 add_prefix_cmd ("detach", class_run, detach_command, _("\
2320 Detach a process or file previously attached.\n\
2321 If a process, it is no longer traced, and it continues its execution. If\n\
2322 you were debugging a file, the file is closed and gdb no longer accesses it."),
2323 &detachlist, "detach ", 0, &cmdlist);
2324
2325 add_com ("disconnect", class_run, disconnect_command, _("\
2326 Disconnect from a target.\n\
2327 The target will wait for another debugger to connect. Not available for\n\
2328 all targets."));
2329
2330 add_com ("signal", class_run, signal_command, _("\
2331 Continue program giving it signal specified by the argument.\n\
2332 An argument of \"0\" means continue program without giving it a signal."));
2333
2334 add_com ("stepi", class_run, stepi_command, _("\
2335 Step one instruction exactly.\n\
2336 Argument N means do this N times (or till program stops for another reason)."));
2337 add_com_alias ("si", "stepi", class_alias, 0);
2338
2339 add_com ("nexti", class_run, nexti_command, _("\
2340 Step one instruction, but proceed through subroutine calls.\n\
2341 Argument N means do this N times (or till program stops for another reason)."));
2342 add_com_alias ("ni", "nexti", class_alias, 0);
2343
2344 add_com ("finish", class_run, finish_command, _("\
2345 Execute until selected stack frame returns.\n\
2346 Upon return, the value returned is printed and put in the value history."));
2347 add_com_alias ("fin", "finish", class_run, 1);
2348
2349 add_com ("next", class_run, next_command, _("\
2350 Step program, proceeding through subroutine calls.\n\
2351 Like the \"step\" command as long as subroutine calls do not happen;\n\
2352 when they do, the call is treated as one instruction.\n\
2353 Argument N means do this N times (or till program stops for another reason)."));
2354 add_com_alias ("n", "next", class_run, 1);
2355 if (xdb_commands)
2356 add_com_alias ("S", "next", class_run, 1);
2357
2358 add_com ("step", class_run, step_command, _("\
2359 Step program until it reaches a different source line.\n\
2360 Argument N means do this N times (or till program stops for another reason)."));
2361 add_com_alias ("s", "step", class_run, 1);
2362
2363 c = add_com ("until", class_run, until_command, _("\
2364 Execute until the program reaches a source line greater than the current\n\
2365 or a specified location (same args as break command) within the current frame."));
2366 set_cmd_completer (c, location_completer);
2367 add_com_alias ("u", "until", class_run, 1);
2368
2369 c = add_com ("advance", class_run, advance_command, _("\
2370 Continue the program up to the given location (same form as args for break command).\n\
2371 Execution will also stop upon exit from the current stack frame."));
2372 set_cmd_completer (c, location_completer);
2373
2374 c = add_com ("jump", class_run, jump_command, _("\
2375 Continue program being debugged at specified line or address.\n\
2376 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
2377 for an address to start at."));
2378 set_cmd_completer (c, location_completer);
2379
2380 if (xdb_commands)
2381 {
2382 c = add_com ("go", class_run, go_command, _("\
2383 Usage: go <location>\n\
2384 Continue program being debugged, stopping at specified line or \n\
2385 address.\n\
2386 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
2387 expression for an address to start at.\n\
2388 This command is a combination of tbreak and jump."));
2389 set_cmd_completer (c, location_completer);
2390 }
2391
2392 if (xdb_commands)
2393 add_com_alias ("g", "go", class_run, 1);
2394
2395 c = add_com ("continue", class_run, continue_command, _("\
2396 Continue program being debugged, after signal or breakpoint.\n\
2397 If proceeding from breakpoint, a number N may be used as an argument,\n\
2398 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
2399 the breakpoint won't break until the Nth time it is reached).\n\
2400 \n\
2401 If non-stop mode is enabled, continue only the current thread,\n\
2402 otherwise all the threads in the program are continued. To \n\
2403 continue all stopped threads in non-stop mode, use the -a option.\n\
2404 Specifying -a and an ignore count simultaneously is an error."));
2405 add_com_alias ("c", "cont", class_run, 1);
2406 add_com_alias ("fg", "cont", class_run, 1);
2407
2408 c = add_com ("run", class_run, run_command, _("\
2409 Start debugged program. You may specify arguments to give it.\n\
2410 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
2411 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
2412 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
2413 To cancel previous arguments and run with no arguments,\n\
2414 use \"set args\" without arguments."));
2415 set_cmd_completer (c, filename_completer);
2416 add_com_alias ("r", "run", class_run, 1);
2417 if (xdb_commands)
2418 add_com ("R", class_run, run_no_args_command,
2419 _("Start debugged program with no arguments."));
2420
2421 c = add_com ("start", class_run, start_command, _("\
2422 Run the debugged program until the beginning of the main procedure.\n\
2423 You may specify arguments to give to your program, just as with the\n\
2424 \"run\" command."));
2425 set_cmd_completer (c, filename_completer);
2426
2427 c = add_com ("interrupt", class_run, interrupt_target_command,
2428 _("Interrupt the execution of the debugged program.\n\
2429 If non-stop mode is enabled, interrupt only the current thread,\n\
2430 otherwise all the threads in the program are stopped. To \n\
2431 interrupt all running threads in non-stop mode, use the -a option."));
2432
2433 add_info ("registers", nofp_registers_info, _("\
2434 List of integer registers and their contents, for selected stack frame.\n\
2435 Register name as argument means describe only that register."));
2436 add_info_alias ("r", "registers", 1);
2437
2438 if (xdb_commands)
2439 add_com ("lr", class_info, nofp_registers_info, _("\
2440 List of integer registers and their contents, for selected stack frame.\n\
2441 Register name as argument means describe only that register."));
2442 add_info ("all-registers", all_registers_info, _("\
2443 List of all registers and their contents, for selected stack frame.\n\
2444 Register name as argument means describe only that register."));
2445
2446 add_info ("program", program_info,
2447 _("Execution status of the program."));
2448
2449 add_info ("float", float_info,
2450 _("Print the status of the floating point unit\n"));
2451
2452 add_info ("vector", vector_info,
2453 _("Print the status of the vector unit\n"));
2454
2455 inferior_environ = make_environ ();
2456 init_environ (inferior_environ);
2457 }