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 /* The `resume' routine should only be called in special circumstances.
 126    Normally, use `proceed', which handles a lot of bookkeeping.  */
 127 extern void
 128 resume PARAMS ((int, int));
 129
 130 /* From misc files */
 131
 132 extern void
 133 store_inferior_registers PARAMS ((int));
 134
 135 extern void
 136 fetch_inferior_registers PARAMS ((int));
 137
 138 extern void
 139 solib_create_inferior_hook PARAMS ((void));
 140
 141 extern void
 142 child_terminal_info PARAMS ((char *, int));
 143
 144 extern void
 145 term_info PARAMS ((char *, int));
 146
 147 extern void
 148 terminal_ours_for_output PARAMS ((void));
 149
 150 extern void
 151 terminal_inferior PARAMS ((void));
 152
 153 extern void
 154 terminal_init_inferior PARAMS ((void));
 155
 156 /* From infptrace.c */
 157
 158 extern int
 159 attach PARAMS ((int));
 160
 161 void
 162 detach PARAMS ((int));
 163
 164 extern void
 165 child_resume PARAMS ((int, int));
 166
 167 #ifndef PTRACE_ARG3_TYPE
 168 #define PTRACE_ARG3_TYPE int    /* Correct definition for most systems. */
 169 #endif
 170
 171 extern int
 172 call_ptrace PARAMS ((int, int, PTRACE_ARG3_TYPE, int));
 173
 174 /* From procfs.c */
 175
 176 extern int
 177 proc_iterate_over_mappings PARAMS ((int (*) (int, CORE_ADDR)));
 178
 179 extern void
 180 proc_signal_handling_change PARAMS ((void));
 181
 182 /* From fork-child.c */
 183
 184 extern void
 185 fork_inferior PARAMS ((char *, char *, char **,
 186                        void (*) (void),
 187                        void (*) (int)));
 188
 189 /* From inflow.c */
 190
 191 extern void
 192 new_tty_prefork PARAMS ((char *));
 193
 194 /* From infrun.c */
 195
 196 extern void
 197 start_remote PARAMS ((void));
 198
 199 extern void
 200 normal_stop PARAMS ((void));
 201
 202 extern int
 203 signal_stop_state PARAMS ((int));
 204
 205 extern int
 206 signal_print_state PARAMS ((int));
 207
 208 extern int
 209 signal_pass_state PARAMS ((int));
 210
 211 /* From infcmd.c */
 212
 213 extern void
 214 tty_command PARAMS ((char *, int));
 215
 216 extern void
 217 attach_command PARAMS ((char *, int));
 218
 219 /* Last signal that the inferior received (why it stopped).  */
 220
 221 extern int stop_signal;
 222
 223 /* Address at which inferior stopped.  */
 224
 225 extern CORE_ADDR stop_pc;
 226
 227 /* Stack frame when program stopped.  */
 228
 229 extern FRAME_ADDR stop_frame_address;
 230
 231 /* Chain containing status of breakpoint(s) that we have stopped at.  */
 232
 233 extern bpstat stop_bpstat;
 234
 235 /* Flag indicating that a command has proceeded the inferior past the
 236    current breakpoint.  */
 237
 238 extern int breakpoint_proceeded;
 239
 240 /* Nonzero if stopped due to a step command.  */
 241
 242 extern int stop_step;
 243
 244 /* Nonzero if stopped due to completion of a stack dummy routine.  */
 245
 246 extern int stop_stack_dummy;
 247
 248 /* Nonzero if program stopped due to a random (unexpected) signal in
 249    inferior process.  */
 250
 251 extern int stopped_by_random_signal;
 252
 253 /* Range to single step within.
 254    If this is nonzero, respond to a single-step signal
 255    by continuing to step if the pc is in this range.  */
 256
 257 extern CORE_ADDR step_range_start; /* Inclusive */
 258 extern CORE_ADDR step_range_end; /* Exclusive */
 259
 260 /* Stack frame address as of when stepping command was issued.
 261    This is how we know when we step into a subroutine call,
 262    and how to set the frame for the breakpoint used to step out.  */
 263
 264 extern FRAME_ADDR step_frame_address;
 265
 266 /* 1 means step over all subroutine calls.
 267    -1 means step over calls to undebuggable functions.  */
 268
 269 extern int step_over_calls;
 270
 271 /* If stepping, nonzero means step count is > 1
 272    so don't print frame next time inferior stops
 273    if it stops due to stepping.  */
 274
 275 extern int step_multi;
 276
 277 /* Nonzero means expecting a trap and caller will handle it themselves.
 278    It is used after attach, due to attaching to a process;
 279    when running in the shell before the child program has been exec'd;
 280    and when running some kinds of remote stuff (FIXME?).  */
 281
 282 extern int stop_soon_quietly;
 283
 284 /* Nonzero if proceed is being used for a "finish" command or a similar
 285    situation when stop_registers should be saved.  */
 286
 287 extern int proceed_to_finish;
 288
 289 /* Save register contents here when about to pop a stack dummy frame,
 290    if-and-only-if proceed_to_finish is set.
 291    Thus this contains the return value from the called function (assuming
 292    values are returned in a register).  */
 293
 294 extern char stop_registers[REGISTER_BYTES];
 295
 296 /* Nonzero if pc has been changed by the debugger
 297    since the inferior stopped.  */
 298
 299 extern int pc_changed;
 300
 301 /* Nonzero if the child process in inferior_pid was attached rather
 302    than forked.  */
 303
 304 extern int attach_flag;
 305 \f
 306 /* Possible values for CALL_DUMMY_LOCATION.  */
 307 #define ON_STACK 1
 308 #define BEFORE_TEXT_END 2
 309 #define AFTER_TEXT_END 3
 310
 311 #if !defined (CALL_DUMMY_LOCATION)
 312 #define CALL_DUMMY_LOCATION ON_STACK
 313 #endif /* No CALL_DUMMY_LOCATION.  */
 314
 315 /* Are we in a call dummy?  The code below which allows DECR_PC_AFTER_BREAK
 316    below is for infrun.c, which may give the macro a pc without that
 317    subtracted out.  */
 318 #if !defined (PC_IN_CALL_DUMMY)
 319 #if CALL_DUMMY_LOCATION == BEFORE_TEXT_END
 320 extern CORE_ADDR text_end;
 321 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
 322   ((pc) >= text_end - CALL_DUMMY_LENGTH         \
 323    && (pc) <= text_end + DECR_PC_AFTER_BREAK)
 324 #else /* Not before text_end.  */
 325 #if CALL_DUMMY_LOCATION == AFTER_TEXT_END
 326 extern CORE_ADDR text_end;
 327 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
 328   ((pc) >= text_end   \
 329    && (pc) <= text_end + CALL_DUMMY_LENGTH + DECR_PC_AFTER_BREAK)
 330 #else /* On stack.  */
 331 #define PC_IN_CALL_DUMMY(pc, sp, frame_address) \
 332   ((sp) INNER_THAN (pc) && (pc) INNER_THAN (frame_address))
 333 #endif /* On stack.  */
 334 #endif /* Not before text_end.  */
 335 #endif /* No PC_IN_CALL_DUMMY.  */
 336
 337 #endif  /* !defined (INFERIOR_H) */