1 /* General functions for the WDB TUI.
3 Copyright (C) 1998-2018 Free Software Foundation, Inc.
5 Contributed by Hewlett-Packard Company.
7 This file is part of GDB.
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.
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.
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/>. */
25 #include "tui/tui-hooks.h"
26 #include "tui/tui-data.h"
27 #include "tui/tui-layout.h"
28 #include "tui/tui-io.h"
29 #include "tui/tui-regs.h"
30 #include "tui/tui-stack.h"
31 #include "tui/tui-win.h"
32 #include "tui/tui-winsource.h"
33 #include "tui/tui-windata.h"
36 #include "breakpoint.h"
51 #include "gdb_curses.h"
54 /* This redefines CTRL if it is not already defined, so it must come
55 after terminal state releated include files like <term.h> and
57 #include "readline/readline.h"
59 /* Tells whether the TUI is active or not. */
61 static int tui_finish_init
= 1;
63 enum tui_key_mode tui_current_key_mode
= TUI_COMMAND_MODE
;
65 struct tui_char_command
71 /* Key mapping to gdb commands when the TUI is using the single key
73 static const struct tui_char_command tui_commands
[] = {
83 { 'v', "info locals" },
88 static Keymap tui_keymap
;
89 static Keymap tui_readline_standard_keymap
;
91 /* TUI readline command.
92 Switch the output mode between TUI/standard gdb. */
94 tui_rl_switch_mode (int notused1
, int notused2
)
97 /* Don't let exceptions escape. We're in the middle of a readline
98 callback that isn't prepared for that. */
104 rl_prep_terminal (0);
108 /* If tui_enable throws, we'll re-prep below. */
109 rl_deprep_terminal ();
113 CATCH (ex
, RETURN_MASK_ALL
)
115 exception_print (gdb_stderr
, ex
);
118 rl_prep_terminal (0);
122 /* Clear the readline in case switching occurred in middle of
125 rl_kill_text (0, rl_end
);
127 /* Since we left the curses mode, the terminal mode is restored to
128 some previous state. That state may not be suitable for readline
129 to work correctly (it may be restored in line mode). We force an
130 exit of the current readline so that readline is re-entered and
131 it will be able to setup the terminal for its needs. By
132 re-entering in readline, we also redisplay its prompt in the
134 rl_newline (1, '\n');
136 /* Make sure the \n we are returning does not repeat the last
142 /* TUI readline command.
143 Change the TUI layout to show a next layout.
144 This function is bound to CTRL-X 2. It is intended to provide
145 a functionality close to the Emacs split-window command. We
146 always show two windows (src+asm), (src+regs) or (asm+regs). */
148 tui_rl_change_windows (int notused1
, int notused2
)
151 tui_rl_switch_mode (0 /* notused */, 0 /* notused */);
155 enum tui_layout_type new_layout
;
157 new_layout
= tui_current_layout ();
159 /* Select a new layout to have a rolling layout behavior with
160 always two windows (except when undefined). */
164 new_layout
= SRC_DISASSEM_COMMAND
;
167 case DISASSEM_COMMAND
:
168 new_layout
= SRC_DISASSEM_COMMAND
;
171 case SRC_DATA_COMMAND
:
172 new_layout
= SRC_DISASSEM_COMMAND
;
175 case SRC_DISASSEM_COMMAND
:
176 new_layout
= DISASSEM_DATA_COMMAND
;
179 case DISASSEM_DATA_COMMAND
:
180 new_layout
= SRC_DATA_COMMAND
;
184 new_layout
= SRC_COMMAND
;
187 tui_set_layout (new_layout
);
192 /* TUI readline command.
193 Delete the second TUI window to only show one. */
195 tui_rl_delete_other_windows (int notused1
, int notused2
)
198 tui_rl_switch_mode (0 /* notused */, 0 /* notused */);
202 enum tui_layout_type new_layout
;
204 new_layout
= tui_current_layout ();
206 /* Kill one window. */
210 case SRC_DATA_COMMAND
:
211 case SRC_DISASSEM_COMMAND
:
213 new_layout
= SRC_COMMAND
;
216 case DISASSEM_COMMAND
:
217 case DISASSEM_DATA_COMMAND
:
218 new_layout
= DISASSEM_COMMAND
;
221 tui_set_layout (new_layout
);
226 /* TUI readline command.
227 Switch the active window to give the focus to a next window. */
229 tui_rl_other_window (int count
, int key
)
231 struct tui_win_info
*win_info
;
234 tui_rl_switch_mode (0 /* notused */, 0 /* notused */);
236 win_info
= tui_next_win (tui_win_with_focus ());
239 tui_set_win_focus_to (win_info
);
240 if (TUI_DATA_WIN
&& TUI_DATA_WIN
->generic
.is_visible
)
241 tui_refresh_data_win ();
242 keypad (TUI_CMD_WIN
->generic
.handle
, (win_info
!= TUI_CMD_WIN
));
247 /* TUI readline command.
248 Execute the gdb command bound to the specified key. */
250 tui_rl_command_key (int count
, int key
)
254 reinitialize_more_filter ();
255 for (i
= 0; tui_commands
[i
].cmd
; i
++)
257 if (tui_commands
[i
].key
== key
)
259 /* Insert the command in the readline buffer.
260 Avoid calling the gdb command here since it creates
261 a possible recursion on readline if prompt_for_continue
262 is called (See PR 9584). The command will also appear
263 in the readline history which turns out to be better. */
264 rl_insert_text (tui_commands
[i
].cmd
);
265 rl_newline (1, '\n');
267 /* Switch to gdb command mode while executing the command.
268 This way the gdb's continue prompty will be displayed. */
269 tui_set_key_mode (TUI_ONE_COMMAND_MODE
);
276 /* TUI readline command.
277 Temporarily leave the TUI SingleKey mode to allow editing
278 a gdb command with the normal readline. Once the command
279 is executed, the TUI SingleKey mode is installed back. */
281 tui_rl_command_mode (int count
, int key
)
283 tui_set_key_mode (TUI_ONE_COMMAND_MODE
);
284 return rl_insert (count
, key
);
287 /* TUI readline command.
288 Switch between TUI SingleKey mode and gdb readline editing. */
290 tui_rl_next_keymap (int notused1
, int notused2
)
293 tui_rl_switch_mode (0 /* notused */, 0 /* notused */);
295 tui_set_key_mode (tui_current_key_mode
== TUI_COMMAND_MODE
296 ? TUI_SINGLE_KEY_MODE
: TUI_COMMAND_MODE
);
300 /* Readline hook to redisplay ourself the gdb prompt.
301 In the SingleKey mode, the prompt is not printed so that
302 the command window is cleaner. It will be displayed if
303 we temporarily leave the SingleKey mode. */
305 tui_rl_startup_hook (void)
307 rl_already_prompted
= 1;
308 if (tui_current_key_mode
!= TUI_COMMAND_MODE
309 && !gdb_in_secondary_prompt_p (current_ui
))
310 tui_set_key_mode (TUI_SINGLE_KEY_MODE
);
311 tui_redisplay_readline ();
315 /* Change the TUI key mode by installing the appropriate readline
318 tui_set_key_mode (enum tui_key_mode mode
)
320 tui_current_key_mode
= mode
;
321 rl_set_keymap (mode
== TUI_SINGLE_KEY_MODE
322 ? tui_keymap
: tui_readline_standard_keymap
);
323 tui_show_locator_content ();
326 /* Initialize readline and configure the keymap for the switching
329 tui_initialize_readline (void)
332 Keymap tui_ctlx_keymap
;
336 rl_add_defun ("tui-switch-mode", tui_rl_switch_mode
, -1);
337 rl_add_defun ("gdb-command", tui_rl_command_key
, -1);
338 rl_add_defun ("next-keymap", tui_rl_next_keymap
, -1);
340 tui_keymap
= rl_make_bare_keymap ();
341 tui_ctlx_keymap
= rl_make_bare_keymap ();
342 tui_readline_standard_keymap
= rl_get_keymap ();
344 for (i
= 0; tui_commands
[i
].cmd
; i
++)
345 rl_bind_key_in_map (tui_commands
[i
].key
, tui_rl_command_key
, tui_keymap
);
347 rl_generic_bind (ISKMAP
, "\\C-x", (char*) tui_ctlx_keymap
, tui_keymap
);
349 /* Bind all other keys to tui_rl_command_mode so that we switch
350 temporarily from SingleKey mode and can enter a gdb command. */
351 for (i
= ' '; i
< 0x7f; i
++)
355 for (j
= 0; tui_commands
[j
].cmd
; j
++)
356 if (tui_commands
[j
].key
== i
)
359 if (tui_commands
[j
].cmd
)
362 rl_bind_key_in_map (i
, tui_rl_command_mode
, tui_keymap
);
365 rl_bind_key_in_map ('a', tui_rl_switch_mode
, emacs_ctlx_keymap
);
366 rl_bind_key_in_map ('a', tui_rl_switch_mode
, tui_ctlx_keymap
);
367 rl_bind_key_in_map ('A', tui_rl_switch_mode
, emacs_ctlx_keymap
);
368 rl_bind_key_in_map ('A', tui_rl_switch_mode
, tui_ctlx_keymap
);
369 rl_bind_key_in_map (CTRL ('A'), tui_rl_switch_mode
, emacs_ctlx_keymap
);
370 rl_bind_key_in_map (CTRL ('A'), tui_rl_switch_mode
, tui_ctlx_keymap
);
371 rl_bind_key_in_map ('1', tui_rl_delete_other_windows
, emacs_ctlx_keymap
);
372 rl_bind_key_in_map ('1', tui_rl_delete_other_windows
, tui_ctlx_keymap
);
373 rl_bind_key_in_map ('2', tui_rl_change_windows
, emacs_ctlx_keymap
);
374 rl_bind_key_in_map ('2', tui_rl_change_windows
, tui_ctlx_keymap
);
375 rl_bind_key_in_map ('o', tui_rl_other_window
, emacs_ctlx_keymap
);
376 rl_bind_key_in_map ('o', tui_rl_other_window
, tui_ctlx_keymap
);
377 rl_bind_key_in_map ('q', tui_rl_next_keymap
, tui_keymap
);
378 rl_bind_key_in_map ('s', tui_rl_next_keymap
, emacs_ctlx_keymap
);
379 rl_bind_key_in_map ('s', tui_rl_next_keymap
, tui_ctlx_keymap
);
382 /* Return the TERM variable from the environment, or "<unset>"
386 gdb_getenv_term (void)
390 term
= getenv ("TERM");
396 /* Enter in the tui mode (curses).
397 When in normal mode, it installs the tui hooks in gdb, redirects
398 the gdb output, configures the readline to work in tui mode.
399 When in curses mode, it does nothing. */
406 /* To avoid to initialize curses when gdb starts, there is a defered
407 curses initialization. This initialization is made only once
408 and the first time the curses mode is entered. */
416 /* If the top level interpreter is not the console/tui (e.g.,
417 MI), enabling curses will certainly lose. */
418 interp
= top_level_interpreter ()->name ();
419 if (strcmp (interp
, INTERP_TUI
) != 0)
420 error (_("Cannot enable the TUI when the interpreter is '%s'"), interp
);
422 /* Don't try to setup curses (and print funny control
423 characters) if we're not outputting to a terminal. */
424 if (!ui_file_isatty (gdb_stdout
))
425 error (_("Cannot enable the TUI when output is not a terminal"));
427 s
= newterm (NULL
, stdout
, stdin
);
429 /* The MinGW port of ncurses requires $TERM to be unset in order
430 to activate the Windows console driver. */
432 s
= newterm ((char *) "unknown", stdout
, stdin
);
436 error (_("Cannot enable the TUI: error opening terminal [TERM=%s]"),
441 /* Check required terminal capabilities. The MinGW port of
442 ncurses does have them, but doesn't expose them through "cup". */
444 cap
= tigetstr ((char *) "cup");
445 if (cap
== NULL
|| cap
== (char *) -1 || *cap
== '\0')
449 error (_("Cannot enable the TUI: "
450 "terminal doesn't support cursor addressing [TERM=%s]"),
462 tui_set_term_height_to (LINES
);
463 tui_set_term_width_to (COLS
);
466 tui_show_frame_info (0);
467 tui_set_layout (SRC_COMMAND
);
468 tui_set_win_focus_to (TUI_SRC_WIN
);
469 keypad (TUI_CMD_WIN
->generic
.handle
, TRUE
);
470 wrefresh (TUI_CMD_WIN
->generic
.handle
);
475 /* Save the current gdb setting of the terminal.
476 Curses will restore this state when endwin() is called. */
478 clearok (stdscr
, TRUE
);
481 /* Install the TUI specific hooks. */
482 tui_install_hooks ();
483 rl_startup_hook
= tui_rl_startup_hook
;
485 tui_update_variables ();
491 /* Resize windows before anything might display/refresh a
493 if (tui_win_resized ())
495 tui_set_win_resized_to (FALSE
);
499 if (deprecated_safe_get_selected_frame ())
500 tui_show_frame_info (deprecated_safe_get_selected_frame ());
502 /* Restore TUI keymap. */
503 tui_set_key_mode (tui_current_key_mode
);
505 /* Refresh the screen. */
506 tui_refresh_all_win ();
508 /* Update gdb's knowledge of its terminal. */
509 gdb_save_tty_state ();
510 tui_update_gdb_sizes ();
513 /* Leave the tui mode.
514 Remove the tui hooks and configure the gdb output and readline
515 back to their original state. The curses mode is left so that
516 the terminal setting is restored to the point when we entered. */
523 /* Restore initial readline keymap. */
524 rl_set_keymap (tui_readline_standard_keymap
);
526 /* Remove TUI hooks. */
529 rl_already_prompted
= 0;
531 /* Leave curses and restore previous gdb terminal setting. */
534 /* gdb terminal has changed, update gdb internal copy of it
535 so that terminal management with the inferior works. */
538 /* Update gdb's knowledge of its terminal. */
539 gdb_save_tty_state ();
542 tui_update_gdb_sizes ();
545 /* Command wrapper for enabling tui mode. */
548 tui_enable_command (const char *args
, int from_tty
)
553 /* Command wrapper for leaving tui mode. */
556 tui_disable_command (const char *args
, int from_tty
)
562 strcat_to_buf (char *buf
, int buflen
,
563 const char *item_to_add
)
565 if (item_to_add
!= NULL
&& buf
!= NULL
)
567 if ((strlen (buf
) + strlen (item_to_add
)) <= buflen
)
568 strcat (buf
, item_to_add
);
570 strncat (buf
, item_to_add
, (buflen
- strlen (buf
)));
575 /* Solaris <sys/termios.h> defines CTRL. */
577 #define CTRL(x) (x & ~0140)
581 #define CHK(val, dft) (val<=0 ? dft : val)
588 /* Reset the teletype mode bits to a sensible state.
590 #if defined (TIOCGETC)
592 #endif /* TIOCGETC */
596 if (ldisc
== NTTYDISC
)
598 ioctl (FILEDES
, TIOCGLTC
, <c
);
599 ltc
.t_suspc
= CHK (ltc
.t_suspc
, CTRL ('Z'));
600 ltc
.t_dsuspc
= CHK (ltc
.t_dsuspc
, CTRL ('Y'));
601 ltc
.t_rprntc
= CHK (ltc
.t_rprntc
, CTRL ('R'));
602 ltc
.t_flushc
= CHK (ltc
.t_flushc
, CTRL ('O'));
603 ltc
.t_werasc
= CHK (ltc
.t_werasc
, CTRL ('W'));
604 ltc
.t_lnextc
= CHK (ltc
.t_lnextc
, CTRL ('V'));
605 ioctl (FILEDES
, TIOCSLTC
, <c
);
607 #endif /* UCB_NTTY */
609 ioctl (FILEDES
, TIOCGETC
, &tbuf
);
610 tbuf
.t_intrc
= CHK (tbuf
.t_intrc
, CTRL ('?'));
611 tbuf
.t_quitc
= CHK (tbuf
.t_quitc
, CTRL ('\\'));
612 tbuf
.t_startc
= CHK (tbuf
.t_startc
, CTRL ('Q'));
613 tbuf
.t_stopc
= CHK (tbuf
.t_stopc
, CTRL ('S'));
614 tbuf
.t_eofc
= CHK (tbuf
.t_eofc
, CTRL ('D'));
615 /* brkc is left alone. */
616 ioctl (FILEDES
, TIOCSETC
, &tbuf
);
617 #endif /* TIOCGETC */
618 mode
.sg_flags
&= ~(RAW
622 | VTDELAY
| ALLDELAY
);
623 mode
.sg_flags
|= XTABS
| ECHO
| CRMOD
| ANYP
;
630 tui_show_source (const char *fullname
, int line
)
632 struct symtab_and_line cursal
= get_current_source_symtab_and_line ();
634 /* Make sure that the source window is displayed. */
635 tui_add_win_to_layout (SRC_WIN
);
637 tui_update_source_windows_with_line (cursal
.symtab
, line
);
638 tui_update_locator_fullname (fullname
);
642 tui_show_assembly (struct gdbarch
*gdbarch
, CORE_ADDR addr
)
644 tui_add_win_to_layout (DISASSEM_WIN
);
645 tui_update_source_windows_with_addr (gdbarch
, addr
);
649 tui_is_window_visible (enum tui_win_type type
)
654 if (tui_win_list
[type
] == 0)
657 return tui_win_list
[type
]->generic
.is_visible
;
661 tui_get_command_dimension (unsigned int *width
,
662 unsigned int *height
)
664 if (!tui_active
|| (TUI_CMD_WIN
== NULL
))
669 *width
= TUI_CMD_WIN
->generic
.width
;
670 *height
= TUI_CMD_WIN
->generic
.height
;
675 _initialize_tui (void)
677 struct cmd_list_element
**tuicmd
;
679 tuicmd
= tui_get_cmd_list ();
681 add_cmd ("enable", class_tui
, tui_enable_command
,
682 _("Enable TUI display mode."),
684 add_cmd ("disable", class_tui
, tui_disable_command
,
685 _("Disable TUI display mode."),