X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Finferior.h;h=c6fb9d326a3ecfcb95f8c00d17d3635b74957bed;hb=14f819c8c5f7d080e5eea9256f0ec7453aac750e;hp=c793936801bc2141c9d86ad23ec5c5261f342270;hpb=9898f801b47255d0f1dee8c7a2238369e34adcd1;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/inferior.h b/gdb/inferior.h index c793936801..c6fb9d326a 100644 --- a/gdb/inferior.h +++ b/gdb/inferior.h @@ -1,9 +1,7 @@ /* Variables that describe the inferior process running under GDB: Where it is, why it stopped, and how to step it. - Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, - 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009 - Free Software Foundation, Inc. + Copyright (C) 1986-2017 Free Software Foundation, Inc. This file is part of GDB. @@ -31,77 +29,45 @@ struct gdbarch; struct regcache; struct ui_out; struct terminal_info; +struct target_desc_info; +struct gdb_environ; +struct continuation; +struct inferior; /* For bpstat. */ #include "breakpoint.h" -/* For enum target_signal. */ +/* For enum gdb_signal. */ #include "target.h" /* For struct frame_id. */ #include "frame.h" -/* Two structures are used to record inferior state. +#include "progspace.h" +#include "registry.h" - inferior_thread_state contains state about the program itself like its - registers and any signal it received when it last stopped. - This state must be restored regardless of how the inferior function call - ends (either successfully, or after it hits a breakpoint or signal) - if the program is to properly continue where it left off. +#include "symfile-add-flags.h" +#include "common/refcounted-object.h" - inferior_status contains state regarding gdb's control of the inferior - itself like stepping control. It also contains session state like the - user's currently selected frame. +struct infcall_suspend_state; +struct infcall_control_state; - Call these routines around hand called functions, including function calls - in conditional breakpoints for example. */ +extern struct infcall_suspend_state *save_infcall_suspend_state (void); +extern struct infcall_control_state *save_infcall_control_state (void); -struct inferior_thread_state; -struct inferior_status; +extern void restore_infcall_suspend_state (struct infcall_suspend_state *); +extern void restore_infcall_control_state (struct infcall_control_state *); -extern struct inferior_thread_state *save_inferior_thread_state (void); -extern struct inferior_status *save_inferior_status (void); +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 *); -extern void restore_inferior_thread_state (struct inferior_thread_state *); -extern void restore_inferior_status (struct inferior_status *); +extern void discard_infcall_suspend_state (struct infcall_suspend_state *); +extern void discard_infcall_control_state (struct infcall_control_state *); -extern struct cleanup *make_cleanup_restore_inferior_thread_state (struct inferior_thread_state *); -extern struct cleanup *make_cleanup_restore_inferior_status (struct inferior_status *); - -extern void discard_inferior_thread_state (struct inferior_thread_state *); -extern void discard_inferior_status (struct inferior_status *); - -extern struct regcache *get_inferior_thread_state_regcache (struct inferior_thread_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; - -/* The null or zero ptid, often used to indicate no process. */ -extern ptid_t null_ptid; - -/* 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); - -/* Find/Create a ptid from just a pid. */ -ptid_t pid_to_ptid (int pid); - -/* 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); - -/* Return true if PTID represents a process id. */ -extern int ptid_is_pid (ptid_t ptid); +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 @@ -118,43 +84,12 @@ 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; -/* 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; - -/* Inferior environment. */ - -extern struct gdb_environ *inferior_environ; - -extern void clear_proceed_status (void); - -extern void proceed (CORE_ADDR, enum target_signal, int); - -extern int sched_multi; - -/* 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; - -/* If set, the inferior should be controlled in non-stop mode. In - this mode, each thread is controlled independently. Execution - commands apply only to the the selected thread by default, and stop - events stop only the thread that had the event -- the other threads - are kept running freely. */ -extern int non_stop; - extern void generic_mourn_inferior (void); -extern void terminal_save_ours (void); - -extern void terminal_ours (void); - extern CORE_ADDR unsigned_pointer_to_address (struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf); @@ -168,21 +103,8 @@ extern void address_to_signed_pointer (struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr); -extern void wait_for_inferior (int treat_exec_as_sigtrap); - -extern void fetch_inferior_event (void *); - -extern void init_wait_for_inferior (void); - -extern void close_exec_file (void); - extern void reopen_exec_file (void); -/* The `resume' routine should only be called in special circumstances. - Normally, use `proceed', which handles a lot of bookkeeping. */ - -extern void resume (int, enum target_signal); - /* From misc files */ extern void default_print_registers_info (struct gdbarch *gdbarch, @@ -190,89 +112,113 @@ extern void default_print_registers_info (struct gdbarch *gdbarch, struct frame_info *frame, int regnum, int all); -extern void child_terminal_info (char *, int); +/* Default implementation of gdbarch_print_float_info. Print + the values of all floating point registers. */ + +extern void default_print_float_info (struct gdbarch *gdbarch, + struct ui_file *file, + struct frame_info *frame, + const char *args); + +extern void child_terminal_info (struct target_ops *self, const char *, int); extern void term_info (char *, int); -extern void terminal_ours_for_output (void); +extern void child_terminal_ours (struct target_ops *self); -extern void terminal_inferior (void); +extern void child_terminal_ours_for_output (struct target_ops *self); -extern void terminal_init_inferior (void); +extern void child_terminal_inferior (struct target_ops *self); -extern void terminal_init_inferior_with_pgrp (int pgrp); +extern void child_terminal_init (struct target_ops *self); -/* From fork-child.c */ +extern void child_terminal_init_with_pgrp (int pgrp); -extern int fork_inferior (char *, char *, char **, - void (*)(void), - void (*)(int), void (*)(void), char *); +/* From fork-child.c */ +/* Report an error that happened when starting to trace the inferior + (i.e., when the "traceme_fun" callback is called on fork_inferior) + and bail out. This function does not return. */ -extern void startup_inferior (int); +extern void trace_start_error (const char *fmt, ...) + ATTRIBUTE_NORETURN; -extern char *construct_inferior_arguments (int, char **); +/* Like "trace_start_error", but the error message is constructed by + combining STRING with the system error message for errno. This + function does not return. */ -/* From infrun.c */ +extern void trace_start_error_with_name (const char *string) + ATTRIBUTE_NORETURN; -extern void start_remote (int from_tty); +extern int fork_inferior (const char *, const std::string &, char **, + void (*)(void), + void (*)(int), void (*)(void), char *, + void (*)(const char *, + char * const *, char * const *)); -extern void normal_stop (void); -extern int signal_stop_state (int); +extern void startup_inferior (int); -extern int signal_print_state (int); +extern char *construct_inferior_arguments (int, char **); -extern int signal_pass_state (int); +/* From infcmd.c */ -extern int signal_stop_update (int, int); +/* Initial inferior setup. Determines the exec file is not yet known, + takes any necessary post-attaching actions, fetches the target + description and syncs the shared library list. */ -extern int signal_print_update (int, int); +extern void setup_inferior (int from_tty); -extern int signal_pass_update (int, int); +extern void post_create_inferior (struct target_ops *, int); -extern void get_last_target_status(ptid_t *ptid, - struct target_waitstatus *status); +extern void attach_command (char *, int); -extern void follow_inferior_reset_breakpoints (void); +extern char *get_inferior_args (void); -/* Throw an error indicating the current thread is running. */ -extern void error_is_running (void); +extern void set_inferior_args (char *); -/* Calls error_is_running if the current thread is running. */ -extern void ensure_not_running (void); +extern void set_inferior_args_vector (int, char **); -/* From infcmd.c */ +extern void registers_info (char *, int); -extern void tty_command (char *, int); +extern void continue_1 (int all_threads); -extern void post_create_inferior (struct target_ops *, int); +extern void interrupt_target_1 (int all_threads); -extern void attach_command (char *, int); +extern void delete_longjmp_breakpoint_cleanup (void *arg); -extern char *get_inferior_args (void); +extern void detach_command (char *, int); -extern char *set_inferior_args (char *); +extern void notice_new_inferior (ptid_t, int, int); -extern void set_inferior_args_vector (int, char **); +extern struct value *get_return_value (struct value *function, + struct type *value_type); -extern void registers_info (char *, int); +/* 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. */ -extern void nexti_command (char *, int); +extern void prepare_execution_command (struct target_ops *target, + int background); -extern void stepi_command (char *, int); +/* Whether to start up the debuggee under a shell. -extern void continue_1 (int all_threads); + If startup-with-shell is set, GDB's "run" will attempt to start up + the debuggee under a shell. -extern void continue_command (char *, int); + This is in order for argument-expansion to occur. E.g., -extern void interrupt_target_command (char *args, int from_tty); + (gdb) run * -extern void interrupt_target_1 (int all_threads); + The "*" gets expanded by the shell into a list of files. -extern void detach_command (char *, int); + 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". -extern void notice_new_inferior (ptid_t, int, int); + 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; /* Address at which inferior stopped. */ @@ -280,15 +226,16 @@ extern CORE_ADDR stop_pc; /* Nonzero if stopped due to completion of a stack dummy routine. */ -extern int stop_stack_dummy; +extern enum stop_stack_kind stop_stack_dummy; /* Nonzero if program stopped due to a random (unexpected) signal in inferior process. */ extern int stopped_by_random_signal; -/* 1 means step over all subroutine calls. - -1 means step over calls to undebuggable functions. */ +/* 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. */ enum step_over_calls_kind { @@ -304,20 +251,20 @@ enum step_over_calls_kind setting up a remote connection; it is like STOP_QUIETLY_NO_SIGSTOP except that there is no need to hide a signal. */ -/* It is also used after attach, due to attaching to a process. This - is a bit trickier. 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. - +/* 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 + 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. */ @@ -330,59 +277,34 @@ enum stop_kind STOP_QUIETLY_NO_SIGSTOP }; -/* Reverse execution. */ -enum exec_direction_kind - { - EXEC_FORWARD, - EXEC_REVERSE, - EXEC_ERROR - }; - -extern enum exec_direction_kind execution_direction; - -/* Save register contents here when executing a "finish" command or are - 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 regcache *stop_registers; - -/* True if we are debugging displaced stepping. */ -extern int debug_displaced; - -/* Dump LEN bytes at BUF in hex to FILE, followed by a newline. */ -void displaced_step_dump_bytes (struct ui_file *file, - const gdb_byte *buf, size_t len); - /* Possible values for gdbarch_call_dummy_location. */ #define ON_STACK 1 #define AT_ENTRY_POINT 4 -#define AT_SYMBOL 5 -/* 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 +/* 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; +}; + +/* Return a pointer to the current inferior. */ +extern inferior *current_inferior (); + +extern void set_current_inferior (inferior *); + /* 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 @@ -390,42 +312,154 @@ struct private_inferior; 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 + threads running in it. + + Inferiors are intrusively refcounted objects. Unlike thread + objects, being the user-selected inferior is considered a strong + reference and is thus accounted for in the inferior object's + refcount (see set_current_inferior). When GDB needs to remember + the selected inferior to later restore it, GDB temporarily bumps + the inferior object's refcount, to prevent something deleting the + inferior object before reverting back (e.g., due to a + "remove-inferiors" command (see + make_cleanup_restore_current_thread). All other inferior + references are considered weak references. Inferiors are always + listed exactly once in the inferior list, so placing an inferior in + the inferior list is an implicit, not counted strong reference. */ + +class inferior : public refcounted_object { +public: + explicit inferior (int pid); + ~inferior (); + + /* Returns true if we can delete this inferior. */ + bool deletable () const { return refcount () == 0; } + /* Pointer to next inferior in singly-linked list of inferiors. */ - struct inferior *next; + struct inferior *next = NULL; /* Convenient handle (GDB inferior id). Unique across all inferiors. */ - int num; + int num = 0; /* Actual target inferior id, usually, a process id. This matches the ptid_t.pid member of threads of this inferior. */ - int pid; + int pid = 0; + /* True if the PID was actually faked by GDB. */ + bool fake_pid_p = false; - /* See the definition of stop_kind above. */ - enum stop_kind stop_soon; + /* The highest thread number this inferior ever had. */ + int highest_thread_num = 0; + + /* State of GDB control of inferior process execution. + See `struct inferior_control_state'. */ + inferior_control_state control {NO_STOP_QUIETLY}; + + /* 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. */ + bool removable = false; + + /* The address space bound to this inferior. */ + struct address_space *aspace = NULL; + + /* The program space bound to this inferior. */ + struct program_space *pspace = NULL; + + /* The arguments string to use when running. */ + char *args = NULL; - /* Nonzero if this child process was attached rather than - forked. */ - int attach_flag; + /* The size of elements in argv. */ + int argc = 0; + + /* 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 = NULL; + + /* The name of terminal device to use for I/O. */ + char *terminal = NULL; + + /* Environment to use for running inferior, + in format described in environ.h. */ + gdb_environ *environment = NULL; + + /* True if this child process was attached rather than forked. */ + bool attach_flag = false; + + /* If this inferior is a vfork child, then this is the pointer to + its vfork parent, if GDB is still attached to it. */ + inferior *vfork_parent = NULL; + + /* 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. */ + inferior *vfork_child = NULL; + + /* True if this inferior should be detached when it's vfork sibling + exits or execs. */ + bool pending_detach = false; + + /* 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. */ + bool waiting_for_vfork_done = false; + + /* True if we're in the process of detaching from this inferior. */ + bool detaching = false; /* 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; + continuation *continuations = NULL; - /* Terminal info and state managed by inflow.c. */ - struct terminal_info *terminal_info; + /* True if setup_inferior wasn't called for this inferior yet. + Until that is done, we must not access inferior memory or + registers, as we haven't determined the target + architecture/description. */ + bool needs_setup = false; /* Private data used by the target vector implementation. */ - struct private_inferior *private; + private_inferior *priv = NULL; + + /* HAS_EXIT_CODE is true if the inferior exited with an exit code. + In this case, the EXIT_CODE field is also valid. */ + bool has_exit_code = false; + LONGEST exit_code = 0; + + /* Default flags to pass to the symbol reading functions. These are + used whenever a new objfile is created. */ + symfile_add_flags symfile_flags = 0; + + /* Info about an inferior's target description (if it's fetched; the + user supplied description's filename, if any; etc.). */ + target_desc_info *tdesc_info = NULL; + + /* The architecture associated with the inferior through the + connection to the target. + + 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 = NULL; + + /* Per inferior data-pointers required by other GDB modules. */ + REGISTRY_FIELDS; }; -/* Create an empty inferior list, or empty the existing one. */ -extern void init_inferior_list (void); +/* Keep a registry of per-inferior data-pointers required by other GDB + modules. */ + +DECLARE_REGISTRY (inferior); /* Add an inferior to the inferior list, print a message that a new inferior is found, and return the pointer to the new inferior. @@ -437,16 +471,19 @@ extern struct inferior *add_inferior (int pid); the CLI. */ extern struct inferior *add_inferior_silent (int pid); -/* Delete an existing inferior list entry, due to inferior exit. */ -extern void delete_inferior (int pid); - -/* Same as delete_inferior, but don't print new inferior notifications - to the CLI. */ -extern void delete_inferior_silent (int pid); +extern void delete_inferior (struct inferior *todel); /* Delete an existing inferior list entry, due to inferior detaching. */ extern void detach_inferior (int pid); +extern void exit_inferior (int pid); + +extern void exit_inferior_silent (int pid); + +extern void exit_inferior_num_silent (int num); + +extern void inferior_appeared (struct inferior *inf, int pid); + /* Get rid of all inferiors. */ extern void discard_all_inferiors (void); @@ -465,9 +502,20 @@ extern int in_inferior_list (int pid); not the system's). */ extern int valid_gdb_inferior_id (int num); -/* Search function to lookup a inferior by target 'pid'. */ +/* Search function to lookup an inferior by target 'pid'. */ extern struct inferior *find_inferior_pid (int pid); +/* Search function to lookup an inferior whose pid is equal to 'ptid.pid'. */ +extern struct inferior *find_inferior_ptid (ptid_t ptid); + +/* Search function to lookup an inferior by GDB 'num'. */ +extern struct inferior *find_inferior_id (int num); + +/* Find an inferior bound to PSPACE, giving preference to the current + inferior. */ +extern struct inferior * + find_inferior_for_program_space (struct program_space *pspace); + /* Inferior iterator function. Calls a callback function once for each inferior, so long as the @@ -482,21 +530,40 @@ extern struct inferior *iterate_over_inferiors (int (*) (struct inferior *, void *), void *); -/* Prints the list of inferiors and their details on UIOUT. - - If REQUESTED_INFERIOR is not -1, it's the GDB id of the inferior - that should be printed. Otherwise, all inferiors are printed. */ -extern void print_inferior (struct ui_out *uiout, int requested_inferior); - /* Returns true if the inferior list is not empty. */ extern int have_inferiors (void); +/* Returns the number of live inferiors (real live processes). */ +extern int number_of_live_inferiors (void); + /* 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); -/* 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); +extern struct cleanup *save_current_inferior (void); + +/* Traverse all inferiors. */ + +#define ALL_INFERIORS(I) \ + for ((I) = inferior_list; (I); (I) = (I)->next) + +/* Traverse all non-exited inferiors. */ + +#define ALL_NON_EXITED_INFERIORS(I) \ + ALL_INFERIORS (I) \ + if ((I)->pid != 0) + +extern struct inferior *inferior_list; + +/* Prune away automatically added inferiors that aren't required + anymore. */ +extern void prune_inferiors (void); + +extern int number_of_inferiors (void); + +extern struct inferior *add_inferior_with_spaces (void); + +/* Print the current selected inferior. */ +extern void print_selected_inferior (struct ui_out *uiout); #endif /* !defined (INFERIOR_H) */