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