gdb/inferior.h

   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.
   4
   5 This file is part of GDB.
   6
   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.
  11
  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.
  16
  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.  */
  20
  21 #if !defined (INFERIOR_H)
  22 #define INFERIOR_H 1
  23
  24 /* For symtab_and_line */
  25 #include "symtab.h"
  26
  27 /* For bpstat.  */
  28 #include "breakpoint.h"
  29
  30 /* For FRAME_ADDR.  */
  31 #include "frame.h"
  32
  33 /*
  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
  39  * control variables.
  40  */
  41 struct inferior_status {
  42   int pc_changed;
  43   int stop_signal;
  44   int stop_pc;
  45   FRAME_ADDR stop_frame_address;
  46   bpstat stop_bpstat;
  47   int stop_step;
  48   int stop_stack_dummy;
  49   int stopped_by_random_signal;
  50   int trap_expected;
  51   CORE_ADDR step_range_start;
  52   CORE_ADDR step_range_end;
  53   FRAME_ADDR step_frame_address;
  54   int step_over_calls;
  55   CORE_ADDR step_resume_break_address;
  56   int stop_after_trap;
  57   int stop_soon_quietly;
  58   FRAME_ADDR selected_frame_address;
  59   int selected_level;
  60   char stop_registers[REGISTER_BYTES];
  61   int breakpoint_proceeded;
  62   int restore_stack_info;
  63   int proceed_to_finish;
  64 };
  65
  66 extern void
  67 save_inferior_status PARAMS ((struct inferior_status *, int));
  68
  69 extern void
  70 restore_inferior_status PARAMS ((struct inferior_status *));
  71
  72 /* File name for default use for standard in/out in the inferior.  */
  73
  74 extern char *inferior_io_terminal;
  75
  76 /* Pid of our debugged inferior, or 0 if no inferior now.  */
  77
  78 extern int inferior_pid;
  79
  80 /* Character array containing an image of the inferior programs' registers.  */
  81
  82 extern char registers[];
  83
  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.  */
  86
  87 extern char register_valid[NUM_REGS];
  88
  89 extern void
  90 clear_proceed_status PARAMS ((void));
  91
  92 extern void
  93 proceed PARAMS ((CORE_ADDR, int, int));
  94
  95 extern void
  96 kill_inferior PARAMS ((void));
  97
  98 extern void
  99 generic_mourn_inferior PARAMS ((void));
 100
 101 extern void
 102 terminal_ours PARAMS ((void));
 103
 104 extern void
 105 run_stack_dummy PARAMS ((CORE_ADDR, char [REGISTER_BYTES]));
 106
 107 extern CORE_ADDR
 108 read_pc PARAMS ((void));
 109
 110 extern void
 111 write_pc PARAMS ((CORE_ADDR));
 112
 113 extern void
 114 wait_for_inferior PARAMS ((void));
 115
 116 extern void
 117 init_wait_for_inferior PARAMS ((void));
 118
 119 extern void
 120 close_exec_file PARAMS ((void));
 121
 122 extern void
 123 reopen_exec_file PARAMS ((void));
 124
 125 extern void
 126 resume PARAMS ((int, int));
 127
 128 /* From misc files */
 129
 130 extern void
 131 store_inferior_registers PARAMS ((int));
 132
 133 extern void
 134 fetch_inferior_registers PARAMS ((int));
 135
 136 extern void
 137 solib_create_inferior_hook PARAMS ((void));
 138
 139 extern void
 140 child_terminal_info PARAMS ((char *, int));
 141
 142 extern void
 143 term_info PARAMS ((char *, int));
 144
 145 extern void
 146 terminal_ours_for_output PARAMS ((void));
 147
 148 extern void
 149 terminal_inferior PARAMS ((void));
 150
 151 extern void
 152 terminal_init_inferior PARAMS ((void));
 153
 154 /* From infptrace.c or procfs.c */
 155
 156 extern int
 157 attach PARAMS ((int));
 158
 159 void
 160 detach PARAMS ((int));
 161
 162 extern void
 163 child_resume PARAMS ((int, int));
 164
 165 #ifndef PTRACE_ARG3_TYPE
 166 #define PTRACE_ARG3_TYPE int    /* Correct definition for most systems. */
 167 #endif
 168
 169 extern int
 170 call_ptrace PARAMS ((int, int, PTRACE_ARG3_TYPE, int));
 171
 172 /* From procfs.c */
 173
 174 #ifdef USE_PROC_FS
 175
 176 extern int
 177 proc_iterate_over_mappings PARAMS ((int (*) (int, CORE_ADDR)));
 178
 179 extern int
 180 proc_wait PARAMS ((int *));
 181
 182 extern void
 183 inferior_proc_init PARAMS ((int));
 184
 185 extern void
 186 proc_signal_handling_change PARAMS ((void));
 187
 188 extern void
 189 proc_set_exec_trap PARAMS ((void));
 190
 191 #endif
 192
 193 /* From inflow.c */
 194
 195 extern void
 196 new_tty_prefork PARAMS ((char *));
 197
 198 /* From infrun.c */
 199
 200 extern void
 201 start_remote PARAMS ((void));
 202
 203 extern void
 204 normal_stop PARAMS ((void));
 205
 206 extern int
 207 signal_stop_state PARAMS ((int));
 208
 209 extern int
 210 signal_print_state PARAMS ((int));
 211
 212 extern int
 213 signal_pass_state PARAMS ((int));
 214
 215 /* From infcmd.c */
 216
 217 extern void
 218 tty_command PARAMS ((char *, int));
 219
 220 extern void
 221 attach_command PARAMS ((char *, int));
 222
 223 /* Last signal that the inferior received (why it stopped).  */
 224
 225 extern int stop_signal;
 226
 227 /* Address at which inferior stopped.  */
 228
 229 extern CORE_ADDR stop_pc;
 230
 231 /* Stack frame when program stopped.  */
 232
 233 extern FRAME_ADDR stop_frame_address;
 234
 235 /* Chain containing status of breakpoint(s) that we have stopped at.  */
 236
 237 extern bpstat stop_bpstat;
 238
 239 /* Flag indicating that a command has proceeded the inferior past the
 240    current breakpoint.  */
 241
 242 extern int breakpoint_proceeded;
 243
 244 /* Nonzero if stopped due to a step command.  */
 245
 246 extern int stop_step;
 247
 248 /* Nonzero if stopped due to completion of a stack dummy routine.  */
 249
 250 extern int stop_stack_dummy;
 251
 252 /* Nonzero if program stopped due to a random (unexpected) signal in
 253    inferior process.  */
 254
 255 extern int stopped_by_random_signal;
 256
 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.  */
 260
 261 extern CORE_ADDR step_range_start; /* Inclusive */
 262 extern CORE_ADDR step_range_end; /* Exclusive */
 263
 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.  */
 267
 268 extern FRAME_ADDR step_frame_address;
 269
 270 /* 1 means step over all subroutine calls.
 271    -1 means step over calls to undebuggable functions.  */
 272
 273 extern int step_over_calls;
 274
 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.  */
 278
 279 extern int step_multi;
 280
 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?).  */
 285
 286 extern int stop_soon_quietly;
 287
 288 /* Nonzero if proceed is being used for a "finish" command or a similar
 289    situation when stop_registers should be saved.  */
 290
 291 extern int proceed_to_finish;
 292
 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).  */
 297
 298 extern char stop_registers[REGISTER_BYTES];
 299
 300 /* Nonzero if pc has been changed by the debugger
 301    since the inferior stopped.  */
 302
 303 extern int pc_changed;
 304
 305 /* Nonzero if the child process in inferior_pid was attached rather
 306    than forked.  */
 307
 308 extern int attach_flag;
 309 \f
 310 /* Possible values for CALL_DUMMY_LOCATION.  */
 311 #define ON_STACK 1
 312 #define BEFORE_TEXT_END 2
 313 #define AFTER_TEXT_END 3
 314
 315 #if !defined (CALL_DUMMY_LOCATION)
 316 #define CALL_DUMMY_LOCATION ON_STACK
 317 #endif /* No CALL_DUMMY_LOCATION.  */
 318
 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
 321    subtracted out.  */
 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) \
 332   ((pc) >= text_end   \
 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.  */
 340
 341 #endif  /* !defined (INFERIOR_H) */