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 | { | |
44f0e208 TT |
243 | /* Does the locator belong to this window? */ |
244 | bool has_locator; | |
2a8854a7 | 245 | /* Execution information window. */ |
6d012f14 | 246 | struct tui_gen_win_info *execution_info; |
1cc6d956 | 247 | int horizontal_offset; /* Used for horizontal scroll. */ |
362c05fe | 248 | struct tui_line_or_address start_line_or_addr; |
aa079c93 JK |
249 | |
250 | /* It is the resolved form as returned by symtab_to_fullname. */ | |
251 | char *fullname; | |
252 | ||
13274fc3 UW |
253 | /* Architecture associated with code at this location. */ |
254 | struct gdbarch *gdbarch; | |
2a8854a7 AC |
255 | }; |
256 | ||
257 | ||
258 | struct tui_command_info | |
259 | { | |
2a8854a7 AC |
260 | int start_line; |
261 | }; | |
c906108c SS |
262 | |
263 | ||
1cc6d956 | 264 | /* This defines information about each logical window. */ |
2a8854a7 AC |
265 | struct tui_win_info |
266 | { | |
33b906ab | 267 | protected: |
e7e11af4 | 268 | |
33b906ab | 269 | explicit tui_win_info (enum tui_win_type type); |
6792b55e TT |
270 | DISABLE_COPY_AND_ASSIGN (tui_win_info); |
271 | ||
13446e05 TT |
272 | /* Scroll the contents vertically. This is only called via |
273 | forward_scroll and backward_scroll. */ | |
274 | virtual void do_scroll_vertical (enum tui_scroll_direction, | |
275 | int num_to_scroll) = 0; | |
276 | ||
277 | /* Scroll the contents horizontally. This is only called via | |
278 | left_scroll and right_scroll. */ | |
279 | virtual void do_scroll_horizontal (enum tui_scroll_direction, | |
280 | int num_to_scroll) = 0; | |
281 | ||
33b906ab TT |
282 | public: |
283 | ||
284 | virtual ~tui_win_info (); | |
285 | ||
8761a91b TT |
286 | /* Clear the pertinent detail in the window. */ |
287 | virtual void clear_detail () = 0; | |
288 | ||
44f0e208 TT |
289 | /* Return true if this window has the locator. */ |
290 | virtual bool has_locator () const | |
291 | { | |
292 | return false; | |
293 | } | |
294 | ||
13446e05 TT |
295 | /* Methods to scroll the contents of this window. Note that they |
296 | are named with "_scroll" coming at the end because the more | |
297 | obvious "scroll_forward" is defined as a macro in term.h. */ | |
298 | void forward_scroll (int num_to_scroll); | |
299 | void backward_scroll (int num_to_scroll); | |
300 | void left_scroll (int num_to_scroll); | |
301 | void right_scroll (int num_to_scroll); | |
302 | ||
1cc6d956 | 303 | struct tui_gen_win_info generic; /* General window information. */ |
2a8854a7 | 304 | union |
c5aa993b | 305 | { |
6d012f14 AC |
306 | struct tui_source_info source_info; |
307 | struct tui_data_info data_display_info; | |
308 | struct tui_command_info command_info; | |
c5aa993b | 309 | } |
2a8854a7 | 310 | detail; |
33b906ab TT |
311 | |
312 | /* Can this window ever be highlighted? */ | |
313 | int can_highlight = 0; | |
314 | ||
315 | /* Is this window highlighted? */ | |
316 | int is_highlighted = 0; | |
317 | }; | |
318 | ||
5cf82909 TT |
319 | /* The base class for all source-like windows, namely the source and |
320 | disassembly windows. */ | |
321 | ||
322 | struct tui_source_window_base : public tui_win_info | |
33b906ab | 323 | { |
5cf82909 TT |
324 | protected: |
325 | explicit tui_source_window_base (enum tui_win_type type); | |
326 | ~tui_source_window_base () override; | |
327 | DISABLE_COPY_AND_ASSIGN (tui_source_window_base); | |
328 | ||
13446e05 TT |
329 | void do_scroll_horizontal (enum tui_scroll_direction, |
330 | int num_to_scroll) override; | |
331 | ||
5cf82909 | 332 | public: |
8761a91b TT |
333 | |
334 | void clear_detail () override; | |
44f0e208 TT |
335 | |
336 | /* Return true if this window has the locator. */ | |
337 | bool has_locator () const override; | |
33b906ab TT |
338 | }; |
339 | ||
5cf82909 TT |
340 | /* A TUI source window. */ |
341 | ||
342 | struct tui_source_window : public tui_source_window_base | |
343 | { | |
344 | tui_source_window () | |
345 | : tui_source_window_base (SRC_WIN) | |
346 | { | |
347 | } | |
348 | ||
349 | DISABLE_COPY_AND_ASSIGN (tui_source_window); | |
13446e05 TT |
350 | |
351 | protected: | |
352 | ||
353 | void do_scroll_vertical (enum tui_scroll_direction, | |
354 | int num_to_scroll) override; | |
5cf82909 TT |
355 | }; |
356 | ||
357 | /* A TUI disassembly window. */ | |
358 | ||
359 | struct tui_disasm_window : public tui_source_window_base | |
360 | { | |
361 | tui_disasm_window () | |
362 | : tui_source_window_base (DISASSEM_WIN) | |
363 | { | |
364 | } | |
365 | ||
366 | DISABLE_COPY_AND_ASSIGN (tui_disasm_window); | |
13446e05 TT |
367 | |
368 | protected: | |
369 | ||
370 | void do_scroll_vertical (enum tui_scroll_direction, | |
371 | int num_to_scroll) override; | |
5cf82909 TT |
372 | }; |
373 | ||
33b906ab TT |
374 | struct tui_data_window : public tui_win_info |
375 | { | |
376 | tui_data_window (); | |
ee1d42d6 | 377 | ~tui_data_window () override; |
33b906ab | 378 | DISABLE_COPY_AND_ASSIGN (tui_data_window); |
8761a91b TT |
379 | |
380 | void clear_detail () override; | |
13446e05 TT |
381 | |
382 | protected: | |
383 | ||
384 | void do_scroll_vertical (enum tui_scroll_direction, | |
385 | int num_to_scroll) override; | |
386 | void do_scroll_horizontal (enum tui_scroll_direction, | |
387 | int num_to_scroll) override | |
388 | { | |
389 | } | |
33b906ab TT |
390 | }; |
391 | ||
392 | struct tui_cmd_window : public tui_win_info | |
393 | { | |
394 | tui_cmd_window (); | |
395 | DISABLE_COPY_AND_ASSIGN (tui_cmd_window); | |
8761a91b TT |
396 | |
397 | void clear_detail () override; | |
13446e05 TT |
398 | |
399 | protected: | |
400 | ||
401 | void do_scroll_vertical (enum tui_scroll_direction, | |
402 | int num_to_scroll) override | |
403 | { | |
404 | } | |
405 | ||
406 | void do_scroll_horizontal (enum tui_scroll_direction, | |
407 | int num_to_scroll) override | |
408 | { | |
409 | } | |
2a8854a7 | 410 | }; |
c906108c | 411 | |
6d012f14 AC |
412 | extern int tui_win_is_source_type (enum tui_win_type win_type); |
413 | extern int tui_win_is_auxillary (enum tui_win_type win_type); | |
6d012f14 AC |
414 | extern void tui_set_win_highlight (struct tui_win_info *win_info, |
415 | int highlight); | |
c906108c SS |
416 | |
417 | ||
1cc6d956 | 418 | /* Global Data. */ |
7fa29be9 | 419 | extern struct tui_win_info *tui_win_list[MAX_MAJOR_WINDOWS]; |
c906108c | 420 | |
1cc6d956 MS |
421 | #define TUI_SRC_WIN tui_win_list[SRC_WIN] |
422 | #define TUI_DISASM_WIN tui_win_list[DISASSEM_WIN] | |
423 | #define TUI_DATA_WIN tui_win_list[DATA_WIN] | |
424 | #define TUI_CMD_WIN tui_win_list[CMD_WIN] | |
c906108c | 425 | |
1cc6d956 | 426 | /* Data Manipulation Functions. */ |
dd1abb8c AC |
427 | extern void tui_initialize_static_data (void); |
428 | extern struct tui_gen_win_info *tui_alloc_generic_win_info (void); | |
22940a24 | 429 | extern struct tui_win_info *tui_alloc_win_info (enum tui_win_type); |
dd1abb8c | 430 | extern void tui_init_generic_part (struct tui_gen_win_info *); |
2a8854a7 | 431 | extern tui_win_content tui_alloc_content (int, enum tui_win_type); |
08ef48c5 MS |
432 | extern int tui_add_content_elements (struct tui_gen_win_info *, |
433 | int); | |
dd1abb8c | 434 | extern void tui_free_win_content (struct tui_gen_win_info *); |
2a8854a7 | 435 | extern void tui_free_data_content (tui_win_content, int); |
dd1abb8c | 436 | extern void tui_free_all_source_wins_content (void); |
a121b7c1 | 437 | extern struct tui_win_info *tui_partial_win_by_name (const char *); |
f41cbf58 | 438 | extern const char *tui_win_name (const struct tui_gen_win_info *); |
2a8854a7 AC |
439 | extern enum tui_layout_type tui_current_layout (void); |
440 | extern void tui_set_current_layout_to (enum tui_layout_type); | |
dd1abb8c AC |
441 | extern int tui_term_height (void); |
442 | extern void tui_set_term_height_to (int); | |
443 | extern int tui_term_width (void); | |
444 | extern void tui_set_term_width_to (int); | |
dd1abb8c AC |
445 | extern struct tui_gen_win_info *tui_locator_win_info_ptr (void); |
446 | extern struct tui_gen_win_info *tui_source_exec_info_win_ptr (void); | |
447 | extern struct tui_gen_win_info *tui_disassem_exec_info_win_ptr (void); | |
b4eb2452 | 448 | extern std::vector<tui_win_info *> &tui_source_windows (); |
dd1abb8c AC |
449 | extern void tui_clear_source_windows (void); |
450 | extern void tui_clear_source_windows_detail (void); | |
dd1abb8c | 451 | extern void tui_add_to_source_windows (struct tui_win_info *); |
dd1abb8c AC |
452 | extern struct tui_win_info *tui_win_with_focus (void); |
453 | extern void tui_set_win_with_focus (struct tui_win_info *); | |
5b6fe301 | 454 | extern struct tui_layout_def *tui_layout_def (void); |
dd1abb8c AC |
455 | extern int tui_win_resized (void); |
456 | extern void tui_set_win_resized_to (int); | |
457 | ||
458 | extern struct tui_win_info *tui_next_win (struct tui_win_info *); | |
459 | extern struct tui_win_info *tui_prev_win (struct tui_win_info *); | |
460 | ||
08ef48c5 | 461 | extern void tui_add_to_source_windows (struct tui_win_info *); |
c7c228ed | 462 | |
7806cea7 TT |
463 | extern unsigned int tui_tab_width; |
464 | ||
1a5c2598 | 465 | #endif /* TUI_TUI_DATA_H */ |