1 /* Variables that describe the inferior process running under GDB:
2 Where it is, why it stopped, and how to step it.
3 Copyright 1986, 1989, 1992 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #if !defined (INFERIOR_H)
24 /* For symtab_and_line */
28 #include "breakpoint.h"
34 * Structure in which to save the status of the inferior. Save
35 * through "save_inferior_status", restore through
36 * "restore_inferior_status".
37 * This pair of routines should be called around any transfer of
38 * control to the inferior which you don't want showing up in your
41 struct inferior_status
{
45 FRAME_ADDR stop_frame_address
;
49 int stopped_by_random_signal
;
51 CORE_ADDR step_range_start
;
52 CORE_ADDR step_range_end
;
53 FRAME_ADDR step_frame_address
;
55 CORE_ADDR step_resume_break_address
;
57 int stop_soon_quietly
;
58 FRAME_ADDR selected_frame_address
;
60 char stop_registers
[REGISTER_BYTES
];
61 int breakpoint_proceeded
;
62 int restore_stack_info
;
63 int proceed_to_finish
;
67 save_inferior_status
PARAMS ((struct inferior_status
*, int));
70 restore_inferior_status
PARAMS ((struct inferior_status
*));
72 /* File name for default use for standard in/out in the inferior. */
74 extern char *inferior_io_terminal
;
76 /* Pid of our debugged inferior, or 0 if no inferior now. */
78 extern int inferior_pid
;
80 /* Character array containing an image of the inferior programs' registers. */
82 extern char registers
[];
84 /* Array of validity bits (one per register). Nonzero at position XXX_REGNUM
85 means that `registers' contains a valid copy of inferior register XXX. */
87 extern char register_valid
[NUM_REGS
];
90 clear_proceed_status
PARAMS ((void));
93 proceed
PARAMS ((CORE_ADDR
, int, int));
96 kill_inferior
PARAMS ((void));
99 generic_mourn_inferior
PARAMS ((void));
102 terminal_ours
PARAMS ((void));
105 run_stack_dummy
PARAMS ((CORE_ADDR
, char [REGISTER_BYTES
]));
108 read_pc
PARAMS ((void));
111 write_pc
PARAMS ((CORE_ADDR
));
114 wait_for_inferior
PARAMS ((void));
117 init_wait_for_inferior
PARAMS ((void));
120 close_exec_file
PARAMS ((void));
123 reopen_exec_file
PARAMS ((void));
126 resume
PARAMS ((int, int));
128 /* From misc files */
131 store_inferior_registers
PARAMS ((int));
134 fetch_inferior_registers
PARAMS ((int));
137 solib_create_inferior_hook
PARAMS ((void));
140 child_terminal_info
PARAMS ((char *, int));
143 term_info
PARAMS ((char *, int));
146 terminal_ours_for_output
PARAMS ((void));
149 terminal_inferior
PARAMS ((void));
152 terminal_init_inferior
PARAMS ((void));
154 /* From infptrace.c or procfs.c */
157 attach
PARAMS ((int));
160 detach
PARAMS ((int));
163 child_resume
PARAMS ((int, int));
165 #ifndef PTRACE_ARG3_TYPE
166 #define PTRACE_ARG3_TYPE int /* Correct definition for most systems. */
170 call_ptrace
PARAMS ((int, int, PTRACE_ARG3_TYPE
, int));
177 proc_iterate_over_mappings
PARAMS ((int (*) (int, CORE_ADDR
)));
180 proc_wait
PARAMS ((int *));
183 inferior_proc_init
PARAMS ((int));
186 proc_signal_handling_change
PARAMS ((void));
189 proc_set_exec_trap
PARAMS ((void));
196 new_tty_prefork
PARAMS ((char *));
201 start_remote
PARAMS ((void));
204 normal_stop
PARAMS ((void));
207 signal_stop_state
PARAMS ((int));
210 signal_print_state
PARAMS ((int));
213 signal_pass_state
PARAMS ((int));
218 tty_command
PARAMS ((char *, int));
221 attach_command
PARAMS ((char *, int));
223 /* Last signal that the inferior received (why it stopped). */
225 extern int stop_signal
;
227 /* Address at which inferior stopped. */
229 extern CORE_ADDR stop_pc
;
231 /* Stack frame when program stopped. */
233 extern FRAME_ADDR stop_frame_address
;
235 /* Chain containing status of breakpoint(s) that we have stopped at. */
237 extern bpstat stop_bpstat
;
239 /* Flag indicating that a command has proceeded the inferior past the
240 current breakpoint. */
242 extern int breakpoint_proceeded
;
244 /* Nonzero if stopped due to a step command. */
246 extern int stop_step
;
248 /* Nonzero if stopped due to completion of a stack dummy routine. */
250 extern int stop_stack_dummy
;
252 /* Nonzero if program stopped due to a random (unexpected) signal in
255 extern int stopped_by_random_signal
;
257 /* Range to single step within.
258 If this is nonzero, respond to a single-step signal
259 by continuing to step if the pc is in this range. */
261 extern CORE_ADDR step_range_start
; /* Inclusive */
262 extern CORE_ADDR step_range_end
; /* Exclusive */
264 /* Stack frame address as of when stepping command was issued.
265 This is how we know when we step into a subroutine call,
266 and how to set the frame for the breakpoint used to step out. */
268 extern FRAME_ADDR step_frame_address
;
270 /* 1 means step over all subroutine calls.
271 -1 means step over calls to undebuggable functions. */
273 extern int step_over_calls
;
275 /* If stepping, nonzero means step count is > 1
276 so don't print frame next time inferior stops
277 if it stops due to stepping. */
279 extern int step_multi
;
281 /* Nonzero means expecting a trap and caller will handle it themselves.
282 It is used after attach, due to attaching to a process;
283 when running in the shell before the child program has been exec'd;
284 and when running some kinds of remote stuff (FIXME?). */
286 extern int stop_soon_quietly
;
288 /* Nonzero if proceed is being used for a "finish" command or a similar
289 situation when stop_registers should be saved. */
291 extern int proceed_to_finish
;
293 /* Save register contents here when about to pop a stack dummy frame,
294 if-and-only-if proceed_to_finish is set.
295 Thus this contains the return value from the called function (assuming
296 values are returned in a register). */
298 extern char stop_registers
[REGISTER_BYTES
];
300 /* Nonzero if pc has been changed by the debugger
301 since the inferior stopped. */
303 extern int pc_changed
;
305 /* Nonzero if the child process in inferior_pid was attached rather
308 extern int attach_flag
;
310 /* Possible values for CALL_DUMMY_LOCATION. */
312 #define BEFORE_TEXT_END 2
313 #define AFTER_TEXT_END 3
315 #if !defined (CALL_DUMMY_LOCATION)
316 #define CALL_DUMMY_LOCATION ON_STACK
317 #endif /* No CALL_DUMMY_LOCATION. */
319 /* Are we in a call dummy? The code below which allows DECR_PC_AFTER_BREAK
320 below is for infrun.c, which may give the macro a pc without that
322 #if !defined (PC_IN_CALL_DUMMY)
323 #if CALL_DUMMY_LOCATION == BEFORE_TEXT_END
324 extern CORE_ADDR text_end
;
325 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
326 ((pc) >= text_end - CALL_DUMMY_LENGTH \
327 && (pc) < text_end + DECR_PC_AFTER_BREAK)
328 #else /* Not before text_end. */
329 #if CALL_DUMMY_LOCATION == AFTER_TEXT_END
330 extern CORE_ADDR text_end
;
331 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
333 && (pc) < text_end + CALL_DUMMY_LENGTH + DECR_PC_AFTER_BREAK)
334 #else /* On stack. */
335 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
336 ((sp) INNER_THAN (pc) && (pc) INNER_THAN (frame_address))
337 #endif /* On stack. */
338 #endif /* Not before text_end. */
339 #endif /* No PC_IN_CALL_DUMMY. */
341 #endif /* !defined (INFERIOR_H) */