plugins/gdb/debugger.h

   1 /* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 4; tab-width: 4 -*- */
   2 /*
   3     debugger.h
   4     Copyright (C) Naba Kumar <naba@gnome.org>
   5
   6     This program is free software; you can redistribute it and/or modify
   7     it under the terms of the GNU General Public License as published by
   8     the Free Software Foundation; either version 2 of the License, or
   9     (at your option) any later version.
  10
  11     This program is distributed in the hope that it will be useful,
  12     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14     GNU General Public License for more details.
  15
  16     You should have received a copy of the GNU General Public License
  17     along with this program; if not, write to the Free Software
  18     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  19 */
  20 #ifndef __DEBUGGER_H__
  21 #define __DEBUGGER_H__
  22
  23 #include <sys/types.h>
  24 #include <glib-object.h>
  25 #include <gtk/gtkwindow.h>
  26 #include "gdbmi.h"
  27
  28 #include <libanjuta/interfaces/ianjuta-message-view.h>
  29 #include <libanjuta/interfaces/ianjuta-debugger.h>
  30 #include <libanjuta/interfaces/ianjuta-cpu-debugger.h>
  31
  32 G_BEGIN_DECLS
  33
  34 typedef struct _Debugger        Debugger;
  35 typedef struct _DebuggerClass   DebuggerClass;
  36 typedef struct _DebuggerPriv    DebuggerPriv;
  37 typedef struct _DebuggerCommand DebuggerCommand;
  38
  39 #define DEBUGGER_TYPE            (debugger_get_type ())
  40 #define DEBUGGER(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), DEBUGGER_TYPE, Debugger))
  41 #define DEBUGGER_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), DEBUGGER_TYPE, DebuggerClass))
  42 #define IS_DEBUGGER(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), DEBUGGER_TYPE))
  43 #define IS_DEBUGGER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), DEBUGGER_TYPE))
  44
  45 typedef enum
  46 {
  47         DEBUGGER_BREAKPOINT,
  48 } DebuggerBreakpointType;
  49
  50 typedef void (*DebuggerParserFunc) (Debugger *debugger,
  51                                                                         const GDBMIValue *mi_result,
  52                                                                         const GList *cli_result,
  53                                                                         GError* error);
  54
  55 struct _DebuggerCommand
  56 {
  57         gchar *cmd;
  58         gboolean suppress_error;
  59         gboolean keep_result;
  60         DebuggerParserFunc parser;
  61         IAnjutaDebuggerCallback callback;
  62         gpointer user_data;
  63 };
  64
  65 struct _Debugger
  66 {
  67         GObject parent;
  68         DebuggerPriv *priv;
  69 };
  70
  71 struct _DebuggerClass
  72 {
  73         GObjectClass parent_class;
  74 };
  75
  76 GType debugger_get_type (void);
  77
  78 Debugger* debugger_new (GtkWindow *parent_win, GObject* instance);
  79 void debugger_free (Debugger *debugger);
  80
  81 gboolean debugger_start (Debugger *debugger, const GList *search_dirs,
  82                                                         const gchar *prog, gboolean is_libtool_prog);
  83
  84 gboolean debugger_stop (Debugger *debugger);
  85 gboolean debugger_abort (Debugger *debugger);
  86
  87 void debugger_set_output_callback (Debugger *debugger, IAnjutaDebuggerOutputCallback callback, gpointer user_data);
  88
  89 /* Status */
  90 gboolean debugger_is_ready (Debugger *debugger);
  91 gboolean debugger_program_is_running (Debugger *debugger);
  92 gboolean debugger_program_is_attached (Debugger *debugger);
  93 gboolean debugger_program_is_loaded (Debugger *debugger);
  94 IAnjutaDebuggerState debugger_get_state (Debugger *debugger);
  95
  96 /* Send standard gdb MI2 or CLI commands */
  97 void debugger_command (Debugger *debugger, const gchar *command,
  98                                            gboolean suppress_error, DebuggerParserFunc parser,
  99                                            gpointer user_data);
 100
 101 void debugger_program_moved (Debugger *debugger, const gchar *file,
 102                                                            gint line, guint address);
 103 gchar* debugger_get_source_path (Debugger *debugger, const gchar *file);
 104
 105 /* Program loading */
 106 void debugger_load_executable (Debugger *debugger, const gchar *prog);
 107 void debugger_load_core (Debugger *debugger, const gchar *core);
 108 void debugger_attach_process (Debugger *debugger, pid_t pid);
 109 void debugger_detach_process (Debugger *debugger);
 110
 111 /* Execution */
 112 void debugger_start_program (Debugger *debugger, const gchar* args, const gchar* tty, gboolean stop);
 113 void debugger_stop_program (Debugger *debugger);
 114 void debugger_restart_program (Debugger *debugger);
 115 void debugger_interrupt (Debugger *debugger);
 116 void debugger_run (Debugger *debugger);
 117 void debugger_step_in (Debugger *debugger);
 118 void debugger_step_over (Debugger *debugger);
 119 void debugger_step_out (Debugger *debugger);
 120 void debugger_stepi_in (Debugger *debugger);
 121 void debugger_stepi_over (Debugger *debugger);
 122 void debugger_run_to_location (Debugger *debugger, const gchar *loc);
 123 void debugger_run_to_position (Debugger *debugger, const gchar *file, guint line);
 124 void debugger_run_to_address (Debugger *debugger, guint address);
 125
 126 /* Breakpoint */
 127 void debugger_add_breakpoint_at_line (Debugger *debugger, const gchar* file, guint line, IAnjutaDebuggerCallback callback, gpointer user_data);
 128 void debugger_add_breakpoint_at_function (Debugger *debugger, const gchar* file, const gchar* function, IAnjutaDebuggerCallback callback, gpointer user_data);
 129 void debugger_add_breakpoint_at_address (Debugger *debugger, guint address, IAnjutaDebuggerCallback callback, gpointer user_data);
 130 void debugger_remove_breakpoint (Debugger *debugger, guint id, IAnjutaDebuggerCallback callback, gpointer user_data);
 131 void debugger_list_breakpoint (Debugger *debugger, IAnjutaDebuggerCallback callback, gpointer user_data);
 132 void debugger_enable_breakpoint (Debugger *debugger, guint id, gboolean enable, IAnjutaDebuggerCallback callback, gpointer user_data);
 133 void debugger_ignore_breakpoint (Debugger *debugger, guint id, guint ignore, IAnjutaDebuggerCallback callback, gpointer user_data);
 134 void debugger_condition_breakpoint (Debugger *debugger, guint id, const gchar* condition, IAnjutaDebuggerCallback callback, gpointer user_data);
 135
 136 /* Variable */
 137 void debugger_print (Debugger *debugger, const gchar* variable, IAnjutaDebuggerCallback callback, gpointer user_data);
 138 void debugger_evaluate (Debugger *debugger, const gchar* name, IAnjutaDebuggerCallback callback, gpointer user_data);
 139
 140 /* Info */
 141 void debugger_list_local (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 142 void debugger_list_argument (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 143 void debugger_info_signal (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 144 void debugger_info_frame (Debugger *debugger, guint frame, IAnjutaDebuggerCallback func, gpointer user_data);
 145 void debugger_info_sharedlib (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 146 void debugger_info_args (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 147 void debugger_info_target (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 148 void debugger_info_program (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 149 void debugger_info_udot (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 150 void debugger_info_variables (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 151 void debugger_inspect_memory (Debugger *debugger, guint address, guint length, IAnjutaDebuggerCallback func, gpointer user_data);
 152 void debugger_disassemble (Debugger *debugger, guint address, guint length, IAnjutaDebuggerCallback func, gpointer user_data);
 153
 154 /* Register */
 155
 156 void debugger_list_register (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 157 void debugger_update_register (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 158 void debugger_write_register (Debugger *debugger, const gchar *name, const gchar *value);
 159
 160 /* Stack */
 161 void debugger_list_argument (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 162 void debugger_list_frame (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 163 void debugger_set_frame (Debugger *debugger, guint frame);
 164
 165 /* Thread */
 166 void debugger_list_thread (Debugger *debugger, IAnjutaDebuggerCallback func, gpointer user_data);
 167 void debugger_set_thread (Debugger *debugger, gint thread);
 168 void debugger_info_thread (Debugger *debugger, gint thread, IAnjutaDebuggerCallback func, gpointer user_data);
 169
 170 /* Log */
 171 void debugger_set_log (Debugger *debugger, IAnjutaMessageView *view);
 172
 173 /* Variable object */
 174 void debugger_delete_variable (Debugger *debugger, const gchar *name);
 175 void debugger_evaluate_variable (Debugger *debugger, const gchar *name, IAnjutaDebuggerCallback callback, gpointer user_data);
 176 void debugger_assign_variable (Debugger *debugger, const gchar *name, const gchar *value);
 177 void debugger_list_variable_children (Debugger *debugger, const gchar* name, IAnjutaDebuggerCallback callback, gpointer user_data);
 178 void debugger_create_variable (Debugger *debugger, const gchar *name, IAnjutaDebuggerCallback callback, gpointer user_data);
 179 void debugger_update_variable (Debugger *debugger, IAnjutaDebuggerCallback callback, gpointer user_data);
 180
 181 #if 0
 182
 183 /* Evaluations */
 184 void debugger_query_execute (void);
 185 void debugger_query_evaluate_expr_tip (const gchar *expr,
 186                                                                            DebuggerFunc parser,
 187                                                                            gpointer data);
 188 void debugger_query_evaluate_expr (const gchar *expr,
 189                                                                    DebuggerFunc parser,
 190                                                                    gpointer data);
 191 #endif
 192
 193 G_END_DECLS
 194
 195 #endif