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