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