ODR warnings for "struct coff_symbol"
[binutils-gdb.git] / gdb / tui / tui-io.c
1 /* TUI support I/O functions.
2
3 Copyright (C) 1998-2022 Free Software Foundation, Inc.
4
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
11 the Free Software Foundation; either version 3 of the License, or
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
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21
22 #include "defs.h"
23 #include "target.h"
24 #include "gdbsupport/event-loop.h"
25 #include "event-top.h"
26 #include "command.h"
27 #include "top.h"
28 #include "tui/tui.h"
29 #include "tui/tui-data.h"
30 #include "tui/tui-io.h"
31 #include "tui/tui-command.h"
32 #include "tui/tui-win.h"
33 #include "tui/tui-wingeneral.h"
34 #include "tui/tui-file.h"
35 #include "tui/tui-out.h"
36 #include "ui-out.h"
37 #include "cli-out.h"
38 #include <fcntl.h>
39 #include <signal.h>
40 #ifdef __MINGW32__
41 #include <windows.h>
42 #endif
43 #include "gdbsupport/filestuff.h"
44 #include "completer.h"
45 #include "gdb_curses.h"
46 #include <map>
47 #include "pager.h"
48
49 /* This redefines CTRL if it is not already defined, so it must come
50 after terminal state releated include files like <term.h> and
51 "gdb_curses.h". */
52 #include "readline/readline.h"
53
54 #ifdef __MINGW32__
55 static SHORT ncurses_norm_attr;
56 #endif
57
58 static int tui_getc (FILE *fp);
59
60 static int
61 key_is_start_sequence (int ch)
62 {
63 return (ch == 27);
64 }
65
66 /* Use definition from readline 4.3. */
67 #undef CTRL_CHAR
68 #define CTRL_CHAR(c) \
69 ((c) < control_character_threshold && (((c) & 0x80) == 0))
70
71 /* This file controls the IO interactions between gdb and curses.
72 When the TUI is enabled, gdb has two modes a curses and a standard
73 mode.
74
75 In curses mode, the gdb outputs are made in a curses command
76 window. For this, the gdb_stdout and gdb_stderr are redirected to
77 the specific ui_file implemented by TUI. The output is handled by
78 tui_puts(). The input is also controlled by curses with
79 tui_getc(). The readline library uses this function to get its
80 input. Several readline hooks are installed to redirect readline
81 output to the TUI (see also the note below).
82
83 In normal mode, the gdb outputs are restored to their origin, that
84 is as if TUI is not used. Readline also uses its original getc()
85 function with stdin.
86
87 Note SCz/2001-07-21: the current readline is not clean in its
88 management of the output. Even if we install a redisplay handler,
89 it sometimes writes on a stdout file. It is important to redirect
90 every output produced by readline, otherwise the curses window will
91 be garbled. This is implemented with a pipe that TUI reads and
92 readline writes to. A gdb input handler is created so that reading
93 the pipe is handled automatically. This will probably not work on
94 non-Unix platforms. The best fix is to make readline clean enough
95 so that is never write on stdout.
96
97 Note SCz/2002-09-01: we now use more readline hooks and it seems
98 that with them we don't need the pipe anymore (verified by creating
99 the pipe and closing its end so that write causes a SIGPIPE). The
100 old pipe code is still there and can be conditionally removed by
101 #undef TUI_USE_PIPE_FOR_READLINE. */
102
103 /* For gdb 5.3, prefer to continue the pipe hack as a backup wheel. */
104 #ifdef HAVE_PIPE
105 #define TUI_USE_PIPE_FOR_READLINE
106 #endif
107 /* #undef TUI_USE_PIPE_FOR_READLINE */
108
109 /* TUI output files. */
110 static struct ui_file *tui_stdout;
111 static struct ui_file *tui_stderr;
112 static struct ui_file *tui_stdlog;
113 struct ui_out *tui_out;
114
115 /* GDB output files in non-curses mode. */
116 static struct ui_file *tui_old_stdout;
117 static struct ui_file *tui_old_stderr;
118 static struct ui_file *tui_old_stdlog;
119 cli_ui_out *tui_old_uiout;
120
121 /* Readline previous hooks. */
122 static rl_getc_func_t *tui_old_rl_getc_function;
123 static rl_voidfunc_t *tui_old_rl_redisplay_function;
124 static rl_vintfunc_t *tui_old_rl_prep_terminal;
125 static rl_voidfunc_t *tui_old_rl_deprep_terminal;
126 static rl_compdisp_func_t *tui_old_rl_display_matches_hook;
127 static int tui_old_rl_echoing_p;
128
129 /* Readline output stream.
130 Should be removed when readline is clean. */
131 static FILE *tui_rl_outstream;
132 static FILE *tui_old_rl_outstream;
133 #ifdef TUI_USE_PIPE_FOR_READLINE
134 static int tui_readline_pipe[2];
135 #endif
136
137 /* Print a character in the curses command window. The output is
138 buffered. It is up to the caller to refresh the screen if
139 necessary. */
140
141 static void
142 do_tui_putc (WINDOW *w, char c)
143 {
144 /* Expand TABs, since ncurses on MS-Windows doesn't. */
145 if (c == '\t')
146 {
147 int col;
148
149 col = getcurx (w);
150 do
151 {
152 waddch (w, ' ');
153 col++;
154 }
155 while ((col % 8) != 0);
156 }
157 else
158 waddch (w, c);
159 }
160
161 /* Update the cached value of the command window's start line based on
162 the window's current Y coordinate. */
163
164 static void
165 update_cmdwin_start_line ()
166 {
167 TUI_CMD_WIN->start_line = getcury (TUI_CMD_WIN->handle.get ());
168 }
169
170 /* Print a character in the curses command window. The output is
171 buffered. It is up to the caller to refresh the screen if
172 necessary. */
173
174 static void
175 tui_putc (char c)
176 {
177 do_tui_putc (TUI_CMD_WIN->handle.get (), c);
178 update_cmdwin_start_line ();
179 }
180
181 /* This maps colors to their corresponding color index. */
182
183 static std::map<ui_file_style::color, int> color_map;
184
185 /* This holds a pair of colors and is used to track the mapping
186 between a color pair index and the actual colors. */
187
188 struct color_pair
189 {
190 int fg;
191 int bg;
192
193 bool operator< (const color_pair &o) const
194 {
195 return fg < o.fg || (fg == o.fg && bg < o.bg);
196 }
197 };
198
199 /* This maps pairs of colors to their corresponding color pair
200 index. */
201
202 static std::map<color_pair, int> color_pair_map;
203
204 /* This is indexed by ANSI color offset from the base color, and holds
205 the corresponding curses color constant. */
206
207 static const int curses_colors[] = {
208 COLOR_BLACK,
209 COLOR_RED,
210 COLOR_GREEN,
211 COLOR_YELLOW,
212 COLOR_BLUE,
213 COLOR_MAGENTA,
214 COLOR_CYAN,
215 COLOR_WHITE
216 };
217
218 /* Given a color, find its index. */
219
220 static bool
221 get_color (const ui_file_style::color &color, int *result)
222 {
223 if (color.is_none ())
224 *result = -1;
225 else if (color.is_basic ())
226 *result = curses_colors[color.get_value ()];
227 else
228 {
229 auto it = color_map.find (color);
230 if (it == color_map.end ())
231 {
232 /* The first 8 colors are standard. */
233 int next = color_map.size () + 8;
234 if (next >= COLORS)
235 return false;
236 uint8_t rgb[3];
237 color.get_rgb (rgb);
238 /* We store RGB as 0..255, but curses wants 0..1000. */
239 if (init_color (next, rgb[0] * 1000 / 255, rgb[1] * 1000 / 255,
240 rgb[2] * 1000 / 255) == ERR)
241 return false;
242 color_map[color] = next;
243 *result = next;
244 }
245 else
246 *result = it->second;
247 }
248 return true;
249 }
250
251 /* The most recently emitted color pair. */
252
253 static int last_color_pair = -1;
254
255 /* The most recently applied style. */
256
257 static ui_file_style last_style;
258
259 /* If true, we're highlighting the current source line in reverse
260 video mode. */
261 static bool reverse_mode_p = false;
262
263 /* The background/foreground colors before we entered reverse
264 mode. */
265 static ui_file_style::color reverse_save_bg (ui_file_style::NONE);
266 static ui_file_style::color reverse_save_fg (ui_file_style::NONE);
267
268 /* Given two colors, return their color pair index; making a new one
269 if necessary. */
270
271 static int
272 get_color_pair (int fg, int bg)
273 {
274 color_pair c = { fg, bg };
275 auto it = color_pair_map.find (c);
276 if (it == color_pair_map.end ())
277 {
278 /* Color pair 0 is our default color, so new colors start at
279 1. */
280 int next = color_pair_map.size () + 1;
281 /* Curses has a limited number of available color pairs. Fall
282 back to the default if we've used too many. */
283 if (next >= COLOR_PAIRS)
284 return 0;
285 init_pair (next, fg, bg);
286 color_pair_map[c] = next;
287 return next;
288 }
289 return it->second;
290 }
291
292 /* Apply STYLE to W. */
293
294 void
295 tui_apply_style (WINDOW *w, ui_file_style style)
296 {
297 /* Reset. */
298 wattron (w, A_NORMAL);
299 wattroff (w, A_BOLD);
300 wattroff (w, A_DIM);
301 wattroff (w, A_REVERSE);
302 if (last_color_pair != -1)
303 wattroff (w, COLOR_PAIR (last_color_pair));
304 wattron (w, COLOR_PAIR (0));
305
306 const ui_file_style::color &fg = style.get_foreground ();
307 const ui_file_style::color &bg = style.get_background ();
308 if (!fg.is_none () || !bg.is_none ())
309 {
310 int fgi, bgi;
311 if (get_color (fg, &fgi) && get_color (bg, &bgi))
312 {
313 #ifdef __MINGW32__
314 /* MS-Windows port of ncurses doesn't support implicit
315 default foreground and background colors, so we must
316 specify them explicitly when needed, using the colors we
317 saw at startup. */
318 if (fgi == -1)
319 fgi = ncurses_norm_attr & 15;
320 if (bgi == -1)
321 bgi = (ncurses_norm_attr >> 4) & 15;
322 #endif
323 int pair = get_color_pair (fgi, bgi);
324 if (last_color_pair != -1)
325 wattroff (w, COLOR_PAIR (last_color_pair));
326 wattron (w, COLOR_PAIR (pair));
327 last_color_pair = pair;
328 }
329 }
330
331 switch (style.get_intensity ())
332 {
333 case ui_file_style::NORMAL:
334 break;
335
336 case ui_file_style::BOLD:
337 wattron (w, A_BOLD);
338 break;
339
340 case ui_file_style::DIM:
341 wattron (w, A_DIM);
342 break;
343
344 default:
345 gdb_assert_not_reached ("invalid intensity");
346 }
347
348 if (style.is_reverse ())
349 wattron (w, A_REVERSE);
350
351 last_style = style;
352 }
353
354 /* Apply an ANSI escape sequence from BUF to W. BUF must start with
355 the ESC character. If BUF does not start with an ANSI escape,
356 return 0. Otherwise, apply the sequence if it is recognized, or
357 simply ignore it if not. In this case, the number of bytes read
358 from BUF is returned. */
359
360 static size_t
361 apply_ansi_escape (WINDOW *w, const char *buf)
362 {
363 ui_file_style style = last_style;
364 size_t n_read;
365
366 if (!style.parse (buf, &n_read))
367 return n_read;
368
369 if (reverse_mode_p)
370 {
371 /* We want to reverse _only_ the default foreground/background
372 colors. If the foreground color is not the default (because
373 the text was styled), we want to leave it as is. If e.g.,
374 the terminal is fg=BLACK, and bg=WHITE, and the style wants
375 to print text in RED, we want to reverse the background color
376 (print in BLACK), but still print the text in RED. To do
377 that, we enable the A_REVERSE attribute, and re-reverse the
378 parsed-style's fb/bg colors.
379
380 Notes on the approach:
381
382 - there's no portable way to know which colors the default
383 fb/bg colors map to.
384
385 - this approach does the right thing even if you change the
386 terminal colors while GDB is running -- the reversed
387 colors automatically adapt.
388 */
389 if (!style.is_default ())
390 {
391 ui_file_style::color bg = style.get_background ();
392 ui_file_style::color fg = style.get_foreground ();
393 style.set_fg (bg);
394 style.set_bg (fg);
395 }
396
397 /* Enable A_REVERSE. */
398 style.set_reverse (true);
399 }
400
401 tui_apply_style (w, style);
402 return n_read;
403 }
404
405 /* See tui.io.h. */
406
407 void
408 tui_set_reverse_mode (WINDOW *w, bool reverse)
409 {
410 ui_file_style style = last_style;
411
412 reverse_mode_p = reverse;
413 style.set_reverse (reverse);
414
415 if (reverse)
416 {
417 reverse_save_bg = style.get_background ();
418 reverse_save_fg = style.get_foreground ();
419 }
420 else
421 {
422 style.set_bg (reverse_save_bg);
423 style.set_fg (reverse_save_fg);
424 }
425
426 tui_apply_style (w, style);
427 }
428
429 /* Print LENGTH characters from the buffer pointed to by BUF to the
430 curses command window. The output is buffered. It is up to the
431 caller to refresh the screen if necessary. */
432
433 void
434 tui_write (const char *buf, size_t length)
435 {
436 /* We need this to be \0-terminated for the regexp matching. */
437 std::string copy (buf, length);
438 tui_puts (copy.c_str ());
439 }
440
441 /* Print a string in the curses command window. The output is
442 buffered. It is up to the caller to refresh the screen if
443 necessary. */
444
445 void
446 tui_puts (const char *string, WINDOW *w)
447 {
448 if (w == nullptr)
449 w = TUI_CMD_WIN->handle.get ();
450
451 while (true)
452 {
453 const char *next = strpbrk (string, "\n\1\2\033\t");
454
455 /* Print the plain text prefix. */
456 size_t n_chars = next == nullptr ? strlen (string) : next - string;
457 if (n_chars > 0)
458 waddnstr (w, string, n_chars);
459
460 /* We finished. */
461 if (next == nullptr)
462 break;
463
464 char c = *next;
465 switch (c)
466 {
467 case '\1':
468 case '\2':
469 /* Ignore these, they are readline escape-marking
470 sequences. */
471 ++next;
472 break;
473
474 case '\n':
475 case '\t':
476 do_tui_putc (w, c);
477 ++next;
478 break;
479
480 case '\033':
481 {
482 size_t bytes_read = apply_ansi_escape (w, next);
483 if (bytes_read > 0)
484 next += bytes_read;
485 else
486 {
487 /* Just drop the escape. */
488 ++next;
489 }
490 }
491 break;
492
493 default:
494 gdb_assert_not_reached ("missing case in tui_puts");
495 }
496
497 string = next;
498 }
499
500 if (TUI_CMD_WIN != nullptr && w == TUI_CMD_WIN->handle.get ())
501 update_cmdwin_start_line ();
502 }
503
504 static void
505 tui_puts_internal (WINDOW *w, const char *string, int *height)
506 {
507 char c;
508 int prev_col = 0;
509 bool saw_nl = false;
510
511 while ((c = *string++) != 0)
512 {
513 if (c == '\n')
514 saw_nl = true;
515
516 if (c == '\1' || c == '\2')
517 {
518 /* Ignore these, they are readline escape-marking
519 sequences. */
520 }
521 else
522 {
523 if (c == '\033')
524 {
525 size_t bytes_read = apply_ansi_escape (w, string - 1);
526 if (bytes_read > 0)
527 {
528 string = string + bytes_read - 1;
529 continue;
530 }
531 }
532 do_tui_putc (w, c);
533
534 if (height != nullptr)
535 {
536 int col = getcurx (w);
537 if (col <= prev_col)
538 ++*height;
539 prev_col = col;
540 }
541 }
542 }
543 if (TUI_CMD_WIN != nullptr && w == TUI_CMD_WIN->handle.get ())
544 update_cmdwin_start_line ();
545 if (saw_nl)
546 wrefresh (w);
547 }
548
549 /* Readline callback.
550 Redisplay the command line with its prompt after readline has
551 changed the edited text. */
552 void
553 tui_redisplay_readline (void)
554 {
555 int prev_col;
556 int height;
557 int col;
558 int c_pos;
559 int c_line;
560 int in;
561 WINDOW *w;
562 const char *prompt;
563 int start_line;
564
565 /* Detect when we temporarily left SingleKey and now the readline
566 edit buffer is empty, automatically restore the SingleKey
567 mode. The restore must only be done if the command has finished.
568 The command could call prompt_for_continue and we must not
569 restore SingleKey so that the prompt and normal keymap are used. */
570 if (tui_current_key_mode == TUI_ONE_COMMAND_MODE && rl_end == 0
571 && !gdb_in_secondary_prompt_p (current_ui))
572 tui_set_key_mode (TUI_SINGLE_KEY_MODE);
573
574 if (tui_current_key_mode == TUI_SINGLE_KEY_MODE)
575 prompt = "";
576 else
577 prompt = rl_display_prompt;
578
579 c_pos = -1;
580 c_line = -1;
581 w = TUI_CMD_WIN->handle.get ();
582 start_line = TUI_CMD_WIN->start_line;
583 wmove (w, start_line, 0);
584 prev_col = 0;
585 height = 1;
586 if (prompt != nullptr)
587 tui_puts_internal (w, prompt, &height);
588
589 prev_col = getcurx (w);
590 for (in = 0; in <= rl_end; in++)
591 {
592 unsigned char c;
593
594 if (in == rl_point)
595 {
596 getyx (w, c_line, c_pos);
597 }
598
599 if (in == rl_end)
600 break;
601
602 c = (unsigned char) rl_line_buffer[in];
603 if (CTRL_CHAR (c) || c == RUBOUT)
604 {
605 waddch (w, '^');
606 waddch (w, CTRL_CHAR (c) ? UNCTRL (c) : '?');
607 }
608 else if (c == '\t')
609 {
610 /* Expand TABs, since ncurses on MS-Windows doesn't. */
611 col = getcurx (w);
612 do
613 {
614 waddch (w, ' ');
615 col++;
616 } while ((col % 8) != 0);
617 }
618 else
619 {
620 waddch (w, c);
621 }
622 if (c == '\n')
623 TUI_CMD_WIN->start_line = getcury (w);
624 col = getcurx (w);
625 if (col < prev_col)
626 height++;
627 prev_col = col;
628 }
629 wclrtobot (w);
630 TUI_CMD_WIN->start_line = getcury (w);
631 if (c_line >= 0)
632 wmove (w, c_line, c_pos);
633 TUI_CMD_WIN->start_line -= height - 1;
634
635 wrefresh (w);
636 fflush(stdout);
637 }
638
639 /* Readline callback to prepare the terminal. It is called once each
640 time we enter readline. Terminal is already setup in curses
641 mode. */
642 static void
643 tui_prep_terminal (int notused1)
644 {
645 #ifdef NCURSES_MOUSE_VERSION
646 mousemask (ALL_MOUSE_EVENTS, NULL);
647 #endif
648 }
649
650 /* Readline callback to restore the terminal. It is called once each
651 time we leave readline. There is nothing to do in curses mode. */
652 static void
653 tui_deprep_terminal (void)
654 {
655 #ifdef NCURSES_MOUSE_VERSION
656 mousemask (0, NULL);
657 #endif
658 }
659
660 #ifdef TUI_USE_PIPE_FOR_READLINE
661 /* Read readline output pipe and feed the command window with it.
662 Should be removed when readline is clean. */
663 static void
664 tui_readline_output (int error, gdb_client_data data)
665 {
666 int size;
667 char buf[256];
668
669 size = read (tui_readline_pipe[0], buf, sizeof (buf) - 1);
670 if (size > 0 && tui_active)
671 {
672 buf[size] = 0;
673 tui_puts (buf);
674 }
675 }
676 #endif
677
678 /* TUI version of displayer.crlf. */
679
680 static void
681 tui_mld_crlf (const struct match_list_displayer *displayer)
682 {
683 tui_putc ('\n');
684 }
685
686 /* TUI version of displayer.putch. */
687
688 static void
689 tui_mld_putch (const struct match_list_displayer *displayer, int ch)
690 {
691 tui_putc (ch);
692 }
693
694 /* TUI version of displayer.puts. */
695
696 static void
697 tui_mld_puts (const struct match_list_displayer *displayer, const char *s)
698 {
699 tui_puts (s);
700 }
701
702 /* TUI version of displayer.flush. */
703
704 static void
705 tui_mld_flush (const struct match_list_displayer *displayer)
706 {
707 wrefresh (TUI_CMD_WIN->handle.get ());
708 }
709
710 /* TUI version of displayer.erase_entire_line. */
711
712 static void
713 tui_mld_erase_entire_line (const struct match_list_displayer *displayer)
714 {
715 WINDOW *w = TUI_CMD_WIN->handle.get ();
716 int cur_y = getcury (w);
717
718 wmove (w, cur_y, 0);
719 wclrtoeol (w);
720 wmove (w, cur_y, 0);
721 }
722
723 /* TUI version of displayer.beep. */
724
725 static void
726 tui_mld_beep (const struct match_list_displayer *displayer)
727 {
728 beep ();
729 }
730
731 /* A wrapper for wgetch that enters nonl mode. We We normally want
732 curses' "nl" mode, but when reading from the user, we'd like to
733 differentiate between C-j and C-m, because some users bind these
734 keys differently in their .inputrc. So, put curses into nonl mode
735 just when reading from the user. See PR tui/20819. */
736
737 static int
738 gdb_wgetch (WINDOW *win)
739 {
740 nonl ();
741 int r = wgetch (win);
742 nl ();
743 return r;
744 }
745
746 /* Helper function for tui_mld_read_key.
747 This temporarily replaces tui_getc for use during tab-completion
748 match list display. */
749
750 static int
751 tui_mld_getc (FILE *fp)
752 {
753 WINDOW *w = TUI_CMD_WIN->handle.get ();
754 int c = gdb_wgetch (w);
755
756 return c;
757 }
758
759 /* TUI version of displayer.read_key. */
760
761 static int
762 tui_mld_read_key (const struct match_list_displayer *displayer)
763 {
764 rl_getc_func_t *prev = rl_getc_function;
765 int c;
766
767 /* We can't use tui_getc as we need NEWLINE to not get emitted. */
768 rl_getc_function = tui_mld_getc;
769 c = rl_read_key ();
770 rl_getc_function = prev;
771 return c;
772 }
773
774 /* TUI version of rl_completion_display_matches_hook.
775 See gdb_display_match_list for a description of the arguments. */
776
777 static void
778 tui_rl_display_match_list (char **matches, int len, int max)
779 {
780 struct match_list_displayer displayer;
781
782 rl_get_screen_size (&displayer.height, &displayer.width);
783 displayer.crlf = tui_mld_crlf;
784 displayer.putch = tui_mld_putch;
785 displayer.puts = tui_mld_puts;
786 displayer.flush = tui_mld_flush;
787 displayer.erase_entire_line = tui_mld_erase_entire_line;
788 displayer.beep = tui_mld_beep;
789 displayer.read_key = tui_mld_read_key;
790
791 gdb_display_match_list (matches, len, max, &displayer);
792 }
793
794 /* Setup the IO for curses or non-curses mode.
795 - In non-curses mode, readline and gdb use the standard input and
796 standard output/error directly.
797 - In curses mode, the standard output/error is controlled by TUI
798 with the tui_stdout and tui_stderr. The output is redirected in
799 the curses command window. Several readline callbacks are installed
800 so that readline asks for its input to the curses command window
801 with wgetch(). */
802 void
803 tui_setup_io (int mode)
804 {
805 extern int _rl_echoing_p;
806
807 if (mode)
808 {
809 /* Ensure that readline has been initialized before saving any
810 of its variables. */
811 tui_ensure_readline_initialized ();
812
813 /* Redirect readline to TUI. */
814 tui_old_rl_redisplay_function = rl_redisplay_function;
815 tui_old_rl_deprep_terminal = rl_deprep_term_function;
816 tui_old_rl_prep_terminal = rl_prep_term_function;
817 tui_old_rl_getc_function = rl_getc_function;
818 tui_old_rl_display_matches_hook = rl_completion_display_matches_hook;
819 tui_old_rl_outstream = rl_outstream;
820 tui_old_rl_echoing_p = _rl_echoing_p;
821 rl_redisplay_function = tui_redisplay_readline;
822 rl_deprep_term_function = tui_deprep_terminal;
823 rl_prep_term_function = tui_prep_terminal;
824 rl_getc_function = tui_getc;
825 _rl_echoing_p = 0;
826 rl_outstream = tui_rl_outstream;
827 rl_prompt = 0;
828 rl_completion_display_matches_hook = tui_rl_display_match_list;
829 rl_already_prompted = 0;
830
831 /* Keep track of previous gdb output. */
832 tui_old_stdout = gdb_stdout;
833 tui_old_stderr = gdb_stderr;
834 tui_old_stdlog = gdb_stdlog;
835 tui_old_uiout = dynamic_cast<cli_ui_out *> (current_uiout);
836 gdb_assert (tui_old_uiout != nullptr);
837
838 /* Reconfigure gdb output. */
839 gdb_stdout = tui_stdout;
840 gdb_stderr = tui_stderr;
841 gdb_stdlog = tui_stdlog;
842 gdb_stdtarg = gdb_stderr; /* for moment */
843 gdb_stdtargerr = gdb_stderr; /* for moment */
844 current_uiout = tui_out;
845
846 /* Save tty for SIGCONT. */
847 savetty ();
848 }
849 else
850 {
851 /* Restore gdb output. */
852 gdb_stdout = tui_old_stdout;
853 gdb_stderr = tui_old_stderr;
854 gdb_stdlog = tui_old_stdlog;
855 gdb_stdtarg = gdb_stderr; /* for moment */
856 gdb_stdtargerr = gdb_stderr; /* for moment */
857 current_uiout = tui_old_uiout;
858
859 /* Restore readline. */
860 rl_redisplay_function = tui_old_rl_redisplay_function;
861 rl_deprep_term_function = tui_old_rl_deprep_terminal;
862 rl_prep_term_function = tui_old_rl_prep_terminal;
863 rl_getc_function = tui_old_rl_getc_function;
864 rl_completion_display_matches_hook = tui_old_rl_display_matches_hook;
865 rl_outstream = tui_old_rl_outstream;
866 _rl_echoing_p = tui_old_rl_echoing_p;
867 rl_already_prompted = 0;
868
869 /* Save tty for SIGCONT. */
870 savetty ();
871
872 /* Clean up color information. */
873 last_color_pair = -1;
874 last_style = ui_file_style ();
875 color_map.clear ();
876 color_pair_map.clear ();
877 }
878 }
879
880 #ifdef SIGCONT
881 /* Catch SIGCONT to restore the terminal and refresh the screen. */
882 static void
883 tui_cont_sig (int sig)
884 {
885 if (tui_active)
886 {
887 /* Restore the terminal setting because another process (shell)
888 might have changed it. */
889 resetty ();
890
891 /* Force a refresh of the screen. */
892 tui_refresh_all_win ();
893 }
894 signal (sig, tui_cont_sig);
895 }
896 #endif
897
898 /* Initialize the IO for gdb in curses mode. */
899 void
900 tui_initialize_io (void)
901 {
902 #ifdef SIGCONT
903 signal (SIGCONT, tui_cont_sig);
904 #endif
905
906 /* Create tui output streams. */
907 tui_stdout = new pager_file (new tui_file (stdout));
908 tui_stderr = new tui_file (stderr);
909 tui_stdlog = new timestamped_file (tui_stderr);
910 tui_out = tui_out_new (tui_stdout);
911
912 /* Create the default UI. */
913 tui_old_uiout = cli_out_new (gdb_stdout);
914
915 #ifdef TUI_USE_PIPE_FOR_READLINE
916 /* Temporary solution for readline writing to stdout: redirect
917 readline output in a pipe, read that pipe and output the content
918 in the curses command window. */
919 if (gdb_pipe_cloexec (tui_readline_pipe) != 0)
920 error (_("Cannot create pipe for readline"));
921
922 tui_rl_outstream = fdopen (tui_readline_pipe[1], "w");
923 if (tui_rl_outstream == 0)
924 error (_("Cannot redirect readline output"));
925
926 setvbuf (tui_rl_outstream, NULL, _IOLBF, 0);
927
928 #ifdef O_NONBLOCK
929 (void) fcntl (tui_readline_pipe[0], F_SETFL, O_NONBLOCK);
930 #else
931 #ifdef O_NDELAY
932 (void) fcntl (tui_readline_pipe[0], F_SETFL, O_NDELAY);
933 #endif
934 #endif
935 add_file_handler (tui_readline_pipe[0], tui_readline_output, 0, "tui");
936 #else
937 tui_rl_outstream = stdout;
938 #endif
939
940 #ifdef __MINGW32__
941 /* MS-Windows port of ncurses doesn't support default foreground and
942 background colors, so we must record the default colors at startup. */
943 HANDLE hstdout = (HANDLE)_get_osfhandle (fileno (stdout));
944 DWORD cmode;
945 CONSOLE_SCREEN_BUFFER_INFO csbi;
946
947 if (hstdout != INVALID_HANDLE_VALUE
948 && GetConsoleMode (hstdout, &cmode) != 0
949 && GetConsoleScreenBufferInfo (hstdout, &csbi))
950 ncurses_norm_attr = csbi.wAttributes;
951 #endif
952 }
953
954 /* Dispatch the correct tui function based upon the mouse event. */
955
956 #ifdef NCURSES_MOUSE_VERSION
957
958 static void
959 tui_dispatch_mouse_event ()
960 {
961 MEVENT mev;
962 if (getmouse (&mev) != OK)
963 return;
964
965 for (tui_win_info *wi : all_tui_windows ())
966 if (mev.x > wi->x && mev.x < wi->x + wi->width - 1
967 && mev.y > wi->y && mev.y < wi->y + wi->height - 1)
968 {
969 if ((mev.bstate & BUTTON1_CLICKED) != 0
970 || (mev.bstate & BUTTON2_CLICKED) != 0
971 || (mev.bstate & BUTTON3_CLICKED) != 0)
972 {
973 int button = (mev.bstate & BUTTON1_CLICKED) != 0 ? 1
974 : ((mev.bstate & BUTTON2_CLICKED) != 0 ? 2
975 : 3);
976 wi->click (mev.x - wi->x - 1, mev.y - wi->y - 1, button);
977 }
978 #ifdef BUTTON5_PRESSED
979 else if ((mev.bstate & BUTTON4_PRESSED) != 0)
980 wi->backward_scroll (3);
981 else if ((mev.bstate & BUTTON5_PRESSED) != 0)
982 wi->forward_scroll (3);
983 #endif
984 break;
985 }
986 }
987
988 #endif
989
990 /* Dispatch the correct tui function based upon the control
991 character. */
992 static unsigned int
993 tui_dispatch_ctrl_char (unsigned int ch)
994 {
995 struct tui_win_info *win_info = tui_win_with_focus ();
996
997 /* If no window has the focus, or if the focus window can't scroll,
998 just pass the character through. */
999 if (win_info == NULL || !win_info->can_scroll ())
1000 return ch;
1001
1002 switch (ch)
1003 {
1004 case KEY_NPAGE:
1005 win_info->forward_scroll (0);
1006 break;
1007 case KEY_PPAGE:
1008 win_info->backward_scroll (0);
1009 break;
1010 case KEY_DOWN:
1011 case KEY_SF:
1012 win_info->forward_scroll (1);
1013 break;
1014 case KEY_UP:
1015 case KEY_SR:
1016 win_info->backward_scroll (1);
1017 break;
1018 case KEY_RIGHT:
1019 win_info->left_scroll (1);
1020 break;
1021 case KEY_LEFT:
1022 win_info->right_scroll (1);
1023 break;
1024 default:
1025 /* We didn't recognize the character as a control character, so pass it
1026 through. */
1027 return ch;
1028 }
1029
1030 /* We intercepted the control character, so return 0 (which readline
1031 will interpret as a no-op). */
1032 return 0;
1033 }
1034
1035 /* See tui-io.h. */
1036
1037 void
1038 tui_inject_newline_into_command_window ()
1039 {
1040 gdb_assert (tui_active);
1041
1042 WINDOW *w = TUI_CMD_WIN->handle.get ();
1043
1044 /* When hitting return with an empty input, gdb executes the last
1045 command. If we emit a newline, this fills up the command window
1046 with empty lines with gdb prompt at beginning. Instead of that,
1047 stay on the same line but provide a visual effect to show the
1048 user we recognized the command. */
1049 if (rl_end == 0 && !gdb_in_secondary_prompt_p (current_ui))
1050 {
1051 wmove (w, getcury (w), 0);
1052
1053 /* Clear the line. This will blink the gdb prompt since
1054 it will be redrawn at the same line. */
1055 wclrtoeol (w);
1056 wrefresh (w);
1057 napms (20);
1058 }
1059 else
1060 {
1061 /* Move cursor to the end of the command line before emitting the
1062 newline. We need to do so because when ncurses outputs a newline
1063 it truncates any text that appears past the end of the cursor. */
1064 int px, py;
1065 getyx (w, py, px);
1066 px += rl_end - rl_point;
1067 py += px / TUI_CMD_WIN->width;
1068 px %= TUI_CMD_WIN->width;
1069 wmove (w, py, px);
1070 tui_putc ('\n');
1071 }
1072 }
1073
1074 /* If we're passing an escape sequence to readline, this points to a
1075 string holding the remaining characters of the sequence to pass.
1076 We advance the pointer one character at a time until '\0' is
1077 reached. */
1078 static const char *cur_seq = nullptr;
1079
1080 /* Set CUR_SEQ to point at the current sequence to pass to readline,
1081 setup to call the input handler again so we complete the sequence
1082 shortly, and return the first character to start the sequence. */
1083
1084 static int
1085 start_sequence (const char *seq)
1086 {
1087 call_stdin_event_handler_again_p = 1;
1088 cur_seq = seq + 1;
1089 return seq[0];
1090 }
1091
1092 /* Main worker for tui_getc. Get a character from the command window.
1093 This is called from the readline package, but wrapped in a
1094 try/catch by tui_getc. */
1095
1096 static int
1097 tui_getc_1 (FILE *fp)
1098 {
1099 int ch;
1100 WINDOW *w;
1101
1102 w = TUI_CMD_WIN->handle.get ();
1103
1104 #ifdef TUI_USE_PIPE_FOR_READLINE
1105 /* Flush readline output. */
1106 tui_readline_output (0, 0);
1107 #endif
1108
1109 /* We enable keypad mode so that curses's wgetch processes mouse
1110 escape sequences. In keypad mode, wgetch also processes the
1111 escape sequences for keys such as up/down etc. and returns KEY_UP
1112 / KEY_DOWN etc. When we have the focus on the command window
1113 though, we want to pass the raw up/down etc. escape codes to
1114 readline so readline understands them. */
1115 if (cur_seq != nullptr)
1116 {
1117 ch = *cur_seq++;
1118
1119 /* If we've reached the end of the string, we're done with the
1120 sequence. Otherwise, setup to get back here again for
1121 another character. */
1122 if (*cur_seq == '\0')
1123 cur_seq = nullptr;
1124 else
1125 call_stdin_event_handler_again_p = 1;
1126 return ch;
1127 }
1128 else
1129 ch = gdb_wgetch (w);
1130
1131 /* Handle prev/next/up/down here. */
1132 ch = tui_dispatch_ctrl_char (ch);
1133
1134 #ifdef NCURSES_MOUSE_VERSION
1135 if (ch == KEY_MOUSE)
1136 {
1137 tui_dispatch_mouse_event ();
1138 return 0;
1139 }
1140 #endif
1141
1142 /* Translate curses keys back to escape sequences so that readline
1143 can understand them. We do this irrespective of which window has
1144 the focus. If e.g., we're focused on a non-command window, then
1145 the up/down keys will already have been filtered by
1146 tui_dispatch_ctrl_char. Keys that haven't been intercepted will
1147 be passed down to readline. */
1148 if (current_ui->command_editing)
1149 {
1150 /* For the standard arrow keys + home/end, hardcode sequences
1151 readline understands. See bind_arrow_keys_internal in
1152 readline/readline.c. */
1153 switch (ch)
1154 {
1155 case KEY_UP:
1156 return start_sequence ("\033[A");
1157 case KEY_DOWN:
1158 return start_sequence ("\033[B");
1159 case KEY_RIGHT:
1160 return start_sequence ("\033[C");
1161 case KEY_LEFT:
1162 return start_sequence ("\033[D");
1163 case KEY_HOME:
1164 return start_sequence ("\033[H");
1165 case KEY_END:
1166 return start_sequence ("\033[F");
1167
1168 /* del and ins are unfortunately not hardcoded in readline for
1169 all systems. */
1170
1171 case KEY_DC: /* del */
1172 #ifdef __MINGW32__
1173 return start_sequence ("\340S");
1174 #else
1175 return start_sequence ("\033[3~");
1176 #endif
1177
1178 case KEY_IC: /* ins */
1179 #if defined __MINGW32__
1180 return start_sequence ("\340R");
1181 #else
1182 return start_sequence ("\033[2~");
1183 #endif
1184 }
1185
1186 /* Keycodes above KEY_MAX are not garanteed to be stable.
1187 Compare keyname instead. */
1188 if (ch >= KEY_MAX)
1189 {
1190 auto name = gdb::string_view (keyname (ch));
1191
1192 /* The following sequences are hardcoded in readline as
1193 well. */
1194
1195 /* ctrl-arrow keys */
1196 if (name == "kLFT5") /* ctrl-left */
1197 return start_sequence ("\033[1;5D");
1198 else if (name == "kRIT5") /* ctrl-right */
1199 return start_sequence ("\033[1;5C");
1200 else if (name == "kDC5") /* ctrl-del */
1201 return start_sequence ("\033[3;5~");
1202
1203 /* alt-arrow keys */
1204 else if (name == "kLFT3") /* alt-left */
1205 return start_sequence ("\033[1;3D");
1206 else if (name == "kRIT3") /* alt-right */
1207 return start_sequence ("\033[1;3C");
1208 }
1209 }
1210
1211 /* Handle the CTRL-L refresh for each window. */
1212 if (ch == '\f')
1213 {
1214 tui_refresh_all_win ();
1215 return ch;
1216 }
1217
1218 if (ch == KEY_BACKSPACE)
1219 return '\b';
1220
1221 if (current_ui->command_editing && key_is_start_sequence (ch))
1222 {
1223 int ch_pending;
1224
1225 nodelay (w, TRUE);
1226 ch_pending = gdb_wgetch (w);
1227 nodelay (w, FALSE);
1228
1229 /* If we have pending input following a start sequence, call the stdin
1230 event handler again because ncurses may have already read and stored
1231 the input into its internal buffer, meaning that we won't get an stdin
1232 event for it. If we don't compensate for this missed stdin event, key
1233 sequences as Alt_F (^[f) will not behave promptly.
1234
1235 (We only compensates for the missed 2nd byte of a key sequence because
1236 2-byte sequences are by far the most commonly used. ncurses may have
1237 buffered a larger, 3+-byte key sequence though it remains to be seen
1238 whether it is useful to compensate for all the bytes of such
1239 sequences.) */
1240 if (ch_pending != ERR)
1241 {
1242 ungetch (ch_pending);
1243 call_stdin_event_handler_again_p = 1;
1244 }
1245 }
1246
1247 if (ch > 0xff)
1248 {
1249 /* Readline doesn't understand non-8-bit curses keys, filter
1250 them out. */
1251 return 0;
1252 }
1253
1254 return ch;
1255 }
1256
1257 /* Get a character from the command window. This is called from the
1258 readline package. */
1259
1260 static int
1261 tui_getc (FILE *fp)
1262 {
1263 try
1264 {
1265 return tui_getc_1 (fp);
1266 }
1267 catch (const gdb_exception &ex)
1268 {
1269 /* Just in case, don't ever let an exception escape to readline.
1270 This shouldn't ever happen, but if it does, print the
1271 exception instead of just crashing GDB. */
1272 exception_print (gdb_stderr, ex);
1273
1274 /* If we threw an exception, it's because we recognized the
1275 character. */
1276 return 0;
1277 }
1278 }