X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Finferior.h;h=63245a24a9ac643df178af37a7509fdcf67523bc;hb=dee91e82ae87f379c90fddff8db7c4b54a116609;hp=14b99e222fede64ec0a90712252a3175006b1361;hpb=6c95b8df7fef5273da71c34775918c554aae0ea8;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/inferior.h b/gdb/inferior.h index 14b99e222f..63245a24a9 100644 --- a/gdb/inferior.h +++ b/gdb/inferior.h @@ -1,9 +1,8 @@ /* 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, 1988-1996, 1998-2001, 2003-2012 Free Software + Foundation, Inc. This file is part of GDB. @@ -32,6 +31,8 @@ struct regcache; struct ui_out; struct terminal_info; +#include "ptid.h" + /* For bpstat. */ #include "breakpoint.h" @@ -43,67 +44,35 @@ struct terminal_info; #include "progspace.h" -/* Two structures are used to record inferior state. - - 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. - - 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. - - Call these routines around hand called functions, including function calls - in conditional breakpoints for example. */ - -struct inferior_thread_state; -struct inferior_status; - -extern struct inferior_thread_state *save_inferior_thread_state (void); -extern struct inferior_status *save_inferior_status (void); - -extern void restore_inferior_thread_state (struct inferior_thread_state *); -extern void restore_inferior_status (struct inferior_status *); +struct infcall_suspend_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 struct infcall_suspend_state *save_infcall_suspend_state (void); +extern struct infcall_control_state *save_infcall_control_state (void); -extern void discard_inferior_thread_state (struct inferior_thread_state *); -extern void discard_inferior_status (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 regcache *get_inferior_thread_state_regcache (struct inferior_thread_state *); +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 *); -/* 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 void discard_infcall_suspend_state (struct infcall_suspend_state *); +extern void discard_infcall_control_state (struct infcall_control_state *); -/* The null or zero ptid, often used to indicate no process. */ -extern ptid_t null_ptid; +extern struct regcache * + get_infcall_suspend_state_regcache (struct infcall_suspend_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); +/* Returns true if PTID matches filter FILTER. FILTER can be the wild + card MINUS_ONE_PTID (all ptid match it); can be a ptid representing + a process (ptid_is_pid returns true), in which case, all lwps and + threads of that given process match, lwps and threads of other + processes do not; or, it can represent a specific thread, in which + case, only that thread will match true. PTID must represent a + specific LWP or THREAD, it can never be a wild card. */ -/* 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 int ptid_match (ptid_t ptid, ptid_t filter); /* Save value of inferior_ptid so that it may be restored by a later call to do_cleanups(). Returns the struct cleanup @@ -120,18 +89,16 @@ 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, PIDGET (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. */ + redisplay the prompt until the execution is actually over. */ extern int sync_execution; -/* Inferior environment. */ - -extern struct gdb_environ *inferior_environ; +/* Inferior environment. */ extern void clear_proceed_status (void); @@ -146,7 +113,7 @@ 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 + commands apply only to 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; @@ -156,6 +123,10 @@ extern int non_stop; detached depends on 'set follow-fork-mode' setting. */ extern int detach_fork; +/* When set (default), the target should attempt to disable the operating + system's address space randomization feature when starting an inferior. */ +extern int disable_randomization; + extern void generic_mourn_inferior (void); extern void terminal_save_ours (void); @@ -175,14 +146,14 @@ 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 wait_for_inferior (void); + +extern void prepare_for_detach (void); 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. @@ -190,6 +161,12 @@ extern void reopen_exec_file (void); extern void resume (int, enum target_signal); +extern ptid_t user_visible_resume_ptid (int step); + +extern void insert_step_resume_breakpoint_at_sal (struct gdbarch *, + struct symtab_and_line , + struct frame_id); + /* From misc files */ extern void default_print_registers_info (struct gdbarch *gdbarch, @@ -213,7 +190,9 @@ extern void terminal_init_inferior_with_pgrp (int pgrp); extern int fork_inferior (char *, char *, char **, void (*)(void), - void (*)(int), void (*)(void), char *); + void (*)(int), void (*)(void), char *, + void (*)(const char *, + char * const *, char * const *)); extern void startup_inferior (int); @@ -222,6 +201,10 @@ extern char *construct_inferior_arguments (int, char **); /* From infrun.c */ +extern int debug_infrun; + +extern int stop_on_solib_events; + extern void start_remote (int from_tty); extern void normal_stop (void); @@ -253,15 +236,13 @@ void set_step_info (struct frame_info *frame, struct symtab_and_line sal); /* From infcmd.c */ -extern void tty_command (char *, int); - extern void post_create_inferior (struct target_ops *, int); extern void attach_command (char *, int); extern char *get_inferior_args (void); -extern char *set_inferior_args (char *); +extern void set_inferior_args (char *); extern void set_inferior_args_vector (int, char **); @@ -279,17 +260,22 @@ extern void interrupt_target_command (char *args, int from_tty); extern void interrupt_target_1 (int all_threads); +extern void delete_longjmp_breakpoint_cleanup (void *arg); + extern void detach_command (char *, int); extern void notice_new_inferior (ptid_t, int, int); +extern struct value *get_return_value (struct type *func_type, + struct type *value_type); + /* Address at which inferior stopped. */ 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. */ @@ -314,10 +300,10 @@ 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 +/* 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 + 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. @@ -325,7 +311,7 @@ enum step_over_calls_kind 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 @@ -344,11 +330,13 @@ enum stop_kind enum exec_direction_kind { EXEC_FORWARD, - EXEC_REVERSE, - EXEC_ERROR + EXEC_REVERSE }; -extern enum exec_direction_kind execution_direction; +/* The current execution direction. This should only be set to enum + exec_direction_kind values. It is only an int to make it + compatible with make_cleanup_restore_integer. */ +extern int 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. @@ -364,6 +352,7 @@ extern int debug_displaced; void displaced_step_dump_bytes (struct ui_file *file, const gdb_byte *buf, size_t len); +struct displaced_step_closure *get_displaced_step_closure_by_addr (CORE_ADDR addr); /* Possible values for gdbarch_call_dummy_location. */ #define ON_STACK 1 @@ -372,7 +361,7 @@ void displaced_step_dump_bytes (struct ui_file *file, /* 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., + 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 @@ -385,7 +374,7 @@ void displaced_step_dump_bytes (struct ui_file *file, 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. */ + START_INFERIOR_TRAPS_EXPECTED in tm.h. */ #define STARTUP_WITH_SHELL 1 #if !defined(START_INFERIOR_TRAPS_EXPECTED) #define START_INFERIOR_TRAPS_EXPECTED 2 @@ -393,6 +382,24 @@ void displaced_step_dump_bytes (struct ui_file *file, 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; +}; + +/* Inferior process specific part of `struct infcall_suspend_state'. + + Inferior thread counterpart is `struct thread_suspend_state'. */ + +struct inferior_suspend_state +{ +}; + /* 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 @@ -414,6 +421,16 @@ struct inferior /* 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; + + /* State of inferior process to restore after GDB is done with an inferior + call. See `struct inferior_suspend_state'. */ + struct inferior_suspend_state suspend; /* True if this was an auto-created inferior, e.g. created from following a fork; false, if this inferior was manually added by @@ -427,8 +444,24 @@ struct inferior /* The program space bound to this inferior. */ struct program_space *pspace; - /* See the definition of stop_kind above. */ - enum stop_kind stop_soon; + /* 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; + + /* The name of terminal device to use for I/O. */ + char *terminal; + + /* Environment to use for running inferior, + in format described in environ.h. */ + struct gdb_environ *environment; /* Nonzero if this child process was attached rather than forked. */ @@ -453,6 +486,9 @@ struct inferior either by exiting or execing. */ int waiting_for_vfork_done; + /* True if we're in the process of detaching from this inferior. */ + int detaching; + /* 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'. */ @@ -461,19 +497,15 @@ struct inferior /* Private data used by the target vector implementation. */ struct private_inferior *private; - /* We keep a count of the number of times the user has requested a - particular syscall to be tracked, and pass this information to the - target. This lets capable targets implement filtering directly. */ - - /* Number of times that "any" syscall is requested. */ - int any_syscall_count; - - /* Count of each system call. */ - VEC(int) *syscalls_counts; + /* 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; - /* This counts all syscall catch requests, so we can readily determine - if any catching is necessary. */ - int total_syscalls_count; + /* 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; /* Per inferior data-pointers required by other GDB modules. */ void **data; @@ -508,6 +540,8 @@ extern struct inferior *add_inferior_silent (int pid); /* Delete an existing inferior list entry, due to inferior exit. */ extern void delete_inferior (int pid); +extern void delete_inferior_1 (struct inferior *todel, int silent); + /* Same as delete_inferior, but don't print new inferior notifications to the CLI. */ extern void delete_inferior_silent (int pid); @@ -565,12 +599,6 @@ 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); @@ -586,6 +614,11 @@ extern void set_current_inferior (struct inferior *); extern struct cleanup *save_current_inferior (void); +/* Traverse all inferiors. */ + +#define ALL_INFERIORS(I) \ + for ((I) = inferior_list; (I); (I) = (I)->next) + extern struct inferior *inferior_list; /* Prune away automatically added inferiors that aren't required @@ -594,4 +627,20 @@ extern void prune_inferiors (void); extern int number_of_inferiors (void); +extern struct inferior *add_inferior_with_spaces (void); + +extern void update_observer_mode (void); + +extern void update_signals_program_target (void); + +/* In some circumstances we allow a command to specify a numeric + signal. The idea is to keep these circumstances limited so that + users (and scripts) develop portable habits. For comparison, + POSIX.2 `kill' requires that 1,2,3,6,9,14, and 15 work (and using a + numeric signal at all is obsolescent. We are slightly more lenient + and allow 1-15 which should match host signal numbers on most + systems. Use of symbolic signal names is strongly encouraged. */ + +enum target_signal target_signal_from_command (int num); + #endif /* !defined (INFERIOR_H) */