1 /* Copyright (C) 1986-2015 Free Software Foundation, Inc.
3 This file is part of GDB.
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 struct target_waitstatus
;
26 struct return_value_info
;
28 /* True if we are debugging run control. */
29 extern unsigned int debug_infrun
;
31 /* True if we are debugging displaced stepping. */
32 extern int debug_displaced
;
34 /* Nonzero if we want to give control to the user when we're notified
35 of shared library events by the dynamic linker. */
36 extern int stop_on_solib_events
;
38 /* Are we simulating synchronous execution? This is used in async gdb
39 to implement the 'run', 'continue' etc commands, which will not
40 redisplay the prompt until the execution is actually over. */
41 extern int sync_execution
;
43 /* True if execution commands resume all threads of all processes by
44 default; otherwise, resume only threads of the current inferior
46 extern int sched_multi
;
48 /* When set, stop the 'step' command if we enter a function which has
49 no line number information. The normal behavior is that we step
50 over such function. */
51 extern int step_stop_if_no_debug
;
53 /* If set, the inferior should be controlled in non-stop mode. In
54 this mode, each thread is controlled independently. Execution
55 commands apply only to the selected thread by default, and stop
56 events stop only the thread that had the event -- the other threads
57 are kept running freely. */
60 /* When set (default), the target should attempt to disable the
61 operating system's address space randomization feature when
62 starting an inferior. */
63 extern int disable_randomization
;
65 /* Returns a unique identifier for the current stop. This can be used
66 to tell whether a command has proceeded the inferior past the
68 extern ULONGEST
get_stop_id (void);
70 /* Reverse execution. */
71 enum exec_direction_kind
77 /* The current execution direction. */
78 extern enum exec_direction_kind execution_direction
;
80 extern void start_remote (int from_tty
);
82 /* Clear out all variables saying what to do when inferior is
83 continued or stepped. First do this, then set the ones you want,
84 then call `proceed'. STEP indicates whether we're preparing for a
85 step/stepi command. */
86 extern void clear_proceed_status (int step
);
88 extern void proceed (CORE_ADDR
, enum gdb_signal
);
90 /* The `resume' routine should only be called in special circumstances.
91 Normally, use `proceed', which handles a lot of bookkeeping. */
92 extern void resume (enum gdb_signal
);
94 /* Return a ptid representing the set of threads that we will proceed,
95 in the perspective of the user/frontend. We may actually resume
96 fewer threads at first, e.g., if a thread is stopped at a
97 breakpoint that needs stepping-off, but that should not be visible
98 to the user/frontend, and neither should the frontend/user be
99 allowed to proceed any of the threads that happen to be stopped for
100 internal run control handling, if a previous command wanted them
102 extern ptid_t
user_visible_resume_ptid (int step
);
104 extern void wait_for_inferior (void);
106 /* Return control to GDB when the inferior stops for real. Print
107 appropriate messages, remove breakpoints, give terminal our modes,
108 and run the stop hook. Returns true if the stop hook proceeded the
109 target, false otherwise. */
110 extern int normal_stop (void);
112 extern void get_last_target_status (ptid_t
*ptid
,
113 struct target_waitstatus
*status
);
115 extern void prepare_for_detach (void);
117 extern void fetch_inferior_event (void *);
119 extern void init_wait_for_inferior (void);
121 extern void insert_step_resume_breakpoint_at_sal (struct gdbarch
*,
122 struct symtab_and_line
,
125 /* Returns true if we're trying to step past the instruction at
126 ADDRESS in ASPACE. */
127 extern int stepping_past_instruction_at (struct address_space
*aspace
,
130 /* Returns true if we're trying to step past an instruction that
131 triggers a non-steppable watchpoint. */
132 extern int stepping_past_nonsteppable_watchpoint (void);
134 extern void set_step_info (struct frame_info
*frame
,
135 struct symtab_and_line sal
);
137 /* Several print_*_reason helper functions to print why the inferior
138 has stopped to the passed in UIOUT. */
140 /* Signal received, print why the inferior has stopped. */
141 extern void print_signal_received_reason (struct ui_out
*uiout
,
142 enum gdb_signal siggnal
);
144 /* Print why the inferior has stopped. We are done with a
145 step/next/si/ni command, print why the inferior has stopped. */
146 extern void print_end_stepping_range_reason (struct ui_out
*uiout
);
148 /* The inferior was terminated by a signal, print why it stopped. */
149 extern void print_signal_exited_reason (struct ui_out
*uiout
,
150 enum gdb_signal siggnal
);
152 /* The inferior program is finished, print why it stopped. */
153 extern void print_exited_reason (struct ui_out
*uiout
, int exitstatus
);
155 /* Reverse execution: target ran out of history info, print why the
156 inferior has stopped. */
157 extern void print_no_history_reason (struct ui_out
*uiout
);
159 /* Print the result of a function at the end of a 'finish' command.
160 RV points at an object representing the captured return value/type
161 and its position in the value history. */
163 extern void print_return_value (struct ui_out
*uiout
,
164 struct return_value_info
*rv
);
166 /* Print current location without a level number, if we have changed
167 functions or hit a breakpoint. Print source line if we have one.
168 If the execution command captured a return value, print it. */
170 extern void print_stop_event (struct ui_out
*uiout
);
172 /* Pretty print the results of target_wait, for debugging purposes. */
174 extern void print_target_wait_results (ptid_t waiton_ptid
, ptid_t result_ptid
,
175 const struct target_waitstatus
*ws
);
177 extern int signal_stop_state (int);
179 extern int signal_print_state (int);
181 extern int signal_pass_state (int);
183 extern int signal_stop_update (int, int);
185 extern int signal_print_update (int, int);
187 extern int signal_pass_update (int, int);
189 extern void update_signals_program_target (void);
191 /* Clear the convenience variables associated with the exit of the
192 inferior. Currently, those variables are $_exitcode and
194 extern void clear_exit_convenience_vars (void);
196 /* Dump LEN bytes at BUF in hex to FILE, followed by a newline. */
197 extern void displaced_step_dump_bytes (struct ui_file
*file
,
198 const gdb_byte
*buf
, size_t len
);
200 extern struct displaced_step_closure
*get_displaced_step_closure_by_addr
203 extern void update_observer_mode (void);
205 extern void signal_catch_update (const unsigned int *);
207 /* In some circumstances we allow a command to specify a numeric
208 signal. The idea is to keep these circumstances limited so that
209 users (and scripts) develop portable habits. For comparison,
210 POSIX.2 `kill' requires that 1,2,3,6,9,14, and 15 work (and using a
211 numeric signal at all is obsolescent. We are slightly more lenient
212 and allow 1-15 which should match host signal numbers on most
213 systems. Use of symbolic signal names is strongly encouraged. */
214 enum gdb_signal
gdb_signal_from_command (int num
);
216 /* Enables/disables infrun's async event source in the event loop. */
217 extern void infrun_async (int enable
);
219 /* Call infrun's event handler the next time through the event
221 extern void mark_infrun_async_event_handler (void);
223 /* The global queue of threads that need to do a step-over operation
224 to get past e.g., a breakpoint. */
225 extern struct thread_info
*step_over_queue_head
;
227 /* Remove breakpoints if possible (usually that means, if everything
228 is stopped). On failure, print a message. */
229 extern void maybe_remove_breakpoints (void);
231 #endif /* INFRUN_H */