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