1 /* Memory-access and commands for "inferior" process, for GDB.
2 Copyright 1986, 1987, 1988, 1989, 1991, 1992 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
22 #include <sys/param.h>
35 static void continue_command PARAMS ((char *, int));
37 static void until_next_command PARAMS ((int));
39 static void until_command PARAMS ((char *, int));
41 static void path_info PARAMS ((char *, int));
43 static void path_command PARAMS ((char *, int));
45 static void unset_command PARAMS ((char *, int));
47 static void float_info PARAMS ((char *, int));
49 static void detach_command PARAMS ((char *, int));
51 static void nofp_registers_info PARAMS ((char *, int));
53 static void all_registers_info PARAMS ((char *, int));
55 static void registers_info PARAMS ((char *, int));
57 static void do_registers_info PARAMS ((int, int));
59 static void unset_environment_command PARAMS ((char *, int));
61 static void set_environment_command PARAMS ((char *, int));
63 static void environment_info PARAMS ((char *, int));
65 static void program_info PARAMS ((char *, int));
67 static void finish_command PARAMS ((char *, int));
69 static void signal_command PARAMS ((char *, int));
71 static void jump_command PARAMS ((char *, int));
73 static void step_1 PARAMS ((int, int, char *));
75 static void nexti_command PARAMS ((char *, int));
77 static void stepi_command PARAMS ((char *, int));
79 static void next_command PARAMS ((char *, int));
81 static void step_command PARAMS ((char *, int));
83 static void run_command PARAMS ((char *, int));
85 #define ERROR_NO_INFERIOR \
86 if (!target_has_execution) error ("The program is not being run.");
88 /* String containing arguments to give to the program, separated by spaces.
89 Empty string (pointer to '\0') means no args. */
91 static char *inferior_args;
93 /* File name for default use for standard in/out in the inferior. */
95 char *inferior_io_terminal;
97 /* Pid of our debugged inferior, or 0 if no inferior now.
98 Since various parts of infrun.c test this to see whether there is a program
99 being debugged it should be nonzero (currently 3 is used) for remote
104 /* Last signal that the inferior received (why it stopped). */
106 enum target_signal stop_signal;
108 /* Address at which inferior stopped. */
112 /* Chain containing status of breakpoint(s) that we have stopped at. */
116 /* Flag indicating that a command has proceeded the inferior past the
117 current breakpoint. */
119 int breakpoint_proceeded;
121 /* Nonzero if stopped due to a step command. */
125 /* Nonzero if stopped due to completion of a stack dummy routine. */
127 int stop_stack_dummy;
129 /* Nonzero if stopped due to a random (unexpected) signal in inferior
132 int stopped_by_random_signal;
134 /* Range to single step within.
135 If this is nonzero, respond to a single-step signal
136 by continuing to step if the pc is in this range. */
138 CORE_ADDR step_range_start; /* Inclusive */
139 CORE_ADDR step_range_end; /* Exclusive */
141 /* Stack frame address as of when stepping command was issued.
142 This is how we know when we step into a subroutine call,
143 and how to set the frame for the breakpoint used to step out. */
145 CORE_ADDR step_frame_address;
147 /* Our notion of the current stack pointer. */
151 /* 1 means step over all subroutine calls.
152 0 means don't step over calls (used by stepi).
153 -1 means step over calls to undebuggable functions. */
157 /* If stepping, nonzero means step count is > 1
158 so don't print frame next time inferior stops
159 if it stops due to stepping. */
163 /* Environment to use for running inferior,
164 in format described in environ.h. */
166 struct environ *inferior_environ;
171 tty_command (file, from_tty)
176 error_no_arg ("terminal name for running target process");
178 inferior_io_terminal = savestring (file, strlen (file));
182 run_command (args, from_tty)
193 !query ("The program being debugged has been started already.\n\
194 Start it from the beginning? "))
195 error ("Program not restarted.");
199 clear_breakpoint_hit_counts ();
201 exec_file = (char *) get_exec_file (0);
203 /* The exec file is re-read every time we do a generic_mourn_inferior, so
204 we just have to worry about the symbol file. */
207 /* We keep symbols from add-symbol-file, on the grounds that the
208 user might want to add some symbols before running the program
209 (right?). But sometimes (dynamic loading where the user manually
210 introduces the new symbols with add-symbol-file), the code which
211 the symbols describe does not persist between runs. Currently
212 the user has to manually nuke all symbols between runs if they
213 want them to go away (PR 2207). This is probably reasonable. */
218 cmd = concat ("set args ", args, NULL);
219 make_cleanup (free, cmd);
220 execute_command (cmd, from_tty);
225 puts_filtered("Starting program: ");
227 puts_filtered(exec_file);
229 puts_filtered(inferior_args);
231 gdb_flush (gdb_stdout);
234 target_create_inferior (exec_file, inferior_args,
235 environ_vector (inferior_environ));
239 continue_command (proc_count_exp, from_tty)
240 char *proc_count_exp;
245 /* If have argument, set proceed count of breakpoint we stopped at. */
247 if (proc_count_exp != NULL)
249 bpstat bs = stop_bpstat;
250 int num = bpstat_num (&bs);
251 if (num == 0 && from_tty)
254 ("Not stopped at any breakpoint; argument ignored.\n");
258 set_ignore_count (num,
259 parse_and_eval_address (proc_count_exp) - 1,
261 /* set_ignore_count prints a message ending with a period.
262 So print two spaces before "Continuing.". */
264 printf_filtered (" ");
265 num = bpstat_num (&bs);
270 printf_filtered ("Continuing.\n");
272 clear_proceed_status ();
274 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
277 /* Step until outside of current statement. */
281 step_command (count_string, from_tty)
285 step_1 (0, 0, count_string);
288 /* Likewise, but skip over subroutine calls as if single instructions. */
292 next_command (count_string, from_tty)
296 step_1 (1, 0, count_string);
299 /* Likewise, but step only one instruction. */
303 stepi_command (count_string, from_tty)
307 step_1 (0, 1, count_string);
312 nexti_command (count_string, from_tty)
316 step_1 (1, 1, count_string);
320 step_1 (skip_subroutines, single_inst, count_string)
321 int skip_subroutines;
325 register int count = 1;
326 struct frame_info *frame;
327 struct cleanup *cleanups = 0;
330 count = count_string ? parse_and_eval_address (count_string) : 1;
332 if (!single_inst || skip_subroutines) /* leave si command alone */
334 enable_longjmp_breakpoint();
335 cleanups = make_cleanup(disable_longjmp_breakpoint, 0);
338 for (; count > 0; count--)
340 clear_proceed_status ();
342 frame = get_current_frame ();
343 if (!frame) /* Avoid coredump here. Why tho? */
344 error ("No current frame");
345 step_frame_address = FRAME_FP (frame);
346 step_sp = read_sp ();
350 find_pc_line_pc_range (stop_pc, &step_range_start, &step_range_end);
351 if (step_range_end == 0)
354 if (find_pc_partial_function (stop_pc, &name, &step_range_start,
355 &step_range_end) == 0)
356 error ("Cannot find bounds of current function");
358 target_terminal_ours ();
360 Single stepping until exit from function %s, \n\
361 which has no line number information.\n", name);
362 gdb_flush (gdb_stdout);
367 /* Say we are stepping, but stop after one insn whatever it does. */
368 step_range_start = step_range_end = 1;
369 if (!skip_subroutines)
371 Don't step over function calls, not even to functions lacking
376 if (skip_subroutines)
379 step_multi = (count > 1);
380 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
384 /* FIXME: On nexti, this may have already been done (when we hit the
385 step resume break, I think). Probably this should be moved to
386 wait_for_inferior (near the top). */
387 #if defined (SHIFT_INST_REGS)
392 if (!single_inst || skip_subroutines)
393 do_cleanups(cleanups);
396 /* Continue program at specified address. */
399 jump_command (arg, from_tty)
403 register CORE_ADDR addr;
404 struct symtabs_and_lines sals;
405 struct symtab_and_line sal;
412 error_no_arg ("starting address");
414 sals = decode_line_spec_1 (arg, 1);
417 error ("Unreasonable jump request");
421 free ((PTR)sals.sals);
423 if (sal.symtab == 0 && sal.pc == 0)
424 error ("No source file has been specified.");
426 resolve_sal_pc (&sal); /* May error out */
428 /* See if we are trying to jump to another function. */
429 fn = get_frame_function (get_current_frame ());
430 sfn = find_pc_function (sal.pc);
431 if (fn != NULL && sfn != fn)
433 if (!query ("Line %d is not in `%s'. Jump anyway? ", sal.line,
434 SYMBOL_SOURCE_NAME (fn)))
436 error ("Not confirmed.");
445 printf_filtered ("Continuing at ");
446 print_address_numeric (addr, 1, gdb_stdout);
447 printf_filtered (".\n");
450 clear_proceed_status ();
451 proceed (addr, TARGET_SIGNAL_0, 0);
454 /* Continue program giving it specified signal. */
457 signal_command (signum_exp, from_tty)
461 enum target_signal oursig;
463 dont_repeat (); /* Too dangerous. */
467 error_no_arg ("signal number");
469 /* It would be even slicker to make signal names be valid expressions,
470 (the type could be "enum $signal" or some such), then the user could
471 assign them to convenience variables. */
472 oursig = target_signal_from_name (signum_exp);
474 if (oursig == TARGET_SIGNAL_UNKNOWN)
476 /* No, try numeric. */
477 int num = parse_and_eval_address (signum_exp);
480 oursig = TARGET_SIGNAL_0;
482 oursig = target_signal_from_command (num);
487 if (oursig == TARGET_SIGNAL_0)
488 printf_filtered ("Continuing with no signal.\n");
490 printf_filtered ("Continuing with signal %s.\n",
491 target_signal_to_name (oursig));
494 clear_proceed_status ();
495 /* "signal 0" should not get stuck if we are stopped at a breakpoint.
496 FIXME: Neither should "signal foo" but when I tried passing
497 (CORE_ADDR)-1 unconditionally I got a testsuite failure which I haven't
498 tried to track down yet. */
499 proceed (oursig == TARGET_SIGNAL_0 ? (CORE_ADDR) -1 : stop_pc, oursig, 0);
502 /* Call breakpoint_auto_delete on the current contents of the bpstat
503 pointed to by arg (which is really a bpstat *). */
505 breakpoint_auto_delete_contents (arg)
508 breakpoint_auto_delete (*(bpstat *)arg);
511 /* Execute a "stack dummy", a piece of code stored in the stack
512 by the debugger to be executed in the inferior.
514 To call: first, do PUSH_DUMMY_FRAME.
515 Then push the contents of the dummy. It should end with a breakpoint insn.
516 Then call here, passing address at which to start the dummy.
518 The contents of all registers are saved before the dummy frame is popped
519 and copied into the buffer BUFFER.
521 The dummy's frame is automatically popped whenever that break is hit.
522 If that is the first time the program stops, run_stack_dummy
523 returns to its caller with that frame already gone and returns 0.
524 Otherwise, run_stack-dummy returns 1 (the frame will eventually be popped
525 when we do hit that breakpoint). */
527 /* DEBUG HOOK: 4 => return instead of letting the stack dummy run. */
529 static int stack_dummy_testing = 0;
532 run_stack_dummy (addr, buffer)
534 char buffer[REGISTER_BYTES];
536 struct cleanup *old_cleanups = make_cleanup (null_cleanup, 0);
538 /* Now proceed, having reached the desired place. */
539 clear_proceed_status ();
540 if (stack_dummy_testing & 4)
545 #ifdef CALL_DUMMY_BREAKPOINT_OFFSET
547 struct breakpoint *bpt;
548 struct symtab_and_line sal;
550 #if CALL_DUMMY_LOCATION != AT_ENTRY_POINT
551 sal.pc = addr - CALL_DUMMY_START_OFFSET + CALL_DUMMY_BREAKPOINT_OFFSET;
553 sal.pc = CALL_DUMMY_ADDRESS ();
558 /* Set up a FRAME for the dummy frame so we can pass it to
559 set_momentary_breakpoint. We need to give the breakpoint a
560 frame in case there is only one copy of the dummy (e.g.
561 CALL_DUMMY_LOCATION == AFTER_TEXT_END). */
562 flush_cached_frames ();
563 set_current_frame (create_new_frame (read_fp (), sal.pc));
565 /* If defined, CALL_DUMMY_BREAKPOINT_OFFSET is where we need to put
566 a breakpoint instruction. If not, the call dummy already has the
567 breakpoint instruction in it.
569 addr is the address of the call dummy plus the CALL_DUMMY_START_OFFSET,
570 so we need to subtract the CALL_DUMMY_START_OFFSET. */
571 bpt = set_momentary_breakpoint (sal,
572 get_current_frame (),
574 bpt->disposition = delete;
576 /* If all error()s out of proceed ended up calling normal_stop (and
577 perhaps they should; it already does in the special case of error
578 out of resume()), then we wouldn't need this. */
579 make_cleanup (breakpoint_auto_delete_contents, &stop_bpstat);
581 #endif /* CALL_DUMMY_BREAKPOINT_OFFSET. */
583 proceed_to_finish = 1; /* We want stop_registers, please... */
584 proceed (addr, TARGET_SIGNAL_0, 0);
586 discard_cleanups (old_cleanups);
588 if (!stop_stack_dummy)
591 /* On return, the stack dummy has been popped already. */
593 memcpy (buffer, stop_registers, sizeof stop_registers);
597 /* Proceed until we reach a different source line with pc greater than
598 our current one or exit the function. We skip calls in both cases.
600 Note that eventually this command should probably be changed so
601 that only source lines are printed out when we hit the breakpoint
602 we set. This may involve changes to wait_for_inferior and the
603 proceed status code. */
607 until_next_command (from_tty)
610 struct frame_info *frame;
613 struct symtab_and_line sal;
615 clear_proceed_status ();
617 frame = get_current_frame ();
619 /* Step until either exited from this function or greater
620 than the current line (if in symbolic section) or pc (if
624 func = find_pc_function (pc);
628 struct minimal_symbol *msymbol = lookup_minimal_symbol_by_pc (pc);
631 error ("Execution is not within a known function.");
633 step_range_start = SYMBOL_VALUE_ADDRESS (msymbol);
638 sal = find_pc_line (pc, 0);
640 step_range_start = BLOCK_START (SYMBOL_BLOCK_VALUE (func));
641 step_range_end = sal.end;
645 step_frame_address = FRAME_FP (frame);
646 step_sp = read_sp ();
648 step_multi = 0; /* Only one call to proceed */
650 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 1);
654 until_command (arg, from_tty)
658 if (!target_has_execution)
659 error ("The program is not running.");
661 until_break_command (arg, from_tty);
663 until_next_command (from_tty);
666 /* "finish": Set a temporary breakpoint at the place
667 the selected frame will return to, then continue. */
670 finish_command (arg, from_tty)
674 struct symtab_and_line sal;
675 register struct frame_info *frame;
676 register struct symbol *function;
677 struct breakpoint *breakpoint;
678 struct cleanup *old_chain;
681 error ("The \"finish\" command does not take any arguments.");
682 if (!target_has_execution)
683 error ("The program is not running.");
684 if (selected_frame == NULL)
685 error ("No selected frame.");
687 frame = get_prev_frame (selected_frame);
689 error ("\"finish\" not meaningful in the outermost frame.");
691 clear_proceed_status ();
693 sal = find_pc_line (frame->pc, 0);
696 breakpoint = set_momentary_breakpoint (sal, frame, bp_finish);
698 old_chain = make_cleanup(delete_breakpoint, breakpoint);
700 /* Find the function we will return from. */
702 function = find_pc_function (selected_frame->pc);
704 /* Print info on the selected frame, including level number
708 printf_filtered ("Run till exit from ");
709 print_stack_frame (selected_frame, selected_frame_level, 0);
712 proceed_to_finish = 1; /* We want stop_registers, please... */
713 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_DEFAULT, 0);
715 /* Did we stop at our breakpoint? */
716 if (bpstat_find_breakpoint(stop_bpstat, breakpoint) != NULL
719 struct type *value_type;
720 register value_ptr val;
723 value_type = TYPE_TARGET_TYPE (SYMBOL_TYPE (function));
725 fatal ("internal: finish_command: function has no target type");
727 if (TYPE_CODE (value_type) == TYPE_CODE_VOID)
730 funcaddr = BLOCK_START (SYMBOL_BLOCK_VALUE (function));
732 val = value_being_returned (value_type, stop_registers,
733 using_struct_return (value_of_variable (function, NULL),
736 BLOCK_GCC_COMPILED (SYMBOL_BLOCK_VALUE (function))));
738 printf_filtered ("Value returned is $%d = ", record_latest_value (val));
739 value_print (val, gdb_stdout, 0, Val_no_prettyprint);
740 printf_filtered ("\n");
742 do_cleanups(old_chain);
747 program_info (args, from_tty)
751 bpstat bs = stop_bpstat;
752 int num = bpstat_num (&bs);
754 if (!target_has_execution)
756 printf_filtered ("The program being debugged is not being run.\n");
760 target_files_info ();
761 printf_filtered ("Program stopped at %s.\n",
762 local_hex_string((unsigned long) stop_pc));
764 printf_filtered ("It stopped after being stepped.\n");
767 /* There may be several breakpoints in the same place, so this
768 isn't as strange as it seems. */
772 printf_filtered ("It stopped at a breakpoint that has since been deleted.\n");
774 printf_filtered ("It stopped at breakpoint %d.\n", num);
775 num = bpstat_num (&bs);
778 else if (stop_signal != TARGET_SIGNAL_0)
780 printf_filtered ("It stopped with signal %s, %s.\n",
781 target_signal_to_name (stop_signal),
782 target_signal_to_string (stop_signal));
786 printf_filtered ("Type \"info stack\" or \"info registers\" for more information.\n");
790 environment_info (var, from_tty)
796 register char *val = get_in_environ (inferior_environ, var);
800 puts_filtered (" = ");
802 puts_filtered ("\n");
806 puts_filtered ("Environment variable \"");
808 puts_filtered ("\" not defined.\n");
813 register char **vector = environ_vector (inferior_environ);
816 puts_filtered (*vector++);
817 puts_filtered ("\n");
823 set_environment_command (arg, from_tty)
827 register char *p, *val, *var;
831 error_no_arg ("environment variable and value");
833 /* Find seperation between variable name and value */
834 p = (char *) strchr (arg, '=');
835 val = (char *) strchr (arg, ' ');
837 if (p != 0 && val != 0)
839 /* We have both a space and an equals. If the space is before the
840 equals, walk forward over the spaces til we see a nonspace
841 (possibly the equals). */
846 /* Now if the = is after the char following the spaces,
847 take the char following the spaces. */
851 else if (val != 0 && p == 0)
855 error_no_arg ("environment variable to set");
857 if (p == 0 || p[1] == 0)
861 p = arg + strlen (arg); /* So that savestring below will work */
865 /* Not setting variable value to null */
867 while (*val == ' ' || *val == '\t')
871 while (p != arg && (p[-1] == ' ' || p[-1] == '\t')) p--;
873 var = savestring (arg, p - arg);
876 printf_filtered ("Setting environment variable \"%s\" to null value.\n", var);
877 set_in_environ (inferior_environ, var, "");
880 set_in_environ (inferior_environ, var, val);
885 unset_environment_command (var, from_tty)
891 /* If there is no argument, delete all environment variables.
892 Ask for confirmation if reading from the terminal. */
893 if (!from_tty || query ("Delete all environment variables? "))
895 free_environ (inferior_environ);
896 inferior_environ = make_environ ();
900 unset_in_environ (inferior_environ, var);
903 /* Handle the execution path (PATH variable) */
905 static const char path_var_name[] = "PATH";
909 path_info (args, from_tty)
913 puts_filtered ("Executable and object file path: ");
914 puts_filtered (get_in_environ (inferior_environ, path_var_name));
915 puts_filtered ("\n");
918 /* Add zero or more directories to the front of the execution path. */
921 path_command (dirname, from_tty)
928 exec_path = strsave (get_in_environ (inferior_environ, path_var_name));
929 mod_path (dirname, &exec_path);
930 set_in_environ (inferior_environ, path_var_name, exec_path);
933 path_info ((char *)NULL, from_tty);
936 /* The array of register names. */
938 char *reg_names[] = REGISTER_NAMES;
940 /* Print out the machine register regnum. If regnum is -1,
941 print all registers (fpregs == 1) or all non-float registers
944 For most machines, having all_registers_info() print the
945 register(s) one per line is good enough. If a different format
946 is required, (eg, for MIPS or Pyramid 90x, which both have
947 lots of regs), or there is an existing convention for showing
948 all the registers, define the macro DO_REGISTERS_INFO(regnum, fp)
949 to provide that format. */
951 #if !defined (DO_REGISTERS_INFO)
953 #define DO_REGISTERS_INFO(regnum, fp) do_registers_info(regnum, fp)
956 do_registers_info (regnum, fpregs)
961 int numregs = ARCH_NUM_REGS;
963 for (i = 0; i < numregs; i++)
965 char raw_buffer[MAX_REGISTER_RAW_SIZE];
966 char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE];
968 /* Decide between printing all regs, nonfloat regs, or specific reg. */
970 if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i)) == TYPE_CODE_FLT && !fpregs)
977 fputs_filtered (reg_names[i], gdb_stdout);
978 print_spaces_filtered (15 - strlen (reg_names[i]), gdb_stdout);
980 /* Get the data in raw format. */
981 if (read_relative_register_raw_bytes (i, raw_buffer))
983 printf_filtered ("Invalid register contents\n");
987 /* Convert raw data to virtual format if necessary. */
988 #ifdef REGISTER_CONVERTIBLE
989 if (REGISTER_CONVERTIBLE (i))
991 REGISTER_CONVERT_TO_VIRTUAL (i, REGISTER_VIRTUAL_TYPE (i),
992 raw_buffer, virtual_buffer);
996 memcpy (virtual_buffer, raw_buffer,
997 REGISTER_VIRTUAL_SIZE (i));
999 /* If virtual format is floating, print it that way, and in raw hex. */
1000 if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i)) == TYPE_CODE_FLT)
1004 #ifdef INVALID_FLOAT
1005 if (INVALID_FLOAT (virtual_buffer, REGISTER_VIRTUAL_SIZE (i)))
1006 printf_filtered ("<invalid float>");
1009 val_print (REGISTER_VIRTUAL_TYPE (i), virtual_buffer, 0,
1010 gdb_stdout, 0, 1, 0, Val_pretty_default);
1012 printf_filtered ("\t(raw 0x");
1013 for (j = 0; j < REGISTER_RAW_SIZE (i); j++)
1014 printf_filtered ("%02x", (unsigned char)raw_buffer[j]);
1015 printf_filtered (")");
1018 /* FIXME! val_print probably can handle all of these cases now... */
1020 /* Else if virtual format is too long for printf,
1021 print in hex a byte at a time. */
1022 else if (REGISTER_VIRTUAL_SIZE (i) > sizeof (long))
1025 printf_filtered ("0x");
1026 for (j = 0; j < REGISTER_VIRTUAL_SIZE (i); j++)
1027 printf_filtered ("%02x", (unsigned char)virtual_buffer[j]);
1029 /* Else print as integer in hex and in decimal. */
1032 val_print (REGISTER_VIRTUAL_TYPE (i), raw_buffer, 0,
1033 gdb_stdout, 'x', 1, 0, Val_pretty_default);
1034 printf_filtered ("\t");
1035 val_print (REGISTER_VIRTUAL_TYPE (i), raw_buffer, 0,
1036 gdb_stdout, 0, 1, 0, Val_pretty_default);
1039 /* The SPARC wants to print even-numbered float regs as doubles
1040 in addition to printing them as floats. */
1041 #ifdef PRINT_REGISTER_HOOK
1042 PRINT_REGISTER_HOOK (i);
1045 printf_filtered ("\n");
1048 #endif /* no DO_REGISTERS_INFO. */
1051 registers_info (addr_exp, fpregs)
1055 int regnum, numregs;
1058 if (!target_has_registers)
1059 error ("The program has no registers now.");
1063 DO_REGISTERS_INFO(-1, fpregs);
1069 if (addr_exp[0] == '$')
1072 while (*end != '\0' && *end != ' ' && *end != '\t')
1074 numregs = ARCH_NUM_REGS;
1075 for (regnum = 0; regnum < numregs; regnum++)
1076 if (!strncmp (addr_exp, reg_names[regnum], end - addr_exp)
1077 && strlen (reg_names[regnum]) == end - addr_exp)
1079 if (*addr_exp >= '0' && *addr_exp <= '9')
1080 regnum = atoi (addr_exp); /* Take a number */
1081 if (regnum >= numregs) /* Bad name, or bad number */
1082 error ("%.*s: invalid register", end - addr_exp, addr_exp);
1085 DO_REGISTERS_INFO(regnum, fpregs);
1088 while (*addr_exp == ' ' || *addr_exp == '\t')
1090 } while (*addr_exp != '\0');
1094 all_registers_info (addr_exp, from_tty)
1098 registers_info (addr_exp, 1);
1102 nofp_registers_info (addr_exp, from_tty)
1106 registers_info (addr_exp, 0);
1111 * Should save/restore the tty state since it might be that the
1112 * program to be debugged was started on this tty and it wants
1113 * the tty in some state other than what we want. If it's running
1114 * on another terminal or without a terminal, then saving and
1115 * restoring the tty state is a harmless no-op.
1116 * This only needs to be done if we are attaching to a process.
1121 takes a program started up outside of gdb and ``attaches'' to it.
1122 This stops it cold in its tracks and allows us to start debugging it.
1123 and wait for the trace-trap that results from attaching. */
1126 attach_command (args, from_tty)
1130 dont_repeat (); /* Not for the faint of heart */
1132 if (target_has_execution)
1134 if (query ("A program is being debugged already. Kill it? "))
1137 error ("Not killed.");
1140 target_attach (args, from_tty);
1142 /* Set up the "saved terminal modes" of the inferior
1143 based on what modes we are starting it with. */
1144 target_terminal_init ();
1146 /* Install inferior's terminal modes. */
1147 target_terminal_inferior ();
1149 /* Set up execution context to know that we should return from
1150 wait_for_inferior as soon as the target reports a stop. */
1151 init_wait_for_inferior ();
1152 clear_proceed_status ();
1153 stop_soon_quietly = 1;
1156 /* Mach 3 does not generate any traps when attaching to inferior,
1157 and to set up frames we can do this. */
1159 wait_for_inferior ();
1163 /* Add shared library symbols from the newly attached process, if any. */
1164 SOLIB_ADD ((char *)0, from_tty, (struct target_ops *)0);
1172 * takes a program previously attached to and detaches it.
1173 * The program resumes execution and will no longer stop
1174 * on signals, etc. We better not have left any breakpoints
1175 * in the program or it'll die when it hits one. For this
1176 * to work, it may be necessary for the process to have been
1177 * previously attached. It *might* work if the program was
1178 * started via the normal ptrace (PTRACE_TRACEME).
1182 detach_command (args, from_tty)
1186 dont_repeat (); /* Not for the faint of heart */
1187 target_detach (args, from_tty);
1192 float_info (addr_exp, from_tty)
1199 printf_filtered ("No floating point info available for this processor.\n");
1205 unset_command (args, from_tty)
1209 printf_filtered ("\"unset\" must be followed by the name of an unset subcommand.\n");
1210 help_list (unsetlist, "unset ", -1, gdb_stdout);
1214 _initialize_infcmd ()
1216 struct cmd_list_element *c;
1218 add_com ("tty", class_run, tty_command,
1219 "Set terminal for future runs of program being debugged.");
1222 (add_set_cmd ("args", class_run, var_string_noescape, (char *)&inferior_args,
1224 "Set arguments to give program being debugged when it is started.\n\
1225 Follow this command with any number of args, to be passed to the program.",
1230 ("environment", no_class, environment_info,
1231 "The environment to give the program, or one variable's value.\n\
1232 With an argument VAR, prints the value of environment variable VAR to\n\
1233 give the program being debugged. With no arguments, prints the entire\n\
1234 environment to be given to the program.", &showlist);
1235 c->completer = noop_completer;
1237 add_prefix_cmd ("unset", no_class, unset_command,
1238 "Complement to certain \"set\" commands",
1239 &unsetlist, "unset ", 0, &cmdlist);
1241 c = add_cmd ("environment", class_run, unset_environment_command,
1242 "Cancel environment variable VAR for the program.\n\
1243 This does not affect the program until the next \"run\" command.",
1245 c->completer = noop_completer;
1247 c = add_cmd ("environment", class_run, set_environment_command,
1248 "Set environment variable value to give the program.\n\
1249 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
1250 VALUES of environment variables are uninterpreted strings.\n\
1251 This does not affect the program until the next \"run\" command.",
1253 c->completer = noop_completer;
1255 add_com ("path", class_files, path_command,
1256 "Add directory DIR(s) to beginning of search path for object files.\n\
1257 $cwd in the path means the current working directory.\n\
1258 This path is equivalent to the $PATH shell variable. It is a list of\n\
1259 directories, separated by colons. These directories are searched to find\n\
1260 fully linked executable files and separately compiled object files as needed.");
1262 c = add_cmd ("paths", no_class, path_info,
1263 "Current search path for finding object files.\n\
1264 $cwd in the path means the current working directory.\n\
1265 This path is equivalent to the $PATH shell variable. It is a list of\n\
1266 directories, separated by colons. These directories are searched to find\n\
1267 fully linked executable files and separately compiled object files as needed.", &showlist);
1268 c->completer = noop_completer;
1270 add_com ("attach", class_run, attach_command,
1271 "Attach to a process or file outside of GDB.\n\
1272 This command attaches to another target, of the same type as your last\n\
1273 `target' command (`info files' will show your target stack).\n\
1274 The command may take as argument a process id or a device file.\n\
1275 For a process id, you must have permission to send the process a signal,\n\
1276 and it must have the same effective uid as the debugger.\n\
1277 When using \"attach\", you should use the \"file\" command to specify\n\
1278 the program running in the process, and to load its symbol table.");
1280 add_com ("detach", class_run, detach_command,
1281 "Detach a process or file previously attached.\n\
1282 If a process, it is no longer traced, and it continues its execution. If you\n\
1283 were debugging a file, the file is closed and gdb no longer accesses it.");
1285 add_com ("signal", class_run, signal_command,
1286 "Continue program giving it signal specified by the argument.\n\
1287 An argument of \"0\" means continue program without giving it a signal.");
1289 add_com ("stepi", class_run, stepi_command,
1290 "Step one instruction exactly.\n\
1291 Argument N means do this N times (or till program stops for another reason).");
1292 add_com_alias ("si", "stepi", class_alias, 0);
1294 add_com ("nexti", class_run, nexti_command,
1295 "Step one instruction, but proceed through subroutine calls.\n\
1296 Argument N means do this N times (or till program stops for another reason).");
1297 add_com_alias ("ni", "nexti", class_alias, 0);
1299 add_com ("finish", class_run, finish_command,
1300 "Execute until selected stack frame returns.\n\
1301 Upon return, the value returned is printed and put in the value history.");
1303 add_com ("next", class_run, next_command,
1304 "Step program, proceeding through subroutine calls.\n\
1305 Like the \"step\" command as long as subroutine calls do not happen;\n\
1306 when they do, the call is treated as one instruction.\n\
1307 Argument N means do this N times (or till program stops for another reason).");
1308 add_com_alias ("n", "next", class_run, 1);
1310 add_com ("step", class_run, step_command,
1311 "Step program until it reaches a different source line.\n\
1312 Argument N means do this N times (or till program stops for another reason).");
1313 add_com_alias ("s", "step", class_run, 1);
1315 add_com ("until", class_run, until_command,
1316 "Execute until the program reaches a source line greater than the current\n\
1317 or a specified line or address or function (same args as break command).\n\
1318 Execution will also stop upon exit from the current stack frame.");
1319 add_com_alias ("u", "until", class_run, 1);
1321 add_com ("jump", class_run, jump_command,
1322 "Continue program being debugged at specified line or address.\n\
1323 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
1324 for an address to start at.");
1326 add_com ("continue", class_run, continue_command,
1327 "Continue program being debugged, after signal or breakpoint.\n\
1328 If proceeding from breakpoint, a number N may be used as an argument,\n\
1329 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
1330 the breakpoint won't break until the Nth time it is reached).");
1331 add_com_alias ("c", "cont", class_run, 1);
1332 add_com_alias ("fg", "cont", class_run, 1);
1334 add_com ("run", class_run, run_command,
1335 "Start debugged program. You may specify arguments to give it.\n\
1336 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
1337 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
1338 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
1339 To cancel previous arguments and run with no arguments,\n\
1340 use \"set args\" without arguments.");
1341 add_com_alias ("r", "run", class_run, 1);
1343 add_info ("registers", nofp_registers_info,
1344 "List of integer registers and their contents, for selected stack frame.\n\
1345 Register name as argument means describe only that register.");
1347 add_info ("all-registers", all_registers_info,
1348 "List of all registers and their contents, for selected stack frame.\n\
1349 Register name as argument means describe only that register.");
1351 add_info ("program", program_info,
1352 "Execution status of the program.");
1354 add_info ("float", float_info,
1355 "Print the status of the floating point unit\n");
1357 inferior_args = savestring ("", 1); /* Initially no args */
1358 inferior_environ = make_environ ();
1359 init_environ (inferior_environ);