]>
Commit | Line | Data |
---|---|---|
f377b406 | 1 | /* TUI data manipulation routines. |
55fb0713 | 2 | |
42a4f53d | 3 | Copyright (C) 1998-2019 Free Software Foundation, Inc. |
55fb0713 | 4 | |
f377b406 SC |
5 | Contributed by Hewlett-Packard Company. |
6 | ||
7 | This file is part of GDB. | |
8 | ||
9 | This program is free software; you can redistribute it and/or modify | |
10 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 11 | the Free Software Foundation; either version 3 of the License, or |
f377b406 SC |
12 | (at your option) any later version. |
13 | ||
14 | This program is distributed in the hope that it will be useful, | |
15 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | GNU General Public License for more details. | |
18 | ||
19 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 20 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
f377b406 | 21 | |
1a5c2598 TT |
22 | #ifndef TUI_TUI_DATA_H |
23 | #define TUI_TUI_DATA_H | |
c906108c | 24 | |
6a83354a AC |
25 | #include "tui/tui.h" /* For enum tui_win_type. */ |
26 | #include "gdb_curses.h" /* For WINDOW. */ | |
27 | ||
28 | /* This is a point definition. */ | |
29 | struct tui_point | |
30 | { | |
31 | int x, y; | |
32 | }; | |
2a5127c4 | 33 | |
63ed8182 PP |
34 | struct tui_win_element; |
35 | ||
36 | /* This describes the content of the window. */ | |
37 | typedef struct tui_win_element **tui_win_content; | |
38 | ||
1cc6d956 | 39 | /* Generic window information. */ |
2a8854a7 AC |
40 | struct tui_gen_win_info |
41 | { | |
08ef48c5 MS |
42 | WINDOW *handle; /* Window handle. */ |
43 | enum tui_win_type type; /* Type of window. */ | |
44 | int width; /* Window width. */ | |
45 | int height; /* Window height. */ | |
46 | struct tui_point origin; /* Origin of window. */ | |
63ed8182 | 47 | tui_win_content content; /* Content of window. */ |
08ef48c5 MS |
48 | int content_size; /* Size of content (# of elements). */ |
49 | int content_in_use; /* Can it be used, or is it already used? */ | |
50 | int viewport_height; /* Viewport height. */ | |
51 | int last_visible_line; /* Index of last visible line. */ | |
52 | int is_visible; /* Whether the window is visible or not. */ | |
53 | char *title; /* Window title to display. */ | |
2a8854a7 | 54 | }; |
2a5127c4 | 55 | |
1cc6d956 | 56 | /* Constant definitions. */ |
08ef48c5 MS |
57 | #define DEFAULT_TAB_LEN 8 |
58 | #define NO_SRC_STRING "[ No Source Available ]" | |
59 | #define NO_DISASSEM_STRING "[ No Assembly Available ]" | |
60 | #define NO_REGS_STRING "[ Register Values Unavailable ]" | |
61 | #define NO_DATA_STRING "[ No Data Values Displayed ]" | |
62 | #define MAX_CONTENT_COUNT 100 | |
6dce28e4 AB |
63 | #define SRC_NAME "src" |
64 | #define CMD_NAME "cmd" | |
65 | #define DATA_NAME "regs" | |
66 | #define DISASSEM_NAME "asm" | |
08ef48c5 MS |
67 | #define TUI_NULL_STR "" |
68 | #define DEFAULT_HISTORY_COUNT 25 | |
69 | #define BOX_WINDOW TRUE | |
70 | #define DONT_BOX_WINDOW FALSE | |
71 | #define HILITE TRUE | |
72 | #define NO_HILITE FALSE | |
73 | #define WITH_LOCATOR TRUE | |
74 | #define NO_LOCATOR FALSE | |
75 | #define EMPTY_SOURCE_PROMPT TRUE | |
76 | #define NO_EMPTY_SOURCE_PROMPT FALSE | |
77 | #define UNDEFINED_ITEM -1 | |
78 | #define MIN_WIN_HEIGHT 3 | |
79 | #define MIN_CMD_WIN_HEIGHT 3 | |
c906108c | 80 | |
50265402 | 81 | /* Strings to display in the TUI status line. */ |
08ef48c5 | 82 | #define PROC_PREFIX "In: " |
9f2850ba | 83 | #define LINE_PREFIX "L" |
08ef48c5 MS |
84 | #define PC_PREFIX "PC: " |
85 | #define SINGLE_KEY "(SingleKey)" | |
50265402 | 86 | |
1cc6d956 MS |
87 | /* Minimum/Maximum length of some fields displayed in the TUI status |
88 | line. */ | |
89 | #define MIN_LINE_WIDTH 4 /* Use at least 4 digits for line | |
90 | numbers. */ | |
50265402 SC |
91 | #define MIN_PROC_WIDTH 12 |
92 | #define MAX_TARGET_WIDTH 10 | |
9f2850ba | 93 | #define MAX_PID_WIDTH 19 |
c906108c | 94 | |
2a8854a7 AC |
95 | /* Scroll direction enum. */ |
96 | enum tui_scroll_direction | |
97 | { | |
98 | FORWARD_SCROLL, | |
99 | BACKWARD_SCROLL, | |
100 | LEFT_SCROLL, | |
101 | RIGHT_SCROLL | |
102 | }; | |
c906108c SS |
103 | |
104 | ||
1cc6d956 | 105 | /* The kinds of layouts available. */ |
2a8854a7 AC |
106 | enum tui_layout_type |
107 | { | |
108 | SRC_COMMAND, | |
109 | DISASSEM_COMMAND, | |
110 | SRC_DISASSEM_COMMAND, | |
111 | SRC_DATA_COMMAND, | |
112 | DISASSEM_DATA_COMMAND, | |
113 | UNDEFINED_LAYOUT | |
114 | }; | |
c906108c | 115 | |
1cc6d956 | 116 | /* Basic data types that can be displayed in the data window. */ |
2a8854a7 AC |
117 | enum tui_data_type |
118 | { | |
119 | TUI_REGISTER, | |
120 | TUI_SCALAR, | |
121 | TUI_COMPLEX, | |
122 | TUI_STRUCT | |
123 | }; | |
c906108c | 124 | |
52059ffd TT |
125 | enum tui_line_or_address_kind |
126 | { | |
127 | LOA_LINE, | |
128 | LOA_ADDRESS | |
129 | }; | |
130 | ||
1cc6d956 | 131 | /* Structure describing source line or line address. */ |
362c05fe | 132 | struct tui_line_or_address |
2a8854a7 | 133 | { |
52059ffd | 134 | enum tui_line_or_address_kind loa; |
362c05fe AS |
135 | union |
136 | { | |
137 | int line_no; | |
138 | CORE_ADDR addr; | |
139 | } u; | |
2a8854a7 | 140 | }; |
c906108c | 141 | |
1cc6d956 | 142 | /* Current Layout definition. */ |
2a8854a7 AC |
143 | struct tui_layout_def |
144 | { | |
6d012f14 | 145 | enum tui_win_type display_mode; |
2a8854a7 | 146 | int split; |
2a8854a7 | 147 | }; |
c906108c | 148 | |
1cc6d956 | 149 | /* Elements in the Source/Disassembly Window. */ |
2a8854a7 AC |
150 | struct tui_source_element |
151 | { | |
152 | char *line; | |
362c05fe | 153 | struct tui_line_or_address line_or_addr; |
6d012f14 AC |
154 | int is_exec_point; |
155 | int has_break; | |
2a8854a7 | 156 | }; |
c906108c SS |
157 | |
158 | ||
1cc6d956 | 159 | /* Elements in the data display window content. */ |
2a8854a7 AC |
160 | struct tui_data_element |
161 | { | |
162 | const char *name; | |
08ef48c5 MS |
163 | int item_no; /* The register number, or data display |
164 | number. */ | |
2a8854a7 | 165 | enum tui_data_type type; |
22940a24 | 166 | void *value; |
2a8854a7 | 167 | int highlight; |
10f59415 | 168 | char *content; |
2a8854a7 | 169 | }; |
c906108c SS |
170 | |
171 | ||
1cc6d956 | 172 | /* Elements in the command window content. */ |
2a8854a7 AC |
173 | struct tui_command_element |
174 | { | |
175 | char *line; | |
176 | }; | |
c906108c | 177 | |
2d42f9a8 JB |
178 | #ifdef PATH_MAX |
179 | # define MAX_LOCATOR_ELEMENT_LEN PATH_MAX | |
180 | #else | |
181 | # define MAX_LOCATOR_ELEMENT_LEN 1024 | |
182 | #endif | |
c906108c | 183 | |
1cc6d956 | 184 | /* Elements in the locator window content. */ |
2a8854a7 AC |
185 | struct tui_locator_element |
186 | { | |
56d397a3 JK |
187 | /* Resolved absolute filename as returned by symtab_to_fullname. */ |
188 | char full_name[MAX_LOCATOR_ELEMENT_LEN]; | |
6d012f14 AC |
189 | char proc_name[MAX_LOCATOR_ELEMENT_LEN]; |
190 | int line_no; | |
2a8854a7 | 191 | CORE_ADDR addr; |
13274fc3 UW |
192 | /* Architecture associated with code at this location. */ |
193 | struct gdbarch *gdbarch; | |
2a8854a7 | 194 | }; |
c906108c | 195 | |
00b2bad4 SC |
196 | /* Flags to tell what kind of breakpoint is at current line. */ |
197 | #define TUI_BP_ENABLED 0x01 | |
198 | #define TUI_BP_DISABLED 0x02 | |
199 | #define TUI_BP_HIT 0x04 | |
200 | #define TUI_BP_CONDITIONAL 0x08 | |
201 | #define TUI_BP_HARDWARE 0x10 | |
202 | ||
203 | /* Position of breakpoint markers in the exec info string. */ | |
204 | #define TUI_BP_HIT_POS 0 | |
205 | #define TUI_BP_BREAK_POS 1 | |
206 | #define TUI_EXEC_POS 2 | |
207 | #define TUI_EXECINFO_SIZE 4 | |
208 | ||
2a8854a7 | 209 | typedef char tui_exec_info_content[TUI_EXECINFO_SIZE]; |
c906108c | 210 | |
1cc6d956 | 211 | /* An content element in a window. */ |
2a8854a7 AC |
212 | union tui_which_element |
213 | { | |
1cc6d956 MS |
214 | struct tui_source_element source; /* The source elements. */ |
215 | struct tui_gen_win_info data_window; /* Data display elements. */ | |
216 | struct tui_data_element data; /* Elements of data_window. */ | |
217 | struct tui_command_element command; /* Command elements. */ | |
218 | struct tui_locator_element locator; /* Locator elements. */ | |
219 | tui_exec_info_content simple_string; /* Simple char based elements. */ | |
2a8854a7 AC |
220 | }; |
221 | ||
222 | struct tui_win_element | |
223 | { | |
6d012f14 | 224 | union tui_which_element which_element; |
2a8854a7 | 225 | }; |
c906108c | 226 | |
1cc6d956 MS |
227 | /* This struct defines the specific information about a data display |
228 | window. */ | |
2a8854a7 AC |
229 | struct tui_data_info |
230 | { | |
1cc6d956 | 231 | tui_win_content data_content; /* Start of data display content. */ |
6d012f14 | 232 | int data_content_count; |
1cc6d956 | 233 | tui_win_content regs_content; /* Start of regs display content. */ |
6d012f14 | 234 | int regs_content_count; |
6d012f14 | 235 | int regs_column_count; |
1cc6d956 | 236 | int display_regs; /* Should regs be displayed at all? */ |
10f59415 | 237 | struct reggroup *current_group; |
2a8854a7 AC |
238 | }; |
239 | ||
240 | ||
241 | struct tui_source_info | |
242 | { | |
1cc6d956 | 243 | int has_locator; /* Does locator belongs to this window? */ |
2a8854a7 | 244 | /* Execution information window. */ |
6d012f14 | 245 | struct tui_gen_win_info *execution_info; |
1cc6d956 | 246 | int horizontal_offset; /* Used for horizontal scroll. */ |
362c05fe | 247 | struct tui_line_or_address start_line_or_addr; |
aa079c93 JK |
248 | |
249 | /* It is the resolved form as returned by symtab_to_fullname. */ | |
250 | char *fullname; | |
251 | ||
13274fc3 UW |
252 | /* Architecture associated with code at this location. */ |
253 | struct gdbarch *gdbarch; | |
2a8854a7 AC |
254 | }; |
255 | ||
256 | ||
257 | struct tui_command_info | |
258 | { | |
2a8854a7 AC |
259 | int start_line; |
260 | }; | |
c906108c SS |
261 | |
262 | ||
1cc6d956 | 263 | /* This defines information about each logical window. */ |
2a8854a7 AC |
264 | struct tui_win_info |
265 | { | |
33b906ab | 266 | protected: |
e7e11af4 | 267 | |
33b906ab | 268 | explicit tui_win_info (enum tui_win_type type); |
6792b55e TT |
269 | DISABLE_COPY_AND_ASSIGN (tui_win_info); |
270 | ||
13446e05 TT |
271 | /* Scroll the contents vertically. This is only called via |
272 | forward_scroll and backward_scroll. */ | |
273 | virtual void do_scroll_vertical (enum tui_scroll_direction, | |
274 | int num_to_scroll) = 0; | |
275 | ||
276 | /* Scroll the contents horizontally. This is only called via | |
277 | left_scroll and right_scroll. */ | |
278 | virtual void do_scroll_horizontal (enum tui_scroll_direction, | |
279 | int num_to_scroll) = 0; | |
280 | ||
33b906ab TT |
281 | public: |
282 | ||
283 | virtual ~tui_win_info (); | |
284 | ||
8761a91b TT |
285 | /* Clear the pertinent detail in the window. */ |
286 | virtual void clear_detail () = 0; | |
287 | ||
13446e05 TT |
288 | /* Methods to scroll the contents of this window. Note that they |
289 | are named with "_scroll" coming at the end because the more | |
290 | obvious "scroll_forward" is defined as a macro in term.h. */ | |
291 | void forward_scroll (int num_to_scroll); | |
292 | void backward_scroll (int num_to_scroll); | |
293 | void left_scroll (int num_to_scroll); | |
294 | void right_scroll (int num_to_scroll); | |
295 | ||
1cc6d956 | 296 | struct tui_gen_win_info generic; /* General window information. */ |
2a8854a7 | 297 | union |
c5aa993b | 298 | { |
6d012f14 AC |
299 | struct tui_source_info source_info; |
300 | struct tui_data_info data_display_info; | |
301 | struct tui_command_info command_info; | |
c5aa993b | 302 | } |
2a8854a7 | 303 | detail; |
33b906ab TT |
304 | |
305 | /* Can this window ever be highlighted? */ | |
306 | int can_highlight = 0; | |
307 | ||
308 | /* Is this window highlighted? */ | |
309 | int is_highlighted = 0; | |
310 | }; | |
311 | ||
5cf82909 TT |
312 | /* The base class for all source-like windows, namely the source and |
313 | disassembly windows. */ | |
314 | ||
315 | struct tui_source_window_base : public tui_win_info | |
33b906ab | 316 | { |
5cf82909 TT |
317 | protected: |
318 | explicit tui_source_window_base (enum tui_win_type type); | |
319 | ~tui_source_window_base () override; | |
320 | DISABLE_COPY_AND_ASSIGN (tui_source_window_base); | |
321 | ||
13446e05 TT |
322 | void do_scroll_horizontal (enum tui_scroll_direction, |
323 | int num_to_scroll) override; | |
324 | ||
5cf82909 | 325 | public: |
8761a91b TT |
326 | |
327 | void clear_detail () override; | |
33b906ab TT |
328 | }; |
329 | ||
5cf82909 TT |
330 | /* A TUI source window. */ |
331 | ||
332 | struct tui_source_window : public tui_source_window_base | |
333 | { | |
334 | tui_source_window () | |
335 | : tui_source_window_base (SRC_WIN) | |
336 | { | |
337 | } | |
338 | ||
339 | DISABLE_COPY_AND_ASSIGN (tui_source_window); | |
13446e05 TT |
340 | |
341 | protected: | |
342 | ||
343 | void do_scroll_vertical (enum tui_scroll_direction, | |
344 | int num_to_scroll) override; | |
5cf82909 TT |
345 | }; |
346 | ||
347 | /* A TUI disassembly window. */ | |
348 | ||
349 | struct tui_disasm_window : public tui_source_window_base | |
350 | { | |
351 | tui_disasm_window () | |
352 | : tui_source_window_base (DISASSEM_WIN) | |
353 | { | |
354 | } | |
355 | ||
356 | DISABLE_COPY_AND_ASSIGN (tui_disasm_window); | |
13446e05 TT |
357 | |
358 | protected: | |
359 | ||
360 | void do_scroll_vertical (enum tui_scroll_direction, | |
361 | int num_to_scroll) override; | |
5cf82909 TT |
362 | }; |
363 | ||
33b906ab TT |
364 | struct tui_data_window : public tui_win_info |
365 | { | |
366 | tui_data_window (); | |
ee1d42d6 | 367 | ~tui_data_window () override; |
33b906ab | 368 | DISABLE_COPY_AND_ASSIGN (tui_data_window); |
8761a91b TT |
369 | |
370 | void clear_detail () override; | |
13446e05 TT |
371 | |
372 | protected: | |
373 | ||
374 | void do_scroll_vertical (enum tui_scroll_direction, | |
375 | int num_to_scroll) override; | |
376 | void do_scroll_horizontal (enum tui_scroll_direction, | |
377 | int num_to_scroll) override | |
378 | { | |
379 | } | |
33b906ab TT |
380 | }; |
381 | ||
382 | struct tui_cmd_window : public tui_win_info | |
383 | { | |
384 | tui_cmd_window (); | |
385 | DISABLE_COPY_AND_ASSIGN (tui_cmd_window); | |
8761a91b TT |
386 | |
387 | void clear_detail () override; | |
13446e05 TT |
388 | |
389 | protected: | |
390 | ||
391 | void do_scroll_vertical (enum tui_scroll_direction, | |
392 | int num_to_scroll) override | |
393 | { | |
394 | } | |
395 | ||
396 | void do_scroll_horizontal (enum tui_scroll_direction, | |
397 | int num_to_scroll) override | |
398 | { | |
399 | } | |
2a8854a7 | 400 | }; |
c906108c | 401 | |
6d012f14 AC |
402 | extern int tui_win_is_source_type (enum tui_win_type win_type); |
403 | extern int tui_win_is_auxillary (enum tui_win_type win_type); | |
404 | extern int tui_win_has_locator (struct tui_win_info *win_info); | |
405 | extern void tui_set_win_highlight (struct tui_win_info *win_info, | |
406 | int highlight); | |
c906108c SS |
407 | |
408 | ||
1cc6d956 | 409 | /* Global Data. */ |
7fa29be9 | 410 | extern struct tui_win_info *tui_win_list[MAX_MAJOR_WINDOWS]; |
c906108c | 411 | |
1cc6d956 MS |
412 | #define TUI_SRC_WIN tui_win_list[SRC_WIN] |
413 | #define TUI_DISASM_WIN tui_win_list[DISASSEM_WIN] | |
414 | #define TUI_DATA_WIN tui_win_list[DATA_WIN] | |
415 | #define TUI_CMD_WIN tui_win_list[CMD_WIN] | |
c906108c | 416 | |
1cc6d956 | 417 | /* Data Manipulation Functions. */ |
dd1abb8c AC |
418 | extern void tui_initialize_static_data (void); |
419 | extern struct tui_gen_win_info *tui_alloc_generic_win_info (void); | |
22940a24 | 420 | extern struct tui_win_info *tui_alloc_win_info (enum tui_win_type); |
dd1abb8c | 421 | extern void tui_init_generic_part (struct tui_gen_win_info *); |
2a8854a7 | 422 | extern tui_win_content tui_alloc_content (int, enum tui_win_type); |
08ef48c5 MS |
423 | extern int tui_add_content_elements (struct tui_gen_win_info *, |
424 | int); | |
dd1abb8c | 425 | extern void tui_free_win_content (struct tui_gen_win_info *); |
2a8854a7 | 426 | extern void tui_free_data_content (tui_win_content, int); |
dd1abb8c | 427 | extern void tui_free_all_source_wins_content (void); |
a121b7c1 | 428 | extern struct tui_win_info *tui_partial_win_by_name (const char *); |
f41cbf58 | 429 | extern const char *tui_win_name (const struct tui_gen_win_info *); |
2a8854a7 AC |
430 | extern enum tui_layout_type tui_current_layout (void); |
431 | extern void tui_set_current_layout_to (enum tui_layout_type); | |
dd1abb8c AC |
432 | extern int tui_term_height (void); |
433 | extern void tui_set_term_height_to (int); | |
434 | extern int tui_term_width (void); | |
435 | extern void tui_set_term_width_to (int); | |
dd1abb8c AC |
436 | extern struct tui_gen_win_info *tui_locator_win_info_ptr (void); |
437 | extern struct tui_gen_win_info *tui_source_exec_info_win_ptr (void); | |
438 | extern struct tui_gen_win_info *tui_disassem_exec_info_win_ptr (void); | |
b4eb2452 | 439 | extern std::vector<tui_win_info *> &tui_source_windows (); |
dd1abb8c AC |
440 | extern void tui_clear_source_windows (void); |
441 | extern void tui_clear_source_windows_detail (void); | |
08ef48c5 | 442 | extern void tui_clear_win_detail (struct tui_win_info *); |
dd1abb8c | 443 | extern void tui_add_to_source_windows (struct tui_win_info *); |
dd1abb8c AC |
444 | extern struct tui_win_info *tui_win_with_focus (void); |
445 | extern void tui_set_win_with_focus (struct tui_win_info *); | |
5b6fe301 | 446 | extern struct tui_layout_def *tui_layout_def (void); |
dd1abb8c AC |
447 | extern int tui_win_resized (void); |
448 | extern void tui_set_win_resized_to (int); | |
449 | ||
450 | extern struct tui_win_info *tui_next_win (struct tui_win_info *); | |
451 | extern struct tui_win_info *tui_prev_win (struct tui_win_info *); | |
452 | ||
08ef48c5 | 453 | extern void tui_add_to_source_windows (struct tui_win_info *); |
c7c228ed | 454 | |
7806cea7 TT |
455 | extern unsigned int tui_tab_width; |
456 | ||
1a5c2598 | 457 | #endif /* TUI_TUI_DATA_H */ |