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. This should only be set to enum
78 exec_direction_kind values. It is only an int to make it
79 compatible with make_cleanup_restore_integer. */
80 extern int execution_direction
;
82 extern void start_remote (int from_tty
);
84 /* Clear out all variables saying what to do when inferior is
85 continued or stepped. First do this, then set the ones you want,
86 then call `proceed'. STEP indicates whether we're preparing for a
87 step/stepi command. */
88 extern void clear_proceed_status (int step
);
90 extern void proceed (CORE_ADDR
, enum gdb_signal
);
92 /* The `resume' routine should only be called in special circumstances.
93 Normally, use `proceed', which handles a lot of bookkeeping. */
94 extern void resume (enum gdb_signal
);
96 /* Return a ptid representing the set of threads that we will proceed,
97 in the perspective of the user/frontend. We may actually resume
98 fewer threads at first, e.g., if a thread is stopped at a
99 breakpoint that needs stepping-off, but that should not be visible
100 to the user/frontend, and neither should the frontend/user be
101 allowed to proceed any of the threads that happen to be stopped for
102 internal run control handling, if a previous command wanted them
104 extern ptid_t
user_visible_resume_ptid (int step
);
106 extern void wait_for_inferior (void);
108 /* Return control to GDB when the inferior stops for real. Print
109 appropriate messages, remove breakpoints, give terminal our modes,
110 and run the stop hook. Returns true if the stop hook proceeded the
111 target, false otherwise. */
112 extern int normal_stop (void);
114 extern void get_last_target_status (ptid_t
*ptid
,
115 struct target_waitstatus
*status
);
117 extern void prepare_for_detach (void);
119 extern void fetch_inferior_event (void *);
121 extern void init_wait_for_inferior (void);
123 extern void insert_step_resume_breakpoint_at_sal (struct gdbarch
*,
124 struct symtab_and_line
,
127 /* Returns true if we're trying to step past the instruction at
128 ADDRESS in ASPACE. */
129 extern int stepping_past_instruction_at (struct address_space
*aspace
,
132 /* Returns true if we're trying to step past an instruction that
133 triggers a non-steppable watchpoint. */
134 extern int stepping_past_nonsteppable_watchpoint (void);
136 extern void set_step_info (struct frame_info
*frame
,
137 struct symtab_and_line sal
);
139 /* Several print_*_reason helper functions to print why the inferior
140 has stopped to the passed in UIOUT. */
142 /* Signal received, print why the inferior has stopped. */
143 extern void print_signal_received_reason (struct ui_out
*uiout
,
144 enum gdb_signal siggnal
);
146 /* Print why the inferior has stopped. We are done with a
147 step/next/si/ni command, print why the inferior has stopped. */
148 extern void print_end_stepping_range_reason (struct ui_out
*uiout
);
150 /* The inferior was terminated by a signal, print why it stopped. */
151 extern void print_signal_exited_reason (struct ui_out
*uiout
,
152 enum gdb_signal siggnal
);
154 /* The inferior program is finished, print why it stopped. */
155 extern void print_exited_reason (struct ui_out
*uiout
, int exitstatus
);
157 /* Reverse execution: target ran out of history info, print why the
158 inferior has stopped. */
159 extern void print_no_history_reason (struct ui_out
*uiout
);
161 /* Print the result of a function at the end of a 'finish' command.
162 RV points at an object representing the captured return value/type
163 and its position in the value history. */
165 extern void print_return_value (struct ui_out
*uiout
,
166 struct return_value_info
*rv
);
168 /* Print current location without a level number, if we have changed
169 functions or hit a breakpoint. Print source line if we have one.
170 If the execution command captured a return value, print it. */
172 extern void print_stop_event (struct ui_out
*uiout
);
174 /* Pretty print the results of target_wait, for debugging purposes. */
176 extern void print_target_wait_results (ptid_t waiton_ptid
, ptid_t result_ptid
,
177 const struct target_waitstatus
*ws
);
179 extern int signal_stop_state (int);
181 extern int signal_print_state (int);
183 extern int signal_pass_state (int);
185 extern int signal_stop_update (int, int);
187 extern int signal_print_update (int, int);
189 extern int signal_pass_update (int, int);
191 extern void update_signals_program_target (void);
193 /* Clear the convenience variables associated with the exit of the
194 inferior. Currently, those variables are $_exitcode and
196 extern void clear_exit_convenience_vars (void);
198 /* Dump LEN bytes at BUF in hex to FILE, followed by a newline. */
199 extern void displaced_step_dump_bytes (struct ui_file
*file
,
200 const gdb_byte
*buf
, size_t len
);
202 extern struct displaced_step_closure
*get_displaced_step_closure_by_addr
205 extern void update_observer_mode (void);
207 extern void signal_catch_update (const unsigned int *);
209 /* In some circumstances we allow a command to specify a numeric
210 signal. The idea is to keep these circumstances limited so that
211 users (and scripts) develop portable habits. For comparison,
212 POSIX.2 `kill' requires that 1,2,3,6,9,14, and 15 work (and using a
213 numeric signal at all is obsolescent. We are slightly more lenient
214 and allow 1-15 which should match host signal numbers on most
215 systems. Use of symbolic signal names is strongly encouraged. */
216 enum gdb_signal
gdb_signal_from_command (int num
);
218 /* Enables/disables infrun's async event source in the event loop. */
219 extern void infrun_async (int enable
);
221 /* Call infrun's event handler the next time through the event
223 extern void mark_infrun_async_event_handler (void);
225 /* The global queue of threads that need to do a step-over operation
226 to get past e.g., a breakpoint. */
227 extern struct thread_info
*step_over_queue_head
;
229 /* Remove breakpoints if possible (usually that means, if everything
230 is stopped). On failure, print a message. */
231 extern void maybe_remove_breakpoints (void);
233 #endif /* INFRUN_H */