X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Finferior.h;h=e09cb0021a91c39f573ace7ebb46facd5a30c35d;hb=bfde72c275bff9d5be21cf51ba790cf38ecd0d59;hp=e875e9cc1865853be2518b52b56c5dc8f086e3a5;hpb=0ab7a791257080198a22f27a12563758f1e78c96;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/inferior.h b/gdb/inferior.h index e875e9cc18..e09cb0021a 100644 --- a/gdb/inferior.h +++ b/gdb/inferior.h @@ -1,13 +1,13 @@ /* Variables that describe the inferior process running under GDB: Where it is, why it stopped, and how to step it. - Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, - 1998, 1999, 2000, 2001 Free Software Foundation, Inc. + + Copyright (C) 1986-2015 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 + the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, @@ -16,70 +16,52 @@ 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. */ + along with this program. If not, see . */ #if !defined (INFERIOR_H) #define INFERIOR_H 1 +struct target_waitstatus; +struct frame_info; +struct ui_file; +struct type; struct gdbarch; struct regcache; +struct ui_out; +struct terminal_info; +struct target_desc_info; /* For bpstat. */ #include "breakpoint.h" -/* For enum target_signal. */ +/* For enum gdb_signal. */ #include "target.h" -/* Structure in which to save the status of the inferior. Create/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; - -extern struct inferior_status *save_inferior_status (int); - -extern void restore_inferior_status (struct inferior_status *); - -extern struct cleanup *make_cleanup_restore_inferior_status (struct inferior_status *); +/* For struct frame_id. */ +#include "frame.h" -extern void discard_inferior_status (struct inferior_status *); +#include "progspace.h" +#include "registry.h" -extern void write_inferior_status_register (struct inferior_status - *inf_status, int regno, - LONGEST val); +struct infcall_suspend_state; +struct infcall_control_state; -/* The -1 ptid, often used to indicate either an error condition - or a "don't care" condition, i.e, "run all threads." */ -extern ptid_t minus_one_ptid; +extern struct infcall_suspend_state *save_infcall_suspend_state (void); +extern struct infcall_control_state *save_infcall_control_state (void); -/* The null or zero ptid, often used to indicate no process. */ -extern ptid_t null_ptid; +extern void restore_infcall_suspend_state (struct infcall_suspend_state *); +extern void restore_infcall_control_state (struct infcall_control_state *); -/* Attempt to find and return an existing ptid with the given PID, LWP, - and TID components. If none exists, create a new one and return - that. */ -ptid_t ptid_build (int pid, long lwp, long tid); +extern struct cleanup *make_cleanup_restore_infcall_suspend_state + (struct infcall_suspend_state *); +extern struct cleanup *make_cleanup_restore_infcall_control_state + (struct infcall_control_state *); -/* Find/Create a ptid from just a pid. */ -ptid_t pid_to_ptid (int pid); +extern void discard_infcall_suspend_state (struct infcall_suspend_state *); +extern void discard_infcall_control_state (struct infcall_control_state *); -/* Fetch the pid (process id) component from a ptid. */ -int ptid_get_pid (ptid_t ptid); - -/* Fetch the lwp (lightweight process) component from a ptid. */ -long ptid_get_lwp (ptid_t ptid); - -/* Fetch the tid (thread id) component from a ptid. */ -long ptid_get_tid (ptid_t ptid); - -/* Compare two ptids to see if they are equal */ -extern int ptid_equal (ptid_t p1, ptid_t p2); +extern struct regcache * + get_infcall_suspend_state_regcache (struct infcall_suspend_state *); /* Save value of inferior_ptid so that it may be restored by a later call to do_cleanups(). Returns the struct cleanup @@ -90,464 +72,437 @@ extern void set_sigint_trap (void); extern void clear_sigint_trap (void); -extern void set_sigio_trap (void); +/* Set/get file name for default use for standard in/out in the inferior. */ -extern void clear_sigio_trap (void); - -/* File name for default use for standard in/out in the inferior. */ - -extern char *inferior_io_terminal; +extern void set_inferior_io_terminal (const char *terminal_name); +extern const char *get_inferior_io_terminal (void); /* Collected pid, tid, etc. of the debugged inferior. When there's - no inferior, PIDGET (inferior_ptid) will be 0. */ + no inferior, ptid_get_pid (inferior_ptid) will be 0. */ extern ptid_t inferior_ptid; -/* Is the inferior running right now, as a result of a 'run&', - 'continue&' etc command? This is used in asycn gdb to determine - whether a command that the user enters while the target is running - is allowed or not. */ -extern int target_executing; - -/* Are we simulating synchronous execution? This is used in async gdb - to implement the 'run', 'continue' etc commands, which will not - redisplay the prompt until the execution is actually over. */ -extern int sync_execution; - -/* This is only valid when inferior_ptid 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; - -extern void clear_proceed_status (void); - -extern void proceed (CORE_ADDR, enum target_signal, int); - -/* When set, stop the 'step' command if we enter a function which has - no line number information. The normal behavior is that we step - over such function. */ -extern int step_stop_if_no_debug; - -extern void kill_inferior (void); - extern void generic_mourn_inferior (void); -extern void terminal_ours (void); - -extern int run_stack_dummy (CORE_ADDR , struct regcache *); - -extern CORE_ADDR read_pc (void); - -extern CORE_ADDR read_pc_pid (ptid_t); - -extern CORE_ADDR generic_target_read_pc (ptid_t); +extern CORE_ADDR unsigned_pointer_to_address (struct gdbarch *gdbarch, + struct type *type, + const gdb_byte *buf); +extern void unsigned_address_to_pointer (struct gdbarch *gdbarch, + struct type *type, gdb_byte *buf, + CORE_ADDR addr); +extern CORE_ADDR signed_pointer_to_address (struct gdbarch *gdbarch, + struct type *type, + const gdb_byte *buf); +extern void address_to_signed_pointer (struct gdbarch *gdbarch, + struct type *type, gdb_byte *buf, + CORE_ADDR addr); -extern void write_pc (CORE_ADDR); +extern void reopen_exec_file (void); -extern void write_pc_pid (CORE_ADDR, ptid_t); +/* From misc files */ -extern void generic_target_write_pc (CORE_ADDR, ptid_t); +extern void default_print_registers_info (struct gdbarch *gdbarch, + struct ui_file *file, + struct frame_info *frame, + int regnum, int all); -extern CORE_ADDR read_sp (void); +/* Default implementation of gdbarch_print_float_info. Print + the values of all floating point registers. */ -extern CORE_ADDR generic_target_read_sp (void); +extern void default_print_float_info (struct gdbarch *gdbarch, + struct ui_file *file, + struct frame_info *frame, + const char *args); -extern void write_sp (CORE_ADDR); +extern void child_terminal_info (struct target_ops *self, const char *, int); -extern void generic_target_write_sp (CORE_ADDR); +extern void term_info (char *, int); -extern CORE_ADDR read_fp (void); +extern void child_terminal_ours (struct target_ops *self); -extern CORE_ADDR generic_target_read_fp (void); +extern void child_terminal_ours_for_output (struct target_ops *self); -extern CORE_ADDR unsigned_pointer_to_address (struct type *type, void *buf); +extern void child_terminal_inferior (struct target_ops *self); -extern void unsigned_address_to_pointer (struct type *type, void *buf, - CORE_ADDR addr); -extern CORE_ADDR signed_pointer_to_address (struct type *type, void *buf); -extern void address_to_signed_pointer (struct type *type, void *buf, - CORE_ADDR addr); +extern void child_terminal_init (struct target_ops *self); -extern void wait_for_inferior (void); +extern void child_terminal_init_with_pgrp (int pgrp); -extern void fetch_inferior_event (void *); +/* From fork-child.c */ -extern void init_wait_for_inferior (void); +extern int fork_inferior (char *, char *, char **, + void (*)(void), + void (*)(int), void (*)(void), char *, + void (*)(const char *, + char * const *, char * const *)); -extern void close_exec_file (void); -extern void reopen_exec_file (void); +extern void startup_inferior (int); -/* The `resume' routine should only be called in special circumstances. - Normally, use `proceed', which handles a lot of bookkeeping. */ +extern char *construct_inferior_arguments (int, char **); -extern void resume (int, enum target_signal); +/* From infcmd.c */ -/* From misc files */ +extern void post_create_inferior (struct target_ops *, int); -extern void default_print_registers_info (struct gdbarch *gdbarch, - struct ui_file *file, - struct frame_info *frame, - int regnum, int all); - -extern void store_inferior_registers (int); +extern void attach_command (char *, int); -extern void fetch_inferior_registers (int); +extern char *get_inferior_args (void); -extern void solib_create_inferior_hook (void); +extern void set_inferior_args (char *); -extern void child_terminal_info (char *, int); +extern void set_inferior_args_vector (int, char **); -extern void term_info (char *, int); +extern void registers_info (char *, int); -extern void terminal_ours_for_output (void); +extern void continue_1 (int all_threads); -extern void terminal_inferior (void); +extern void interrupt_target_1 (int all_threads); -extern void terminal_init_inferior (void); +extern void delete_longjmp_breakpoint_cleanup (void *arg); -extern void terminal_init_inferior_with_pgrp (int pgrp); +extern void detach_command (char *, int); -/* From infptrace.c or infttrace.c */ +extern void notice_new_inferior (ptid_t, int, int); -extern int attach (int); +extern struct value *get_return_value (struct value *function, + struct type *value_type); -#if !defined(REQUIRE_ATTACH) -#define REQUIRE_ATTACH attach -#endif +/* Prepare for execution command. TARGET is the target that will run + the command. BACKGROUND determines whether this is a foreground + (synchronous) or background (asynchronous) command. */ -#if !defined(REQUIRE_DETACH) -#define REQUIRE_DETACH(pid,siggnal) detach (siggnal) -#endif +extern void prepare_execution_command (struct target_ops *target, + int background); -extern void detach (int); +/* Whether to start up the debuggee under a shell. -/* PTRACE method of waiting for inferior process. */ -int ptrace_wait (ptid_t, int *); + If startup-with-shell is set, GDB's "run" will attempt to start up + the debuggee under a shell. -extern void child_resume (ptid_t, int, enum target_signal); + This is in order for argument-expansion to occur. E.g., -#ifndef PTRACE_ARG3_TYPE -#define PTRACE_ARG3_TYPE int /* Correct definition for most systems. */ -#endif + (gdb) run * -extern int call_ptrace (int, int, PTRACE_ARG3_TYPE, int); + The "*" gets expanded by the shell into a list of files. -extern void pre_fork_inferior (void); + While this is a nice feature, it may be handy to bypass the shell + in some cases. To disable this feature, do "set startup-with-shell + false". -/* From procfs.c */ + The catch-exec traps expected during start-up will be one more if + the target is started up with a shell. */ +extern int startup_with_shell; -extern int proc_iterate_over_mappings (int (*)(int, CORE_ADDR)); +/* Address at which inferior stopped. */ -extern ptid_t procfs_first_available (void); +extern CORE_ADDR stop_pc; -/* From fork-child.c */ +/* Nonzero if stopped due to completion of a stack dummy routine. */ -extern void fork_inferior (char *, char *, char **, - void (*)(void), - void (*)(int), void (*)(void), char *); +extern enum stop_stack_kind stop_stack_dummy; +/* Nonzero if program stopped due to a random (unexpected) signal in + inferior process. */ -extern void clone_and_follow_inferior (int, int *); +extern int stopped_by_random_signal; -extern void startup_inferior (int); +/* STEP_OVER_ALL means step over all subroutine calls. + STEP_OVER_UNDEBUGGABLE means step over calls to undebuggable functions. + STEP_OVER_NONE means don't step over any subroutine calls. */ -extern char *construct_inferior_arguments (struct gdbarch *, int, char **); +enum step_over_calls_kind + { + STEP_OVER_NONE, + STEP_OVER_ALL, + STEP_OVER_UNDEBUGGABLE + }; -/* From inflow.c */ +/* Anything but NO_STOP_QUIETLY means we expect a trap and the caller + will handle it themselves. STOP_QUIETLY is used when running in + the shell before the child program has been exec'd and when running + through shared library loading. STOP_QUIETLY_REMOTE is used when + setting up a remote connection; it is like STOP_QUIETLY_NO_SIGSTOP + except that there is no need to hide a signal. */ + +/* STOP_QUIETLY_NO_SIGSTOP is used to handle a tricky situation with attach. + When doing an attach, the kernel stops the debuggee with a SIGSTOP. + On newer GNU/Linux kernels (>= 2.5.61) the handling of SIGSTOP for + a ptraced process has changed. Earlier versions of the kernel + would ignore these SIGSTOPs, while now SIGSTOP is treated like any + other signal, i.e. it is not muffled. + + If the gdb user does a 'continue' after the 'attach', gdb passes + the global variable stop_signal (which stores the signal from the + attach, SIGSTOP) to the ptrace(PTRACE_CONT,...) call. This is + problematic, because the kernel doesn't ignore such SIGSTOP + now. I.e. it is reported back to gdb, which in turn presents it + back to the user. + + To avoid the problem, we use STOP_QUIETLY_NO_SIGSTOP, which allows + gdb to clear the value of stop_signal after the attach, so that it + is not passed back down to the kernel. */ + +enum stop_kind + { + NO_STOP_QUIETLY = 0, + STOP_QUIETLY, + STOP_QUIETLY_REMOTE, + STOP_QUIETLY_NO_SIGSTOP + }; -extern void new_tty_prefork (char *); + +/* Possible values for gdbarch_call_dummy_location. */ +#define ON_STACK 1 +#define AT_ENTRY_POINT 4 -extern int gdb_has_a_terminal (void); +/* Number of traps that happen between exec'ing the shell to run an + inferior and when we finally get to the inferior code, not counting + the exec for the shell. This is 1 on all supported + implementations. */ +#define START_INFERIOR_TRAPS_EXPECTED 1 + +struct private_inferior; + +/* Inferior process specific part of `struct infcall_control_state'. + + Inferior thread counterpart is `struct thread_control_state'. */ + +struct inferior_control_state +{ + /* See the definition of stop_kind above. */ + enum stop_kind stop_soon; +}; + +/* GDB represents the state of each program execution with an object + called an inferior. An inferior typically corresponds to a process + but is more general and applies also to targets that do not have a + notion of processes. Each run of an executable creates a new + inferior, as does each attachment to an existing process. + Inferiors have unique internal identifiers that are different from + target process ids. Each inferior may in turn have multiple + threads running in it. */ + +struct inferior +{ + /* Pointer to next inferior in singly-linked list of inferiors. */ + struct inferior *next; + + /* Convenient handle (GDB inferior id). Unique across all + inferiors. */ + int num; + + /* Actual target inferior id, usually, a process id. This matches + the ptid_t.pid member of threads of this inferior. */ + int pid; + /* True if the PID was actually faked by GDB. */ + int fake_pid_p; + + /* State of GDB control of inferior process execution. + See `struct inferior_control_state'. */ + struct inferior_control_state control; + + /* True if this was an auto-created inferior, e.g. created from + following a fork; false, if this inferior was manually added by + the user, and we should not attempt to prune it + automatically. */ + int removable; + + /* The address space bound to this inferior. */ + struct address_space *aspace; + + /* The program space bound to this inferior. */ + struct program_space *pspace; + + /* The arguments string to use when running. */ + char *args; + + /* The size of elements in argv. */ + int argc; + + /* The vector version of arguments. If ARGC is nonzero, + then we must compute ARGS from this (via the target). + This is always coming from main's argv and therefore + should never be freed. */ + char **argv; -/* From infrun.c */ + /* The name of terminal device to use for I/O. */ + char *terminal; -extern void start_remote (void); + /* Environment to use for running inferior, + in format described in environ.h. */ + struct gdb_environ *environment; -extern void normal_stop (void); + /* Nonzero if this child process was attached rather than + forked. */ + int attach_flag; -extern int signal_stop_state (int); + /* If this inferior is a vfork child, then this is the pointer to + its vfork parent, if GDB is still attached to it. */ + struct inferior *vfork_parent; -extern int signal_print_state (int); + /* If this process is a vfork parent, this is the pointer to the + child. Since a vfork parent is left frozen by the kernel until + the child execs or exits, a process can only have one vfork child + at a given time. */ + struct inferior *vfork_child; -extern int signal_pass_state (int); + /* True if this inferior should be detached when it's vfork sibling + exits or execs. */ + int pending_detach; -extern int signal_stop_update (int, int); + /* True if this inferior is a vfork parent waiting for a vfork child + not under our control to be done with the shared memory region, + either by exiting or execing. */ + int waiting_for_vfork_done; -extern int signal_print_update (int, int); + /* True if we're in the process of detaching from this inferior. */ + int detaching; -extern int signal_pass_update (int, int); + /* What is left to do for an execution command after any thread of + this inferior stops. For continuations associated with a + specific thread, see `struct thread_info'. */ + struct continuation *continuations; -extern void get_last_target_status(ptid_t *ptid, - struct target_waitstatus *status); + /* Private data used by the target vector implementation. */ + struct private_inferior *priv; -/* From infcmd.c */ + /* HAS_EXIT_CODE is true if the inferior exited with an exit code. + In this case, the EXIT_CODE field is also valid. */ + int has_exit_code; + LONGEST exit_code; -extern void tty_command (char *, int); + /* Default flags to pass to the symbol reading functions. These are + used whenever a new objfile is created. The valid values come + from enum symfile_add_flags. */ + int symfile_flags; -extern void attach_command (char *, int); + /* Info about an inferior's target description (if it's fetched; the + user supplied description's filename, if any; etc.). */ + struct target_desc_info *tdesc_info; -extern char *get_inferior_args (void); + /* The architecture associated with the inferior through the + connection to the target. -extern char *set_inferior_args (char *); + The architecture vector provides some information that is really + a property of the inferior, accessed through a particular target: + ptrace operations; the layout of certain RSP packets; the + solib_ops vector; etc. To differentiate architecture accesses to + per-inferior/target properties from + per-thread/per-frame/per-objfile properties, accesses to + per-inferior/target properties should be made through + this gdbarch. */ + struct gdbarch *gdbarch; -extern void set_inferior_args_vector (int, char **); + /* Per inferior data-pointers required by other GDB modules. */ + REGISTRY_FIELDS; +}; -/* Last signal that the inferior received (why it stopped). */ +/* Keep a registry of per-inferior data-pointers required by other GDB + modules. */ -extern enum target_signal stop_signal; +DECLARE_REGISTRY (inferior); -/* Address at which inferior stopped. */ +/* Create an empty inferior list, or empty the existing one. */ +extern void init_inferior_list (void); -extern CORE_ADDR stop_pc; +/* Add an inferior to the inferior list, print a message that a new + inferior is found, and return the pointer to the new inferior. + Caller may use this pointer to initialize the private inferior + data. */ +extern struct inferior *add_inferior (int pid); -/* Chain containing status of breakpoint(s) that we have stopped at. */ +/* Same as add_inferior, but don't print new inferior notifications to + the CLI. */ +extern struct inferior *add_inferior_silent (int pid); -extern bpstat stop_bpstat; +extern void delete_inferior (struct inferior *todel); -/* Flag indicating that a command has proceeded the inferior past the - current breakpoint. */ +/* Delete an existing inferior list entry, due to inferior detaching. */ +extern void detach_inferior (int pid); -extern int breakpoint_proceeded; +extern void exit_inferior (int pid); -/* Nonzero if stopped due to a step command. */ +extern void exit_inferior_silent (int pid); -extern int stop_step; +extern void exit_inferior_num_silent (int num); -/* Nonzero if stopped due to completion of a stack dummy routine. */ +extern void inferior_appeared (struct inferior *inf, int pid); -extern int stop_stack_dummy; +/* Get rid of all inferiors. */ +extern void discard_all_inferiors (void); -/* Nonzero if program stopped due to a random (unexpected) signal in - inferior process. */ +/* Translate the integer inferior id (GDB's homegrown id, not the system's) + into a "pid" (which may be overloaded with extra inferior information). */ +extern int gdb_inferior_id_to_pid (int); -extern int stopped_by_random_signal; +/* Translate a target 'pid' into the integer inferior id (GDB's + homegrown id, not the system's). */ +extern int pid_to_gdb_inferior_id (int pid); -/* 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. +/* Boolean test for an already-known pid. */ +extern int in_inferior_list (int pid); - 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.). */ +/* Boolean test for an already-known inferior id (GDB's homegrown id, + not the system's). */ +extern int valid_gdb_inferior_id (int num); -extern CORE_ADDR step_range_start; /* Inclusive */ -extern CORE_ADDR step_range_end; /* Exclusive */ +/* Search function to lookup an inferior by target 'pid'. */ +extern struct inferior *find_inferior_pid (int pid); -/* 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. */ +/* Search function to lookup an inferior whose pid is equal to 'ptid.pid'. */ +extern struct inferior *find_inferior_ptid (ptid_t ptid); -extern CORE_ADDR step_frame_address; +/* Search function to lookup an inferior by GDB 'num'. */ +extern struct inferior *find_inferior_id (int num); -/* Our notion of the current stack pointer. */ +/* Find an inferior bound to PSPACE, giving preference to the current + inferior. */ +extern struct inferior * + find_inferior_for_program_space (struct program_space *pspace); -extern CORE_ADDR step_sp; +/* Inferior iterator function. -/* 1 means step over all subroutine calls. - -1 means step over calls to undebuggable functions. */ + Calls a callback function once for each inferior, so long as the + callback function returns false. If the callback function returns + true, the iteration will end and the current inferior will be + returned. This can be useful for implementing a search for a + inferior with arbitrary attributes, or for applying some operation + to every inferior. -enum step_over_calls_kind - { - STEP_OVER_NONE, - STEP_OVER_ALL, - STEP_OVER_UNDEBUGGABLE - }; + It is safe to delete the iterated inferior from the callback. */ +extern struct inferior *iterate_over_inferiors (int (*) (struct inferior *, + void *), + void *); -extern enum step_over_calls_kind step_over_calls; +/* Returns true if the inferior list is not empty. */ +extern int have_inferiors (void); -/* If stepping, nonzero means step count is > 1 - so don't print frame next time inferior stops - if it stops due to stepping. */ +/* Returns true if there are any live inferiors in the inferior list + (not cores, not executables, real live processes). */ +extern int have_live_inferiors (void); -extern int step_multi; +/* Return a pointer to the current inferior. It is an error to call + this if there is no current inferior. */ +extern struct inferior *current_inferior (void); -/* 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 void set_current_inferior (struct inferior *); -extern int stop_soon_quietly; +extern struct cleanup *save_current_inferior (void); -/* Nonzero if proceed is being used for a "finish" command or a similar - situation when stop_registers should be saved. */ +/* Traverse all inferiors. */ -extern int proceed_to_finish; +#define ALL_INFERIORS(I) \ + for ((I) = inferior_list; (I); (I) = (I)->next) -/* 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 struct inferior *inferior_list; -extern struct regcache *stop_registers; +/* Prune away automatically added inferiors that aren't required + anymore. */ +extern void prune_inferiors (void); -/* Nonzero if the child process in inferior_ptid was attached rather - than forked. */ +extern int number_of_inferiors (void); -extern int attach_flag; - -/* 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 +extern struct inferior *add_inferior_with_spaces (void); -#if !defined (USE_GENERIC_DUMMY_FRAMES) -#define USE_GENERIC_DUMMY_FRAMES 0 -#endif - -#if !defined (CALL_DUMMY_LOCATION) -#define CALL_DUMMY_LOCATION ON_STACK -#endif /* No CALL_DUMMY_LOCATION. */ - -#if !defined (CALL_DUMMY_ADDRESS) -#define CALL_DUMMY_ADDRESS() (internal_error (__FILE__, __LINE__, "CALL_DUMMY_ADDRESS"), 0) -#endif -#if !defined (CALL_DUMMY_START_OFFSET) -#define CALL_DUMMY_START_OFFSET (internal_error (__FILE__, __LINE__, "CALL_DUMMY_START_OFFSET"), 0) -#endif -#if !defined (CALL_DUMMY_BREAKPOINT_OFFSET) -#define CALL_DUMMY_BREAKPOINT_OFFSET_P (0) -#define CALL_DUMMY_BREAKPOINT_OFFSET (internal_error (__FILE__, __LINE__, "CALL_DUMMY_BREAKPOINT_OFFSET"), 0) -#endif -#if !defined CALL_DUMMY_BREAKPOINT_OFFSET_P -#define CALL_DUMMY_BREAKPOINT_OFFSET_P (1) -#endif -#if !defined (CALL_DUMMY_LENGTH) -#define CALL_DUMMY_LENGTH (internal_error (__FILE__, __LINE__, "CALL_DUMMY_LENGTH"), 0) -#endif - -#if defined (CALL_DUMMY_STACK_ADJUST) -#if !defined (CALL_DUMMY_STACK_ADJUST_P) -#define CALL_DUMMY_STACK_ADJUST_P (1) -#endif -#endif -#if !defined (CALL_DUMMY_STACK_ADJUST) -#define CALL_DUMMY_STACK_ADJUST (internal_error (__FILE__, __LINE__, "CALL_DUMMY_STACK_ADJUST"), 0) -#endif -#if !defined (CALL_DUMMY_STACK_ADJUST_P) -#define CALL_DUMMY_STACK_ADJUST_P (0) -#endif - -/* FIXME: cagney/2000-04-17: gdbarch should manage this. The default - shouldn't be necessary. */ - -#if !defined (CALL_DUMMY_P) -#if defined (CALL_DUMMY) -#define CALL_DUMMY_P 1 -#else -#define CALL_DUMMY_P 0 -#endif -#endif - -#if !defined PUSH_DUMMY_FRAME -#define PUSH_DUMMY_FRAME (internal_error (__FILE__, __LINE__, "PUSH_DUMMY_FRAME"), 0) -#endif - -#if !defined FIX_CALL_DUMMY -#define FIX_CALL_DUMMY(a1,a2,a3,a4,a5,a6,a7) (internal_error (__FILE__, __LINE__, "FIX_CALL_DUMMY"), 0) -#endif - -#if !defined STORE_STRUCT_RETURN -#define STORE_STRUCT_RETURN(a1,a2) (internal_error (__FILE__, __LINE__, "STORE_STRUCT_RETURN"), 0) -#endif - - -/* Are we in a call dummy? */ - -extern int pc_in_call_dummy_before_text_end (CORE_ADDR pc, CORE_ADDR sp, - CORE_ADDR frame_address); -#if !GDB_MULTI_ARCH -#if !defined (PC_IN_CALL_DUMMY) && CALL_DUMMY_LOCATION == BEFORE_TEXT_END -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) pc_in_call_dummy_before_text_end (pc, sp, frame_address) -#endif /* Before text_end. */ -#endif - -extern int pc_in_call_dummy_after_text_end (CORE_ADDR pc, CORE_ADDR sp, - CORE_ADDR frame_address); -#if !GDB_MULTI_ARCH -#if !defined (PC_IN_CALL_DUMMY) && CALL_DUMMY_LOCATION == AFTER_TEXT_END -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) pc_in_call_dummy_after_text_end (pc, sp, frame_address) -#endif -#endif - -extern int pc_in_call_dummy_on_stack (CORE_ADDR pc, CORE_ADDR sp, - CORE_ADDR frame_address); -#if !GDB_MULTI_ARCH -#if !defined (PC_IN_CALL_DUMMY) && CALL_DUMMY_LOCATION == ON_STACK -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) pc_in_call_dummy_on_stack (pc, sp, frame_address) -#endif -#endif - -extern int pc_in_call_dummy_at_entry_point (CORE_ADDR pc, CORE_ADDR sp, - CORE_ADDR frame_address); -#if !GDB_MULTI_ARCH -#if !defined (PC_IN_CALL_DUMMY) && CALL_DUMMY_LOCATION == AT_ENTRY_POINT -#define PC_IN_CALL_DUMMY(pc, sp, frame_address) pc_in_call_dummy_at_entry_point (pc, sp, frame_address) -#endif -#endif - -/* 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 -#if !defined(START_INFERIOR_TRAPS_EXPECTED) -#define START_INFERIOR_TRAPS_EXPECTED 2 -#endif #endif /* !defined (INFERIOR_H) */