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