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