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