1 /* Top level stuff for GDB, the GNU debugger.
3 Copyright (C) 1986-2016 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 #include "event-loop.h"
26 struct tl_interp_info
;
28 /* All about a user interface instance. Each user interface has its
29 own I/O files/streams, readline state, its own top level
30 interpreter (for the main UI, this is the interpreter specified
31 with -i on the command line) and secondary interpreters (for
32 interpreter-exec ...), etc. There's always one UI associated with
33 stdin/stdout/stderr, but the user can create secondary UIs, for
34 example, to create a separate MI channel on its own stdio
39 /* Pointer to next in singly-linked list. */
42 /* The UI's command line buffer. This is to used to accumulate
43 input until we have a whole command line. */
44 struct buffer line_buffer
;
46 /* The callback used by the event loop whenever an event is detected
47 on the UI's input file descriptor. This function incrementally
48 builds a buffer where it accumulates the line read up to the
49 point of invocation. In the special case in which the character
50 read is newline, the function invokes the INPUT_HANDLER callback
52 void (*call_readline
) (gdb_client_data
);
54 /* The function to invoke when a complete line of input is ready for
56 void (*input_handler
) (char *);
58 /* Each UI has its own independent set of interpreters. */
59 struct ui_interp_info
*interp_info
;
61 /* True if the UI is in async mode, false if in sync mode. If in
62 sync mode, a synchronous execution command (e.g, "next") does not
63 return until the command is finished. If in async mode, then
64 running a synchronous command returns right after resuming the
65 target. Waiting for the command's completion is later done on
66 the top event loop. For the main UI, this starts out disabled,
67 until all the explicit command line arguments (e.g., `gdb -ex
68 "start" -ex "next"') are processed. */
71 /* stdio stream that command input is being read from. Set to stdin
72 normally. Set by source_command to the file we are sourcing.
73 Set to NULL if we are executing a user-defined command or
74 interacting via a GUI. */
77 /* The file descriptor for the input stream, so that we can register
78 it with the event loop. */
81 /* The fields below that start with "m_" are "private". They're
82 meant to be accessed through wrapper macros that make them look
85 /* The ui_file streams. */
87 struct ui_file
*m_gdb_stdout
;
89 struct ui_file
*m_gdb_stdin
;
90 /* Serious error notifications */
91 struct ui_file
*m_gdb_stderr
;
92 /* Log/debug/trace messages that should bypass normal stdout/stderr
93 filtering. For moment, always call this stream using
94 *_unfiltered. In the very near future that restriction shall be
95 removed - either call shall be unfiltered. (cagney 1999-06-13). */
96 struct ui_file
*m_gdb_stdlog
;
99 /* The main UI. This is the UI that is bound to stdin/stdout/stderr.
100 It always exists and is created automatically when GDB starts
102 extern struct ui
*main_ui
;
104 /* The current UI. */
105 extern struct ui
*current_ui
;
107 /* The list of all UIs. */
108 extern struct ui
*ui_list
;
110 /* State for SWITCH_THRU_ALL_UIS. Declared here because it is meant
111 to be created on the stack, but should be treated as opaque. */
112 struct switch_thru_all_uis
115 struct cleanup
*old_chain
;
118 /* Functions to drive SWITCH_THRU_ALL_UIS. Though declared here by
119 necessity, these functions should not be used other than via the
120 SWITCH_THRU_ALL_UIS macro defined below. */
121 extern void switch_thru_all_uis_init (struct switch_thru_all_uis
*state
);
122 extern int switch_thru_all_uis_cond (struct switch_thru_all_uis
*state
);
123 extern void switch_thru_all_uis_next (struct switch_thru_all_uis
*state
);
125 /* Traverse through all UI, and switch the current UI to the one
127 #define SWITCH_THRU_ALL_UIS(STATE) \
128 for (switch_thru_all_uis_init (&STATE); \
129 switch_thru_all_uis_cond (&STATE); \
130 switch_thru_all_uis_next (&STATE))
133 extern char *saved_command_line
;
134 extern int in_user_command
;
136 extern char gdb_dirbuf
[1024];
137 extern int inhibit_gdbinit
;
138 extern const char gdbinit
[];
140 extern void print_gdb_version (struct ui_file
*);
141 extern void print_gdb_configuration (struct ui_file
*);
143 extern void read_command_file (FILE *);
144 extern void init_history (void);
145 extern void command_loop (void);
146 extern int quit_confirm (void);
147 extern void quit_force (char *, int);
148 extern void quit_command (char *, int);
149 extern void quit_cover (void);
150 extern void execute_command (char *, int);
152 /* If the interpreter is in sync mode (we're running a user command's
153 list, running command hooks or similars), and we just ran a
154 synchronous command that started the target, wait for that command
155 to end. WAS_SYNC indicates whether sync_execution was set before
156 the command was run. */
158 extern void maybe_wait_sync_command_done (int was_sync
);
160 /* Wait for a synchronous execution command to end. */
161 extern void wait_sync_command_done (void);
163 extern void check_frame_language_change (void);
165 /* Prepare for execution of a command.
166 Call this before every command, CLI or MI.
167 Returns a cleanup to be run after the command is completed. */
168 extern struct cleanup
*prepare_execute_command (void);
170 /* This function returns a pointer to the string that is used
171 by gdb for its command prompt. */
172 extern char *get_prompt (void);
174 /* This function returns a pointer to the string that is used
175 by gdb for its command prompt. */
176 extern void set_prompt (const char *s
);
178 /* Return 1 if the current input handler is a secondary prompt, 0 otherwise. */
180 extern int gdb_in_secondary_prompt_p (void);
182 /* From random places. */
183 extern int readnow_symbol_files
;
185 /* Perform _initialize initialization. */
186 extern void gdb_init (char *);
188 /* For use by event-top.c. */
189 /* Variables from top.c. */
190 extern int source_line_number
;
191 extern const char *source_file_name
;
192 extern int history_expansion_p
;
193 extern int server_command
;
194 extern char *lim_at_start
;
196 extern void gdb_add_history (const char *);
198 extern void show_commands (char *args
, int from_tty
);
200 extern void set_history (char *, int);
202 extern void show_history (char *, int);
204 extern void set_verbose (char *, int, struct cmd_list_element
*);
206 extern void do_restore_instream_cleanup (void *stream
);
208 extern char *handle_line_of_input (struct buffer
*cmd_line_buffer
,
209 char *rl
, int repeat
,
210 char *annotation_suffix
);
This page took 0.035413 seconds and 5 git commands to generate.