diff options
Diffstat (limited to 'gdb/inferior.h')
| -rw-r--r-- | gdb/inferior.h | 471 |
1 files changed, 0 insertions, 471 deletions
diff --git a/gdb/inferior.h b/gdb/inferior.h deleted file mode 100644 index 5b72c92..0000000 --- a/gdb/inferior.h +++ /dev/null @@ -1,471 +0,0 @@ -/* Variables that describe the inferior process running under GDB: - Where it is, why it stopped, and how to step it. - Copyright 1986, 1989, 1992, 1996, 1998 Free Software Foundation, Inc. - -This file is part of GDB. - -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ - -#if !defined (INFERIOR_H) -#define INFERIOR_H 1 - -/* For bpstat. */ -#include "breakpoint.h" - -/* For enum target_signal. */ -#include "target.h" - -/* Structure in which to save the status of the inferior. Save - through "save_inferior_status", restore through - "restore_inferior_status". - This pair of routines should be called around any transfer of - control to the inferior which you don't want showing up in your - control variables. */ - -struct inferior_status { - enum target_signal stop_signal; - CORE_ADDR stop_pc; - bpstat stop_bpstat; - int stop_step; - int stop_stack_dummy; - int stopped_by_random_signal; - int trap_expected; - CORE_ADDR step_range_start; - CORE_ADDR step_range_end; - CORE_ADDR step_frame_address; - int step_over_calls; - CORE_ADDR step_resume_break_address; - int stop_after_trap; - int stop_soon_quietly; - CORE_ADDR selected_frame_address; - char stop_registers[REGISTER_BYTES]; - - /* These are here because if call_function_by_hand has written some - registers and then decides to call error(), we better not have changed - any registers. */ - char registers[REGISTER_BYTES]; - - int selected_level; - int breakpoint_proceeded; - int restore_stack_info; - int proceed_to_finish; -}; - -/* This macro gives the number of registers actually in use by the - inferior. This may be less than the total number of registers, - perhaps depending on the actual CPU in use or program being run. */ - -#ifndef ARCH_NUM_REGS -#define ARCH_NUM_REGS NUM_REGS -#endif - -extern void save_inferior_status PARAMS ((struct inferior_status *, int)); - -extern void restore_inferior_status PARAMS ((struct inferior_status *)); - -extern void set_sigint_trap PARAMS ((void)); - -extern void clear_sigint_trap PARAMS ((void)); - -extern void set_sigio_trap PARAMS ((void)); - -extern void clear_sigio_trap PARAMS ((void)); - -/* File name for default use for standard in/out in the inferior. */ - -extern char *inferior_io_terminal; - -/* Pid of our debugged inferior, or 0 if no inferior now. */ - -extern int inferior_pid; - -/* This is only valid when inferior_pid is non-zero. - - If this is 0, then exec events should be noticed and responded to - by the debugger (i.e., be reported to the user). - - If this is > 0, then that many subsequent exec events should be - ignored (i.e., not be reported to the user). - */ -extern int inferior_ignoring_startup_exec_events; - -/* This is only valid when inferior_ignoring_startup_exec_events is - zero. - - Some targets (stupidly) report more than one exec event per actual - call to an event() system call. If only the last such exec event - need actually be noticed and responded to by the debugger (i.e., - be reported to the user), then this is the number of "leading" - exec events which should be ignored. - */ -extern int inferior_ignoring_leading_exec_events; - -/* Inferior environment. */ - -extern struct environ *inferior_environ; - -/* Character array containing an image of the inferior programs' registers. */ - -extern char registers[]; - -/* Array of validity bits (one per register). Nonzero at position XXX_REGNUM - means that `registers' contains a valid copy of inferior register XXX. - -1 if register value is not available. */ - -extern SIGNED char register_valid[NUM_REGS]; - -extern void clear_proceed_status PARAMS ((void)); - -extern void proceed PARAMS ((CORE_ADDR, enum target_signal, int)); - -extern void kill_inferior PARAMS ((void)); - -extern void generic_mourn_inferior PARAMS ((void)); - -extern void terminal_ours PARAMS ((void)); - -extern int run_stack_dummy PARAMS ((CORE_ADDR, char [REGISTER_BYTES])); - -extern CORE_ADDR read_pc PARAMS ((void)); - -extern CORE_ADDR read_pc_pid PARAMS ((int)); - -extern void write_pc PARAMS ((CORE_ADDR)); - -extern void write_pc_pid PARAMS ((CORE_ADDR, int)); - -extern CORE_ADDR read_sp PARAMS ((void)); - -extern void write_sp PARAMS ((CORE_ADDR)); - -extern CORE_ADDR read_fp PARAMS ((void)); - -extern void write_fp PARAMS ((CORE_ADDR)); - -extern void wait_for_inferior PARAMS ((void)); - -extern void init_wait_for_inferior PARAMS ((void)); - -extern void close_exec_file PARAMS ((void)); - -extern void reopen_exec_file PARAMS ((void)); - -/* The `resume' routine should only be called in special circumstances. - Normally, use `proceed', which handles a lot of bookkeeping. */ - -extern void resume PARAMS ((int, enum target_signal)); - -/* From misc files */ - -extern void store_inferior_registers PARAMS ((int)); - -extern void fetch_inferior_registers PARAMS ((int)); - -extern void solib_create_inferior_hook PARAMS ((void)); - -extern void child_terminal_info PARAMS ((char *, int)); - -extern void term_info PARAMS ((char *, int)); - -extern void terminal_ours_for_output PARAMS ((void)); - -extern void terminal_inferior PARAMS ((void)); - -extern void terminal_init_inferior PARAMS ((void)); - -extern void terminal_init_inferior_with_pgrp PARAMS ((int pgrp)); - -/* From infptrace.c or infttrace.c */ - -extern int attach PARAMS ((int)); - -#if !defined(REQUIRE_ATTACH) -#define REQUIRE_ATTACH attach -#endif - -#if !defined(REQUIRE_DETACH) -#define REQUIRE_DETACH(pid,siggnal) detach (siggnal) -#endif - -extern void detach PARAMS ((int)); - -int proc_wait PARAMS ((int, int *)); - -extern void child_resume PARAMS ((int, int, enum target_signal)); - -#ifndef PTRACE_ARG3_TYPE -#define PTRACE_ARG3_TYPE int /* Correct definition for most systems. */ -#endif - -extern int call_ptrace PARAMS ((int, int, PTRACE_ARG3_TYPE, int)); - -extern void pre_fork_inferior PARAMS ((void)); - -/* From procfs.c */ - -extern int proc_iterate_over_mappings PARAMS ((int (*) (int, CORE_ADDR))); - -extern int procfs_first_available PARAMS ((void)); - -extern int procfs_get_pid_fd PARAMS ((int)); - -/* From fork-child.c */ - -extern void fork_inferior PARAMS ((char *, char *, char **, - void (*) (void), - void (*) (int), - void (*) (void), - char *)); - - -extern void -clone_and_follow_inferior PARAMS ((int, int *)); - -extern void startup_inferior PARAMS ((int)); - -/* From inflow.c */ - -extern void new_tty_prefork PARAMS ((char *)); - -extern int gdb_has_a_terminal PARAMS ((void)); - -/* From infrun.c */ - -extern void start_remote PARAMS ((void)); - -extern void normal_stop PARAMS ((void)); - -extern int signal_stop_state PARAMS ((int)); - -extern int signal_print_state PARAMS ((int)); - -extern int signal_pass_state PARAMS ((int)); - -/* From infcmd.c */ - -extern void tty_command PARAMS ((char *, int)); - -extern void attach_command PARAMS ((char *, int)); - -/* Last signal that the inferior received (why it stopped). */ - -extern enum target_signal stop_signal; - -/* Address at which inferior stopped. */ - -extern CORE_ADDR stop_pc; - -/* Chain containing status of breakpoint(s) that we have stopped at. */ - -extern bpstat stop_bpstat; - -/* Flag indicating that a command has proceeded the inferior past the - current breakpoint. */ - -extern int breakpoint_proceeded; - -/* Nonzero if stopped due to a step command. */ - -extern int stop_step; - -/* Nonzero if stopped due to completion of a stack dummy routine. */ - -extern int stop_stack_dummy; - -/* Nonzero if program stopped due to a random (unexpected) signal in - inferior process. */ - -extern int stopped_by_random_signal; - -/* Range to single step within. - If this is nonzero, respond to a single-step signal - by continuing to step if the pc is in this range. - - If step_range_start and step_range_end are both 1, it means to step for - a single instruction (FIXME: it might clean up wait_for_inferior in a - minor way if this were changed to the address of the instruction and - that address plus one. But maybe not.). */ - -extern CORE_ADDR step_range_start; /* Inclusive */ -extern CORE_ADDR step_range_end; /* Exclusive */ - -/* Stack frame address as of when stepping command was issued. - This is how we know when we step into a subroutine call, - and how to set the frame for the breakpoint used to step out. */ - -extern CORE_ADDR step_frame_address; - -/* Our notion of the current stack pointer. */ - -extern CORE_ADDR step_sp; - -/* 1 means step over all subroutine calls. - -1 means step over calls to undebuggable functions. */ - -extern int step_over_calls; - -/* If stepping, nonzero means step count is > 1 - so don't print frame next time inferior stops - if it stops due to stepping. */ - -extern int step_multi; - -/* Nonzero means expecting a trap and caller will handle it themselves. - It is used after attach, due to attaching to a process; - when running in the shell before the child program has been exec'd; - and when running some kinds of remote stuff (FIXME?). */ - -extern int stop_soon_quietly; - -/* Nonzero if proceed is being used for a "finish" command or a similar - situation when stop_registers should be saved. */ - -extern int proceed_to_finish; - -/* Save register contents here when about to pop a stack dummy frame, - if-and-only-if proceed_to_finish is set. - Thus this contains the return value from the called function (assuming - values are returned in a register). */ - -extern char stop_registers[REGISTER_BYTES]; - -/* Nonzero if the child process in inferior_pid was attached rather - than forked. */ - -extern int attach_flag; - -/* Sigtramp is a routine that the kernel calls (which then calls the - signal handler). On most machines it is a library routine that - is linked into the executable. - - This macro, given a program counter value and the name of the - function in which that PC resides (which can be null if the - name is not known), returns nonzero if the PC and name show - that we are in sigtramp. - - On most machines just see if the name is sigtramp (and if we have - no name, assume we are not in sigtramp). */ -#if !defined (IN_SIGTRAMP) -# if defined (SIGTRAMP_START) -# define IN_SIGTRAMP(pc, name) \ - ((pc) >= SIGTRAMP_START(pc) \ - && (pc) < SIGTRAMP_END(pc) \ - ) -# else -# define IN_SIGTRAMP(pc, name) \ - (name && STREQ ("_sigtramp", name)) -# endif -#endif - -/* Possible values for CALL_DUMMY_LOCATION. */ -#define ON_STACK 1 -#define BEFORE_TEXT_END 2 -#define AFTER_TEXT_END 3 -#define AT_ENTRY_POINT 4 - -#if !defined (CALL_DUMMY_LOCATION) -#define CALL_DUMMY_LOCATION ON_STACK -#endif /* No CALL_DUMMY_LOCATION. */ - -/* Are we in a call dummy? The code below which allows DECR_PC_AFTER_BREAK - below is for infrun.c, which may give the macro a pc without that - subtracted out. */ -#if !defined (PC_IN_CALL_DUMMY) -#if CALL_DUMMY_LOCATION == BEFORE_TEXT_END -extern CORE_ADDR text_end; -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) \ - ((pc) >= text_end - CALL_DUMMY_LENGTH \ - && (pc) <= text_end + DECR_PC_AFTER_BREAK) -#endif /* Before text_end. */ - -#if CALL_DUMMY_LOCATION == AFTER_TEXT_END -extern CORE_ADDR text_end; -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) \ - ((pc) >= text_end \ - && (pc) <= text_end + CALL_DUMMY_LENGTH + DECR_PC_AFTER_BREAK) -#endif /* After text_end. */ - -#if CALL_DUMMY_LOCATION == ON_STACK -/* Is the PC in a call dummy? SP and FRAME_ADDRESS are the bottom and - top of the stack frame which we are checking, where "bottom" and - "top" refer to some section of memory which contains the code for - the call dummy. Calls to this macro assume that the contents of - SP_REGNUM and FP_REGNUM (or the saved values thereof), respectively, - are the things to pass. - - This won't work on the 29k, where SP_REGNUM and FP_REGNUM don't - have that meaning, but the 29k doesn't use ON_STACK. This could be - fixed by generalizing this scheme, perhaps by passing in a frame - and adding a few fields, at least on machines which need them for - PC_IN_CALL_DUMMY. - - Something simpler, like checking for the stack segment, doesn't work, - since various programs (threads implementations, gcc nested function - stubs, etc) may either allocate stack frames in another segment, or - allocate other kinds of code on the stack. */ - -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) \ - (INNER_THAN ((sp), (pc)) && (frame_address != 0) && INNER_THAN ((pc), (frame_address))) -#endif /* On stack. */ - -#if CALL_DUMMY_LOCATION == AT_ENTRY_POINT -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) \ - ((pc) >= CALL_DUMMY_ADDRESS () \ - && (pc) <= (CALL_DUMMY_ADDRESS () + DECR_PC_AFTER_BREAK)) -#endif /* At entry point. */ -#endif /* No PC_IN_CALL_DUMMY. */ - -/* It's often not enough for our clients to know whether the PC is merely - somewhere within the call dummy. They may need to know whether the - call dummy has actually completed. (For example, wait_for_inferior - wants to know when it should truly stop because the call dummy has - completed. If we're single-stepping because of slow watchpoints, - then we may find ourselves stopped at the entry of the call dummy, - and want to continue stepping until we reach the end.) - - Note that this macro is intended for targets (like HP-UX) which - require more than a single breakpoint in their call dummies, and - therefore cannot use the CALL_DUMMY_BREAKPOINT_OFFSET mechanism. - - If a target does define CALL_DUMMY_BREAKPOINT_OFFSET, then this - default implementation of CALL_DUMMY_HAS_COMPLETED is sufficient. - Else, a target may wish to supply an implementation that works in - the presense of multiple breakpoints in its call dummy. - */ -#if !defined(CALL_DUMMY_HAS_COMPLETED) -#define CALL_DUMMY_HAS_COMPLETED(pc, sp, frame_address) \ - PC_IN_CALL_DUMMY((pc), (sp), (frame_address)) -#endif - -/* If STARTUP_WITH_SHELL is set, GDB's "run" - will attempts to start up the debugee under a shell. - This is in order for argument-expansion to occur. E.g., - (gdb) run * - The "*" gets expanded by the shell into a list of files. - While this is a nice feature, it turns out to interact badly - with some of the catch-fork/catch-exec features we have added. - In particular, if the shell does any fork/exec's before - the exec of the target program, that can confuse GDB. - To disable this feature, set STARTUP_WITH_SHELL to 0. - To enable this feature, set STARTUP_WITH_SHELL to 1. - The catch-exec traps expected during start-up will - be 1 if target is not started up with a shell, 2 if it is. - - RT - If you disable this, you need to decrement - START_INFERIOR_TRAPS_EXPECTED in tm.h. */ -#define STARTUP_WITH_SHELL 1 - -#endif /* !defined (INFERIOR_H) */ - |