ChangeLog:
[external/binutils.git] / gdb / infcmd.c
1 /* Memory-access and commands for "inferior" process, for GDB.
2
3    Copyright (C) 1986-2012 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "defs.h"
21 #include "arch-utils.h"
22 #include <signal.h>
23 #include "gdb_string.h"
24 #include "symtab.h"
25 #include "gdbtypes.h"
26 #include "frame.h"
27 #include "inferior.h"
28 #include "environ.h"
29 #include "value.h"
30 #include "gdbcmd.h"
31 #include "symfile.h"
32 #include "gdbcore.h"
33 #include "target.h"
34 #include "language.h"
35 #include "symfile.h"
36 #include "objfiles.h"
37 #include "completer.h"
38 #include "ui-out.h"
39 #include "event-top.h"
40 #include "parser-defs.h"
41 #include "regcache.h"
42 #include "reggroups.h"
43 #include "block.h"
44 #include "solib.h"
45 #include <ctype.h>
46 #include "gdb_assert.h"
47 #include "observer.h"
48 #include "target-descriptions.h"
49 #include "user-regs.h"
50 #include "exceptions.h"
51 #include "cli/cli-decode.h"
52 #include "gdbthread.h"
53 #include "valprint.h"
54 #include "inline-frame.h"
55 #include "tracepoint.h"
56 #include "inf-loop.h"
57 #include "continuations.h"
58 #include "linespec.h"
59
60 /* Functions exported for general use, in inferior.h: */
61
62 void all_registers_info (char *, int);
63
64 void registers_info (char *, int);
65
66 void nexti_command (char *, int);
67
68 void stepi_command (char *, int);
69
70 void continue_command (char *, int);
71
72 void interrupt_target_command (char *args, int from_tty);
73
74 /* Local functions: */
75
76 static void nofp_registers_info (char *, int);
77
78 static void print_return_value (struct type *func_type,
79                                 struct type *value_type);
80
81 static void until_next_command (int);
82
83 static void until_command (char *, int);
84
85 static void path_info (char *, int);
86
87 static void path_command (char *, int);
88
89 static void unset_command (char *, int);
90
91 static void float_info (char *, int);
92
93 static void disconnect_command (char *, int);
94
95 static void unset_environment_command (char *, int);
96
97 static void set_environment_command (char *, int);
98
99 static void environment_info (char *, int);
100
101 static void program_info (char *, int);
102
103 static void finish_command (char *, int);
104
105 static void signal_command (char *, int);
106
107 static void jump_command (char *, int);
108
109 static void step_1 (int, int, char *);
110 static void step_once (int skip_subroutines, int single_inst,
111                        int count, int thread);
112
113 static void next_command (char *, int);
114
115 static void step_command (char *, int);
116
117 static void run_command (char *, int);
118
119 static void run_no_args_command (char *args, int from_tty);
120
121 static void go_command (char *line_no, int from_tty);
122
123 static int strip_bg_char (char **);
124
125 void _initialize_infcmd (void);
126
127 #define ERROR_NO_INFERIOR \
128    if (!target_has_execution) error (_("The program is not being run."));
129
130 /* Scratch area where string containing arguments to give to the
131    program will be stored by 'set args'.  As soon as anything is
132    stored, notice_args_set will move it into per-inferior storage.
133    Arguments are separated by spaces.  Empty string (pointer to '\0')
134    means no args.  */
135
136 static char *inferior_args_scratch;
137
138 /* Scratch area where 'set inferior-tty' will store user-provided value.
139    We'll immediate copy it into per-inferior storage.  */
140
141 static char *inferior_io_terminal_scratch;
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 /* Address at which inferior stopped.  */
151
152 CORE_ADDR stop_pc;
153
154 /* Flag indicating that a command has proceeded the inferior past the
155    current breakpoint.  */
156
157 int breakpoint_proceeded;
158
159 /* Nonzero if stopped due to completion of a stack dummy routine.  */
160
161 enum stop_stack_kind stop_stack_dummy;
162
163 /* Nonzero if stopped due to a random (unexpected) signal in inferior
164    process.  */
165
166 int stopped_by_random_signal;
167
168 \f
169 /* Accessor routines.  */
170
171 /* Set the io terminal for the current inferior.  Ownership of
172    TERMINAL_NAME is not transferred.  */
173
174 void 
175 set_inferior_io_terminal (const char *terminal_name)
176 {
177   xfree (current_inferior ()->terminal);
178   current_inferior ()->terminal = terminal_name ? xstrdup (terminal_name) : 0;
179 }
180
181 const char *
182 get_inferior_io_terminal (void)
183 {
184   return current_inferior ()->terminal;
185 }
186
187 static void
188 set_inferior_tty_command (char *args, int from_tty,
189                           struct cmd_list_element *c)
190 {
191   /* CLI has assigned the user-provided value to inferior_io_terminal_scratch.
192      Now route it to current inferior.  */
193   set_inferior_io_terminal (inferior_io_terminal_scratch);
194 }
195
196 static void
197 show_inferior_tty_command (struct ui_file *file, int from_tty,
198                            struct cmd_list_element *c, const char *value)
199 {
200   /* Note that we ignore the passed-in value in favor of computing it
201      directly.  */
202   const char *inferior_io_terminal = get_inferior_io_terminal ();
203
204   if (inferior_io_terminal == NULL)
205     inferior_io_terminal = "";
206   fprintf_filtered (gdb_stdout,
207                     _("Terminal for future runs of program being debugged "
208                       "is \"%s\".\n"), inferior_io_terminal);
209 }
210
211 char *
212 get_inferior_args (void)
213 {
214   if (current_inferior ()->argc != 0)
215     {
216       char *n;
217
218       n = construct_inferior_arguments (current_inferior ()->argc,
219                                         current_inferior ()->argv);
220       set_inferior_args (n);
221       xfree (n);
222     }
223
224   if (current_inferior ()->args == NULL)
225     current_inferior ()->args = xstrdup ("");
226
227   return current_inferior ()->args;
228 }
229
230 /* Set the arguments for the current inferior.  Ownership of
231    NEWARGS is not transferred.  */
232
233 void
234 set_inferior_args (char *newargs)
235 {
236   xfree (current_inferior ()->args);
237   current_inferior ()->args = newargs ? xstrdup (newargs) : NULL;
238   current_inferior ()->argc = 0;
239   current_inferior ()->argv = 0;
240 }
241
242 void
243 set_inferior_args_vector (int argc, char **argv)
244 {
245   current_inferior ()->argc = argc;
246   current_inferior ()->argv = argv;
247 }
248
249 /* Notice when `set args' is run.  */
250 static void
251 set_args_command (char *args, int from_tty, struct cmd_list_element *c)
252 {
253   /* CLI has assigned the user-provided value to inferior_args_scratch.
254      Now route it to current inferior.  */
255   set_inferior_args (inferior_args_scratch);
256 }
257
258 /* Notice when `show args' is run.  */
259 static void
260 show_args_command (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 (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 += 3 * 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 (*cp == '\n')
309                     {
310                       /* A newline cannot be quoted with a backslash (it
311                          just disappears), only by putting it inside
312                          quotes.  */
313                       *out++ = '\'';
314                       *out++ = '\n';
315                       *out++ = '\'';
316                     }
317                   else
318                     {
319                       if (strchr (special, *cp) != NULL)
320                         *out++ = '\\';
321                       *out++ = *cp;
322                     }
323                 }
324             }
325         }
326       *out = '\0';
327     }
328   else
329     {
330       /* In this case we can't handle arguments that contain spaces,
331          tabs, or newlines -- see breakup_args().  */
332       int i;
333       int length = 0;
334
335       for (i = 0; i < argc; ++i)
336         {
337           char *cp = strchr (argv[i], ' ');
338           if (cp == NULL)
339             cp = strchr (argv[i], '\t');
340           if (cp == NULL)
341             cp = strchr (argv[i], '\n');
342           if (cp != NULL)
343             error (_("can't handle command-line "
344                      "argument containing whitespace"));
345           length += strlen (argv[i]) + 1;
346         }
347
348       result = (char *) xmalloc (length);
349       result[0] = '\0';
350       for (i = 0; i < argc; ++i)
351         {
352           if (i > 0)
353             strcat (result, " ");
354           strcat (result, argv[i]);
355         }
356     }
357
358   return result;
359 }
360 \f
361
362 /* This function detects whether or not a '&' character (indicating
363    background execution) has been added as *the last* of the arguments ARGS
364    of a command.  If it has, it removes it and returns 1.  Otherwise it
365    does nothing and returns 0.  */
366 static int
367 strip_bg_char (char **args)
368 {
369   char *p = NULL;
370
371   p = strchr (*args, '&');
372
373   if (p)
374     {
375       if (p == (*args + strlen (*args) - 1))
376         {
377           if (strlen (*args) > 1)
378             {
379               do
380                 p--;
381               while (*p == ' ' || *p == '\t');
382               *(p + 1) = '\0';
383             }
384           else
385             *args = 0;
386           return 1;
387         }
388     }
389   return 0;
390 }
391
392 /* Common actions to take after creating any sort of inferior, by any
393    means (running, attaching, connecting, et cetera).  The target
394    should be stopped.  */
395
396 void
397 post_create_inferior (struct target_ops *target, int from_tty)
398 {
399   volatile struct gdb_exception ex;
400
401   /* Be sure we own the terminal in case write operations are performed.  */ 
402   target_terminal_ours ();
403
404   /* If the target hasn't taken care of this already, do it now.
405      Targets which need to access registers during to_open,
406      to_create_inferior, or to_attach should do it earlier; but many
407      don't need to.  */
408   target_find_description ();
409
410   /* Now that we know the register layout, retrieve current PC.  But
411      if the PC is unavailable (e.g., we're opening a core file with
412      missing registers info), ignore it.  */
413   stop_pc = 0;
414   TRY_CATCH (ex, RETURN_MASK_ERROR)
415     {
416       stop_pc = regcache_read_pc (get_current_regcache ());
417     }
418   if (ex.reason < 0 && ex.error != NOT_AVAILABLE_ERROR)
419     throw_exception (ex);
420
421   if (exec_bfd)
422     {
423       const unsigned solib_add_generation
424         = current_program_space->solib_add_generation;
425
426       /* Create the hooks to handle shared library load and unload
427          events.  */
428 #ifdef SOLIB_CREATE_INFERIOR_HOOK
429       SOLIB_CREATE_INFERIOR_HOOK (PIDGET (inferior_ptid));
430 #else
431       solib_create_inferior_hook (from_tty);
432 #endif
433
434       if (current_program_space->solib_add_generation == solib_add_generation)
435         {
436           /* The platform-specific hook should load initial shared libraries,
437              but didn't.  FROM_TTY will be incorrectly 0 but such solib
438              targets should be fixed anyway.  Call it only after the solib
439              target has been initialized by solib_create_inferior_hook.  */
440
441           if (info_verbose)
442             warning (_("platform-specific solib_create_inferior_hook did "
443                        "not load initial shared libraries."));
444
445           /* If the solist is global across processes, there's no need to
446              refetch it here.  */
447           if (!gdbarch_has_global_solist (target_gdbarch))
448             {
449 #ifdef SOLIB_ADD
450               SOLIB_ADD (NULL, 0, target, auto_solib_add);
451 #else
452               solib_add (NULL, 0, target, auto_solib_add);
453 #endif
454             }
455         }
456     }
457
458   /* If the user sets watchpoints before execution having started,
459      then she gets software watchpoints, because GDB can't know which
460      target will end up being pushed, or if it supports hardware
461      watchpoints or not.  breakpoint_re_set takes care of promoting
462      watchpoints to hardware watchpoints if possible, however, if this
463      new inferior doesn't load shared libraries or we don't pull in
464      symbols from any other source on this target/arch,
465      breakpoint_re_set is never called.  Call it now so that software
466      watchpoints get a chance to be promoted to hardware watchpoints
467      if the now pushed target supports hardware watchpoints.  */
468   breakpoint_re_set ();
469
470   observer_notify_inferior_created (target, from_tty);
471 }
472
473 /* Kill the inferior if already running.  This function is designed
474    to be called when we are about to start the execution of the program
475    from the beginning.  Ask the user to confirm that he wants to restart
476    the program being debugged when FROM_TTY is non-null.  */
477
478 static void
479 kill_if_already_running (int from_tty)
480 {
481   if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
482     {
483       /* Bail out before killing the program if we will not be able to
484          restart it.  */
485       target_require_runnable ();
486
487       if (from_tty
488           && !query (_("The program being debugged has been started already.\n\
489 Start it from the beginning? ")))
490         error (_("Program not restarted."));
491       target_kill ();
492     }
493 }
494
495 /* Implement the "run" command.  If TBREAK_AT_MAIN is set, then insert
496    a temporary breakpoint at the begining of the main program before
497    running the program.  */
498
499 static void
500 run_command_1 (char *args, int from_tty, int tbreak_at_main)
501 {
502   char *exec_file;
503   struct cleanup *old_chain;
504   ptid_t ptid;
505   struct ui_out *uiout = current_uiout;
506
507   dont_repeat ();
508
509   kill_if_already_running (from_tty);
510
511   init_wait_for_inferior ();
512   clear_breakpoint_hit_counts ();
513
514   /* Clean up any leftovers from other runs.  Some other things from
515      this function should probably be moved into target_pre_inferior.  */
516   target_pre_inferior (from_tty);
517
518   /* The comment here used to read, "The exec file is re-read every
519      time we do a generic_mourn_inferior, so we just have to worry
520      about the symbol file."  The `generic_mourn_inferior' function
521      gets called whenever the program exits.  However, suppose the
522      program exits, and *then* the executable file changes?  We need
523      to check again here.  Since reopen_exec_file doesn't do anything
524      if the timestamp hasn't changed, I don't see the harm.  */
525   reopen_exec_file ();
526   reread_symbols ();
527
528   /* Insert the temporary breakpoint if a location was specified.  */
529   if (tbreak_at_main)
530     tbreak_command (main_name (), 0);
531
532   exec_file = (char *) get_exec_file (0);
533
534   if (non_stop && !target_supports_non_stop ())
535     error (_("The target does not support running in non-stop mode."));
536
537   /* We keep symbols from add-symbol-file, on the grounds that the
538      user might want to add some symbols before running the program
539      (right?).  But sometimes (dynamic loading where the user manually
540      introduces the new symbols with add-symbol-file), the code which
541      the symbols describe does not persist between runs.  Currently
542      the user has to manually nuke all symbols between runs if they
543      want them to go away (PR 2207).  This is probably reasonable.  */
544
545   if (!args)
546     {
547       if (target_can_async_p ())
548         async_disable_stdin ();
549     }
550   else
551     {
552       int async_exec = strip_bg_char (&args);
553
554       /* If we get a request for running in the bg but the target
555          doesn't support it, error out.  */
556       if (async_exec && !target_can_async_p ())
557         error (_("Asynchronous execution not supported on this target."));
558
559       /* If we don't get a request of running in the bg, then we need
560          to simulate synchronous (fg) execution.  */
561       if (!async_exec && target_can_async_p ())
562         {
563           /* Simulate synchronous execution.  */
564           async_disable_stdin ();
565         }
566
567       /* If there were other args, beside '&', process them.  */
568       if (args)
569         set_inferior_args (args);
570     }
571
572   if (from_tty)
573     {
574       ui_out_field_string (uiout, NULL, "Starting program");
575       ui_out_text (uiout, ": ");
576       if (exec_file)
577         ui_out_field_string (uiout, "execfile", exec_file);
578       ui_out_spaces (uiout, 1);
579       /* We call get_inferior_args() because we might need to compute
580          the value now.  */
581       ui_out_field_string (uiout, "infargs", get_inferior_args ());
582       ui_out_text (uiout, "\n");
583       ui_out_flush (uiout);
584     }
585
586   /* We call get_inferior_args() because we might need to compute
587      the value now.  */
588   target_create_inferior (exec_file, get_inferior_args (),
589                           environ_vector (current_inferior ()->environment),
590                           from_tty);
591
592   /* We're starting off a new process.  When we get out of here, in
593      non-stop mode, finish the state of all threads of that process,
594      but leave other threads alone, as they may be stopped in internal
595      events --- the frontend shouldn't see them as stopped.  In
596      all-stop, always finish the state of all threads, as we may be
597      resuming more than just the new process.  */
598   if (non_stop)
599     ptid = pid_to_ptid (ptid_get_pid (inferior_ptid));
600   else
601     ptid = minus_one_ptid;
602   old_chain = make_cleanup (finish_thread_state_cleanup, &ptid);
603
604   /* Pass zero for FROM_TTY, because at this point the "run" command
605      has done its thing; now we are setting up the running program.  */
606   post_create_inferior (&current_target, 0);
607
608   /* Start the target running.  Do not use -1 continuation as it would skip
609      breakpoint right at the entry point.  */
610   proceed (regcache_read_pc (get_current_regcache ()), TARGET_SIGNAL_0, 0);
611
612   /* Since there was no error, there's no need to finish the thread
613      states here.  */
614   discard_cleanups (old_chain);
615 }
616
617 static void
618 run_command (char *args, int from_tty)
619 {
620   run_command_1 (args, from_tty, 0);
621 }
622
623 static void
624 run_no_args_command (char *args, int from_tty)
625 {
626   set_inferior_args ("");
627 }
628 \f
629
630 /* Start the execution of the program up until the beginning of the main
631    program.  */
632
633 static void
634 start_command (char *args, int from_tty)
635 {
636   /* Some languages such as Ada need to search inside the program
637      minimal symbols for the location where to put the temporary
638      breakpoint before starting.  */
639   if (!have_minimal_symbols ())
640     error (_("No symbol table loaded.  Use the \"file\" command."));
641
642   /* Run the program until reaching the main procedure...  */
643   run_command_1 (args, from_tty, 1);
644
645
646 static int
647 proceed_thread_callback (struct thread_info *thread, void *arg)
648 {
649   /* We go through all threads individually instead of compressing
650      into a single target `resume_all' request, because some threads
651      may be stopped in internal breakpoints/events, or stopped waiting
652      for its turn in the displaced stepping queue (that is, they are
653      running && !executing).  The target side has no idea about why
654      the thread is stopped, so a `resume_all' command would resume too
655      much.  If/when GDB gains a way to tell the target `hold this
656      thread stopped until I say otherwise', then we can optimize
657      this.  */
658   if (!is_stopped (thread->ptid))
659     return 0;
660
661   switch_to_thread (thread->ptid);
662   clear_proceed_status ();
663   proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
664   return 0;
665 }
666
667 void
668 ensure_valid_thread (void)
669 {
670   if (ptid_equal (inferior_ptid, null_ptid)
671       || is_exited (inferior_ptid))
672     error (_("Cannot execute this command without a live selected thread."));
673 }
674
675 /* If the user is looking at trace frames, any resumption of execution
676    is likely to mix up recorded and live target data.  So simply
677    disallow those commands.  */
678
679 void
680 ensure_not_tfind_mode (void)
681 {
682   if (get_traceframe_number () >= 0)
683     error (_("Cannot execute this command while looking at trace frames."));
684 }
685
686 void
687 continue_1 (int all_threads)
688 {
689   ERROR_NO_INFERIOR;
690   ensure_not_tfind_mode ();
691
692   if (non_stop && all_threads)
693     {
694       /* Don't error out if the current thread is running, because
695          there may be other stopped threads.  */
696       struct cleanup *old_chain;
697
698       /* Backup current thread and selected frame.  */
699       old_chain = make_cleanup_restore_current_thread ();
700
701       iterate_over_threads (proceed_thread_callback, NULL);
702
703       /* Restore selected ptid.  */
704       do_cleanups (old_chain);
705     }
706   else
707     {
708       ensure_valid_thread ();
709       ensure_not_running ();
710       clear_proceed_status ();
711       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
712     }
713 }
714
715 /* continue [-a] [proceed-count] [&]  */
716 void
717 continue_command (char *args, int from_tty)
718 {
719   int async_exec = 0;
720   int all_threads = 0;
721   ERROR_NO_INFERIOR;
722
723   /* Find out whether we must run in the background.  */
724   if (args != NULL)
725     async_exec = strip_bg_char (&args);
726
727   /* If we must run in the background, but the target can't do it,
728      error out.  */
729   if (async_exec && !target_can_async_p ())
730     error (_("Asynchronous execution not supported on this target."));
731
732   /* If we are not asked to run in the bg, then prepare to run in the
733      foreground, synchronously.  */
734   if (!async_exec && target_can_async_p ())
735     {
736       /* Simulate synchronous execution.  */
737       async_disable_stdin ();
738     }
739
740   if (args != NULL)
741     {
742       if (strncmp (args, "-a", sizeof ("-a") - 1) == 0)
743         {
744           all_threads = 1;
745           args += sizeof ("-a") - 1;
746           if (*args == '\0')
747             args = NULL;
748         }
749     }
750
751   if (!non_stop && all_threads)
752     error (_("`-a' is meaningless in all-stop mode."));
753
754   if (args != NULL && all_threads)
755     error (_("Can't resume all threads and specify "
756              "proceed count simultaneously."));
757
758   /* If we have an argument left, set proceed count of breakpoint we
759      stopped at.  */
760   if (args != NULL)
761     {
762       bpstat bs = NULL;
763       int num, stat;
764       int stopped = 0;
765       struct thread_info *tp;
766
767       if (non_stop)
768         tp = find_thread_ptid (inferior_ptid);
769       else
770         {
771           ptid_t last_ptid;
772           struct target_waitstatus ws;
773
774           get_last_target_status (&last_ptid, &ws);
775           tp = find_thread_ptid (last_ptid);
776         }
777       if (tp != NULL)
778         bs = tp->control.stop_bpstat;
779
780       while ((stat = bpstat_num (&bs, &num)) != 0)
781         if (stat > 0)
782           {
783             set_ignore_count (num,
784                               parse_and_eval_long (args) - 1,
785                               from_tty);
786             /* set_ignore_count prints a message ending with a period.
787                So print two spaces before "Continuing.".  */
788             if (from_tty)
789               printf_filtered ("  ");
790             stopped = 1;
791           }
792
793       if (!stopped && from_tty)
794         {
795           printf_filtered
796             ("Not stopped at any breakpoint; argument ignored.\n");
797         }
798     }
799
800   if (from_tty)
801     printf_filtered (_("Continuing.\n"));
802
803   continue_1 (all_threads);
804 }
805 \f
806 /* Record the starting point of a "step" or "next" command.  */
807
808 static void
809 set_step_frame (void)
810 {
811   struct symtab_and_line sal;
812
813   find_frame_sal (get_current_frame (), &sal);
814   set_step_info (get_current_frame (), sal);
815 }
816
817 /* Step until outside of current statement.  */
818
819 static void
820 step_command (char *count_string, int from_tty)
821 {
822   step_1 (0, 0, count_string);
823 }
824
825 /* Likewise, but skip over subroutine calls as if single instructions.  */
826
827 static void
828 next_command (char *count_string, int from_tty)
829 {
830   step_1 (1, 0, count_string);
831 }
832
833 /* Likewise, but step only one instruction.  */
834
835 void
836 stepi_command (char *count_string, int from_tty)
837 {
838   step_1 (0, 1, count_string);
839 }
840
841 void
842 nexti_command (char *count_string, int from_tty)
843 {
844   step_1 (1, 1, count_string);
845 }
846
847 void
848 delete_longjmp_breakpoint_cleanup (void *arg)
849 {
850   int thread = * (int *) arg;
851   delete_longjmp_breakpoint (thread);
852 }
853
854 static void
855 step_1 (int skip_subroutines, int single_inst, char *count_string)
856 {
857   int count = 1;
858   struct cleanup *cleanups = make_cleanup (null_cleanup, NULL);
859   int async_exec = 0;
860   int thread = -1;
861
862   ERROR_NO_INFERIOR;
863   ensure_not_tfind_mode ();
864   ensure_valid_thread ();
865   ensure_not_running ();
866
867   if (count_string)
868     async_exec = strip_bg_char (&count_string);
869
870   /* If we get a request for running in the bg but the target
871      doesn't support it, error out.  */
872   if (async_exec && !target_can_async_p ())
873     error (_("Asynchronous execution not supported on this target."));
874
875   /* If we don't get a request of running in the bg, then we need
876      to simulate synchronous (fg) execution.  */
877   if (!async_exec && target_can_async_p ())
878     {
879       /* Simulate synchronous execution.  */
880       async_disable_stdin ();
881     }
882
883   count = count_string ? parse_and_eval_long (count_string) : 1;
884
885   if (!single_inst || skip_subroutines)         /* Leave si command alone.  */
886     {
887       struct thread_info *tp = inferior_thread ();
888
889       if (in_thread_list (inferior_ptid))
890         thread = pid_to_thread_id (inferior_ptid);
891
892       set_longjmp_breakpoint (tp, get_frame_id (get_current_frame ()));
893
894       make_cleanup (delete_longjmp_breakpoint_cleanup, &thread);
895     }
896
897   /* In synchronous case, all is well; each step_once call will step once.  */
898   if (!target_can_async_p ())
899     {
900       for (; count > 0; count--)
901         {
902           step_once (skip_subroutines, single_inst, count, thread);
903
904           if (!target_has_execution)
905             break;
906           else
907             {
908               struct thread_info *tp = inferior_thread ();
909
910               if (!tp->control.stop_step || !tp->step_multi)
911                 {
912                   /* If we stopped for some reason that is not stepping
913                      there are no further steps to make.  */
914                   tp->step_multi = 0;
915                   break;
916                 }
917             }
918         }
919
920       do_cleanups (cleanups);
921     }
922   else
923     {
924       /* In the case of an asynchronous target things get complicated;
925          do only one step for now, before returning control to the
926          event loop.  Let the continuation figure out how many other
927          steps we need to do, and handle them one at the time, through
928          step_once.  */
929       step_once (skip_subroutines, single_inst, count, thread);
930
931       /* We are running, and the continuation is installed.  It will
932          disable the longjmp breakpoint as appropriate.  */
933       discard_cleanups (cleanups);
934     }
935 }
936
937 struct step_1_continuation_args
938 {
939   int count;
940   int skip_subroutines;
941   int single_inst;
942   int thread;
943 };
944
945 /* Called after we are done with one step operation, to check whether
946    we need to step again, before we print the prompt and return control
947    to the user.  If count is > 1, we will need to do one more call to
948    proceed(), via step_once().  Basically it is like step_once and
949    step_1_continuation are co-recursive.  */
950 static void
951 step_1_continuation (void *args, int err)
952 {
953   struct step_1_continuation_args *a = args;
954
955   if (target_has_execution)
956     {
957       struct thread_info *tp;
958
959       tp = inferior_thread ();
960       if (!err
961           && tp->step_multi && tp->control.stop_step)
962         {
963           /* There are more steps to make, and we did stop due to
964              ending a stepping range.  Do another step.  */
965           step_once (a->skip_subroutines, a->single_inst,
966                      a->count - 1, a->thread);
967           return;
968         }
969       tp->step_multi = 0;
970     }
971
972   /* We either hit an error, or stopped for some reason that is
973      not stepping, or there are no further steps to make.
974      Cleanup.  */
975   if (!a->single_inst || a->skip_subroutines)
976     delete_longjmp_breakpoint (a->thread);
977 }
978
979 /* Do just one step operation.  This is useful to implement the 'step
980    n' kind of commands.  In case of asynchronous targets, we will have
981    to set up a continuation to be done after the target stops (after
982    this one step).  For synch targets, the caller handles further
983    stepping.  */
984
985 static void
986 step_once (int skip_subroutines, int single_inst, int count, int thread)
987 {
988   struct frame_info *frame = get_current_frame ();
989
990   if (count > 0)
991     {
992       /* Don't assume THREAD is a valid thread id.  It is set to -1 if
993          the longjmp breakpoint was not required.  Use the
994          INFERIOR_PTID thread instead, which is the same thread when
995          THREAD is set.  */
996       struct thread_info *tp = inferior_thread ();
997
998       clear_proceed_status ();
999       set_step_frame ();
1000
1001       if (!single_inst)
1002         {
1003           CORE_ADDR pc;
1004
1005           /* Step at an inlined function behaves like "down".  */
1006           if (!skip_subroutines && !single_inst
1007               && inline_skipped_frames (inferior_ptid))
1008             {
1009               ptid_t resume_ptid;
1010
1011               /* Pretend that we've ran.  */
1012               resume_ptid = user_visible_resume_ptid (1);
1013               set_running (resume_ptid, 1);
1014
1015               step_into_inline_frame (inferior_ptid);
1016               if (count > 1)
1017                 step_once (skip_subroutines, single_inst, count - 1, thread);
1018               else
1019                 {
1020                   /* Pretend that we've stopped.  */
1021                   normal_stop ();
1022
1023                   if (target_can_async_p ())
1024                     inferior_event_handler (INF_EXEC_COMPLETE, NULL);
1025                 }
1026               return;
1027             }
1028
1029           pc = get_frame_pc (frame);
1030           find_pc_line_pc_range (pc,
1031                                  &tp->control.step_range_start,
1032                                  &tp->control.step_range_end);
1033
1034           /* If we have no line info, switch to stepi mode.  */
1035           if (tp->control.step_range_end == 0 && step_stop_if_no_debug)
1036             tp->control.step_range_start = tp->control.step_range_end = 1;
1037           else if (tp->control.step_range_end == 0)
1038             {
1039               char *name;
1040
1041               if (find_pc_partial_function (pc, &name,
1042                                             &tp->control.step_range_start,
1043                                             &tp->control.step_range_end) == 0)
1044                 error (_("Cannot find bounds of current function"));
1045
1046               target_terminal_ours ();
1047               printf_filtered (_("Single stepping until exit from function %s,"
1048                                  "\nwhich has no line number information.\n"),
1049                                name);
1050             }
1051         }
1052       else
1053         {
1054           /* Say we are stepping, but stop after one insn whatever it does.  */
1055           tp->control.step_range_start = tp->control.step_range_end = 1;
1056           if (!skip_subroutines)
1057             /* It is stepi.
1058                Don't step over function calls, not even to functions lacking
1059                line numbers.  */
1060             tp->control.step_over_calls = STEP_OVER_NONE;
1061         }
1062
1063       if (skip_subroutines)
1064         tp->control.step_over_calls = STEP_OVER_ALL;
1065
1066       tp->step_multi = (count > 1);
1067       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
1068
1069       /* For async targets, register a continuation to do any
1070          additional steps.  For sync targets, the caller will handle
1071          further stepping.  */
1072       if (target_can_async_p ())
1073         {
1074           struct step_1_continuation_args *args;
1075
1076           args = xmalloc (sizeof (*args));
1077           args->skip_subroutines = skip_subroutines;
1078           args->single_inst = single_inst;
1079           args->count = count;
1080           args->thread = thread;
1081
1082           add_intermediate_continuation (tp, step_1_continuation, args, xfree);
1083         }
1084     }
1085 }
1086
1087 \f
1088 /* Continue program at specified address.  */
1089
1090 static void
1091 jump_command (char *arg, int from_tty)
1092 {
1093   struct gdbarch *gdbarch = get_current_arch ();
1094   CORE_ADDR addr;
1095   struct symtabs_and_lines sals;
1096   struct symtab_and_line sal;
1097   struct symbol *fn;
1098   struct symbol *sfn;
1099   int async_exec = 0;
1100
1101   ERROR_NO_INFERIOR;
1102   ensure_not_tfind_mode ();
1103   ensure_valid_thread ();
1104   ensure_not_running ();
1105
1106   /* Find out whether we must run in the background.  */
1107   if (arg != NULL)
1108     async_exec = strip_bg_char (&arg);
1109
1110   /* If we must run in the background, but the target can't do it,
1111      error out.  */
1112   if (async_exec && !target_can_async_p ())
1113     error (_("Asynchronous execution not supported on this target."));
1114
1115   if (!arg)
1116     error_no_arg (_("starting address"));
1117
1118   sals = decode_line_spec_1 (arg, DECODE_LINE_FUNFIRSTLINE);
1119   if (sals.nelts != 1)
1120     {
1121       error (_("Unreasonable jump request"));
1122     }
1123
1124   sal = sals.sals[0];
1125   xfree (sals.sals);
1126
1127   if (sal.symtab == 0 && sal.pc == 0)
1128     error (_("No source file has been specified."));
1129
1130   resolve_sal_pc (&sal);        /* May error out.  */
1131
1132   /* See if we are trying to jump to another function.  */
1133   fn = get_frame_function (get_current_frame ());
1134   sfn = find_pc_function (sal.pc);
1135   if (fn != NULL && sfn != fn)
1136     {
1137       if (!query (_("Line %d is not in `%s'.  Jump anyway? "), sal.line,
1138                   SYMBOL_PRINT_NAME (fn)))
1139         {
1140           error (_("Not confirmed."));
1141           /* NOTREACHED */
1142         }
1143     }
1144
1145   if (sfn != NULL)
1146     {
1147       fixup_symbol_section (sfn, 0);
1148       if (section_is_overlay (SYMBOL_OBJ_SECTION (sfn)) &&
1149           !section_is_mapped (SYMBOL_OBJ_SECTION (sfn)))
1150         {
1151           if (!query (_("WARNING!!!  Destination is in "
1152                         "unmapped overlay!  Jump anyway? ")))
1153             {
1154               error (_("Not confirmed."));
1155               /* NOTREACHED */
1156             }
1157         }
1158     }
1159
1160   addr = sal.pc;
1161
1162   if (from_tty)
1163     {
1164       printf_filtered (_("Continuing at "));
1165       fputs_filtered (paddress (gdbarch, addr), gdb_stdout);
1166       printf_filtered (".\n");
1167     }
1168
1169   /* If we are not asked to run in the bg, then prepare to run in the
1170      foreground, synchronously.  */
1171   if (!async_exec && target_can_async_p ())
1172     {
1173       /* Simulate synchronous execution.  */
1174       async_disable_stdin ();
1175     }
1176
1177   clear_proceed_status ();
1178   proceed (addr, TARGET_SIGNAL_0, 0);
1179 }
1180 \f
1181
1182 /* Go to line or address in current procedure.  */
1183 static void
1184 go_command (char *line_no, int from_tty)
1185 {
1186   if (line_no == (char *) NULL || !*line_no)
1187     printf_filtered (_("Usage: go <location>\n"));
1188   else
1189     {
1190       tbreak_command (line_no, from_tty);
1191       jump_command (line_no, from_tty);
1192     }
1193 }
1194 \f
1195
1196 /* Continue program giving it specified signal.  */
1197
1198 static void
1199 signal_command (char *signum_exp, int from_tty)
1200 {
1201   enum target_signal oursig;
1202   int async_exec = 0;
1203
1204   dont_repeat ();               /* Too dangerous.  */
1205   ERROR_NO_INFERIOR;
1206   ensure_not_tfind_mode ();
1207   ensure_valid_thread ();
1208   ensure_not_running ();
1209
1210   /* Find out whether we must run in the background.  */
1211   if (signum_exp != NULL)
1212     async_exec = strip_bg_char (&signum_exp);
1213
1214   /* If we must run in the background, but the target can't do it,
1215      error out.  */
1216   if (async_exec && !target_can_async_p ())
1217     error (_("Asynchronous execution not supported on this target."));
1218
1219   /* If we are not asked to run in the bg, then prepare to run in the
1220      foreground, synchronously.  */
1221   if (!async_exec && target_can_async_p ())
1222     {
1223       /* Simulate synchronous execution.  */
1224       async_disable_stdin ();
1225     }
1226
1227   if (!signum_exp)
1228     error_no_arg (_("signal number"));
1229
1230   /* It would be even slicker to make signal names be valid expressions,
1231      (the type could be "enum $signal" or some such), then the user could
1232      assign them to convenience variables.  */
1233   oursig = target_signal_from_name (signum_exp);
1234
1235   if (oursig == TARGET_SIGNAL_UNKNOWN)
1236     {
1237       /* No, try numeric.  */
1238       int num = parse_and_eval_long (signum_exp);
1239
1240       if (num == 0)
1241         oursig = TARGET_SIGNAL_0;
1242       else
1243         oursig = target_signal_from_command (num);
1244     }
1245
1246   if (from_tty)
1247     {
1248       if (oursig == TARGET_SIGNAL_0)
1249         printf_filtered (_("Continuing with no signal.\n"));
1250       else
1251         printf_filtered (_("Continuing with signal %s.\n"),
1252                          target_signal_to_name (oursig));
1253     }
1254
1255   clear_proceed_status ();
1256   proceed ((CORE_ADDR) -1, oursig, 0);
1257 }
1258
1259 /* Continuation args to be passed to the "until" command
1260    continuation.  */
1261 struct until_next_continuation_args
1262 {
1263   /* The thread that was current when the command was executed.  */
1264   int thread;
1265 };
1266
1267 /* A continuation callback for until_next_command.  */
1268
1269 static void
1270 until_next_continuation (void *arg, int err)
1271 {
1272   struct until_next_continuation_args *a = arg;
1273
1274   delete_longjmp_breakpoint (a->thread);
1275 }
1276
1277 /* Proceed until we reach a different source line with pc greater than
1278    our current one or exit the function.  We skip calls in both cases.
1279
1280    Note that eventually this command should probably be changed so
1281    that only source lines are printed out when we hit the breakpoint
1282    we set.  This may involve changes to wait_for_inferior and the
1283    proceed status code.  */
1284
1285 static void
1286 until_next_command (int from_tty)
1287 {
1288   struct frame_info *frame;
1289   CORE_ADDR pc;
1290   struct symbol *func;
1291   struct symtab_and_line sal;
1292   struct thread_info *tp = inferior_thread ();
1293   int thread = tp->num;
1294   struct cleanup *old_chain;
1295
1296   clear_proceed_status ();
1297   set_step_frame ();
1298
1299   frame = get_current_frame ();
1300
1301   /* Step until either exited from this function or greater
1302      than the current line (if in symbolic section) or pc (if
1303      not).  */
1304
1305   pc = get_frame_pc (frame);
1306   func = find_pc_function (pc);
1307
1308   if (!func)
1309     {
1310       struct minimal_symbol *msymbol = lookup_minimal_symbol_by_pc (pc);
1311
1312       if (msymbol == NULL)
1313         error (_("Execution is not within a known function."));
1314
1315       tp->control.step_range_start = SYMBOL_VALUE_ADDRESS (msymbol);
1316       tp->control.step_range_end = pc;
1317     }
1318   else
1319     {
1320       sal = find_pc_line (pc, 0);
1321
1322       tp->control.step_range_start = BLOCK_START (SYMBOL_BLOCK_VALUE (func));
1323       tp->control.step_range_end = sal.end;
1324     }
1325
1326   tp->control.step_over_calls = STEP_OVER_ALL;
1327
1328   tp->step_multi = 0;           /* Only one call to proceed */
1329
1330   set_longjmp_breakpoint (tp, get_frame_id (frame));
1331   old_chain = make_cleanup (delete_longjmp_breakpoint_cleanup, &thread);
1332
1333   proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
1334
1335   if (target_can_async_p () && is_running (inferior_ptid))
1336     {
1337       struct until_next_continuation_args *cont_args;
1338
1339       discard_cleanups (old_chain);
1340       cont_args = XNEW (struct until_next_continuation_args);
1341       cont_args->thread = inferior_thread ()->num;
1342
1343       add_continuation (tp, until_next_continuation, cont_args, xfree);
1344     }
1345   else
1346     do_cleanups (old_chain);
1347 }
1348
1349 static void
1350 until_command (char *arg, int from_tty)
1351 {
1352   int async_exec = 0;
1353
1354   ERROR_NO_INFERIOR;
1355   ensure_not_tfind_mode ();
1356   ensure_valid_thread ();
1357   ensure_not_running ();
1358
1359   /* Find out whether we must run in the background.  */
1360   if (arg != NULL)
1361     async_exec = strip_bg_char (&arg);
1362
1363   /* If we must run in the background, but the target can't do it,
1364      error out.  */
1365   if (async_exec && !target_can_async_p ())
1366     error (_("Asynchronous execution not supported on this target."));
1367
1368   /* If we are not asked to run in the bg, then prepare to run in the
1369      foreground, synchronously.  */
1370   if (!async_exec && target_can_async_p ())
1371     {
1372       /* Simulate synchronous execution.  */
1373       async_disable_stdin ();
1374     }
1375
1376   if (arg)
1377     until_break_command (arg, from_tty, 0);
1378   else
1379     until_next_command (from_tty);
1380 }
1381
1382 static void
1383 advance_command (char *arg, int from_tty)
1384 {
1385   int async_exec = 0;
1386
1387   ERROR_NO_INFERIOR;
1388   ensure_not_tfind_mode ();
1389   ensure_valid_thread ();
1390   ensure_not_running ();
1391
1392   if (arg == NULL)
1393     error_no_arg (_("a location"));
1394
1395   /* Find out whether we must run in the background.  */
1396   if (arg != NULL)
1397     async_exec = strip_bg_char (&arg);
1398
1399   /* If we must run in the background, but the target can't do it,
1400      error out.  */
1401   if (async_exec && !target_can_async_p ())
1402     error (_("Asynchronous execution not supported on this target."));
1403
1404   /* If we are not asked to run in the bg, then prepare to run in the
1405      foreground, synchronously.  */
1406   if (!async_exec && target_can_async_p ())
1407     {
1408       /* Simulate synchronous execution.  */
1409       async_disable_stdin ();
1410     }
1411
1412   until_break_command (arg, from_tty, 1);
1413 }
1414 \f
1415 /* Return the value of the result of a function at the end of a 'finish'
1416    command/BP.  */
1417
1418 struct value *
1419 get_return_value (struct type *func_type, struct type *value_type)
1420 {
1421   struct regcache *stop_regs = stop_registers;
1422   struct gdbarch *gdbarch;
1423   struct value *value;
1424   struct ui_out *uiout = current_uiout;
1425   struct cleanup *cleanup = make_cleanup (null_cleanup, NULL);
1426
1427   /* If stop_registers were not saved, use the current registers.  */
1428   if (!stop_regs)
1429     {
1430       stop_regs = regcache_dup (get_current_regcache ());
1431       cleanup = make_cleanup_regcache_xfree (stop_regs);
1432     }
1433
1434   gdbarch = get_regcache_arch (stop_regs);
1435
1436   CHECK_TYPEDEF (value_type);
1437   gdb_assert (TYPE_CODE (value_type) != TYPE_CODE_VOID);
1438
1439   /* FIXME: 2003-09-27: When returning from a nested inferior function
1440      call, it's possible (with no help from the architecture vector)
1441      to locate and return/print a "struct return" value.  This is just
1442      a more complicated case of what is already being done in the
1443      inferior function call code.  In fact, when inferior function
1444      calls are made async, this will likely be made the norm.  */
1445
1446   switch (gdbarch_return_value (gdbarch, func_type, value_type,
1447                                 NULL, NULL, NULL))
1448     {
1449     case RETURN_VALUE_REGISTER_CONVENTION:
1450     case RETURN_VALUE_ABI_RETURNS_ADDRESS:
1451     case RETURN_VALUE_ABI_PRESERVES_ADDRESS:
1452       value = allocate_value (value_type);
1453       gdbarch_return_value (gdbarch, func_type, value_type, stop_regs,
1454                             value_contents_raw (value), NULL);
1455       break;
1456     case RETURN_VALUE_STRUCT_CONVENTION:
1457       value = NULL;
1458       break;
1459     default:
1460       internal_error (__FILE__, __LINE__, _("bad switch"));
1461     }
1462
1463   do_cleanups (cleanup);
1464
1465   return value;
1466 }
1467
1468 /* Print the result of a function at the end of a 'finish' command.  */
1469
1470 static void
1471 print_return_value (struct type *func_type, struct type *value_type)
1472 {
1473   struct value *value = get_return_value (func_type, value_type);
1474   struct cleanup *old_chain;
1475   struct ui_stream *stb;
1476   struct ui_out *uiout = current_uiout;
1477
1478   if (value)
1479     {
1480       struct value_print_options opts;
1481
1482       /* Print it.  */
1483       stb = ui_out_stream_new (uiout);
1484       old_chain = make_cleanup_ui_out_stream_delete (stb);
1485       ui_out_text (uiout, "Value returned is ");
1486       ui_out_field_fmt (uiout, "gdb-result-var", "$%d",
1487                         record_latest_value (value));
1488       ui_out_text (uiout, " = ");
1489       get_raw_print_options (&opts);
1490       value_print (value, stb->stream, &opts);
1491       ui_out_field_stream (uiout, "return-value", stb);
1492       ui_out_text (uiout, "\n");
1493       do_cleanups (old_chain);
1494     }
1495   else
1496     {
1497       ui_out_text (uiout, "Value returned has type: ");
1498       ui_out_field_string (uiout, "return-type", TYPE_NAME (value_type));
1499       ui_out_text (uiout, ".");
1500       ui_out_text (uiout, " Cannot determine contents\n");
1501     }
1502 }
1503
1504 /* Stuff that needs to be done by the finish command after the target
1505    has stopped.  In asynchronous mode, we wait for the target to stop
1506    in the call to poll or select in the event loop, so it is
1507    impossible to do all the stuff as part of the finish_command
1508    function itself.  The only chance we have to complete this command
1509    is in fetch_inferior_event, which is called by the event loop as
1510    soon as it detects that the target has stopped.  */
1511
1512 struct finish_command_continuation_args
1513 {
1514   /* The thread that as current when the command was executed.  */
1515   int thread;
1516   struct breakpoint *breakpoint;
1517   struct symbol *function;
1518 };
1519
1520 static void
1521 finish_command_continuation (void *arg, int err)
1522 {
1523   struct finish_command_continuation_args *a = arg;
1524
1525   if (!err)
1526     {
1527       struct thread_info *tp = NULL;
1528       bpstat bs = NULL;
1529
1530       if (!ptid_equal (inferior_ptid, null_ptid)
1531           && target_has_execution
1532           && is_stopped (inferior_ptid))
1533         {
1534           tp = inferior_thread ();
1535           bs = tp->control.stop_bpstat;
1536         }
1537
1538       if (bpstat_find_breakpoint (bs, a->breakpoint) != NULL
1539           && a->function != NULL)
1540         {
1541           struct type *value_type;
1542
1543           value_type = TYPE_TARGET_TYPE (SYMBOL_TYPE (a->function));
1544           if (!value_type)
1545             internal_error (__FILE__, __LINE__,
1546                             _("finish_command: function has no target type"));
1547
1548           if (TYPE_CODE (value_type) != TYPE_CODE_VOID)
1549             {
1550               volatile struct gdb_exception ex;
1551
1552               TRY_CATCH (ex, RETURN_MASK_ALL)
1553                 {
1554                   /* print_return_value can throw an exception in some
1555                      circumstances.  We need to catch this so that we still
1556                      delete the breakpoint.  */
1557                   print_return_value (SYMBOL_TYPE (a->function), value_type);
1558                 }
1559               if (ex.reason < 0)
1560                 exception_print (gdb_stdout, ex);
1561             }
1562         }
1563
1564       /* We suppress normal call of normal_stop observer and do it
1565          here so that the *stopped notification includes the return
1566          value.  */
1567       if (bs != NULL && tp->control.proceed_to_finish)
1568         observer_notify_normal_stop (bs, 1 /* print frame */);
1569     }
1570
1571   delete_breakpoint (a->breakpoint);
1572   delete_longjmp_breakpoint (a->thread);
1573 }
1574
1575 static void
1576 finish_command_continuation_free_arg (void *arg)
1577 {
1578   xfree (arg);
1579 }
1580
1581 /* finish_backward -- helper function for finish_command.  */
1582
1583 static void
1584 finish_backward (struct symbol *function)
1585 {
1586   struct symtab_and_line sal;
1587   struct thread_info *tp = inferior_thread ();
1588   CORE_ADDR pc;
1589   CORE_ADDR func_addr;
1590
1591   pc = get_frame_pc (get_current_frame ());
1592
1593   if (find_pc_partial_function (pc, NULL, &func_addr, NULL) == 0)
1594     internal_error (__FILE__, __LINE__,
1595                     _("Finish: couldn't find function."));
1596
1597   sal = find_pc_line (func_addr, 0);
1598
1599   tp->control.proceed_to_finish = 1;
1600   /* Special case: if we're sitting at the function entry point,
1601      then all we need to do is take a reverse singlestep.  We
1602      don't need to set a breakpoint, and indeed it would do us
1603      no good to do so.
1604
1605      Note that this can only happen at frame #0, since there's
1606      no way that a function up the stack can have a return address
1607      that's equal to its entry point.  */
1608
1609   if (sal.pc != pc)
1610     {
1611       struct frame_info *frame = get_selected_frame (NULL);
1612       struct gdbarch *gdbarch = get_frame_arch (frame);
1613       struct symtab_and_line sr_sal;
1614
1615       /* Set a step-resume at the function's entry point.  Once that's
1616          hit, we'll do one more step backwards.  */
1617       init_sal (&sr_sal);
1618       sr_sal.pc = sal.pc;
1619       sr_sal.pspace = get_frame_program_space (frame);
1620       insert_step_resume_breakpoint_at_sal (gdbarch,
1621                                             sr_sal, null_frame_id);
1622
1623       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
1624     }
1625   else
1626     {
1627       /* We're almost there -- we just need to back up by one more
1628          single-step.  */
1629       tp->control.step_range_start = tp->control.step_range_end = 1;
1630       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
1631     }
1632 }
1633
1634 /* finish_forward -- helper function for finish_command.  */
1635
1636 static void
1637 finish_forward (struct symbol *function, struct frame_info *frame)
1638 {
1639   struct gdbarch *gdbarch = get_frame_arch (frame);
1640   struct symtab_and_line sal;
1641   struct thread_info *tp = inferior_thread ();
1642   struct breakpoint *breakpoint;
1643   struct cleanup *old_chain;
1644   struct finish_command_continuation_args *cargs;
1645   int thread = tp->num;
1646
1647   sal = find_pc_line (get_frame_pc (frame), 0);
1648   sal.pc = get_frame_pc (frame);
1649
1650   breakpoint = set_momentary_breakpoint (gdbarch, sal,
1651                                          get_stack_frame_id (frame),
1652                                          bp_finish);
1653
1654   old_chain = make_cleanup_delete_breakpoint (breakpoint);
1655
1656   set_longjmp_breakpoint (tp, get_frame_id (frame));
1657   make_cleanup (delete_longjmp_breakpoint_cleanup, &thread);
1658
1659   /* We want stop_registers, please...  */
1660   tp->control.proceed_to_finish = 1;
1661   cargs = xmalloc (sizeof (*cargs));
1662
1663   cargs->thread = thread;
1664   cargs->breakpoint = breakpoint;
1665   cargs->function = function;
1666   add_continuation (tp, finish_command_continuation, cargs,
1667                     finish_command_continuation_free_arg);
1668   proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
1669
1670   discard_cleanups (old_chain);
1671   if (!target_can_async_p ())
1672     do_all_continuations (0);
1673 }
1674
1675 /* "finish": Set a temporary breakpoint at the place the selected
1676    frame will return to, then continue.  */
1677
1678 static void
1679 finish_command (char *arg, int from_tty)
1680 {
1681   struct frame_info *frame;
1682   struct symbol *function;
1683
1684   int async_exec = 0;
1685
1686   ERROR_NO_INFERIOR;
1687   ensure_not_tfind_mode ();
1688   ensure_valid_thread ();
1689   ensure_not_running ();
1690
1691   /* Find out whether we must run in the background.  */
1692   if (arg != NULL)
1693     async_exec = strip_bg_char (&arg);
1694
1695   /* If we must run in the background, but the target can't do it,
1696      error out.  */
1697   if (async_exec && !target_can_async_p ())
1698     error (_("Asynchronous execution not supported on this target."));
1699
1700   /* If we are not asked to run in the bg, then prepare to run in the
1701      foreground, synchronously.  */
1702   if (!async_exec && target_can_async_p ())
1703     {
1704       /* Simulate synchronous execution.  */
1705       async_disable_stdin ();
1706     }
1707
1708   if (arg)
1709     error (_("The \"finish\" command does not take any arguments."));
1710
1711   frame = get_prev_frame (get_selected_frame (_("No selected frame.")));
1712   if (frame == 0)
1713     error (_("\"finish\" not meaningful in the outermost frame."));
1714
1715   clear_proceed_status ();
1716
1717   /* Finishing from an inline frame is completely different.  We don't
1718      try to show the "return value" - no way to locate it.  So we do
1719      not need a completion.  */
1720   if (get_frame_type (get_selected_frame (_("No selected frame.")))
1721       == INLINE_FRAME)
1722     {
1723       /* Claim we are stepping in the calling frame.  An empty step
1724          range means that we will stop once we aren't in a function
1725          called by that frame.  We don't use the magic "1" value for
1726          step_range_end, because then infrun will think this is nexti,
1727          and not step over the rest of this inlined function call.  */
1728       struct thread_info *tp = inferior_thread ();
1729       struct symtab_and_line empty_sal;
1730
1731       init_sal (&empty_sal);
1732       set_step_info (frame, empty_sal);
1733       tp->control.step_range_start = get_frame_pc (frame);
1734       tp->control.step_range_end = tp->control.step_range_start;
1735       tp->control.step_over_calls = STEP_OVER_ALL;
1736
1737       /* Print info on the selected frame, including level number but not
1738          source.  */
1739       if (from_tty)
1740         {
1741           printf_filtered (_("Run till exit from "));
1742           print_stack_frame (get_selected_frame (NULL), 1, LOCATION);
1743         }
1744
1745       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
1746       return;
1747     }
1748
1749   /* Find the function we will return from.  */
1750
1751   function = find_pc_function (get_frame_pc (get_selected_frame (NULL)));
1752
1753   /* Print info on the selected frame, including level number but not
1754      source.  */
1755   if (from_tty)
1756     {
1757       if (execution_direction == EXEC_REVERSE)
1758         printf_filtered (_("Run back to call of "));
1759       else
1760         printf_filtered (_("Run till exit from "));
1761
1762       print_stack_frame (get_selected_frame (NULL), 1, LOCATION);
1763     }
1764
1765   if (execution_direction == EXEC_REVERSE)
1766     finish_backward (function);
1767   else
1768     finish_forward (function, frame);
1769 }
1770 \f
1771
1772 static void
1773 program_info (char *args, int from_tty)
1774 {
1775   bpstat bs;
1776   int num, stat;
1777   struct thread_info *tp;
1778   ptid_t ptid;
1779
1780   if (!target_has_execution)
1781     {
1782       printf_filtered (_("The program being debugged is not being run.\n"));
1783       return;
1784     }
1785
1786   if (non_stop)
1787     ptid = inferior_ptid;
1788   else
1789     {
1790       struct target_waitstatus ws;
1791
1792       get_last_target_status (&ptid, &ws);
1793     }
1794
1795   if (ptid_equal (ptid, null_ptid) || is_exited (ptid))
1796     error (_("Invalid selected thread."));
1797   else if (is_running (ptid))
1798     error (_("Selected thread is running."));
1799
1800   tp = find_thread_ptid (ptid);
1801   bs = tp->control.stop_bpstat;
1802   stat = bpstat_num (&bs, &num);
1803
1804   target_files_info ();
1805   printf_filtered (_("Program stopped at %s.\n"),
1806                    paddress (target_gdbarch, stop_pc));
1807   if (tp->control.stop_step)
1808     printf_filtered (_("It stopped after being stepped.\n"));
1809   else if (stat != 0)
1810     {
1811       /* There may be several breakpoints in the same place, so this
1812          isn't as strange as it seems.  */
1813       while (stat != 0)
1814         {
1815           if (stat < 0)
1816             {
1817               printf_filtered (_("It stopped at a breakpoint "
1818                                  "that has since been deleted.\n"));
1819             }
1820           else
1821             printf_filtered (_("It stopped at breakpoint %d.\n"), num);
1822           stat = bpstat_num (&bs, &num);
1823         }
1824     }
1825   else if (tp->suspend.stop_signal != TARGET_SIGNAL_0)
1826     {
1827       printf_filtered (_("It stopped with signal %s, %s.\n"),
1828                        target_signal_to_name (tp->suspend.stop_signal),
1829                        target_signal_to_string (tp->suspend.stop_signal));
1830     }
1831
1832   if (!from_tty)
1833     {
1834       printf_filtered (_("Type \"info stack\" or \"info "
1835                          "registers\" for more information.\n"));
1836     }
1837 }
1838 \f
1839 static void
1840 environment_info (char *var, int from_tty)
1841 {
1842   if (var)
1843     {
1844       char *val = get_in_environ (current_inferior ()->environment, var);
1845
1846       if (val)
1847         {
1848           puts_filtered (var);
1849           puts_filtered (" = ");
1850           puts_filtered (val);
1851           puts_filtered ("\n");
1852         }
1853       else
1854         {
1855           puts_filtered ("Environment variable \"");
1856           puts_filtered (var);
1857           puts_filtered ("\" not defined.\n");
1858         }
1859     }
1860   else
1861     {
1862       char **vector = environ_vector (current_inferior ()->environment);
1863
1864       while (*vector)
1865         {
1866           puts_filtered (*vector++);
1867           puts_filtered ("\n");
1868         }
1869     }
1870 }
1871
1872 static void
1873 set_environment_command (char *arg, int from_tty)
1874 {
1875   char *p, *val, *var;
1876   int nullset = 0;
1877
1878   if (arg == 0)
1879     error_no_arg (_("environment variable and value"));
1880
1881   /* Find seperation between variable name and value.  */
1882   p = (char *) strchr (arg, '=');
1883   val = (char *) strchr (arg, ' ');
1884
1885   if (p != 0 && val != 0)
1886     {
1887       /* We have both a space and an equals.  If the space is before the
1888          equals, walk forward over the spaces til we see a nonspace 
1889          (possibly the equals).  */
1890       if (p > val)
1891         while (*val == ' ')
1892           val++;
1893
1894       /* Now if the = is after the char following the spaces,
1895          take the char following the spaces.  */
1896       if (p > val)
1897         p = val - 1;
1898     }
1899   else if (val != 0 && p == 0)
1900     p = val;
1901
1902   if (p == arg)
1903     error_no_arg (_("environment variable to set"));
1904
1905   if (p == 0 || p[1] == 0)
1906     {
1907       nullset = 1;
1908       if (p == 0)
1909         p = arg + strlen (arg); /* So that savestring below will work.  */
1910     }
1911   else
1912     {
1913       /* Not setting variable value to null.  */
1914       val = p + 1;
1915       while (*val == ' ' || *val == '\t')
1916         val++;
1917     }
1918
1919   while (p != arg && (p[-1] == ' ' || p[-1] == '\t'))
1920     p--;
1921
1922   var = savestring (arg, p - arg);
1923   if (nullset)
1924     {
1925       printf_filtered (_("Setting environment variable "
1926                          "\"%s\" to null value.\n"),
1927                        var);
1928       set_in_environ (current_inferior ()->environment, var, "");
1929     }
1930   else
1931     set_in_environ (current_inferior ()->environment, var, val);
1932   xfree (var);
1933 }
1934
1935 static void
1936 unset_environment_command (char *var, int from_tty)
1937 {
1938   if (var == 0)
1939     {
1940       /* If there is no argument, delete all environment variables.
1941          Ask for confirmation if reading from the terminal.  */
1942       if (!from_tty || query (_("Delete all environment variables? ")))
1943         {
1944           free_environ (current_inferior ()->environment);
1945           current_inferior ()->environment = make_environ ();
1946         }
1947     }
1948   else
1949     unset_in_environ (current_inferior ()->environment, var);
1950 }
1951
1952 /* Handle the execution path (PATH variable).  */
1953
1954 static const char path_var_name[] = "PATH";
1955
1956 static void
1957 path_info (char *args, int from_tty)
1958 {
1959   puts_filtered ("Executable and object file path: ");
1960   puts_filtered (get_in_environ (current_inferior ()->environment,
1961                                  path_var_name));
1962   puts_filtered ("\n");
1963 }
1964
1965 /* Add zero or more directories to the front of the execution path.  */
1966
1967 static void
1968 path_command (char *dirname, int from_tty)
1969 {
1970   char *exec_path;
1971   char *env;
1972
1973   dont_repeat ();
1974   env = get_in_environ (current_inferior ()->environment, path_var_name);
1975   /* Can be null if path is not set.  */
1976   if (!env)
1977     env = "";
1978   exec_path = xstrdup (env);
1979   mod_path (dirname, &exec_path);
1980   set_in_environ (current_inferior ()->environment, path_var_name, exec_path);
1981   xfree (exec_path);
1982   if (from_tty)
1983     path_info ((char *) NULL, from_tty);
1984 }
1985 \f
1986
1987 /* Print out the machine register regnum.  If regnum is -1, print all
1988    registers (print_all == 1) or all non-float and non-vector
1989    registers (print_all == 0).
1990
1991    For most machines, having all_registers_info() print the
1992    register(s) one per line is good enough.  If a different format is
1993    required, (eg, for MIPS or Pyramid 90x, which both have lots of
1994    regs), or there is an existing convention for showing all the
1995    registers, define the architecture method PRINT_REGISTERS_INFO to
1996    provide that format.  */
1997
1998 void
1999 default_print_registers_info (struct gdbarch *gdbarch,
2000                               struct ui_file *file,
2001                               struct frame_info *frame,
2002                               int regnum, int print_all)
2003 {
2004   int i;
2005   const int numregs = gdbarch_num_regs (gdbarch)
2006                       + gdbarch_num_pseudo_regs (gdbarch);
2007
2008   for (i = 0; i < numregs; i++)
2009     {
2010       struct type *regtype;
2011       struct value *val;
2012
2013       /* Decide between printing all regs, non-float / vector regs, or
2014          specific reg.  */
2015       if (regnum == -1)
2016         {
2017           if (print_all)
2018             {
2019               if (!gdbarch_register_reggroup_p (gdbarch, i, all_reggroup))
2020                 continue;
2021             }
2022           else
2023             {
2024               if (!gdbarch_register_reggroup_p (gdbarch, i, general_reggroup))
2025                 continue;
2026             }
2027         }
2028       else
2029         {
2030           if (i != regnum)
2031             continue;
2032         }
2033
2034       /* If the register name is empty, it is undefined for this
2035          processor, so don't display anything.  */
2036       if (gdbarch_register_name (gdbarch, i) == NULL
2037           || *(gdbarch_register_name (gdbarch, i)) == '\0')
2038         continue;
2039
2040       fputs_filtered (gdbarch_register_name (gdbarch, i), file);
2041       print_spaces_filtered (15 - strlen (gdbarch_register_name
2042                                           (gdbarch, i)), file);
2043
2044       regtype = register_type (gdbarch, i);
2045       val = allocate_value (regtype);
2046
2047       /* Get the data in raw format.  */
2048       if (! frame_register_read (frame, i, value_contents_raw (val)))
2049         {
2050           fprintf_filtered (file, "*value not available*\n");
2051           continue;
2052         }
2053
2054       /* If virtual format is floating, print it that way, and in raw
2055          hex.  */
2056       if (TYPE_CODE (regtype) == TYPE_CODE_FLT
2057           || TYPE_CODE (regtype) == TYPE_CODE_DECFLOAT)
2058         {
2059           int j;
2060           struct value_print_options opts;
2061           const gdb_byte *valaddr = value_contents_for_printing (val);
2062
2063           get_user_print_options (&opts);
2064           opts.deref_ref = 1;
2065
2066           val_print (regtype,
2067                      value_contents_for_printing (val),
2068                      value_embedded_offset (val), 0,
2069                      file, 0, val, &opts, current_language);
2070
2071           fprintf_filtered (file, "\t(raw 0x");
2072           for (j = 0; j < register_size (gdbarch, i); j++)
2073             {
2074               int idx;
2075
2076               if (gdbarch_byte_order (gdbarch) == BFD_ENDIAN_BIG)
2077                 idx = j;
2078               else
2079                 idx = register_size (gdbarch, i) - 1 - j;
2080               fprintf_filtered (file, "%02x", (unsigned char) valaddr[idx]);
2081             }
2082           fprintf_filtered (file, ")");
2083         }
2084       else
2085         {
2086           struct value_print_options opts;
2087
2088           /* Print the register in hex.  */
2089           get_formatted_print_options (&opts, 'x');
2090           opts.deref_ref = 1;
2091           val_print (regtype,
2092                      value_contents_for_printing (val),
2093                      value_embedded_offset (val), 0,
2094                      file, 0, val, &opts, current_language);
2095           /* If not a vector register, print it also according to its
2096              natural format.  */
2097           if (TYPE_VECTOR (regtype) == 0)
2098             {
2099               get_user_print_options (&opts);
2100               opts.deref_ref = 1;
2101               fprintf_filtered (file, "\t");
2102               val_print (regtype,
2103                          value_contents_for_printing (val),
2104                          value_embedded_offset (val), 0,
2105                          file, 0, val, &opts, current_language);
2106             }
2107         }
2108
2109       fprintf_filtered (file, "\n");
2110     }
2111 }
2112
2113 void
2114 registers_info (char *addr_exp, int fpregs)
2115 {
2116   struct frame_info *frame;
2117   struct gdbarch *gdbarch;
2118
2119   if (!target_has_registers)
2120     error (_("The program has no registers now."));
2121   frame = get_selected_frame (NULL);
2122   gdbarch = get_frame_arch (frame);
2123
2124   if (!addr_exp)
2125     {
2126       gdbarch_print_registers_info (gdbarch, gdb_stdout,
2127                                     frame, -1, fpregs);
2128       return;
2129     }
2130
2131   while (*addr_exp != '\0')
2132     {
2133       char *start;
2134       const char *end;
2135
2136       /* Keep skipping leading white space.  */
2137       if (isspace ((*addr_exp)))
2138         {
2139           addr_exp++;
2140           continue;
2141         }
2142
2143       /* Discard any leading ``$''.  Check that there is something
2144          resembling a register following it.  */
2145       if (addr_exp[0] == '$')
2146         addr_exp++;
2147       if (isspace ((*addr_exp)) || (*addr_exp) == '\0')
2148         error (_("Missing register name"));
2149
2150       /* Find the start/end of this register name/num/group.  */
2151       start = addr_exp;
2152       while ((*addr_exp) != '\0' && !isspace ((*addr_exp)))
2153         addr_exp++;
2154       end = addr_exp;
2155
2156       /* Figure out what we've found and display it.  */
2157
2158       /* A register name?  */
2159       {
2160         int regnum = user_reg_map_name_to_regnum (gdbarch, start, end - start);
2161
2162         if (regnum >= 0)
2163           {
2164             /* User registers lie completely outside of the range of
2165                normal registers.  Catch them early so that the target
2166                never sees them.  */
2167             if (regnum >= gdbarch_num_regs (gdbarch)
2168                           + gdbarch_num_pseudo_regs (gdbarch))
2169               {
2170                 struct value_print_options opts;
2171                 struct value *val = value_of_user_reg (regnum, frame);
2172
2173                 printf_filtered ("%s: ", start);
2174                 get_formatted_print_options (&opts, 'x');
2175                 val_print_scalar_formatted (check_typedef (value_type (val)),
2176                                             value_contents_for_printing (val),
2177                                             value_embedded_offset (val),
2178                                             val,
2179                                             &opts, 0, gdb_stdout);
2180                 printf_filtered ("\n");
2181               }
2182             else
2183               gdbarch_print_registers_info (gdbarch, gdb_stdout,
2184                                             frame, regnum, fpregs);
2185             continue;
2186           }
2187       }
2188
2189       /* A register group?  */
2190       {
2191         struct reggroup *group;
2192
2193         for (group = reggroup_next (gdbarch, NULL);
2194              group != NULL;
2195              group = reggroup_next (gdbarch, group))
2196           {
2197             /* Don't bother with a length check.  Should the user
2198                enter a short register group name, go with the first
2199                group that matches.  */
2200             if (strncmp (start, reggroup_name (group), end - start) == 0)
2201               break;
2202           }
2203         if (group != NULL)
2204           {
2205             int regnum;
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, group))
2213                   gdbarch_print_registers_info (gdbarch,
2214                                                 gdb_stdout, frame,
2215                                                 regnum, fpregs);
2216               }
2217             continue;
2218           }
2219       }
2220
2221       /* Nothing matched.  */
2222       error (_("Invalid register `%.*s'"), (int) (end - start), start);
2223     }
2224 }
2225
2226 void
2227 all_registers_info (char *addr_exp, int from_tty)
2228 {
2229   registers_info (addr_exp, 1);
2230 }
2231
2232 static void
2233 nofp_registers_info (char *addr_exp, int from_tty)
2234 {
2235   registers_info (addr_exp, 0);
2236 }
2237
2238 static void
2239 print_vector_info (struct ui_file *file,
2240                    struct frame_info *frame, const char *args)
2241 {
2242   struct gdbarch *gdbarch = get_frame_arch (frame);
2243
2244   if (gdbarch_print_vector_info_p (gdbarch))
2245     gdbarch_print_vector_info (gdbarch, file, frame, args);
2246   else
2247     {
2248       int regnum;
2249       int printed_something = 0;
2250
2251       for (regnum = 0;
2252            regnum < gdbarch_num_regs (gdbarch)
2253                     + gdbarch_num_pseudo_regs (gdbarch);
2254            regnum++)
2255         {
2256           if (gdbarch_register_reggroup_p (gdbarch, regnum, vector_reggroup))
2257             {
2258               printed_something = 1;
2259               gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
2260             }
2261         }
2262       if (!printed_something)
2263         fprintf_filtered (file, "No vector information\n");
2264     }
2265 }
2266
2267 static void
2268 vector_info (char *args, int from_tty)
2269 {
2270   if (!target_has_registers)
2271     error (_("The program has no registers now."));
2272
2273   print_vector_info (gdb_stdout, get_selected_frame (NULL), args);
2274 }
2275 \f
2276 /* Kill the inferior process.  Make us have no inferior.  */
2277
2278 static void
2279 kill_command (char *arg, int from_tty)
2280 {
2281   /* FIXME:  This should not really be inferior_ptid (or target_has_execution).
2282      It should be a distinct flag that indicates that a target is active, cuz
2283      some targets don't have processes!  */
2284
2285   if (ptid_equal (inferior_ptid, null_ptid))
2286     error (_("The program is not being run."));
2287   if (!query (_("Kill the program being debugged? ")))
2288     error (_("Not confirmed."));
2289   target_kill ();
2290
2291   /* If we still have other inferiors to debug, then don't mess with
2292      with their threads.  */
2293   if (!have_inferiors ())
2294     {
2295       init_thread_list ();              /* Destroy thread info.  */
2296
2297       /* Killing off the inferior can leave us with a core file.  If
2298          so, print the state we are left in.  */
2299       if (target_has_stack)
2300         {
2301           printf_filtered (_("In %s,\n"), target_longname);
2302           print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC);
2303         }
2304     }
2305   bfd_cache_close_all ();
2306 }
2307
2308 /* Used in `attach&' command.  ARG is a point to an integer
2309    representing a process id.  Proceed threads of this process iff
2310    they stopped due to debugger request, and when they did, they
2311    reported a clean stop (TARGET_SIGNAL_0).  Do not proceed threads
2312    that have been explicitly been told to stop.  */
2313
2314 static int
2315 proceed_after_attach_callback (struct thread_info *thread,
2316                                void *arg)
2317 {
2318   int pid = * (int *) arg;
2319
2320   if (ptid_get_pid (thread->ptid) == pid
2321       && !is_exited (thread->ptid)
2322       && !is_executing (thread->ptid)
2323       && !thread->stop_requested
2324       && thread->suspend.stop_signal == TARGET_SIGNAL_0)
2325     {
2326       switch_to_thread (thread->ptid);
2327       clear_proceed_status ();
2328       proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
2329     }
2330
2331   return 0;
2332 }
2333
2334 static void
2335 proceed_after_attach (int pid)
2336 {
2337   /* Don't error out if the current thread is running, because
2338      there may be other stopped threads.  */
2339   struct cleanup *old_chain;
2340
2341   /* Backup current thread and selected frame.  */
2342   old_chain = make_cleanup_restore_current_thread ();
2343
2344   iterate_over_threads (proceed_after_attach_callback, &pid);
2345
2346   /* Restore selected ptid.  */
2347   do_cleanups (old_chain);
2348 }
2349
2350 /*
2351  * TODO:
2352  * Should save/restore the tty state since it might be that the
2353  * program to be debugged was started on this tty and it wants
2354  * the tty in some state other than what we want.  If it's running
2355  * on another terminal or without a terminal, then saving and
2356  * restoring the tty state is a harmless no-op.
2357  * This only needs to be done if we are attaching to a process.
2358  */
2359
2360 /* attach_command --
2361    takes a program started up outside of gdb and ``attaches'' to it.
2362    This stops it cold in its tracks and allows us to start debugging it.
2363    and wait for the trace-trap that results from attaching.  */
2364
2365 static void
2366 attach_command_post_wait (char *args, int from_tty, int async_exec)
2367 {
2368   char *exec_file;
2369   char *full_exec_path = NULL;
2370   struct inferior *inferior;
2371
2372   inferior = current_inferior ();
2373   inferior->control.stop_soon = NO_STOP_QUIETLY;
2374
2375   /* If no exec file is yet known, try to determine it from the
2376      process itself.  */
2377   exec_file = (char *) get_exec_file (0);
2378   if (!exec_file)
2379     {
2380       exec_file = target_pid_to_exec_file (PIDGET (inferior_ptid));
2381       if (exec_file)
2382         {
2383           /* It's possible we don't have a full path, but rather just a
2384              filename.  Some targets, such as HP-UX, don't provide the
2385              full path, sigh.
2386
2387              Attempt to qualify the filename against the source path.
2388              (If that fails, we'll just fall back on the original
2389              filename.  Not much more we can do...)  */
2390
2391           if (!source_full_path_of (exec_file, &full_exec_path))
2392             full_exec_path = xstrdup (exec_file);
2393
2394           exec_file_attach (full_exec_path, from_tty);
2395           symbol_file_add_main (full_exec_path, from_tty);
2396         }
2397     }
2398   else
2399     {
2400       reopen_exec_file ();
2401       reread_symbols ();
2402     }
2403
2404   /* Take any necessary post-attaching actions for this platform.  */
2405   target_post_attach (PIDGET (inferior_ptid));
2406
2407   post_create_inferior (&current_target, from_tty);
2408
2409   /* Install inferior's terminal modes.  */
2410   target_terminal_inferior ();
2411
2412   if (async_exec)
2413     {
2414       /* The user requested an `attach&', so be sure to leave threads
2415          that didn't get a signal running.  */
2416
2417       /* Immediatelly resume all suspended threads of this inferior,
2418          and this inferior only.  This should have no effect on
2419          already running threads.  If a thread has been stopped with a
2420          signal, leave it be.  */
2421       if (non_stop)
2422         proceed_after_attach (inferior->pid);
2423       else
2424         {
2425           if (inferior_thread ()->suspend.stop_signal == TARGET_SIGNAL_0)
2426             {
2427               clear_proceed_status ();
2428               proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
2429             }
2430         }
2431     }
2432   else
2433     {
2434       /* The user requested a plain `attach', so be sure to leave
2435          the inferior stopped.  */
2436
2437       if (target_can_async_p ())
2438         async_enable_stdin ();
2439
2440       /* At least the current thread is already stopped.  */
2441
2442       /* In all-stop, by definition, all threads have to be already
2443          stopped at this point.  In non-stop, however, although the
2444          selected thread is stopped, others may still be executing.
2445          Be sure to explicitly stop all threads of the process.  This
2446          should have no effect on already stopped threads.  */
2447       if (non_stop)
2448         target_stop (pid_to_ptid (inferior->pid));
2449
2450       /* Tell the user/frontend where we're stopped.  */
2451       normal_stop ();
2452       if (deprecated_attach_hook)
2453         deprecated_attach_hook ();
2454     }
2455 }
2456
2457 struct attach_command_continuation_args
2458 {
2459   char *args;
2460   int from_tty;
2461   int async_exec;
2462 };
2463
2464 static void
2465 attach_command_continuation (void *args, int err)
2466 {
2467   struct attach_command_continuation_args *a = args;
2468
2469   if (err)
2470     return;
2471
2472   attach_command_post_wait (a->args, a->from_tty, a->async_exec);
2473 }
2474
2475 static void
2476 attach_command_continuation_free_args (void *args)
2477 {
2478   struct attach_command_continuation_args *a = args;
2479
2480   xfree (a->args);
2481   xfree (a);
2482 }
2483
2484 void
2485 attach_command (char *args, int from_tty)
2486 {
2487   int async_exec = 0;
2488   struct cleanup *back_to = make_cleanup (null_cleanup, NULL);
2489
2490   dont_repeat ();               /* Not for the faint of heart */
2491
2492   if (gdbarch_has_global_solist (target_gdbarch))
2493     /* Don't complain if all processes share the same symbol
2494        space.  */
2495     ;
2496   else if (target_has_execution)
2497     {
2498       if (query (_("A program is being debugged already.  Kill it? ")))
2499         target_kill ();
2500       else
2501         error (_("Not killed."));
2502     }
2503
2504   /* Clean up any leftovers from other runs.  Some other things from
2505      this function should probably be moved into target_pre_inferior.  */
2506   target_pre_inferior (from_tty);
2507
2508   if (non_stop && !target_supports_non_stop ())
2509     error (_("Cannot attach to this target in non-stop mode"));
2510
2511   if (args)
2512     {
2513       async_exec = strip_bg_char (&args);
2514
2515       /* If we get a request for running in the bg but the target
2516          doesn't support it, error out.  */
2517       if (async_exec && !target_can_async_p ())
2518         error (_("Asynchronous execution not supported on this target."));
2519     }
2520
2521   /* If we don't get a request of running in the bg, then we need
2522      to simulate synchronous (fg) execution.  */
2523   if (!async_exec && target_can_async_p ())
2524     {
2525       /* Simulate synchronous execution.  */
2526       async_disable_stdin ();
2527       make_cleanup ((make_cleanup_ftype *)async_enable_stdin, NULL);
2528     }
2529
2530   target_attach (args, from_tty);
2531
2532   /* Set up the "saved terminal modes" of the inferior
2533      based on what modes we are starting it with.  */
2534   target_terminal_init ();
2535
2536   /* Set up execution context to know that we should return from
2537      wait_for_inferior as soon as the target reports a stop.  */
2538   init_wait_for_inferior ();
2539   clear_proceed_status ();
2540
2541   if (non_stop)
2542     {
2543       /* If we find that the current thread isn't stopped, explicitly
2544          do so now, because we're going to install breakpoints and
2545          poke at memory.  */
2546
2547       if (async_exec)
2548         /* The user requested an `attach&'; stop just one thread.  */
2549         target_stop (inferior_ptid);
2550       else
2551         /* The user requested an `attach', so stop all threads of this
2552            inferior.  */
2553         target_stop (pid_to_ptid (ptid_get_pid (inferior_ptid)));
2554     }
2555
2556   /* Some system don't generate traps when attaching to inferior.
2557      E.g. Mach 3 or GNU hurd.  */
2558   if (!target_attach_no_wait)
2559     {
2560       struct inferior *inferior = current_inferior ();
2561
2562       /* Careful here.  See comments in inferior.h.  Basically some
2563          OSes don't ignore SIGSTOPs on continue requests anymore.  We
2564          need a way for handle_inferior_event to reset the stop_signal
2565          variable after an attach, and this is what
2566          STOP_QUIETLY_NO_SIGSTOP is for.  */
2567       inferior->control.stop_soon = STOP_QUIETLY_NO_SIGSTOP;
2568
2569       if (target_can_async_p ())
2570         {
2571           /* sync_execution mode.  Wait for stop.  */
2572           struct attach_command_continuation_args *a;
2573
2574           a = xmalloc (sizeof (*a));
2575           a->args = xstrdup (args);
2576           a->from_tty = from_tty;
2577           a->async_exec = async_exec;
2578           add_inferior_continuation (attach_command_continuation, a,
2579                                      attach_command_continuation_free_args);
2580           discard_cleanups (back_to);
2581           return;
2582         }
2583
2584       wait_for_inferior ();
2585     }
2586
2587   attach_command_post_wait (args, from_tty, async_exec);
2588   discard_cleanups (back_to);
2589 }
2590
2591 /* We had just found out that the target was already attached to an
2592    inferior.  PTID points at a thread of this new inferior, that is
2593    the most likely to be stopped right now, but not necessarily so.
2594    The new inferior is assumed to be already added to the inferior
2595    list at this point.  If LEAVE_RUNNING, then leave the threads of
2596    this inferior running, except those we've explicitly seen reported
2597    as stopped.  */
2598
2599 void
2600 notice_new_inferior (ptid_t ptid, int leave_running, int from_tty)
2601 {
2602   struct cleanup* old_chain;
2603   int async_exec;
2604
2605   old_chain = make_cleanup (null_cleanup, NULL);
2606
2607   /* If in non-stop, leave threads as running as they were.  If
2608      they're stopped for some reason other than us telling it to, the
2609      target reports a signal != TARGET_SIGNAL_0.  We don't try to
2610      resume threads with such a stop signal.  */
2611   async_exec = non_stop;
2612
2613   if (!ptid_equal (inferior_ptid, null_ptid))
2614     make_cleanup_restore_current_thread ();
2615
2616   switch_to_thread (ptid);
2617
2618   /* When we "notice" a new inferior we need to do all the things we
2619      would normally do if we had just attached to it.  */
2620
2621   if (is_executing (inferior_ptid))
2622     {
2623       struct inferior *inferior = current_inferior ();
2624
2625       /* We're going to install breakpoints, and poke at memory,
2626          ensure that the inferior is stopped for a moment while we do
2627          that.  */
2628       target_stop (inferior_ptid);
2629
2630       inferior->control.stop_soon = STOP_QUIETLY_REMOTE;
2631
2632       /* Wait for stop before proceeding.  */
2633       if (target_can_async_p ())
2634         {
2635           struct attach_command_continuation_args *a;
2636
2637           a = xmalloc (sizeof (*a));
2638           a->args = xstrdup ("");
2639           a->from_tty = from_tty;
2640           a->async_exec = async_exec;
2641           add_inferior_continuation (attach_command_continuation, a,
2642                                      attach_command_continuation_free_args);
2643
2644           do_cleanups (old_chain);
2645           return;
2646         }
2647       else
2648         wait_for_inferior ();
2649     }
2650
2651   async_exec = leave_running;
2652   attach_command_post_wait ("" /* args */, from_tty, async_exec);
2653
2654   do_cleanups (old_chain);
2655 }
2656
2657 /*
2658  * detach_command --
2659  * takes a program previously attached to and detaches it.
2660  * The program resumes execution and will no longer stop
2661  * on signals, etc.  We better not have left any breakpoints
2662  * in the program or it'll die when it hits one.  For this
2663  * to work, it may be necessary for the process to have been
2664  * previously attached.  It *might* work if the program was
2665  * started via the normal ptrace (PTRACE_TRACEME).
2666  */
2667
2668 void
2669 detach_command (char *args, int from_tty)
2670 {
2671   dont_repeat ();               /* Not for the faint of heart.  */
2672
2673   if (ptid_equal (inferior_ptid, null_ptid))
2674     error (_("The program is not being run."));
2675
2676   disconnect_tracing (from_tty);
2677
2678   target_detach (args, from_tty);
2679
2680   /* If the solist is global across inferiors, don't clear it when we
2681      detach from a single inferior.  */
2682   if (!gdbarch_has_global_solist (target_gdbarch))
2683     no_shared_libraries (NULL, from_tty);
2684
2685   /* If we still have inferiors to debug, then don't mess with their
2686      threads.  */
2687   if (!have_inferiors ())
2688     init_thread_list ();
2689
2690   if (deprecated_detach_hook)
2691     deprecated_detach_hook ();
2692 }
2693
2694 /* Disconnect from the current target without resuming it (leaving it
2695    waiting for a debugger).
2696
2697    We'd better not have left any breakpoints in the program or the
2698    next debugger will get confused.  Currently only supported for some
2699    remote targets, since the normal attach mechanisms don't work on
2700    stopped processes on some native platforms (e.g. GNU/Linux).  */
2701
2702 static void
2703 disconnect_command (char *args, int from_tty)
2704 {
2705   dont_repeat ();               /* Not for the faint of heart.  */
2706   disconnect_tracing (from_tty);
2707   target_disconnect (args, from_tty);
2708   no_shared_libraries (NULL, from_tty);
2709   init_thread_list ();
2710   if (deprecated_detach_hook)
2711     deprecated_detach_hook ();
2712 }
2713
2714 void 
2715 interrupt_target_1 (int all_threads)
2716 {
2717   ptid_t ptid;
2718
2719   if (all_threads)
2720     ptid = minus_one_ptid;
2721   else
2722     ptid = inferior_ptid;
2723   target_stop (ptid);
2724
2725   /* Tag the thread as having been explicitly requested to stop, so
2726      other parts of gdb know not to resume this thread automatically,
2727      if it was stopped due to an internal event.  Limit this to
2728      non-stop mode, as when debugging a multi-threaded application in
2729      all-stop mode, we will only get one stop event --- it's undefined
2730      which thread will report the event.  */
2731   if (non_stop)
2732     set_stop_requested (ptid, 1);
2733 }
2734
2735 /* Stop the execution of the target while running in async mode, in
2736    the backgound.  In all-stop, stop the whole process.  In non-stop
2737    mode, stop the current thread only by default, or stop all threads
2738    if the `-a' switch is used.  */
2739
2740 /* interrupt [-a]  */
2741 void
2742 interrupt_target_command (char *args, int from_tty)
2743 {
2744   if (target_can_async_p ())
2745     {
2746       int all_threads = 0;
2747
2748       dont_repeat ();           /* Not for the faint of heart.  */
2749
2750       if (args != NULL
2751           && strncmp (args, "-a", sizeof ("-a") - 1) == 0)
2752         all_threads = 1;
2753
2754       if (!non_stop && all_threads)
2755         error (_("-a is meaningless in all-stop mode."));
2756
2757       interrupt_target_1 (all_threads);
2758     }
2759 }
2760
2761 static void
2762 print_float_info (struct ui_file *file,
2763                   struct frame_info *frame, const char *args)
2764 {
2765   struct gdbarch *gdbarch = get_frame_arch (frame);
2766
2767   if (gdbarch_print_float_info_p (gdbarch))
2768     gdbarch_print_float_info (gdbarch, file, frame, args);
2769   else
2770     {
2771       int regnum;
2772       int printed_something = 0;
2773
2774       for (regnum = 0;
2775            regnum < gdbarch_num_regs (gdbarch)
2776                     + gdbarch_num_pseudo_regs (gdbarch);
2777            regnum++)
2778         {
2779           if (gdbarch_register_reggroup_p (gdbarch, regnum, float_reggroup))
2780             {
2781               printed_something = 1;
2782               gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
2783             }
2784         }
2785       if (!printed_something)
2786         fprintf_filtered (file, "No floating-point info "
2787                           "available for this processor.\n");
2788     }
2789 }
2790
2791 static void
2792 float_info (char *args, int from_tty)
2793 {
2794   if (!target_has_registers)
2795     error (_("The program has no registers now."));
2796
2797   print_float_info (gdb_stdout, get_selected_frame (NULL), args);
2798 }
2799 \f
2800 static void
2801 unset_command (char *args, int from_tty)
2802 {
2803   printf_filtered (_("\"unset\" must be followed by the "
2804                      "name of an unset subcommand.\n"));
2805   help_list (unsetlist, "unset ", -1, gdb_stdout);
2806 }
2807
2808 /* Implement `info proc' family of commands.  */
2809
2810 static void
2811 info_proc_cmd_1 (char *args, enum info_proc_what what, int from_tty)
2812 {
2813   target_info_proc (args, what);
2814 }
2815
2816 /* Implement `info proc' when given without any futher parameters.  */
2817
2818 static void
2819 info_proc_cmd (char *args, int from_tty)
2820 {
2821   info_proc_cmd_1 (args, IP_MINIMAL, from_tty);
2822 }
2823
2824 /* Implement `info proc mappings'.  */
2825
2826 static void
2827 info_proc_cmd_mappings (char *args, int from_tty)
2828 {
2829   info_proc_cmd_1 (args, IP_MAPPINGS, from_tty);
2830 }
2831
2832 /* Implement `info proc stat'.  */
2833
2834 static void
2835 info_proc_cmd_stat (char *args, int from_tty)
2836 {
2837   info_proc_cmd_1 (args, IP_STAT, from_tty);
2838 }
2839
2840 /* Implement `info proc status'.  */
2841
2842 static void
2843 info_proc_cmd_status (char *args, int from_tty)
2844 {
2845   info_proc_cmd_1 (args, IP_STATUS, from_tty);
2846 }
2847
2848 /* Implement `info proc cwd'.  */
2849
2850 static void
2851 info_proc_cmd_cwd (char *args, int from_tty)
2852 {
2853   info_proc_cmd_1 (args, IP_CWD, from_tty);
2854 }
2855
2856 /* Implement `info proc cmdline'.  */
2857
2858 static void
2859 info_proc_cmd_cmdline (char *args, int from_tty)
2860 {
2861   info_proc_cmd_1 (args, IP_CMDLINE, from_tty);
2862 }
2863
2864 /* Implement `info proc exe'.  */
2865
2866 static void
2867 info_proc_cmd_exe (char *args, int from_tty)
2868 {
2869   info_proc_cmd_1 (args, IP_EXE, from_tty);
2870 }
2871
2872 /* Implement `info proc all'.  */
2873
2874 static void
2875 info_proc_cmd_all (char *args, int from_tty)
2876 {
2877   info_proc_cmd_1 (args, IP_ALL, from_tty);
2878 }
2879
2880 void
2881 _initialize_infcmd (void)
2882 {
2883   static struct cmd_list_element *info_proc_cmdlist;
2884   struct cmd_list_element *c = NULL;
2885
2886   /* Add the filename of the terminal connected to inferior I/O.  */
2887   add_setshow_filename_cmd ("inferior-tty", class_run,
2888                             &inferior_io_terminal_scratch, _("\
2889 Set terminal for future runs of program being debugged."), _("\
2890 Show terminal for future runs of program being debugged."), _("\
2891 Usage: set inferior-tty /dev/pts/1"),
2892                             set_inferior_tty_command,
2893                             show_inferior_tty_command,
2894                             &setlist, &showlist);
2895   add_com_alias ("tty", "set inferior-tty", class_alias, 0);
2896
2897   add_setshow_optional_filename_cmd ("args", class_run,
2898                                      &inferior_args_scratch, _("\
2899 Set argument list to give program being debugged when it is started."), _("\
2900 Show argument list to give program being debugged when it is started."), _("\
2901 Follow this command with any number of args, to be passed to the program."),
2902                                      set_args_command,
2903                                      show_args_command,
2904                                      &setlist, &showlist);
2905
2906   c = add_cmd ("environment", no_class, environment_info, _("\
2907 The environment to give the program, or one variable's value.\n\
2908 With an argument VAR, prints the value of environment variable VAR to\n\
2909 give the program being debugged.  With no arguments, prints the entire\n\
2910 environment to be given to the program."), &showlist);
2911   set_cmd_completer (c, noop_completer);
2912
2913   add_prefix_cmd ("unset", no_class, unset_command,
2914                   _("Complement to certain \"set\" commands."),
2915                   &unsetlist, "unset ", 0, &cmdlist);
2916
2917   c = add_cmd ("environment", class_run, unset_environment_command, _("\
2918 Cancel environment variable VAR for the program.\n\
2919 This does not affect the program until the next \"run\" command."),
2920                &unsetlist);
2921   set_cmd_completer (c, noop_completer);
2922
2923   c = add_cmd ("environment", class_run, set_environment_command, _("\
2924 Set environment variable value to give the program.\n\
2925 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
2926 VALUES of environment variables are uninterpreted strings.\n\
2927 This does not affect the program until the next \"run\" command."),
2928                &setlist);
2929   set_cmd_completer (c, noop_completer);
2930
2931   c = add_com ("path", class_files, path_command, _("\
2932 Add directory DIR(s) to beginning of search path for object files.\n\
2933 $cwd in the path means the current working directory.\n\
2934 This path is equivalent to the $PATH shell variable.  It is a list of\n\
2935 directories, separated by colons.  These directories are searched to find\n\
2936 fully linked executable files and separately compiled object files as \
2937 needed."));
2938   set_cmd_completer (c, filename_completer);
2939
2940   c = add_cmd ("paths", no_class, path_info, _("\
2941 Current search path for finding object files.\n\
2942 $cwd in the path means the current working directory.\n\
2943 This path is equivalent to the $PATH shell variable.  It is a list of\n\
2944 directories, separated by colons.  These directories are searched to find\n\
2945 fully linked executable files and separately compiled object files as \
2946 needed."),
2947                &showlist);
2948   set_cmd_completer (c, noop_completer);
2949
2950   add_prefix_cmd ("kill", class_run, kill_command,
2951                   _("Kill execution of program being debugged."),
2952                   &killlist, "kill ", 0, &cmdlist);
2953
2954   add_com ("attach", class_run, attach_command, _("\
2955 Attach to a process or file outside of GDB.\n\
2956 This command attaches to another target, of the same type as your last\n\
2957 \"target\" command (\"info files\" will show your target stack).\n\
2958 The command may take as argument a process id or a device file.\n\
2959 For a process id, you must have permission to send the process a signal,\n\
2960 and it must have the same effective uid as the debugger.\n\
2961 When using \"attach\" with a process id, the debugger finds the\n\
2962 program running in the process, looking first in the current working\n\
2963 directory, or (if not found there) using the source file search path\n\
2964 (see the \"directory\" command).  You can also use the \"file\" command\n\
2965 to specify the program, and to load its symbol table."));
2966
2967   add_prefix_cmd ("detach", class_run, detach_command, _("\
2968 Detach a process or file previously attached.\n\
2969 If a process, it is no longer traced, and it continues its execution.  If\n\
2970 you were debugging a file, the file is closed and gdb no longer accesses it."),
2971                   &detachlist, "detach ", 0, &cmdlist);
2972
2973   add_com ("disconnect", class_run, disconnect_command, _("\
2974 Disconnect from a target.\n\
2975 The target will wait for another debugger to connect.  Not available for\n\
2976 all targets."));
2977
2978   add_com ("signal", class_run, signal_command, _("\
2979 Continue program giving it signal specified by the argument.\n\
2980 An argument of \"0\" means continue program without giving it a signal."));
2981
2982   add_com ("stepi", class_run, stepi_command, _("\
2983 Step one instruction exactly.\n\
2984 Argument N means do this N times (or till program stops for another \
2985 reason)."));
2986   add_com_alias ("si", "stepi", class_alias, 0);
2987
2988   add_com ("nexti", class_run, nexti_command, _("\
2989 Step one instruction, but proceed through subroutine calls.\n\
2990 Argument N means do this N times (or till program stops for another \
2991 reason)."));
2992   add_com_alias ("ni", "nexti", class_alias, 0);
2993
2994   add_com ("finish", class_run, finish_command, _("\
2995 Execute until selected stack frame returns.\n\
2996 Upon return, the value returned is printed and put in the value history."));
2997   add_com_alias ("fin", "finish", class_run, 1);
2998
2999   add_com ("next", class_run, next_command, _("\
3000 Step program, proceeding through subroutine calls.\n\
3001 Like the \"step\" command as long as subroutine calls do not happen;\n\
3002 when they do, the call is treated as one instruction.\n\
3003 Argument N means do this N times (or till program stops for another \
3004 reason)."));
3005   add_com_alias ("n", "next", class_run, 1);
3006   if (xdb_commands)
3007     add_com_alias ("S", "next", class_run, 1);
3008
3009   add_com ("step", class_run, step_command, _("\
3010 Step program until it reaches a different source line.\n\
3011 Argument N means do this N times (or till program stops for another \
3012 reason)."));
3013   add_com_alias ("s", "step", class_run, 1);
3014
3015   c = add_com ("until", class_run, until_command, _("\
3016 Execute until the program reaches a source line greater than the current\n\
3017 or a specified location (same args as break command) within the current \
3018 frame."));
3019   set_cmd_completer (c, location_completer);
3020   add_com_alias ("u", "until", class_run, 1);
3021
3022   c = add_com ("advance", class_run, advance_command, _("\
3023 Continue the program up to the given location (same form as args for break \
3024 command).\n\
3025 Execution will also stop upon exit from the current stack frame."));
3026   set_cmd_completer (c, location_completer);
3027
3028   c = add_com ("jump", class_run, jump_command, _("\
3029 Continue program being debugged at specified line or address.\n\
3030 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
3031 for an address to start at."));
3032   set_cmd_completer (c, location_completer);
3033
3034   if (xdb_commands)
3035     {
3036       c = add_com ("go", class_run, go_command, _("\
3037 Usage: go <location>\n\
3038 Continue program being debugged, stopping at specified line or \n\
3039 address.\n\
3040 Give as argument either LINENUM or *ADDR, where ADDR is an \n\
3041 expression for an address to start at.\n\
3042 This command is a combination of tbreak and jump."));
3043       set_cmd_completer (c, location_completer);
3044     }
3045
3046   if (xdb_commands)
3047     add_com_alias ("g", "go", class_run, 1);
3048
3049   add_com ("continue", class_run, continue_command, _("\
3050 Continue program being debugged, after signal or breakpoint.\n\
3051 If proceeding from breakpoint, a number N may be used as an argument,\n\
3052 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
3053 the breakpoint won't break until the Nth time it is reached).\n\
3054 \n\
3055 If non-stop mode is enabled, continue only the current thread,\n\
3056 otherwise all the threads in the program are continued.  To \n\
3057 continue all stopped threads in non-stop mode, use the -a option.\n\
3058 Specifying -a and an ignore count simultaneously is an error."));
3059   add_com_alias ("c", "cont", class_run, 1);
3060   add_com_alias ("fg", "cont", class_run, 1);
3061
3062   c = add_com ("run", class_run, run_command, _("\
3063 Start debugged program.  You may specify arguments to give it.\n\
3064 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
3065 Input and output redirection with \">\", \"<\", or \">>\" are also \
3066 allowed.\n\n\
3067 With no arguments, uses arguments last specified (with \"run\" \
3068 or \"set args\").\n\
3069 To cancel previous arguments and run with no arguments,\n\
3070 use \"set args\" without arguments."));
3071   set_cmd_completer (c, filename_completer);
3072   add_com_alias ("r", "run", class_run, 1);
3073   if (xdb_commands)
3074     add_com ("R", class_run, run_no_args_command,
3075              _("Start debugged program with no arguments."));
3076
3077   c = add_com ("start", class_run, start_command, _("\
3078 Run the debugged program until the beginning of the main procedure.\n\
3079 You may specify arguments to give to your program, just as with the\n\
3080 \"run\" command."));
3081   set_cmd_completer (c, filename_completer);
3082
3083   add_com ("interrupt", class_run, interrupt_target_command,
3084            _("Interrupt the execution of the debugged program.\n\
3085 If non-stop mode is enabled, interrupt only the current thread,\n\
3086 otherwise all the threads in the program are stopped.  To \n\
3087 interrupt all running threads in non-stop mode, use the -a option."));
3088
3089   add_info ("registers", nofp_registers_info, _("\
3090 List of integer registers and their contents, for selected stack frame.\n\
3091 Register name as argument means describe only that register."));
3092   add_info_alias ("r", "registers", 1);
3093
3094   if (xdb_commands)
3095     add_com ("lr", class_info, nofp_registers_info, _("\
3096 List of integer registers and their contents, for selected stack frame.\n\
3097 Register name as argument means describe only that register."));
3098   add_info ("all-registers", all_registers_info, _("\
3099 List of all registers and their contents, for selected stack frame.\n\
3100 Register name as argument means describe only that register."));
3101
3102   add_info ("program", program_info,
3103             _("Execution status of the program."));
3104
3105   add_info ("float", float_info,
3106             _("Print the status of the floating point unit\n"));
3107
3108   add_info ("vector", vector_info,
3109             _("Print the status of the vector unit\n"));
3110
3111   add_prefix_cmd ("proc", class_info, info_proc_cmd,
3112                   _("\
3113 Show /proc process information about any running process.\n\
3114 Specify any process id, or use the program being debugged by default."),
3115                   &info_proc_cmdlist, "info proc ",
3116                   1/*allow-unknown*/, &infolist);
3117
3118   add_cmd ("mappings", class_info, info_proc_cmd_mappings, _("\
3119 List of mapped memory regions."),
3120            &info_proc_cmdlist);
3121
3122   add_cmd ("stat", class_info, info_proc_cmd_stat, _("\
3123 List process info from /proc/PID/stat."),
3124            &info_proc_cmdlist);
3125
3126   add_cmd ("status", class_info, info_proc_cmd_status, _("\
3127 List process info from /proc/PID/status."),
3128            &info_proc_cmdlist);
3129
3130   add_cmd ("cwd", class_info, info_proc_cmd_cwd, _("\
3131 List current working directory of the process."),
3132            &info_proc_cmdlist);
3133
3134   add_cmd ("cmdline", class_info, info_proc_cmd_cmdline, _("\
3135 List command line arguments of the process."),
3136            &info_proc_cmdlist);
3137
3138   add_cmd ("exe", class_info, info_proc_cmd_exe, _("\
3139 List absolute filename for executable of the process."),
3140            &info_proc_cmdlist);
3141
3142   add_cmd ("all", class_info, info_proc_cmd_all, _("\
3143 List all available /proc info."),
3144            &info_proc_cmdlist);
3145 }