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