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