X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Finterps.h;h=8ff15da4fe2631f3cc63e8b92b13b153c32c2c3b;hb=9aaf8e3a2875f719e4d5633ba222a3c04a5d0e8d;hp=21362f4ddec8c487fc5955fc7d12dc7f37785015;hpb=4a8f6654af815d1dc2e36a60d270f21fcb91d13e;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/interps.h b/gdb/interps.h index 21362f4dde..8ff15da4fe 100644 --- a/gdb/interps.h +++ b/gdb/interps.h @@ -1,6 +1,6 @@ /* Manages interpreters for GDB, the GNU debugger. - Copyright 2000, 2002, 2003 Free Software Foundation, Inc. + Copyright (C) 2000-2015 Free Software Foundation, Inc. Written by Jim Ingham of Apple Computer, Inc. @@ -8,7 +8,7 @@ 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 2 of the License, or + 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, @@ -17,9 +17,7 @@ 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, write to the Free Software - Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. */ + along with this program. If not, see . */ #ifndef INTERPS_H #define INTERPS_H @@ -29,17 +27,21 @@ struct interp; extern int interp_resume (struct interp *interp); extern int interp_suspend (struct interp *interp); -extern int interp_prompt_p (struct interp *interp); -extern int interp_exec_p (struct interp *interp); -extern int interp_exec (struct interp *interp, const char *command); +extern struct gdb_exception interp_exec (struct interp *interp, + const char *command); extern int interp_quiet_p (struct interp *interp); -typedef void *(interp_init_ftype) (void); +typedef void *(interp_init_ftype) (struct interp *self, int top_level); typedef int (interp_resume_ftype) (void *data); typedef int (interp_suspend_ftype) (void *data); -typedef int (interp_prompt_p_ftype) (void *data); -typedef int (interp_exec_ftype) (void *data, const char *command); -typedef int (interp_command_loop_ftype) (void *data); +typedef struct gdb_exception (interp_exec_ftype) (void *data, + const char *command); +typedef void (interp_command_loop_ftype) (void *data); +typedef struct ui_out *(interp_ui_out_ftype) (struct interp *self); + +typedef int (interp_set_logging_ftype) (struct interp *self, int start_log, + struct ui_file *out, + struct ui_file *logfile); struct interp_procs { @@ -47,27 +49,68 @@ struct interp_procs interp_resume_ftype *resume_proc; interp_suspend_ftype *suspend_proc; interp_exec_ftype *exec_proc; - interp_prompt_p_ftype *prompt_proc_p; + + /* Returns the ui_out currently used to collect results for this + interpreter. It can be a formatter for stdout, as is the case + for the console & mi outputs, or it might be a result + formatter. */ + interp_ui_out_ftype *ui_out_proc; + + /* Provides a hook for interpreters to do any additional + setup/cleanup that they might need when logging is enabled or + disabled. */ + interp_set_logging_ftype *set_logging_proc; + interp_command_loop_ftype *command_loop_proc; }; -extern struct interp *interp_new (const char *name, void *data, - struct ui_out *uiout, - const struct interp_procs *procs); +extern struct interp *interp_new (const char *name, const struct interp_procs *procs); extern void interp_add (struct interp *interp); -extern int interp_set (struct interp *interp); +extern int interp_set (struct interp *interp, int top_level); extern struct interp *interp_lookup (const char *name); extern struct ui_out *interp_ui_out (struct interp *interp); +extern void *interp_data (struct interp *interp); +extern const char *interp_name (struct interp *interp); +extern struct interp *interp_set_temp (const char *name); extern int current_interp_named_p (const char *name); -extern int current_interp_display_prompt_p (void); + extern void current_interp_command_loop (void); -extern void clear_interpreter_hooks (); +/* Call this function to give the current interpreter an opportunity + to do any special handling of streams when logging is enabled or + disabled. START_LOG is 1 when logging is starting, 0 when it ends, + and OUT is the stream for the log file; it will be NULL when + logging is ending. LOGFILE is non-NULL if the output streams + are to be tees, with the log file as one of the outputs. */ + +extern int current_interp_set_logging (int start_log, struct ui_file *out, + struct ui_file *logfile); + +/* Returns opaque data associated with the top-level interpreter. */ +extern void *top_level_interpreter_data (void); +extern struct interp *top_level_interpreter (void); + +extern struct interp *command_interp (void); + +/* True if the current interpreter is in async mode, false if in sync + mode. If in sync mode, running a synchronous execution command + (with execute_command, e.g, "next") will not return until the + command is finished. If in async mode, then running a synchronous + command returns right after resuming the target. Waiting for the + command's completion is later done on the top event loop (using + continuations). */ +extern int interpreter_async; + +extern void clear_interpreter_hooks (void); /* well-known interpreters */ #define INTERP_CONSOLE "console" #define INTERP_MI1 "mi1" +#define INTERP_MI2 "mi2" +#define INTERP_MI3 "mi3" #define INTERP_MI "mi" +#define INTERP_TUI "tui" +#define INTERP_INSIGHT "insight" #endif