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