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 proceed (stop_pc
, oursig
, 0);
498 /* Call breakpoint_auto_delete on the current contents of the bpstat
499 pointed to by arg (which is really a bpstat *). */
501 breakpoint_auto_delete_contents (arg
)
504 breakpoint_auto_delete (*(bpstat
*)arg
);
507 /* Execute a "stack dummy", a piece of code stored in the stack
508 by the debugger to be executed in the inferior.
510 To call: first, do PUSH_DUMMY_FRAME.
511 Then push the contents of the dummy. It should end with a breakpoint insn.
512 Then call here, passing address at which to start the dummy.
514 The contents of all registers are saved before the dummy frame is popped
515 and copied into the buffer BUFFER.
517 The dummy's frame is automatically popped whenever that break is hit.
518 If that is the first time the program stops, run_stack_dummy
519 returns to its caller with that frame already gone and returns 0.
520 Otherwise, run_stack-dummy returns 1 (the frame will eventually be popped
521 when we do hit that breakpoint). */
523 /* DEBUG HOOK: 4 => return instead of letting the stack dummy run. */
525 static int stack_dummy_testing
= 0;
528 run_stack_dummy (addr
, buffer
)
530 char buffer
[REGISTER_BYTES
];
532 struct cleanup
*old_cleanups
= make_cleanup (null_cleanup
, 0);
534 /* Now proceed, having reached the desired place. */
535 clear_proceed_status ();
536 if (stack_dummy_testing
& 4)
541 #ifdef CALL_DUMMY_BREAKPOINT_OFFSET
543 struct breakpoint
*bpt
;
544 struct symtab_and_line sal
;
546 #if CALL_DUMMY_LOCATION != AT_ENTRY_POINT
547 sal
.pc
= addr
- CALL_DUMMY_START_OFFSET
+ CALL_DUMMY_BREAKPOINT_OFFSET
;
549 sal
.pc
= CALL_DUMMY_ADDRESS ();
554 /* Set up a FRAME for the dummy frame so we can pass it to
555 set_momentary_breakpoint. We need to give the breakpoint a
556 frame in case there is only one copy of the dummy (e.g.
557 CALL_DUMMY_LOCATION == AFTER_TEXT_END). */
558 flush_cached_frames ();
559 set_current_frame (create_new_frame (read_fp (), sal
.pc
));
561 /* If defined, CALL_DUMMY_BREAKPOINT_OFFSET is where we need to put
562 a breakpoint instruction. If not, the call dummy already has the
563 breakpoint instruction in it.
565 addr is the address of the call dummy plus the CALL_DUMMY_START_OFFSET,
566 so we need to subtract the CALL_DUMMY_START_OFFSET. */
567 bpt
= set_momentary_breakpoint (sal
,
568 get_current_frame (),
570 bpt
->disposition
= delete;
572 /* If all error()s out of proceed ended up calling normal_stop (and
573 perhaps they should; it already does in the special case of error
574 out of resume()), then we wouldn't need this. */
575 make_cleanup (breakpoint_auto_delete_contents
, &stop_bpstat
);
577 #endif /* CALL_DUMMY_BREAKPOINT_OFFSET. */
579 proceed_to_finish
= 1; /* We want stop_registers, please... */
580 proceed (addr
, TARGET_SIGNAL_0
, 0);
582 discard_cleanups (old_cleanups
);
584 if (!stop_stack_dummy
)
587 /* On return, the stack dummy has been popped already. */
589 memcpy (buffer
, stop_registers
, sizeof stop_registers
);
593 /* Proceed until we reach a different source line with pc greater than
594 our current one or exit the function. We skip calls in both cases.
596 Note that eventually this command should probably be changed so
597 that only source lines are printed out when we hit the breakpoint
598 we set. This may involve changes to wait_for_inferior and the
599 proceed status code. */
603 until_next_command (from_tty
)
606 struct frame_info
*frame
;
609 struct symtab_and_line sal
;
611 clear_proceed_status ();
613 frame
= get_current_frame ();
615 /* Step until either exited from this function or greater
616 than the current line (if in symbolic section) or pc (if
620 func
= find_pc_function (pc
);
624 struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (pc
);
627 error ("Execution is not within a known function.");
629 step_range_start
= SYMBOL_VALUE_ADDRESS (msymbol
);
634 sal
= find_pc_line (pc
, 0);
636 step_range_start
= BLOCK_START (SYMBOL_BLOCK_VALUE (func
));
637 step_range_end
= sal
.end
;
641 step_frame_address
= FRAME_FP (frame
);
642 step_sp
= read_sp ();
644 step_multi
= 0; /* Only one call to proceed */
646 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 1);
650 until_command (arg
, from_tty
)
654 if (!target_has_execution
)
655 error ("The program is not running.");
657 until_break_command (arg
, from_tty
);
659 until_next_command (from_tty
);
662 /* "finish": Set a temporary breakpoint at the place
663 the selected frame will return to, then continue. */
666 finish_command (arg
, from_tty
)
670 struct symtab_and_line sal
;
671 register struct frame_info
*frame
;
672 register struct symbol
*function
;
673 struct breakpoint
*breakpoint
;
674 struct cleanup
*old_chain
;
677 error ("The \"finish\" command does not take any arguments.");
678 if (!target_has_execution
)
679 error ("The program is not running.");
680 if (selected_frame
== NULL
)
681 error ("No selected frame.");
683 frame
= get_prev_frame (selected_frame
);
685 error ("\"finish\" not meaningful in the outermost frame.");
687 clear_proceed_status ();
689 sal
= find_pc_line (frame
->pc
, 0);
692 breakpoint
= set_momentary_breakpoint (sal
, frame
, bp_finish
);
694 old_chain
= make_cleanup(delete_breakpoint
, breakpoint
);
696 /* Find the function we will return from. */
698 function
= find_pc_function (selected_frame
->pc
);
700 /* Print info on the selected frame, including level number
704 printf_filtered ("Run till exit from ");
705 print_stack_frame (selected_frame
, selected_frame_level
, 0);
708 proceed_to_finish
= 1; /* We want stop_registers, please... */
709 proceed ((CORE_ADDR
) -1, TARGET_SIGNAL_DEFAULT
, 0);
711 /* Did we stop at our breakpoint? */
712 if (bpstat_find_breakpoint(stop_bpstat
, breakpoint
) != NULL
715 struct type
*value_type
;
716 register value_ptr val
;
719 value_type
= TYPE_TARGET_TYPE (SYMBOL_TYPE (function
));
721 fatal ("internal: finish_command: function has no target type");
723 if (TYPE_CODE (value_type
) == TYPE_CODE_VOID
)
726 funcaddr
= BLOCK_START (SYMBOL_BLOCK_VALUE (function
));
728 val
= value_being_returned (value_type
, stop_registers
,
729 using_struct_return (value_of_variable (function
, NULL
),
732 BLOCK_GCC_COMPILED (SYMBOL_BLOCK_VALUE (function
))));
734 printf_filtered ("Value returned is $%d = ", record_latest_value (val
));
735 value_print (val
, gdb_stdout
, 0, Val_no_prettyprint
);
736 printf_filtered ("\n");
738 do_cleanups(old_chain
);
743 program_info (args
, from_tty
)
747 bpstat bs
= stop_bpstat
;
748 int num
= bpstat_num (&bs
);
750 if (!target_has_execution
)
752 printf_filtered ("The program being debugged is not being run.\n");
756 target_files_info ();
757 printf_filtered ("Program stopped at %s.\n",
758 local_hex_string((unsigned long) stop_pc
));
760 printf_filtered ("It stopped after being stepped.\n");
763 /* There may be several breakpoints in the same place, so this
764 isn't as strange as it seems. */
768 printf_filtered ("It stopped at a breakpoint that has since been deleted.\n");
770 printf_filtered ("It stopped at breakpoint %d.\n", num
);
771 num
= bpstat_num (&bs
);
774 else if (stop_signal
!= TARGET_SIGNAL_0
)
776 printf_filtered ("It stopped with signal %s, %s.\n",
777 target_signal_to_name (stop_signal
),
778 target_signal_to_string (stop_signal
));
782 printf_filtered ("Type \"info stack\" or \"info registers\" for more information.\n");
786 environment_info (var
, from_tty
)
792 register char *val
= get_in_environ (inferior_environ
, var
);
796 puts_filtered (" = ");
798 puts_filtered ("\n");
802 puts_filtered ("Environment variable \"");
804 puts_filtered ("\" not defined.\n");
809 register char **vector
= environ_vector (inferior_environ
);
812 puts_filtered (*vector
++);
813 puts_filtered ("\n");
819 set_environment_command (arg
, from_tty
)
823 register char *p
, *val
, *var
;
827 error_no_arg ("environment variable and value");
829 /* Find seperation between variable name and value */
830 p
= (char *) strchr (arg
, '=');
831 val
= (char *) strchr (arg
, ' ');
833 if (p
!= 0 && val
!= 0)
835 /* We have both a space and an equals. If the space is before the
836 equals, walk forward over the spaces til we see a nonspace
837 (possibly the equals). */
842 /* Now if the = is after the char following the spaces,
843 take the char following the spaces. */
847 else if (val
!= 0 && p
== 0)
851 error_no_arg ("environment variable to set");
853 if (p
== 0 || p
[1] == 0)
857 p
= arg
+ strlen (arg
); /* So that savestring below will work */
861 /* Not setting variable value to null */
863 while (*val
== ' ' || *val
== '\t')
867 while (p
!= arg
&& (p
[-1] == ' ' || p
[-1] == '\t')) p
--;
869 var
= savestring (arg
, p
- arg
);
872 printf_filtered ("Setting environment variable \"%s\" to null value.\n", var
);
873 set_in_environ (inferior_environ
, var
, "");
876 set_in_environ (inferior_environ
, var
, val
);
881 unset_environment_command (var
, from_tty
)
887 /* If there is no argument, delete all environment variables.
888 Ask for confirmation if reading from the terminal. */
889 if (!from_tty
|| query ("Delete all environment variables? "))
891 free_environ (inferior_environ
);
892 inferior_environ
= make_environ ();
896 unset_in_environ (inferior_environ
, var
);
899 /* Handle the execution path (PATH variable) */
901 static const char path_var_name
[] = "PATH";
905 path_info (args
, from_tty
)
909 puts_filtered ("Executable and object file path: ");
910 puts_filtered (get_in_environ (inferior_environ
, path_var_name
));
911 puts_filtered ("\n");
914 /* Add zero or more directories to the front of the execution path. */
917 path_command (dirname
, from_tty
)
924 exec_path
= strsave (get_in_environ (inferior_environ
, path_var_name
));
925 mod_path (dirname
, &exec_path
);
926 set_in_environ (inferior_environ
, path_var_name
, exec_path
);
929 path_info ((char *)NULL
, from_tty
);
932 /* The array of register names. */
934 char *reg_names
[] = REGISTER_NAMES
;
936 /* Print out the machine register regnum. If regnum is -1,
937 print all registers (fpregs == 1) or all non-float registers
940 For most machines, having all_registers_info() print the
941 register(s) one per line is good enough. If a different format
942 is required, (eg, for MIPS or Pyramid 90x, which both have
943 lots of regs), or there is an existing convention for showing
944 all the registers, define the macro DO_REGISTERS_INFO(regnum, fp)
945 to provide that format. */
947 #if !defined (DO_REGISTERS_INFO)
949 #define DO_REGISTERS_INFO(regnum, fp) do_registers_info(regnum, fp)
952 do_registers_info (regnum
, fpregs
)
957 int numregs
= ARCH_NUM_REGS
;
959 for (i
= 0; i
< numregs
; i
++)
961 char raw_buffer
[MAX_REGISTER_RAW_SIZE
];
962 char virtual_buffer
[MAX_REGISTER_VIRTUAL_SIZE
];
964 /* Decide between printing all regs, nonfloat regs, or specific reg. */
966 if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i
)) == TYPE_CODE_FLT
&& !fpregs
)
973 fputs_filtered (reg_names
[i
], gdb_stdout
);
974 print_spaces_filtered (15 - strlen (reg_names
[i
]), gdb_stdout
);
976 /* Get the data in raw format. */
977 if (read_relative_register_raw_bytes (i
, raw_buffer
))
979 printf_filtered ("Invalid register contents\n");
983 /* Convert raw data to virtual format if necessary. */
984 #ifdef REGISTER_CONVERTIBLE
985 if (REGISTER_CONVERTIBLE (i
))
987 REGISTER_CONVERT_TO_VIRTUAL (i
, REGISTER_VIRTUAL_TYPE (i
),
988 raw_buffer
, virtual_buffer
);
992 memcpy (virtual_buffer
, raw_buffer
,
993 REGISTER_VIRTUAL_SIZE (i
));
995 /* If virtual format is floating, print it that way, and in raw hex. */
996 if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i
)) == TYPE_CODE_FLT
)
1000 #ifdef INVALID_FLOAT
1001 if (INVALID_FLOAT (virtual_buffer
, REGISTER_VIRTUAL_SIZE (i
)))
1002 printf_filtered ("<invalid float>");
1005 val_print (REGISTER_VIRTUAL_TYPE (i
), virtual_buffer
, 0,
1006 gdb_stdout
, 0, 1, 0, Val_pretty_default
);
1008 printf_filtered ("\t(raw 0x");
1009 for (j
= 0; j
< REGISTER_RAW_SIZE (i
); j
++)
1010 printf_filtered ("%02x", (unsigned char)raw_buffer
[j
]);
1011 printf_filtered (")");
1014 /* FIXME! val_print probably can handle all of these cases now... */
1016 /* Else if virtual format is too long for printf,
1017 print in hex a byte at a time. */
1018 else if (REGISTER_VIRTUAL_SIZE (i
) > sizeof (long))
1021 printf_filtered ("0x");
1022 for (j
= 0; j
< REGISTER_VIRTUAL_SIZE (i
); j
++)
1023 printf_filtered ("%02x", (unsigned char)virtual_buffer
[j
]);
1025 /* Else print as integer in hex and in decimal. */
1028 val_print (REGISTER_VIRTUAL_TYPE (i
), raw_buffer
, 0,
1029 gdb_stdout
, 'x', 1, 0, Val_pretty_default
);
1030 printf_filtered ("\t");
1031 val_print (REGISTER_VIRTUAL_TYPE (i
), raw_buffer
, 0,
1032 gdb_stdout
, 0, 1, 0, Val_pretty_default
);
1035 /* The SPARC wants to print even-numbered float regs as doubles
1036 in addition to printing them as floats. */
1037 #ifdef PRINT_REGISTER_HOOK
1038 PRINT_REGISTER_HOOK (i
);
1041 printf_filtered ("\n");
1044 #endif /* no DO_REGISTERS_INFO. */
1047 registers_info (addr_exp
, fpregs
)
1051 int regnum
, numregs
;
1054 if (!target_has_registers
)
1055 error ("The program has no registers now.");
1059 DO_REGISTERS_INFO(-1, fpregs
);
1065 if (addr_exp
[0] == '$')
1068 while (*end
!= '\0' && *end
!= ' ' && *end
!= '\t')
1070 numregs
= ARCH_NUM_REGS
;
1071 for (regnum
= 0; regnum
< numregs
; regnum
++)
1072 if (!strncmp (addr_exp
, reg_names
[regnum
], end
- addr_exp
)
1073 && strlen (reg_names
[regnum
]) == end
- addr_exp
)
1075 if (*addr_exp
>= '0' && *addr_exp
<= '9')
1076 regnum
= atoi (addr_exp
); /* Take a number */
1077 if (regnum
>= numregs
) /* Bad name, or bad number */
1078 error ("%.*s: invalid register", end
- addr_exp
, addr_exp
);
1081 DO_REGISTERS_INFO(regnum
, fpregs
);
1084 while (*addr_exp
== ' ' || *addr_exp
== '\t')
1086 } while (*addr_exp
!= '\0');
1090 all_registers_info (addr_exp
, from_tty
)
1094 registers_info (addr_exp
, 1);
1098 nofp_registers_info (addr_exp
, from_tty
)
1102 registers_info (addr_exp
, 0);
1107 * Should save/restore the tty state since it might be that the
1108 * program to be debugged was started on this tty and it wants
1109 * the tty in some state other than what we want. If it's running
1110 * on another terminal or without a terminal, then saving and
1111 * restoring the tty state is a harmless no-op.
1112 * This only needs to be done if we are attaching to a process.
1117 takes a program started up outside of gdb and ``attaches'' to it.
1118 This stops it cold in its tracks and allows us to start debugging it.
1119 and wait for the trace-trap that results from attaching. */
1122 attach_command (args
, from_tty
)
1126 dont_repeat (); /* Not for the faint of heart */
1128 if (target_has_execution
)
1130 if (query ("A program is being debugged already. Kill it? "))
1133 error ("Not killed.");
1136 target_attach (args
, from_tty
);
1138 /* Set up the "saved terminal modes" of the inferior
1139 based on what modes we are starting it with. */
1140 target_terminal_init ();
1142 /* Install inferior's terminal modes. */
1143 target_terminal_inferior ();
1145 /* Set up execution context to know that we should return from
1146 wait_for_inferior as soon as the target reports a stop. */
1147 init_wait_for_inferior ();
1148 clear_proceed_status ();
1149 stop_soon_quietly
= 1;
1152 /* Mach 3 does not generate any traps when attaching to inferior,
1153 and to set up frames we can do this. */
1155 wait_for_inferior ();
1159 /* Add shared library symbols from the newly attached process, if any. */
1160 SOLIB_ADD ((char *)0, from_tty
, (struct target_ops
*)0);
1168 * takes a program previously attached to and detaches it.
1169 * The program resumes execution and will no longer stop
1170 * on signals, etc. We better not have left any breakpoints
1171 * in the program or it'll die when it hits one. For this
1172 * to work, it may be necessary for the process to have been
1173 * previously attached. It *might* work if the program was
1174 * started via the normal ptrace (PTRACE_TRACEME).
1178 detach_command (args
, from_tty
)
1182 dont_repeat (); /* Not for the faint of heart */
1183 target_detach (args
, from_tty
);
1188 float_info (addr_exp
, from_tty
)
1195 printf_filtered ("No floating point info available for this processor.\n");
1201 unset_command (args
, from_tty
)
1205 printf_filtered ("\"unset\" must be followed by the name of an unset subcommand.\n");
1206 help_list (unsetlist
, "unset ", -1, gdb_stdout
);
1210 _initialize_infcmd ()
1212 struct cmd_list_element
*c
;
1214 add_com ("tty", class_run
, tty_command
,
1215 "Set terminal for future runs of program being debugged.");
1218 (add_set_cmd ("args", class_run
, var_string_noescape
, (char *)&inferior_args
,
1220 "Set arguments to give program being debugged when it is started.\n\
1221 Follow this command with any number of args, to be passed to the program.",
1226 ("environment", no_class
, environment_info
,
1227 "The environment to give the program, or one variable's value.\n\
1228 With an argument VAR, prints the value of environment variable VAR to\n\
1229 give the program being debugged. With no arguments, prints the entire\n\
1230 environment to be given to the program.", &showlist
);
1231 c
->completer
= noop_completer
;
1233 add_prefix_cmd ("unset", no_class
, unset_command
,
1234 "Complement to certain \"set\" commands",
1235 &unsetlist
, "unset ", 0, &cmdlist
);
1237 c
= add_cmd ("environment", class_run
, unset_environment_command
,
1238 "Cancel environment variable VAR for the program.\n\
1239 This does not affect the program until the next \"run\" command.",
1241 c
->completer
= noop_completer
;
1243 c
= add_cmd ("environment", class_run
, set_environment_command
,
1244 "Set environment variable value to give the program.\n\
1245 Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\
1246 VALUES of environment variables are uninterpreted strings.\n\
1247 This does not affect the program until the next \"run\" command.",
1249 c
->completer
= noop_completer
;
1251 add_com ("path", class_files
, path_command
,
1252 "Add directory DIR(s) to beginning of search path for object files.\n\
1253 $cwd in the path means the current working directory.\n\
1254 This path is equivalent to the $PATH shell variable. It is a list of\n\
1255 directories, separated by colons. These directories are searched to find\n\
1256 fully linked executable files and separately compiled object files as needed.");
1258 c
= add_cmd ("paths", no_class
, path_info
,
1259 "Current search path for finding object files.\n\
1260 $cwd in the path means the current working directory.\n\
1261 This path is equivalent to the $PATH shell variable. It is a list of\n\
1262 directories, separated by colons. These directories are searched to find\n\
1263 fully linked executable files and separately compiled object files as needed.", &showlist
);
1264 c
->completer
= noop_completer
;
1266 add_com ("attach", class_run
, attach_command
,
1267 "Attach to a process or file outside of GDB.\n\
1268 This command attaches to another target, of the same type as your last\n\
1269 `target' command (`info files' will show your target stack).\n\
1270 The command may take as argument a process id or a device file.\n\
1271 For a process id, you must have permission to send the process a signal,\n\
1272 and it must have the same effective uid as the debugger.\n\
1273 When using \"attach\", you should use the \"file\" command to specify\n\
1274 the program running in the process, and to load its symbol table.");
1276 add_com ("detach", class_run
, detach_command
,
1277 "Detach a process or file previously attached.\n\
1278 If a process, it is no longer traced, and it continues its execution. If you\n\
1279 were debugging a file, the file is closed and gdb no longer accesses it.");
1281 add_com ("signal", class_run
, signal_command
,
1282 "Continue program giving it signal specified by the argument.\n\
1283 An argument of \"0\" means continue program without giving it a signal.");
1285 add_com ("stepi", class_run
, stepi_command
,
1286 "Step one instruction exactly.\n\
1287 Argument N means do this N times (or till program stops for another reason).");
1288 add_com_alias ("si", "stepi", class_alias
, 0);
1290 add_com ("nexti", class_run
, nexti_command
,
1291 "Step one instruction, but proceed through subroutine calls.\n\
1292 Argument N means do this N times (or till program stops for another reason).");
1293 add_com_alias ("ni", "nexti", class_alias
, 0);
1295 add_com ("finish", class_run
, finish_command
,
1296 "Execute until selected stack frame returns.\n\
1297 Upon return, the value returned is printed and put in the value history.");
1299 add_com ("next", class_run
, next_command
,
1300 "Step program, proceeding through subroutine calls.\n\
1301 Like the \"step\" command as long as subroutine calls do not happen;\n\
1302 when they do, the call is treated as one instruction.\n\
1303 Argument N means do this N times (or till program stops for another reason).");
1304 add_com_alias ("n", "next", class_run
, 1);
1306 add_com ("step", class_run
, step_command
,
1307 "Step program until it reaches a different source line.\n\
1308 Argument N means do this N times (or till program stops for another reason).");
1309 add_com_alias ("s", "step", class_run
, 1);
1311 add_com ("until", class_run
, until_command
,
1312 "Execute until the program reaches a source line greater than the current\n\
1313 or a specified line or address or function (same args as break command).\n\
1314 Execution will also stop upon exit from the current stack frame.");
1315 add_com_alias ("u", "until", class_run
, 1);
1317 add_com ("jump", class_run
, jump_command
,
1318 "Continue program being debugged at specified line or address.\n\
1319 Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\
1320 for an address to start at.");
1322 add_com ("continue", class_run
, continue_command
,
1323 "Continue program being debugged, after signal or breakpoint.\n\
1324 If proceeding from breakpoint, a number N may be used as an argument,\n\
1325 which means to set the ignore count of that breakpoint to N - 1 (so that\n\
1326 the breakpoint won't break until the Nth time it is reached).");
1327 add_com_alias ("c", "cont", class_run
, 1);
1328 add_com_alias ("fg", "cont", class_run
, 1);
1330 add_com ("run", class_run
, run_command
,
1331 "Start debugged program. You may specify arguments to give it.\n\
1332 Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\
1333 Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\
1334 With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\
1335 To cancel previous arguments and run with no arguments,\n\
1336 use \"set args\" without arguments.");
1337 add_com_alias ("r", "run", class_run
, 1);
1339 add_info ("registers", nofp_registers_info
,
1340 "List of integer registers and their contents, for selected stack frame.\n\
1341 Register name as argument means describe only that register.");
1343 add_info ("all-registers", all_registers_info
,
1344 "List of all registers and their contents, for selected stack frame.\n\
1345 Register name as argument means describe only that register.");
1347 add_info ("program", program_info
,
1348 "Execution status of the program.");
1350 add_info ("float", float_info
,
1351 "Print the status of the floating point unit\n");
1353 inferior_args
= savestring ("", 1); /* Initially no args */
1354 inferior_environ
= make_environ ();
1355 init_environ (inferior_environ
);