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