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