NEWS: Remove empty line.
[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       frame = skip_unwritable_frames (frame);
2033
2034       if (frame == NULL)
2035         error (_("Cannot find the caller frame."));
2036
2037       finish_forward (sm, frame);
2038     }
2039 }
2040 \f
2041
2042 static void
2043 program_info (char *args, int from_tty)
2044 {
2045   bpstat bs;
2046   int num, stat;
2047   struct thread_info *tp;
2048   ptid_t ptid;
2049
2050   if (!target_has_execution)
2051     {
2052       printf_filtered (_("The program being debugged is not being run.\n"));
2053       return;
2054     }
2055
2056   if (non_stop)
2057     ptid = inferior_ptid;
2058   else
2059     {
2060       struct target_waitstatus ws;
2061
2062       get_last_target_status (&ptid, &ws);
2063     }
2064
2065   if (ptid_equal (ptid, null_ptid) || is_exited (ptid))
2066     error (_("Invalid selected thread."));
2067   else if (is_running (ptid))
2068     error (_("Selected thread is running."));
2069
2070   tp = find_thread_ptid (ptid);
2071   bs = tp->control.stop_bpstat;
2072   stat = bpstat_num (&bs, &num);
2073
2074   target_files_info ();
2075   printf_filtered (_("Program stopped at %s.\n"),
2076                    paddress (target_gdbarch (), stop_pc));
2077   if (tp->control.stop_step)
2078     printf_filtered (_("It stopped after being stepped.\n"));
2079   else if (stat != 0)
2080     {
2081       /* There may be several breakpoints in the same place, so this
2082          isn't as strange as it seems.  */
2083       while (stat != 0)
2084         {
2085           if (stat < 0)
2086             {
2087               printf_filtered (_("It stopped at a breakpoint "
2088                                  "that has since been deleted.\n"));
2089             }
2090           else
2091             printf_filtered (_("It stopped at breakpoint %d.\n"), num);
2092           stat = bpstat_num (&bs, &num);
2093         }
2094     }
2095   else if (tp->suspend.stop_signal != GDB_SIGNAL_0)
2096     {
2097       printf_filtered (_("It stopped with signal %s, %s.\n"),
2098                        gdb_signal_to_name (tp->suspend.stop_signal),
2099                        gdb_signal_to_string (tp->suspend.stop_signal));
2100     }
2101
2102   if (from_tty)
2103     {
2104       printf_filtered (_("Type \"info stack\" or \"info "
2105                          "registers\" for more information.\n"));
2106     }
2107 }
2108 \f
2109 static void
2110 environment_info (char *var, int from_tty)
2111 {
2112   if (var)
2113     {
2114       char *val = get_in_environ (current_inferior ()->environment, var);
2115
2116       if (val)
2117         {
2118           puts_filtered (var);
2119           puts_filtered (" = ");
2120           puts_filtered (val);
2121           puts_filtered ("\n");
2122         }
2123       else
2124         {
2125           puts_filtered ("Environment variable \"");
2126           puts_filtered (var);
2127           puts_filtered ("\" not defined.\n");
2128         }
2129     }
2130   else
2131     {
2132       char **vector = environ_vector (current_inferior ()->environment);
2133
2134       while (*vector)
2135         {
2136           puts_filtered (*vector++);
2137           puts_filtered ("\n");
2138         }
2139     }
2140 }
2141
2142 static void
2143 set_environment_command (char *arg, int from_tty)
2144 {
2145   char *p, *val, *var;
2146   int nullset = 0;
2147
2148   if (arg == 0)
2149     error_no_arg (_("environment variable and value"));
2150
2151   /* Find seperation between variable name and value.  */
2152   p = (char *) strchr (arg, '=');
2153   val = (char *) strchr (arg, ' ');
2154
2155   if (p != 0 && val != 0)
2156     {
2157       /* We have both a space and an equals.  If the space is before the
2158          equals, walk forward over the spaces til we see a nonspace 
2159          (possibly the equals).  */
2160       if (p > val)
2161         while (*val == ' ')
2162           val++;
2163
2164       /* Now if the = is after the char following the spaces,
2165          take the char following the spaces.  */
2166       if (p > val)
2167         p = val - 1;
2168     }
2169   else if (val != 0 && p == 0)
2170     p = val;
2171
2172   if (p == arg)
2173     error_no_arg (_("environment variable to set"));
2174
2175   if (p == 0 || p[1] == 0)
2176     {
2177       nullset = 1;
2178       if (p == 0)
2179         p = arg + strlen (arg); /* So that savestring below will work.  */
2180     }
2181   else
2182     {
2183       /* Not setting variable value to null.  */
2184       val = p + 1;
2185       while (*val == ' ' || *val == '\t')
2186         val++;
2187     }
2188
2189   while (p != arg && (p[-1] == ' ' || p[-1] == '\t'))
2190     p--;
2191
2192   var = savestring (arg, p - arg);
2193   if (nullset)
2194     {
2195       printf_filtered (_("Setting environment variable "
2196                          "\"%s\" to null value.\n"),
2197                        var);
2198       set_in_environ (current_inferior ()->environment, var, "");
2199     }
2200   else
2201     set_in_environ (current_inferior ()->environment, var, val);
2202   xfree (var);
2203 }
2204
2205 static void
2206 unset_environment_command (char *var, int from_tty)
2207 {
2208   if (var == 0)
2209     {
2210       /* If there is no argument, delete all environment variables.
2211          Ask for confirmation if reading from the terminal.  */
2212       if (!from_tty || query (_("Delete all environment variables? ")))
2213         {
2214           free_environ (current_inferior ()->environment);
2215           current_inferior ()->environment = make_environ ();
2216         }
2217     }
2218   else
2219     unset_in_environ (current_inferior ()->environment, var);
2220 }
2221
2222 /* Handle the execution path (PATH variable).  */
2223
2224 static const char path_var_name[] = "PATH";
2225
2226 static void
2227 path_info (char *args, int from_tty)
2228 {
2229   puts_filtered ("Executable and object file path: ");
2230   puts_filtered (get_in_environ (current_inferior ()->environment,
2231                                  path_var_name));
2232   puts_filtered ("\n");
2233 }
2234
2235 /* Add zero or more directories to the front of the execution path.  */
2236
2237 static void
2238 path_command (char *dirname, int from_tty)
2239 {
2240   char *exec_path;
2241   char *env;
2242
2243   dont_repeat ();
2244   env = get_in_environ (current_inferior ()->environment, path_var_name);
2245   /* Can be null if path is not set.  */
2246   if (!env)
2247     env = "";
2248   exec_path = xstrdup (env);
2249   mod_path (dirname, &exec_path);
2250   set_in_environ (current_inferior ()->environment, path_var_name, exec_path);
2251   xfree (exec_path);
2252   if (from_tty)
2253     path_info ((char *) NULL, from_tty);
2254 }
2255 \f
2256
2257 /* Print out the register NAME with value VAL, to FILE, in the default
2258    fashion.  */
2259
2260 static void
2261 default_print_one_register_info (struct ui_file *file,
2262                                  const char *name,
2263                                  struct value *val)
2264 {
2265   struct type *regtype = value_type (val);
2266   int print_raw_format;
2267
2268   fputs_filtered (name, file);
2269   print_spaces_filtered (15 - strlen (name), file);
2270
2271   print_raw_format = (value_entirely_available (val)
2272                       && !value_optimized_out (val));
2273
2274   /* If virtual format is floating, print it that way, and in raw
2275      hex.  */
2276   if (TYPE_CODE (regtype) == TYPE_CODE_FLT
2277       || TYPE_CODE (regtype) == TYPE_CODE_DECFLOAT)
2278     {
2279       struct value_print_options opts;
2280       const gdb_byte *valaddr = value_contents_for_printing (val);
2281       enum bfd_endian byte_order = gdbarch_byte_order (get_type_arch (regtype));
2282
2283       get_user_print_options (&opts);
2284       opts.deref_ref = 1;
2285
2286       val_print (regtype,
2287                  value_contents_for_printing (val),
2288                  value_embedded_offset (val), 0,
2289                  file, 0, val, &opts, current_language);
2290
2291       if (print_raw_format)
2292         {
2293           fprintf_filtered (file, "\t(raw ");
2294           print_hex_chars (file, valaddr, TYPE_LENGTH (regtype), byte_order);
2295           fprintf_filtered (file, ")");
2296         }
2297     }
2298   else
2299     {
2300       struct value_print_options opts;
2301
2302       /* Print the register in hex.  */
2303       get_formatted_print_options (&opts, 'x');
2304       opts.deref_ref = 1;
2305       val_print (regtype,
2306                  value_contents_for_printing (val),
2307                  value_embedded_offset (val), 0,
2308                  file, 0, val, &opts, current_language);
2309       /* If not a vector register, print it also according to its
2310          natural format.  */
2311       if (print_raw_format && TYPE_VECTOR (regtype) == 0)
2312         {
2313           get_user_print_options (&opts);
2314           opts.deref_ref = 1;
2315           fprintf_filtered (file, "\t");
2316           val_print (regtype,
2317                      value_contents_for_printing (val),
2318                      value_embedded_offset (val), 0,
2319                      file, 0, val, &opts, current_language);
2320         }
2321     }
2322
2323   fprintf_filtered (file, "\n");
2324 }
2325
2326 /* Print out the machine register regnum.  If regnum is -1, print all
2327    registers (print_all == 1) or all non-float and non-vector
2328    registers (print_all == 0).
2329
2330    For most machines, having all_registers_info() print the
2331    register(s) one per line is good enough.  If a different format is
2332    required, (eg, for MIPS or Pyramid 90x, which both have lots of
2333    regs), or there is an existing convention for showing all the
2334    registers, define the architecture method PRINT_REGISTERS_INFO to
2335    provide that format.  */
2336
2337 void
2338 default_print_registers_info (struct gdbarch *gdbarch,
2339                               struct ui_file *file,
2340                               struct frame_info *frame,
2341                               int regnum, int print_all)
2342 {
2343   int i;
2344   const int numregs = gdbarch_num_regs (gdbarch)
2345                       + gdbarch_num_pseudo_regs (gdbarch);
2346
2347   for (i = 0; i < numregs; i++)
2348     {
2349       /* Decide between printing all regs, non-float / vector regs, or
2350          specific reg.  */
2351       if (regnum == -1)
2352         {
2353           if (print_all)
2354             {
2355               if (!gdbarch_register_reggroup_p (gdbarch, i, all_reggroup))
2356                 continue;
2357             }
2358           else
2359             {
2360               if (!gdbarch_register_reggroup_p (gdbarch, i, general_reggroup))
2361                 continue;
2362             }
2363         }
2364       else
2365         {
2366           if (i != regnum)
2367             continue;
2368         }
2369
2370       /* If the register name is empty, it is undefined for this
2371          processor, so don't display anything.  */
2372       if (gdbarch_register_name (gdbarch, i) == NULL
2373           || *(gdbarch_register_name (gdbarch, i)) == '\0')
2374         continue;
2375
2376       default_print_one_register_info (file,
2377                                        gdbarch_register_name (gdbarch, i),
2378                                        value_of_register (i, frame));
2379     }
2380 }
2381
2382 void
2383 registers_info (char *addr_exp, int fpregs)
2384 {
2385   struct frame_info *frame;
2386   struct gdbarch *gdbarch;
2387
2388   if (!target_has_registers)
2389     error (_("The program has no registers now."));
2390   frame = get_selected_frame (NULL);
2391   gdbarch = get_frame_arch (frame);
2392
2393   if (!addr_exp)
2394     {
2395       gdbarch_print_registers_info (gdbarch, gdb_stdout,
2396                                     frame, -1, fpregs);
2397       return;
2398     }
2399
2400   while (*addr_exp != '\0')
2401     {
2402       char *start;
2403       const char *end;
2404
2405       /* Skip leading white space.  */
2406       addr_exp = skip_spaces (addr_exp);
2407
2408       /* Discard any leading ``$''.  Check that there is something
2409          resembling a register following it.  */
2410       if (addr_exp[0] == '$')
2411         addr_exp++;
2412       if (isspace ((*addr_exp)) || (*addr_exp) == '\0')
2413         error (_("Missing register name"));
2414
2415       /* Find the start/end of this register name/num/group.  */
2416       start = addr_exp;
2417       while ((*addr_exp) != '\0' && !isspace ((*addr_exp)))
2418         addr_exp++;
2419       end = addr_exp;
2420
2421       /* Figure out what we've found and display it.  */
2422
2423       /* A register name?  */
2424       {
2425         int regnum = user_reg_map_name_to_regnum (gdbarch, start, end - start);
2426
2427         if (regnum >= 0)
2428           {
2429             /* User registers lie completely outside of the range of
2430                normal registers.  Catch them early so that the target
2431                never sees them.  */
2432             if (regnum >= gdbarch_num_regs (gdbarch)
2433                           + gdbarch_num_pseudo_regs (gdbarch))
2434               {
2435                 struct value *regval = value_of_user_reg (regnum, frame);
2436                 const char *regname = user_reg_map_regnum_to_name (gdbarch,
2437                                                                    regnum);
2438
2439                 /* Print in the same fashion
2440                    gdbarch_print_registers_info's default
2441                    implementation prints.  */
2442                 default_print_one_register_info (gdb_stdout,
2443                                                  regname,
2444                                                  regval);
2445               }
2446             else
2447               gdbarch_print_registers_info (gdbarch, gdb_stdout,
2448                                             frame, regnum, fpregs);
2449             continue;
2450           }
2451       }
2452
2453       /* A register group?  */
2454       {
2455         struct reggroup *group;
2456
2457         for (group = reggroup_next (gdbarch, NULL);
2458              group != NULL;
2459              group = reggroup_next (gdbarch, group))
2460           {
2461             /* Don't bother with a length check.  Should the user
2462                enter a short register group name, go with the first
2463                group that matches.  */
2464             if (strncmp (start, reggroup_name (group), end - start) == 0)
2465               break;
2466           }
2467         if (group != NULL)
2468           {
2469             int regnum;
2470
2471             for (regnum = 0;
2472                  regnum < gdbarch_num_regs (gdbarch)
2473                           + gdbarch_num_pseudo_regs (gdbarch);
2474                  regnum++)
2475               {
2476                 if (gdbarch_register_reggroup_p (gdbarch, regnum, group))
2477                   gdbarch_print_registers_info (gdbarch,
2478                                                 gdb_stdout, frame,
2479                                                 regnum, fpregs);
2480               }
2481             continue;
2482           }
2483       }
2484
2485       /* Nothing matched.  */
2486       error (_("Invalid register `%.*s'"), (int) (end - start), start);
2487     }
2488 }
2489
2490 static void
2491 all_registers_info (char *addr_exp, int from_tty)
2492 {
2493   registers_info (addr_exp, 1);
2494 }
2495
2496 static void
2497 nofp_registers_info (char *addr_exp, int from_tty)
2498 {
2499   registers_info (addr_exp, 0);
2500 }
2501
2502 static void
2503 print_vector_info (struct ui_file *file,
2504                    struct frame_info *frame, const char *args)
2505 {
2506   struct gdbarch *gdbarch = get_frame_arch (frame);
2507
2508   if (gdbarch_print_vector_info_p (gdbarch))
2509     gdbarch_print_vector_info (gdbarch, file, frame, args);
2510   else
2511     {
2512       int regnum;
2513       int printed_something = 0;
2514
2515       for (regnum = 0;
2516            regnum < gdbarch_num_regs (gdbarch)
2517                     + gdbarch_num_pseudo_regs (gdbarch);
2518            regnum++)
2519         {
2520           if (gdbarch_register_reggroup_p (gdbarch, regnum, vector_reggroup))
2521             {
2522               printed_something = 1;
2523               gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
2524             }
2525         }
2526       if (!printed_something)
2527         fprintf_filtered (file, "No vector information\n");
2528     }
2529 }
2530
2531 static void
2532 vector_info (char *args, int from_tty)
2533 {
2534   if (!target_has_registers)
2535     error (_("The program has no registers now."));
2536
2537   print_vector_info (gdb_stdout, get_selected_frame (NULL), args);
2538 }
2539 \f
2540 /* Kill the inferior process.  Make us have no inferior.  */
2541
2542 static void
2543 kill_command (char *arg, int from_tty)
2544 {
2545   /* FIXME:  This should not really be inferior_ptid (or target_has_execution).
2546      It should be a distinct flag that indicates that a target is active, cuz
2547      some targets don't have processes!  */
2548
2549   if (ptid_equal (inferior_ptid, null_ptid))
2550     error (_("The program is not being run."));
2551   if (!query (_("Kill the program being debugged? ")))
2552     error (_("Not confirmed."));
2553   target_kill ();
2554
2555   /* If we still have other inferiors to debug, then don't mess with
2556      with their threads.  */
2557   if (!have_inferiors ())
2558     {
2559       init_thread_list ();              /* Destroy thread info.  */
2560
2561       /* Killing off the inferior can leave us with a core file.  If
2562          so, print the state we are left in.  */
2563       if (target_has_stack)
2564         {
2565           printf_filtered (_("In %s,\n"), target_longname);
2566           print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
2567         }
2568     }
2569   bfd_cache_close_all ();
2570 }
2571
2572 /* Used in `attach&' command.  ARG is a point to an integer
2573    representing a process id.  Proceed threads of this process iff
2574    they stopped due to debugger request, and when they did, they
2575    reported a clean stop (GDB_SIGNAL_0).  Do not proceed threads
2576    that have been explicitly been told to stop.  */
2577
2578 static int
2579 proceed_after_attach_callback (struct thread_info *thread,
2580                                void *arg)
2581 {
2582   int pid = * (int *) arg;
2583
2584   if (ptid_get_pid (thread->ptid) == pid
2585       && !is_exited (thread->ptid)
2586       && !is_executing (thread->ptid)
2587       && !thread->stop_requested
2588       && thread->suspend.stop_signal == GDB_SIGNAL_0)
2589     {
2590       switch_to_thread (thread->ptid);
2591       clear_proceed_status (0);
2592       proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT);
2593     }
2594
2595   return 0;
2596 }
2597
2598 static void
2599 proceed_after_attach (int pid)
2600 {
2601   /* Don't error out if the current thread is running, because
2602      there may be other stopped threads.  */
2603   struct cleanup *old_chain;
2604
2605   /* Backup current thread and selected frame.  */
2606   old_chain = make_cleanup_restore_current_thread ();
2607
2608   iterate_over_threads (proceed_after_attach_callback, &pid);
2609
2610   /* Restore selected ptid.  */
2611   do_cleanups (old_chain);
2612 }
2613
2614 /* See inferior.h.  */
2615
2616 void
2617 setup_inferior (int from_tty)
2618 {
2619   struct inferior *inferior;
2620
2621   inferior = current_inferior ();
2622   inferior->needs_setup = 0;
2623
2624   /* If no exec file is yet known, try to determine it from the
2625      process itself.  */
2626   if (get_exec_file (0) == NULL)
2627     exec_file_locate_attach (ptid_get_pid (inferior_ptid), from_tty);
2628   else
2629     {
2630       reopen_exec_file ();
2631       reread_symbols ();
2632     }
2633
2634   /* Take any necessary post-attaching actions for this platform.  */
2635   target_post_attach (ptid_get_pid (inferior_ptid));
2636
2637   post_create_inferior (&current_target, from_tty);
2638 }
2639
2640 /* What to do after the first program stops after attaching.  */
2641 enum attach_post_wait_mode
2642 {
2643   /* Do nothing.  Leaves threads as they are.  */
2644   ATTACH_POST_WAIT_NOTHING,
2645
2646   /* Re-resume threads that are marked running.  */
2647   ATTACH_POST_WAIT_RESUME,
2648
2649   /* Stop all threads.  */
2650   ATTACH_POST_WAIT_STOP,
2651 };
2652
2653 /* Called after we've attached to a process and we've seen it stop for
2654    the first time.  If ASYNC_EXEC is true, re-resume threads that
2655    should be running.  Else if ATTACH, */
2656
2657 static void
2658 attach_post_wait (char *args, int from_tty, enum attach_post_wait_mode mode)
2659 {
2660   struct inferior *inferior;
2661
2662   inferior = current_inferior ();
2663   inferior->control.stop_soon = NO_STOP_QUIETLY;
2664
2665   if (inferior->needs_setup)
2666     setup_inferior (from_tty);
2667
2668   if (mode == ATTACH_POST_WAIT_RESUME)
2669     {
2670       /* The user requested an `attach&', so be sure to leave threads
2671          that didn't get a signal running.  */
2672
2673       /* Immediatelly resume all suspended threads of this inferior,
2674          and this inferior only.  This should have no effect on
2675          already running threads.  If a thread has been stopped with a
2676          signal, leave it be.  */
2677       if (non_stop)
2678         proceed_after_attach (inferior->pid);
2679       else
2680         {
2681           if (inferior_thread ()->suspend.stop_signal == GDB_SIGNAL_0)
2682             {
2683               clear_proceed_status (0);
2684               proceed ((CORE_ADDR) -1, GDB_SIGNAL_DEFAULT);
2685             }
2686         }
2687     }
2688   else if (mode == ATTACH_POST_WAIT_STOP)
2689     {
2690       /* The user requested a plain `attach', so be sure to leave
2691          the inferior stopped.  */
2692
2693       async_enable_stdin ();
2694
2695       /* At least the current thread is already stopped.  */
2696
2697       /* In all-stop, by definition, all threads have to be already
2698          stopped at this point.  In non-stop, however, although the
2699          selected thread is stopped, others may still be executing.
2700          Be sure to explicitly stop all threads of the process.  This
2701          should have no effect on already stopped threads.  */
2702       if (non_stop)
2703         target_stop (pid_to_ptid (inferior->pid));
2704       else if (target_is_non_stop_p ())
2705         {
2706           struct thread_info *thread;
2707           struct thread_info *lowest = inferior_thread ();
2708           int pid = current_inferior ()->pid;
2709
2710           stop_all_threads ();
2711
2712           /* It's not defined which thread will report the attach
2713              stop.  For consistency, always select the thread with
2714              lowest GDB number, which should be the main thread, if it
2715              still exists.  */
2716           ALL_NON_EXITED_THREADS (thread)
2717             {
2718               if (ptid_get_pid (thread->ptid) == pid)
2719                 {
2720                   if (thread->inf->num < lowest->inf->num
2721                       || thread->per_inf_num < lowest->per_inf_num)
2722                     lowest = thread;
2723                 }
2724             }
2725
2726           switch_to_thread (lowest->ptid);
2727         }
2728
2729       /* Tell the user/frontend where we're stopped.  */
2730       normal_stop ();
2731       if (deprecated_attach_hook)
2732         deprecated_attach_hook ();
2733     }
2734 }
2735
2736 struct attach_command_continuation_args
2737 {
2738   char *args;
2739   int from_tty;
2740   enum attach_post_wait_mode mode;
2741 };
2742
2743 static void
2744 attach_command_continuation (void *args, int err)
2745 {
2746   struct attach_command_continuation_args *a
2747     = (struct attach_command_continuation_args *) args;
2748
2749   if (err)
2750     return;
2751
2752   attach_post_wait (a->args, a->from_tty, a->mode);
2753 }
2754
2755 static void
2756 attach_command_continuation_free_args (void *args)
2757 {
2758   struct attach_command_continuation_args *a
2759     = (struct attach_command_continuation_args *) args;
2760
2761   xfree (a->args);
2762   xfree (a);
2763 }
2764
2765 /* "attach" command entry point.  Takes a program started up outside
2766    of gdb and ``attaches'' to it.  This stops it cold in its tracks
2767    and allows us to start debugging it.  */
2768
2769 void
2770 attach_command (char *args, int from_tty)
2771 {
2772   int async_exec;
2773   struct cleanup *args_chain;
2774   struct target_ops *attach_target;
2775   struct inferior *inferior = current_inferior ();
2776   enum attach_post_wait_mode mode;
2777
2778   dont_repeat ();               /* Not for the faint of heart */
2779
2780   if (gdbarch_has_global_solist (target_gdbarch ()))
2781     /* Don't complain if all processes share the same symbol
2782        space.  */
2783     ;
2784   else if (target_has_execution)
2785     {
2786       if (query (_("A program is being debugged already.  Kill it? ")))
2787         target_kill ();
2788       else
2789         error (_("Not killed."));
2790     }
2791
2792   /* Clean up any leftovers from other runs.  Some other things from
2793      this function should probably be moved into target_pre_inferior.  */
2794   target_pre_inferior (from_tty);
2795
2796   args = strip_bg_char (args, &async_exec);
2797   args_chain = make_cleanup (xfree, args);
2798
2799   attach_target = find_attach_target ();
2800
2801   prepare_execution_command (attach_target, async_exec);
2802
2803   if (non_stop && !attach_target->to_supports_non_stop (attach_target))
2804     error (_("Cannot attach to this target in non-stop mode"));
2805
2806   attach_target->to_attach (attach_target, args, from_tty);
2807   /* to_attach should push the target, so after this point we
2808      shouldn't refer to attach_target again.  */
2809   attach_target = NULL;
2810
2811   /* Set up the "saved terminal modes" of the inferior
2812      based on what modes we are starting it with.  */
2813   target_terminal_init ();
2814
2815   /* Install inferior's terminal modes.  This may look like a no-op,
2816      as we've just saved them above, however, this does more than
2817      restore terminal settings:
2818
2819      - installs a SIGINT handler that forwards SIGINT to the inferior.
2820        Otherwise a Ctrl-C pressed just while waiting for the initial
2821        stop would end up as a spurious Quit.
2822
2823      - removes stdin from the event loop, which we need if attaching
2824        in the foreground, otherwise on targets that report an initial
2825        stop on attach (which are most) we'd process input/commands
2826        while we're in the event loop waiting for that stop.  That is,
2827        before the attach continuation runs and the command is really
2828        finished.  */
2829   target_terminal_inferior ();
2830
2831   /* Set up execution context to know that we should return from
2832      wait_for_inferior as soon as the target reports a stop.  */
2833   init_wait_for_inferior ();
2834   clear_proceed_status (0);
2835
2836   inferior->needs_setup = 1;
2837
2838   if (target_is_non_stop_p ())
2839     {
2840       /* If we find that the current thread isn't stopped, explicitly
2841          do so now, because we're going to install breakpoints and
2842          poke at memory.  */
2843
2844       if (async_exec)
2845         /* The user requested an `attach&'; stop just one thread.  */
2846         target_stop (inferior_ptid);
2847       else
2848         /* The user requested an `attach', so stop all threads of this
2849            inferior.  */
2850         target_stop (pid_to_ptid (ptid_get_pid (inferior_ptid)));
2851     }
2852
2853   mode = async_exec ? ATTACH_POST_WAIT_RESUME : ATTACH_POST_WAIT_STOP;
2854
2855   /* Some system don't generate traps when attaching to inferior.
2856      E.g. Mach 3 or GNU hurd.  */
2857   if (!target_attach_no_wait)
2858     {
2859       struct attach_command_continuation_args *a;
2860
2861       /* Careful here.  See comments in inferior.h.  Basically some
2862          OSes don't ignore SIGSTOPs on continue requests anymore.  We
2863          need a way for handle_inferior_event to reset the stop_signal
2864          variable after an attach, and this is what
2865          STOP_QUIETLY_NO_SIGSTOP is for.  */
2866       inferior->control.stop_soon = STOP_QUIETLY_NO_SIGSTOP;
2867
2868       /* sync_execution mode.  Wait for stop.  */
2869       a = XNEW (struct attach_command_continuation_args);
2870       a->args = xstrdup (args);
2871       a->from_tty = from_tty;
2872       a->mode = mode;
2873       add_inferior_continuation (attach_command_continuation, a,
2874                                  attach_command_continuation_free_args);
2875       /* Done with ARGS.  */
2876       do_cleanups (args_chain);
2877
2878       if (!target_is_async_p ())
2879         mark_infrun_async_event_handler ();
2880       return;
2881     }
2882
2883   /* Done with ARGS.  */
2884   do_cleanups (args_chain);
2885
2886   attach_post_wait (args, from_tty, mode);
2887 }
2888
2889 /* We had just found out that the target was already attached to an
2890    inferior.  PTID points at a thread of this new inferior, that is
2891    the most likely to be stopped right now, but not necessarily so.
2892    The new inferior is assumed to be already added to the inferior
2893    list at this point.  If LEAVE_RUNNING, then leave the threads of
2894    this inferior running, except those we've explicitly seen reported
2895    as stopped.  */
2896
2897 void
2898 notice_new_inferior (ptid_t ptid, int leave_running, int from_tty)
2899 {
2900   struct cleanup* old_chain;
2901   enum attach_post_wait_mode mode;
2902
2903   old_chain = make_cleanup (null_cleanup, NULL);
2904
2905   mode = leave_running ? ATTACH_POST_WAIT_RESUME : ATTACH_POST_WAIT_NOTHING;
2906
2907   if (!ptid_equal (inferior_ptid, null_ptid))
2908     make_cleanup_restore_current_thread ();
2909
2910   /* Avoid reading registers -- we haven't fetched the target
2911      description yet.  */
2912   switch_to_thread_no_regs (find_thread_ptid (ptid));
2913
2914   /* When we "notice" a new inferior we need to do all the things we
2915      would normally do if we had just attached to it.  */
2916
2917   if (is_executing (inferior_ptid))
2918     {
2919       struct attach_command_continuation_args *a;
2920       struct inferior *inferior = current_inferior ();
2921
2922       /* We're going to install breakpoints, and poke at memory,
2923          ensure that the inferior is stopped for a moment while we do
2924          that.  */
2925       target_stop (inferior_ptid);
2926
2927       inferior->control.stop_soon = STOP_QUIETLY_REMOTE;
2928
2929       /* Wait for stop before proceeding.  */
2930       a = XNEW (struct attach_command_continuation_args);
2931       a->args = xstrdup ("");
2932       a->from_tty = from_tty;
2933       a->mode = mode;
2934       add_inferior_continuation (attach_command_continuation, a,
2935                                  attach_command_continuation_free_args);
2936
2937       do_cleanups (old_chain);
2938       return;
2939     }
2940
2941   attach_post_wait ("" /* args */, from_tty, mode);
2942
2943   do_cleanups (old_chain);
2944 }
2945
2946 /*
2947  * detach_command --
2948  * takes a program previously attached to and detaches it.
2949  * The program resumes execution and will no longer stop
2950  * on signals, etc.  We better not have left any breakpoints
2951  * in the program or it'll die when it hits one.  For this
2952  * to work, it may be necessary for the process to have been
2953  * previously attached.  It *might* work if the program was
2954  * started via the normal ptrace (PTRACE_TRACEME).
2955  */
2956
2957 void
2958 detach_command (char *args, int from_tty)
2959 {
2960   dont_repeat ();               /* Not for the faint of heart.  */
2961
2962   if (ptid_equal (inferior_ptid, null_ptid))
2963     error (_("The program is not being run."));
2964
2965   query_if_trace_running (from_tty);
2966
2967   disconnect_tracing ();
2968
2969   target_detach (args, from_tty);
2970
2971   /* If the solist is global across inferiors, don't clear it when we
2972      detach from a single inferior.  */
2973   if (!gdbarch_has_global_solist (target_gdbarch ()))
2974     no_shared_libraries (NULL, from_tty);
2975
2976   /* If we still have inferiors to debug, then don't mess with their
2977      threads.  */
2978   if (!have_inferiors ())
2979     init_thread_list ();
2980
2981   if (deprecated_detach_hook)
2982     deprecated_detach_hook ();
2983 }
2984
2985 /* Disconnect from the current target without resuming it (leaving it
2986    waiting for a debugger).
2987
2988    We'd better not have left any breakpoints in the program or the
2989    next debugger will get confused.  Currently only supported for some
2990    remote targets, since the normal attach mechanisms don't work on
2991    stopped processes on some native platforms (e.g. GNU/Linux).  */
2992
2993 static void
2994 disconnect_command (char *args, int from_tty)
2995 {
2996   dont_repeat ();               /* Not for the faint of heart.  */
2997   query_if_trace_running (from_tty);
2998   disconnect_tracing ();
2999   target_disconnect (args, from_tty);
3000   no_shared_libraries (NULL, from_tty);
3001   init_thread_list ();
3002   if (deprecated_detach_hook)
3003     deprecated_detach_hook ();
3004 }
3005
3006 void 
3007 interrupt_target_1 (int all_threads)
3008 {
3009   ptid_t ptid;
3010
3011   if (all_threads)
3012     ptid = minus_one_ptid;
3013   else
3014     ptid = inferior_ptid;
3015
3016   if (non_stop)
3017     target_stop (ptid);
3018   else
3019     target_interrupt (ptid);
3020
3021   /* Tag the thread as having been explicitly requested to stop, so
3022      other parts of gdb know not to resume this thread automatically,
3023      if it was stopped due to an internal event.  Limit this to
3024      non-stop mode, as when debugging a multi-threaded application in
3025      all-stop mode, we will only get one stop event --- it's undefined
3026      which thread will report the event.  */
3027   if (non_stop)
3028     set_stop_requested (ptid, 1);
3029 }
3030
3031 /* interrupt [-a]
3032    Stop the execution of the target while running in async mode, in
3033    the backgound.  In all-stop, stop the whole process.  In non-stop
3034    mode, stop the current thread only by default, or stop all threads
3035    if the `-a' switch is used.  */
3036
3037 static void
3038 interrupt_command (char *args, int from_tty)
3039 {
3040   if (target_can_async_p ())
3041     {
3042       int all_threads = 0;
3043
3044       dont_repeat ();           /* Not for the faint of heart.  */
3045
3046       if (args != NULL
3047           && startswith (args, "-a"))
3048         all_threads = 1;
3049
3050       if (!non_stop && all_threads)
3051         error (_("-a is meaningless in all-stop mode."));
3052
3053       interrupt_target_1 (all_threads);
3054     }
3055 }
3056
3057 /* See inferior.h.  */
3058
3059 void
3060 default_print_float_info (struct gdbarch *gdbarch, struct ui_file *file,
3061                           struct frame_info *frame, const char *args)
3062 {
3063   int regnum;
3064   int printed_something = 0;
3065
3066   for (regnum = 0;
3067        regnum < gdbarch_num_regs (gdbarch)
3068          + gdbarch_num_pseudo_regs (gdbarch);
3069        regnum++)
3070     {
3071       if (gdbarch_register_reggroup_p (gdbarch, regnum, float_reggroup))
3072         {
3073           printed_something = 1;
3074           gdbarch_print_registers_info (gdbarch, file, frame, regnum, 1);
3075         }
3076     }
3077   if (!printed_something)
3078     fprintf_filtered (file, "No floating-point info "
3079                       "available for this processor.\n");
3080 }
3081
3082 static void
3083 float_info (char *args, int from_tty)
3084 {
3085   struct frame_info *frame;
3086
3087   if (!target_has_registers)
3088     error (_("The program has no registers now."));
3089
3090   frame = get_selected_frame (NULL);
3091   gdbarch_print_float_info (get_frame_arch (frame), gdb_stdout, frame, args);
3092 }
3093 \f
3094 static void
3095 unset_command (char *args, int from_tty)
3096 {
3097   printf_filtered (_("\"unset\" must be followed by the "
3098                      "name of an unset subcommand.\n"));
3099   help_list (unsetlist, "unset ", all_commands, gdb_stdout);
3100 }
3101
3102 /* Implement `info proc' family of commands.  */
3103
3104 static void
3105 info_proc_cmd_1 (char *args, enum info_proc_what what, int from_tty)
3106 {
3107   struct gdbarch *gdbarch = get_current_arch ();
3108
3109   if (!target_info_proc (args, what))
3110     {
3111       if (gdbarch_info_proc_p (gdbarch))
3112         gdbarch_info_proc (gdbarch, args, what);
3113       else
3114         error (_("Not supported on this target."));
3115     }
3116 }
3117
3118 /* Implement `info proc' when given without any futher parameters.  */
3119
3120 static void
3121 info_proc_cmd (char *args, int from_tty)
3122 {
3123   info_proc_cmd_1 (args, IP_MINIMAL, from_tty);
3124 }
3125
3126 /* Implement `info proc mappings'.  */
3127
3128 static void
3129 info_proc_cmd_mappings (char *args, int from_tty)
3130 {
3131   info_proc_cmd_1 (args, IP_MAPPINGS, from_tty);
3132 }
3133
3134 /* Implement `info proc stat'.  */
3135
3136 static void
3137 info_proc_cmd_stat (char *args, int from_tty)
3138 {
3139   info_proc_cmd_1 (args, IP_STAT, from_tty);
3140 }
3141
3142 /* Implement `info proc status'.  */
3143
3144 static void
3145 info_proc_cmd_status (char *args, int from_tty)
3146 {
3147   info_proc_cmd_1 (args, IP_STATUS, from_tty);
3148 }
3149
3150 /* Implement `info proc cwd'.  */
3151
3152 static void
3153 info_proc_cmd_cwd (char *args, int from_tty)
3154 {
3155   info_proc_cmd_1 (args, IP_CWD, from_tty);
3156 }
3157
3158 /* Implement `info proc cmdline'.  */
3159
3160 static void
3161 info_proc_cmd_cmdline (char *args, int from_tty)
3162 {
3163   info_proc_cmd_1 (args, IP_CMDLINE, from_tty);
3164 }
3165
3166 /* Implement `info proc exe'.  */
3167
3168 static void
3169 info_proc_cmd_exe (char *args, int from_tty)
3170 {
3171   info_proc_cmd_1 (args, IP_EXE, from_tty);
3172 }
3173
3174 /* Implement `info proc all'.  */
3175
3176 static void
3177 info_proc_cmd_all (char *args, int from_tty)
3178 {
3179   info_proc_cmd_1 (args, IP_ALL, from_tty);
3180 }
3181
3182 void
3183 _initialize_infcmd (void)
3184 {
3185   static struct cmd_list_element *info_proc_cmdlist;
3186   struct cmd_list_element *c = NULL;
3187   const char *cmd_name;
3188
3189   /* Add the filename of the terminal connected to inferior I/O.  */
3190   add_setshow_filename_cmd ("inferior-tty", class_run,
3191                             &inferior_io_terminal_scratch, _("\
3192 Set terminal for future runs of program being debugged."), _("\
3193 Show terminal for future runs of program being debugged."), _("\
3194 Usage: set inferior-tty /dev/pts/1"),
3195                             set_inferior_tty_command,
3196                             show_inferior_tty_command,
3197                             &setlist, &showlist);
3198   add_com_alias ("tty", "set inferior-tty", class_alias, 0);
3199
3200   cmd_name = "args";
3201   add_setshow_string_noescape_cmd (cmd_name, class_run,
3202                                    &inferior_args_scratch, _("\
3203 Set argument list to give program being debugged when it is started."), _("\
3204 Show argument list to give program being debugged when it is started."), _("\
3205 Follow this command with any number of args, to be passed to the program."),
3206                                    set_args_command,
3207                                    show_args_command,
3208                                    &setlist, &showlist);
3209   c = lookup_cmd (&cmd_name, setlist, "", -1, 1);
3210   gdb_assert (c != NULL);
3211   set_cmd_completer (c, filename_completer);
3212
3213   c = add_cmd ("environment", no_class, environment_info, _("\
3214 The environment to give the program, or one variable's value.\n\
3215 With an argument VAR, prints the value of environment variable VAR to\n\
3216 give the program being debugged.  With no arguments, prints the entire\n\
3217 environment to be given to the program."), &showlist);
3218   set_cmd_completer (c, noop_completer);
3219
3220   add_prefix_cmd ("unset", no_class, unset_command,
3221                   _("Complement to certain \"set\" commands."),
3222                   &unsetlist, "unset ", 0, &cmdlist);
3223
3224   c = add_cmd ("environment", class_run, unset_environment_command, _("\
3225 Cancel environment variable VAR for the program.\n\
3226 This does not affect the program until the next \"run\" command."),
3227                &unsetlist);
3228   set_cmd_completer (c, noop_completer);
3229
3230   c = add_cmd ("environment", class_run, set_environment_command, _("\
3231 Set environment variable value to give the program.\n\
3232 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
3233 VALUES of environment variables are uninterpreted strings.\n\
3234 This does not affect the program until the next \"run\" command."),
3235                &setlist);
3236   set_cmd_completer (c, noop_completer);
3237
3238   c = add_com ("path", class_files, path_command, _("\
3239 Add directory DIR(s) to beginning of search path for object files.\n\
3240 $cwd in the path means the current working directory.\n\
3241 This path is equivalent to the $PATH shell variable.  It is a list of\n\
3242 directories, separated by colons.  These directories are searched to find\n\
3243 fully linked executable files and separately compiled object files as \
3244 needed."));
3245   set_cmd_completer (c, filename_completer);
3246
3247   c = add_cmd ("paths", no_class, path_info, _("\
3248 Current search path for finding object files.\n\
3249 $cwd in the path means the current working directory.\n\
3250 This path is equivalent to the $PATH shell variable.  It is a list of\n\
3251 directories, separated by colons.  These directories are searched to find\n\
3252 fully linked executable files and separately compiled object files as \
3253 needed."),
3254                &showlist);
3255   set_cmd_completer (c, noop_completer);
3256
3257   add_prefix_cmd ("kill", class_run, kill_command,
3258                   _("Kill execution of program being debugged."),
3259                   &killlist, "kill ", 0, &cmdlist);
3260
3261   add_com ("attach", class_run, attach_command, _("\
3262 Attach to a process or file outside of GDB.\n\
3263 This command attaches to another target, of the same type as your last\n\
3264 \"target\" command (\"info files\" will show your target stack).\n\
3265 The command may take as argument a process id or a device file.\n\
3266 For a process id, you must have permission to send the process a signal,\n\
3267 and it must have the same effective uid as the debugger.\n\
3268 When using \"attach\" with a process id, the debugger finds the\n\
3269 program running in the process, looking first in the current working\n\
3270 directory, or (if not found there) using the source file search path\n\
3271 (see the \"directory\" command).  You can also use the \"file\" command\n\
3272 to specify the program, and to load its symbol table."));
3273
3274   add_prefix_cmd ("detach", class_run, detach_command, _("\
3275 Detach a process or file previously attached.\n\
3276 If a process, it is no longer traced, and it continues its execution.  If\n\
3277 you were debugging a file, the file is closed and gdb no longer accesses it."),
3278                   &detachlist, "detach ", 0, &cmdlist);
3279
3280   add_com ("disconnect", class_run, disconnect_command, _("\
3281 Disconnect from a target.\n\
3282 The target will wait for another debugger to connect.  Not available for\n\
3283 all targets."));
3284
3285   c = add_com ("signal", class_run, signal_command, _("\
3286 Continue program with the specified signal.\n\
3287 Usage: signal SIGNAL\n\
3288 The SIGNAL argument is processed the same as the handle command.\n\
3289 \n\
3290 An argument of \"0\" means continue the program without sending it a signal.\n\
3291 This is useful in cases where the program stopped because of a signal,\n\
3292 and you want to resume the program while discarding the signal.\n\
3293 \n\
3294 In a multi-threaded program the signal is delivered to, or discarded from,\n\
3295 the current thread only."));
3296   set_cmd_completer (c, signal_completer);
3297
3298   c = add_com ("queue-signal", class_run, queue_signal_command, _("\
3299 Queue a signal to be delivered to the current thread when it is resumed.\n\
3300 Usage: queue-signal SIGNAL\n\
3301 The SIGNAL argument is processed the same as the handle command.\n\
3302 It is an error if the handling state of SIGNAL is \"nopass\".\n\
3303 \n\
3304 An argument of \"0\" means remove any currently queued signal from\n\
3305 the current thread.  This is useful in cases where the program stopped\n\
3306 because of a signal, and you want to resume it while discarding the signal.\n\
3307 \n\
3308 In a multi-threaded program the signal is queued with, or discarded from,\n\
3309 the current thread only."));
3310   set_cmd_completer (c, signal_completer);
3311
3312   add_com ("stepi", class_run, stepi_command, _("\
3313 Step one instruction exactly.\n\
3314 Usage: stepi [N]\n\
3315 Argument N means step N times (or till program stops for another \
3316 reason)."));
3317   add_com_alias ("si", "stepi", class_alias, 0);
3318
3319   add_com ("nexti", class_run, nexti_command, _("\
3320 Step one instruction, but proceed through subroutine calls.\n\
3321 Usage: nexti [N]\n\
3322 Argument N means step N times (or till program stops for another \
3323 reason)."));
3324   add_com_alias ("ni", "nexti", class_alias, 0);
3325
3326   add_com ("finish", class_run, finish_command, _("\
3327 Execute until selected stack frame returns.\n\
3328 Usage: finish\n\
3329 Upon return, the value returned is printed and put in the value history."));
3330   add_com_alias ("fin", "finish", class_run, 1);
3331
3332   add_com ("next", class_run, next_command, _("\
3333 Step program, proceeding through subroutine calls.\n\
3334 Usage: next [N]\n\
3335 Unlike \"step\", if the current source line calls a subroutine,\n\
3336 this command does not enter the subroutine, but instead steps over\n\
3337 the call, in effect treating it as a single source line."));
3338   add_com_alias ("n", "next", class_run, 1);
3339
3340   add_com ("step", class_run, step_command, _("\
3341 Step program until it reaches a different source line.\n\
3342 Usage: step [N]\n\
3343 Argument N means step N times (or till program stops for another \
3344 reason)."));
3345   add_com_alias ("s", "step", class_run, 1);
3346
3347   c = add_com ("until", class_run, until_command, _("\
3348 Execute until the program reaches a source line greater than the current\n\
3349 or a specified location (same args as break command) within the current \
3350 frame."));
3351   set_cmd_completer (c, location_completer);
3352   add_com_alias ("u", "until", class_run, 1);
3353
3354   c = add_com ("advance", class_run, advance_command, _("\
3355 Continue the program up to the given location (same form as args for break \
3356 command).\n\
3357 Execution will also stop upon exit from the current stack frame."));
3358   set_cmd_completer (c, location_completer);
3359
3360   c = add_com ("jump", class_run, jump_command, _("\
3361 Continue program being debugged at specified line or address.\n\
3362 Usage: jump <location>\n\
3363 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
3364 for an address to start at."));
3365   set_cmd_completer (c, location_completer);
3366   add_com_alias ("j", "jump", class_run, 1);
3367
3368   add_com ("continue", class_run, continue_command, _("\
3369 Continue program being debugged, after signal or breakpoint.\n\
3370 Usage: continue [N]\n\
3371 If proceeding from breakpoint, a number N may be used as an argument,\n\
3372 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
3373 the breakpoint won't break until the Nth time it is reached).\n\
3374 \n\
3375 If non-stop mode is enabled, continue only the current thread,\n\
3376 otherwise all the threads in the program are continued.  To \n\
3377 continue all stopped threads in non-stop mode, use the -a option.\n\
3378 Specifying -a and an ignore count simultaneously is an error."));
3379   add_com_alias ("c", "cont", class_run, 1);
3380   add_com_alias ("fg", "cont", class_run, 1);
3381
3382   c = add_com ("run", class_run, run_command, _("\
3383 Start debugged program.  You may specify arguments to give it.\n\
3384 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
3385 Input and output redirection with \">\", \"<\", or \">>\" are also \
3386 allowed.\n\n\
3387 With no arguments, uses arguments last specified (with \"run\" \
3388 or \"set args\").\n\
3389 To cancel previous arguments and run with no arguments,\n\
3390 use \"set args\" without arguments."));
3391   set_cmd_completer (c, filename_completer);
3392   add_com_alias ("r", "run", class_run, 1);
3393
3394   c = add_com ("start", class_run, start_command, _("\
3395 Run the debugged program until the beginning of the main procedure.\n\
3396 You may specify arguments to give to your program, just as with the\n\
3397 \"run\" command."));
3398   set_cmd_completer (c, filename_completer);
3399
3400   add_com ("interrupt", class_run, interrupt_command,
3401            _("Interrupt the execution of the debugged program.\n\
3402 If non-stop mode is enabled, interrupt only the current thread,\n\
3403 otherwise all the threads in the program are stopped.  To \n\
3404 interrupt all running threads in non-stop mode, use the -a option."));
3405
3406   c = add_info ("registers", nofp_registers_info, _("\
3407 List of integer registers and their contents, for selected stack frame.\n\
3408 Register name as argument means describe only that register."));
3409   add_info_alias ("r", "registers", 1);
3410   set_cmd_completer (c, reg_or_group_completer);
3411
3412   c = add_info ("all-registers", all_registers_info, _("\
3413 List of all registers and their contents, for selected stack frame.\n\
3414 Register name as argument means describe only that register."));
3415   set_cmd_completer (c, reg_or_group_completer);
3416
3417   add_info ("program", program_info,
3418             _("Execution status of the program."));
3419
3420   add_info ("float", float_info,
3421             _("Print the status of the floating point unit\n"));
3422
3423   add_info ("vector", vector_info,
3424             _("Print the status of the vector unit\n"));
3425
3426   add_prefix_cmd ("proc", class_info, info_proc_cmd,
3427                   _("\
3428 Show /proc process information about any running process.\n\
3429 Specify any process id, or use the program being debugged by default."),
3430                   &info_proc_cmdlist, "info proc ",
3431                   1/*allow-unknown*/, &infolist);
3432
3433   add_cmd ("mappings", class_info, info_proc_cmd_mappings, _("\
3434 List of mapped memory regions."),
3435            &info_proc_cmdlist);
3436
3437   add_cmd ("stat", class_info, info_proc_cmd_stat, _("\
3438 List process info from /proc/PID/stat."),
3439            &info_proc_cmdlist);
3440
3441   add_cmd ("status", class_info, info_proc_cmd_status, _("\
3442 List process info from /proc/PID/status."),
3443            &info_proc_cmdlist);
3444
3445   add_cmd ("cwd", class_info, info_proc_cmd_cwd, _("\
3446 List current working directory of the process."),
3447            &info_proc_cmdlist);
3448
3449   add_cmd ("cmdline", class_info, info_proc_cmd_cmdline, _("\
3450 List command line arguments of the process."),
3451            &info_proc_cmdlist);
3452
3453   add_cmd ("exe", class_info, info_proc_cmd_exe, _("\
3454 List absolute filename for executable of the process."),
3455            &info_proc_cmdlist);
3456
3457   add_cmd ("all", class_info, info_proc_cmd_all, _("\
3458 List all available /proc info."),
3459            &info_proc_cmdlist);
3460 }