/* TUI Interpreter definitions for GDB, the GNU debugger. Copyright (C) 2003-2024 Free Software Foundation, Inc. This file is part of GDB. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #include "defs.h" #include "cli/cli-interp.h" #include "interps.h" #include "ui.h" #include "event-top.h" #include "gdbsupport/event-loop.h" #include "ui-out.h" #include "cli-out.h" #include "tui/tui-data.h" #include "tui/tui-win.h" #include "tui/tui.h" #include "tui/tui-io.h" #include "infrun.h" #include "observable.h" #include "gdbthread.h" #include "inferior.h" #include "main.h" /* Set to true when the TUI mode must be activated when we first start gdb. */ static bool tui_start_enabled = false; class tui_interp final : public cli_interp_base { public: explicit tui_interp (const char *name) : cli_interp_base (name) {} void init (bool top_level) override; void resume () override; void suspend () override; void exec (const char *command_str) override; ui_out *interp_ui_out () override; }; /* Cleanup the tui before exiting. */ static void tui_exit (void) { /* Disable the tui. Curses mode is left leaving the screen in a clean state (see endwin()). */ tui_disable (); } /* These implement the TUI interpreter. */ void tui_interp::init (bool top_level) { /* Install exit handler to leave the screen in a good shape. */ atexit (tui_exit); tui_initialize_io (); if (gdb_stdout->isatty ()) { tui_ensure_readline_initialized (); /* This installs the SIGWINCH signal handler. The handler needs to do readline calls (to rl_resize_terminal), so it must not be installed unless readline is properly initialized. */ tui_initialize_win (); } } /* Used as the command handler for the tui. */ static void tui_command_line_handler (gdb::unique_xmalloc_ptr &&rl) { /* When a tui enabled GDB is running in either tui mode or cli mode then it is always the tui interpreter that is in use. As a result we end up in here even in standard cli mode. We only need to do any special actions when the tui is in use though. When the tui is active the users return is not echoed to the screen as a result the display will not automatically move us to the next line. Here we manually insert a newline character and move the cursor. */ if (tui_active) tui_inject_newline_into_command_window (); /* Now perform GDB's standard CLI command line handling. */ command_line_handler (std::move (rl)); } void tui_interp::resume () { struct ui *ui = current_ui; struct ui_file *stream; /* gdb_setup_readline will change gdb_stdout. If the TUI was previously writing to gdb_stdout, then set it to the new gdb_stdout afterwards. */ stream = tui_old_uiout->set_stream (gdb_stdout); if (stream != gdb_stdout) { tui_old_uiout->set_stream (stream); stream = NULL; } gdb_setup_readline (1); ui->input_handler = tui_command_line_handler; if (stream != NULL) tui_old_uiout->set_stream (gdb_stdout); if (tui_start_enabled) tui_enable (); } void tui_interp::suspend () { gdb_disable_readline (); tui_start_enabled = tui_active; tui_disable (); } ui_out * tui_interp::interp_ui_out () { if (tui_active) return tui_out; else return tui_old_uiout; } void tui_interp::exec (const char *command_str) { internal_error (_("tui_exec called")); } /* Factory for TUI interpreters. */ static struct interp * tui_interp_factory (const char *name) { return new tui_interp (name); } void _initialize_tui_interp (); void _initialize_tui_interp () { interp_factory_register (INTERP_TUI, tui_interp_factory); if (interpreter_p == INTERP_TUI) tui_start_enabled = true; if (interpreter_p == INTERP_CONSOLE) interpreter_p = INTERP_TUI; /* There are no observers here because the CLI interpreter's observers work for the TUI interpreter as well. See cli-interp.c. */ }