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