gdb/event-top.h

   1 /* Definitions used by event-top.c, for GDB, the GNU debugger.
   2
   3    Copyright (C) 1999-2022 Free Software Foundation, Inc.
   4
   5    Written by Elena Zannoni <ezannoni@cygnus.com> of Cygnus Solutions.
   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 #ifndef EVENT_TOP_H
  23 #define EVENT_TOP_H
  24
  25 #include <signal.h>
  26
  27 struct cmd_list_element;
  28
  29 /* Exported functions from event-top.c.
  30    FIXME: these should really go into top.h.  */
  31
  32 extern void display_gdb_prompt (const char *new_prompt);
  33 extern void gdb_setup_readline (int);
  34 extern void gdb_disable_readline (void);
  35 extern void gdb_init_signals (void);
  36 extern void change_line_handler (int);
  37
  38 extern void command_line_handler (gdb::unique_xmalloc_ptr<char> &&rl);
  39 extern void command_handler (const char *command);
  40
  41 #ifdef SIGTSTP
  42 extern void handle_sigtstp (int sig);
  43 #endif
  44
  45 extern void handle_sigint (int sig);
  46 extern void handle_sigterm (int sig);
  47 extern void async_request_quit (void *arg);
  48 extern void stdin_event_handler (int error, void *client_data);
  49 extern void async_disable_stdin (void);
  50 extern void async_enable_stdin (void);
  51
  52 /* Exported variables from event-top.c.
  53    FIXME: these should really go into top.h.  */
  54
  55 extern bool set_editing_cmd_var;
  56 extern bool exec_done_display_p;
  57 extern struct prompts the_prompts;
  58 extern void (*after_char_processing_hook) (void);
  59 extern int call_stdin_event_handler_again_p;
  60 extern void gdb_readline_no_editing_callback (void *client_data);
  61
  62 /* Wrappers for rl_callback_handler_remove and
  63    rl_callback_handler_install that keep track of whether the callback
  64    handler is installed in readline.  Do not call the readline
  65    versions directly.  */
  66 extern void gdb_rl_callback_handler_remove (void);
  67 extern void gdb_rl_callback_handler_install (const char *prompt);
  68
  69 /* Reinstall the readline callback handler (with no prompt), if not
  70    currently installed.  */
  71 extern void gdb_rl_callback_handler_reinstall (void);
  72
  73 /* Called by readline after a complete line has been gathered from the
  74    user, but before the line is dispatched to back to GDB.  This function
  75    is a wrapper around readline's builtin rl_deprep_terminal function, and
  76    handles the case where readline received EOF.  */
  77 extern void gdb_rl_deprep_term_function (void);
  78
  79 typedef void (*segv_handler_t) (int);
  80
  81 /* On construction, replaces the current thread's SIGSEGV handler with
  82    the provided one.  On destruction, restores the handler to the
  83    original one.  */
  84 class scoped_segv_handler_restore
  85 {
  86  public:
  87   scoped_segv_handler_restore (segv_handler_t new_handler);
  88   ~scoped_segv_handler_restore ();
  89
  90  private:
  91   segv_handler_t m_old_handler;
  92 };
  93
  94 #endif