GDB (xrefs)
mi-cmds.c
Go to the documentation of this file.
1 /* MI Command Set for GDB, the GNU debugger.
2  Copyright (C) 2000-2015 Free Software Foundation, Inc.
3 
4  Contributed by Cygnus Solutions (a Red Hat company).
5 
6  This file is part of GDB.
7 
8  This program is free software; you can redistribute it and/or modify
9  it under the terms of the GNU General Public License as published by
10  the Free Software Foundation; either version 3 of the License, or
11  (at your option) any later version.
12 
13  This program is distributed in the hope that it will be useful,
14  but WITHOUT ANY WARRANTY; without even the implied warranty of
15  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  GNU General Public License for more details.
17 
18  You should have received a copy of the GNU General Public License
19  along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 
21 #include "defs.h"
22 #include "top.h"
23 #include "mi-cmds.h"
24 #include "mi-main.h"
25 
26 extern void _initialize_mi_cmds (void);
27 
28 struct mi_cmd;
29 static struct mi_cmd **lookup_table (const char *command);
30 static void build_table (struct mi_cmd *commands);
31 
32 static struct mi_cmd mi_cmds[] =
33 {
34 /* Define a MI command of NAME, and its corresponding CLI command is
35  CLI_NAME. */
36 #define DEF_MI_CMD_CLI_1(NAME, CLI_NAME, ARGS_P, CALLED) \
37  { NAME, { CLI_NAME, ARGS_P}, NULL, CALLED }
38 #define DEF_MI_CMD_CLI(NAME, CLI_NAME, ARGS_P) \
39  DEF_MI_CMD_CLI_1(NAME, CLI_NAME, ARGS_P, NULL)
40 
41 /* Define a MI command of NAME, and implemented by function MI_FUNC. */
42 #define DEF_MI_CMD_MI_1(NAME, MI_FUNC, CALLED) \
43  { NAME, {NULL, 0}, MI_FUNC, CALLED }
44 #define DEF_MI_CMD_MI(NAME, MI_FUNC) DEF_MI_CMD_MI_1(NAME, MI_FUNC, NULL)
45 
46  DEF_MI_CMD_MI ("ada-task-info", mi_cmd_ada_task_info),
47  DEF_MI_CMD_MI ("add-inferior", mi_cmd_add_inferior),
48  DEF_MI_CMD_CLI_1 ("break-after", "ignore", 1,
50  DEF_MI_CMD_CLI_1 ("break-condition","cond", 1,
52  DEF_MI_CMD_MI_1 ("break-commands", mi_cmd_break_commands,
54  DEF_MI_CMD_CLI_1 ("break-delete", "delete breakpoint", 1,
56  DEF_MI_CMD_CLI_1 ("break-disable", "disable breakpoint", 1,
58  DEF_MI_CMD_CLI_1 ("break-enable", "enable breakpoint", 1,
60  DEF_MI_CMD_CLI ("break-info", "info break", 1),
61  DEF_MI_CMD_MI_1 ("break-insert", mi_cmd_break_insert,
63  DEF_MI_CMD_MI_1 ("dprintf-insert", mi_cmd_dprintf_insert,
65  DEF_MI_CMD_CLI ("break-list", "info break", 0),
66  DEF_MI_CMD_MI_1 ("break-passcount", mi_cmd_break_passcount,
68  DEF_MI_CMD_MI_1 ("break-watch", mi_cmd_break_watch,
70  DEF_MI_CMD_MI_1 ("catch-assert", mi_cmd_catch_assert,
72  DEF_MI_CMD_MI_1 ("catch-exception", mi_cmd_catch_exception,
74  DEF_MI_CMD_MI_1 ("catch-load", mi_cmd_catch_load,
76  DEF_MI_CMD_MI_1 ("catch-unload", mi_cmd_catch_unload,
78  DEF_MI_CMD_MI ("data-disassemble", mi_cmd_disassemble),
79  DEF_MI_CMD_MI ("data-evaluate-expression", mi_cmd_data_evaluate_expression),
80  DEF_MI_CMD_MI ("data-list-changed-registers",
82  DEF_MI_CMD_MI ("data-list-register-names", mi_cmd_data_list_register_names),
83  DEF_MI_CMD_MI ("data-list-register-values", mi_cmd_data_list_register_values),
84  DEF_MI_CMD_MI ("data-read-memory", mi_cmd_data_read_memory),
85  DEF_MI_CMD_MI ("data-read-memory-bytes", mi_cmd_data_read_memory_bytes),
86  DEF_MI_CMD_MI_1 ("data-write-memory", mi_cmd_data_write_memory,
88  DEF_MI_CMD_MI_1 ("data-write-memory-bytes", mi_cmd_data_write_memory_bytes,
90  DEF_MI_CMD_MI ("data-write-register-values",
92  DEF_MI_CMD_MI ("enable-timings", mi_cmd_enable_timings),
93  DEF_MI_CMD_MI ("enable-pretty-printing", mi_cmd_enable_pretty_printing),
94  DEF_MI_CMD_MI ("enable-frame-filters", mi_cmd_enable_frame_filters),
95  DEF_MI_CMD_MI ("environment-cd", mi_cmd_env_cd),
96  DEF_MI_CMD_MI ("environment-directory", mi_cmd_env_dir),
97  DEF_MI_CMD_MI ("environment-path", mi_cmd_env_path),
98  DEF_MI_CMD_MI ("environment-pwd", mi_cmd_env_pwd),
99  DEF_MI_CMD_CLI_1 ("exec-arguments", "set args", 1,
101  DEF_MI_CMD_MI ("exec-continue", mi_cmd_exec_continue),
102  DEF_MI_CMD_MI ("exec-finish", mi_cmd_exec_finish),
103  DEF_MI_CMD_MI ("exec-jump", mi_cmd_exec_jump),
104  DEF_MI_CMD_MI ("exec-interrupt", mi_cmd_exec_interrupt),
105  DEF_MI_CMD_MI ("exec-next", mi_cmd_exec_next),
106  DEF_MI_CMD_MI ("exec-next-instruction", mi_cmd_exec_next_instruction),
107  DEF_MI_CMD_MI ("exec-return", mi_cmd_exec_return),
108  DEF_MI_CMD_MI ("exec-run", mi_cmd_exec_run),
109  DEF_MI_CMD_MI ("exec-step", mi_cmd_exec_step),
110  DEF_MI_CMD_MI ("exec-step-instruction", mi_cmd_exec_step_instruction),
111  DEF_MI_CMD_CLI ("exec-until", "until", 1),
112  DEF_MI_CMD_CLI ("file-exec-and-symbols", "file", 1),
113  DEF_MI_CMD_CLI ("file-exec-file", "exec-file", 1),
114  DEF_MI_CMD_MI ("file-list-exec-source-file",
116  DEF_MI_CMD_MI ("file-list-exec-source-files",
118  DEF_MI_CMD_CLI ("file-symbol-file", "symbol-file", 1),
119  DEF_MI_CMD_MI ("gdb-exit", mi_cmd_gdb_exit),
120  DEF_MI_CMD_CLI_1 ("gdb-set", "set", 1,
122  DEF_MI_CMD_CLI ("gdb-show", "show", 1),
123  DEF_MI_CMD_CLI ("gdb-version", "show version", 0),
124  DEF_MI_CMD_MI ("inferior-tty-set", mi_cmd_inferior_tty_set),
125  DEF_MI_CMD_MI ("inferior-tty-show", mi_cmd_inferior_tty_show),
126  DEF_MI_CMD_MI ("info-ada-exceptions", mi_cmd_info_ada_exceptions),
127  DEF_MI_CMD_MI ("info-gdb-mi-command", mi_cmd_info_gdb_mi_command),
128  DEF_MI_CMD_MI ("info-os", mi_cmd_info_os),
129  DEF_MI_CMD_MI ("interpreter-exec", mi_cmd_interpreter_exec),
130  DEF_MI_CMD_MI ("list-features", mi_cmd_list_features),
131  DEF_MI_CMD_MI ("list-target-features", mi_cmd_list_target_features),
132  DEF_MI_CMD_MI ("list-thread-groups", mi_cmd_list_thread_groups),
133  DEF_MI_CMD_MI ("remove-inferior", mi_cmd_remove_inferior),
134  DEF_MI_CMD_MI ("stack-info-depth", mi_cmd_stack_info_depth),
135  DEF_MI_CMD_MI ("stack-info-frame", mi_cmd_stack_info_frame),
136  DEF_MI_CMD_MI ("stack-list-arguments", mi_cmd_stack_list_args),
137  DEF_MI_CMD_MI ("stack-list-frames", mi_cmd_stack_list_frames),
138  DEF_MI_CMD_MI ("stack-list-locals", mi_cmd_stack_list_locals),
139  DEF_MI_CMD_MI ("stack-list-variables", mi_cmd_stack_list_variables),
140  DEF_MI_CMD_MI ("stack-select-frame", mi_cmd_stack_select_frame),
141  DEF_MI_CMD_MI ("symbol-list-lines", mi_cmd_symbol_list_lines),
142  DEF_MI_CMD_CLI ("target-attach", "attach", 1),
143  DEF_MI_CMD_MI ("target-detach", mi_cmd_target_detach),
144  DEF_MI_CMD_CLI ("target-disconnect", "disconnect", 0),
145  DEF_MI_CMD_CLI ("target-download", "load", 1),
146  DEF_MI_CMD_MI ("target-file-delete", mi_cmd_target_file_delete),
147  DEF_MI_CMD_MI ("target-file-get", mi_cmd_target_file_get),
148  DEF_MI_CMD_MI ("target-file-put", mi_cmd_target_file_put),
149  DEF_MI_CMD_CLI ("target-select", "target", 1),
150  DEF_MI_CMD_MI ("thread-info", mi_cmd_thread_info),
151  DEF_MI_CMD_MI ("thread-list-ids", mi_cmd_thread_list_ids),
152  DEF_MI_CMD_MI ("thread-select", mi_cmd_thread_select),
153  DEF_MI_CMD_MI ("trace-define-variable", mi_cmd_trace_define_variable),
154  DEF_MI_CMD_MI_1 ("trace-find", mi_cmd_trace_find,
156  DEF_MI_CMD_MI ("trace-frame-collected",
158  DEF_MI_CMD_MI ("trace-list-variables", mi_cmd_trace_list_variables),
159  DEF_MI_CMD_MI ("trace-save", mi_cmd_trace_save),
160  DEF_MI_CMD_MI ("trace-start", mi_cmd_trace_start),
161  DEF_MI_CMD_MI ("trace-status", mi_cmd_trace_status),
162  DEF_MI_CMD_MI ("trace-stop", mi_cmd_trace_stop),
163  DEF_MI_CMD_MI ("var-assign", mi_cmd_var_assign),
164  DEF_MI_CMD_MI ("var-create", mi_cmd_var_create),
165  DEF_MI_CMD_MI ("var-delete", mi_cmd_var_delete),
166  DEF_MI_CMD_MI ("var-evaluate-expression", mi_cmd_var_evaluate_expression),
167  DEF_MI_CMD_MI ("var-info-path-expression", mi_cmd_var_info_path_expression),
168  DEF_MI_CMD_MI ("var-info-expression", mi_cmd_var_info_expression),
169  DEF_MI_CMD_MI ("var-info-num-children", mi_cmd_var_info_num_children),
170  DEF_MI_CMD_MI ("var-info-type", mi_cmd_var_info_type),
171  DEF_MI_CMD_MI ("var-list-children", mi_cmd_var_list_children),
172  DEF_MI_CMD_MI ("var-set-format", mi_cmd_var_set_format),
173  DEF_MI_CMD_MI ("var-set-frozen", mi_cmd_var_set_frozen),
174  DEF_MI_CMD_MI ("var-set-update-range", mi_cmd_var_set_update_range),
175  DEF_MI_CMD_MI ("var-set-visualizer", mi_cmd_var_set_visualizer),
176  DEF_MI_CMD_MI ("var-show-attributes", mi_cmd_var_show_attributes),
177  DEF_MI_CMD_MI ("var-show-format", mi_cmd_var_show_format),
178  DEF_MI_CMD_MI ("var-update", mi_cmd_var_update),
179  { NULL, }
180 };
181 
182 /* Pointer to the mi command table (built at run time). */
183 
184 static struct mi_cmd **mi_table;
185 
186 /* A prime large enough to accomodate the entire command table. */
187 enum
188  {
190  };
191 
192 /* Exported function used to obtain info from the table. */
193 struct mi_cmd *
194 mi_lookup (const char *command)
195 {
196  return *lookup_table (command);
197 }
198 
199 /* Used for collecting hash hit/miss statistics. */
200 
202 {
203  int hit;
204  int miss;
205  int rehash;
206 };
208 
209 /* Look up a command. */
210 
211 static struct mi_cmd **
212 lookup_table (const char *command)
213 {
214  const char *chp;
215  unsigned int index = 0;
216 
217  /* Compute our hash. */
218  for (chp = command; *chp; chp++)
219  {
220  /* We use a somewhat arbitrary formula. */
221  index = ((index << 6) + (unsigned int) *chp) % MI_TABLE_SIZE;
222  }
223 
224  while (1)
225  {
226  struct mi_cmd **entry = &mi_table[index];
227  if ((*entry) == 0)
228  {
229  /* not found, return pointer to next free. */
230  stats.miss++;
231  return entry;
232  }
233  if (strcmp (command, (*entry)->name) == 0)
234  {
235  stats.hit++;
236  return entry; /* found */
237  }
238  index = (index + 1) % MI_TABLE_SIZE;
239  stats.rehash++;
240  }
241 }
242 
243 static void
244 build_table (struct mi_cmd *commands)
245 {
246  int nr_rehash = 0;
247  int nr_entries = 0;
248  struct mi_cmd *command;
249 
250  mi_table = XCNEWVEC (struct mi_cmd *, MI_TABLE_SIZE);
251  for (command = commands; command->name != 0; command++)
252  {
253  struct mi_cmd **entry = lookup_table (command->name);
254 
255  if (*entry)
256  internal_error (__FILE__, __LINE__,
257  _("command `%s' appears to be duplicated"),
258  command->name);
259  *entry = command;
260  /* FIXME lose these prints */
261  if (0)
262  {
263  fprintf_unfiltered (gdb_stdlog, "%-30s %2d\n",
264  command->name, stats.rehash - nr_rehash);
265  }
266  nr_entries++;
267  nr_rehash = stats.rehash;
268  }
269  if (0)
270  {
271  fprintf_filtered (gdb_stdlog, "Average %3.1f\n",
272  (double) nr_rehash / (double) nr_entries);
273  }
274 }
275 
276 void
278 {
279  build_table (mi_cmds);
280  memset (&stats, 0, sizeof (stats));
281 }
mi_cmd_argv_ftype mi_cmd_exec_run
#define DEF_MI_CMD_MI(NAME, MI_FUNC)
mi_cmd_argv_ftype mi_cmd_trace_list_variables
#define DEF_MI_CMD_CLI_1(NAME, CLI_NAME, ARGS_P, CALLED)
mi_cmd_argv_ftype mi_cmd_stack_list_args
mi_cmd_argv_ftype mi_cmd_exec_step
mi_cmd_argv_ftype mi_cmd_enable_pretty_printing
mi_cmd_argv_ftype mi_cmd_var_info_path_expression
mi_cmd_argv_ftype mi_cmd_stack_select_frame
mi_cmd_argv_ftype mi_cmd_var_info_expression
mi_cmd_argv_ftype mi_cmd_list_thread_groups
mi_cmd_argv_ftype mi_cmd_trace_define_variable
mi_cmd_argv_ftype mi_cmd_var_set_format
mi_cmd_argv_ftype mi_cmd_enable_timings
mi_cmd_argv_ftype mi_cmd_stack_info_depth
mi_cmd_argv_ftype mi_cmd_info_ada_exceptions
mi_cmd_argv_ftype mi_cmd_break_insert
mi_cmd_argv_ftype mi_cmd_exec_continue
mi_cmd_argv_ftype mi_cmd_trace_start
int rehash
Definition: mi-cmds.c:205
mi_cmd_argv_ftype mi_cmd_list_target_features
mi_cmd_argv_ftype mi_cmd_var_create
mi_cmd_argv_ftype mi_cmd_data_write_memory_bytes
mi_cmd_argv_ftype mi_cmd_file_list_exec_source_files
void internal_error(const char *file, int line, const char *fmt,...)
Definition: errors.c:50
mi_cmd_argv_ftype mi_cmd_var_delete
mi_cmd_argv_ftype mi_cmd_inferior_tty_set
mi_cmd_argv_ftype mi_cmd_data_list_changed_registers
mi_cmd_argv_ftype mi_cmd_data_read_memory
mi_cmd_argv_ftype mi_cmd_stack_list_frames
mi_cmd_argv_ftype mi_cmd_target_detach
mi_cmd_argv_ftype mi_cmd_target_file_put
mi_cmd_argv_ftype mi_cmd_thread_info
#define _(String)
Definition: gdb_locale.h:40
mi_cmd_argv_ftype mi_cmd_add_inferior
mi_cmd_argv_ftype mi_cmd_env_path
mi_cmd_argv_ftype mi_cmd_list_features
mi_cmd_argv_ftype mi_cmd_var_info_type
mi_cmd_argv_ftype mi_cmd_symbol_list_lines
mi_cmd_argv_ftype mi_cmd_trace_save
mi_cmd_argv_ftype mi_cmd_data_write_memory
mi_cmd_argv_ftype mi_cmd_stack_info_frame
mi_cmd_argv_ftype mi_cmd_data_write_register_values
mi_cmd_argv_ftype mi_cmd_data_list_register_names
mi_cmd_argv_ftype mi_cmd_stack_list_variables
mi_cmd_argv_ftype mi_cmd_env_cd
void fprintf_filtered(struct ui_file *stream, const char *format,...)
Definition: utils.c:2351
mi_cmd_argv_ftype mi_cmd_data_evaluate_expression
mi_cmd_argv_ftype mi_cmd_break_watch
mi_cmd_argv_ftype mi_cmd_var_set_visualizer
mi_cmd_argv_ftype mi_cmd_interpreter_exec
mi_cmd_argv_ftype mi_cmd_catch_load
mi_cmd_argv_ftype mi_cmd_var_show_attributes
void fprintf_unfiltered(struct ui_file *stream, const char *format,...)
Definition: utils.c:2361
mi_cmd_argv_ftype mi_cmd_ada_task_info
mi_cmd_argv_ftype mi_cmd_catch_assert
mi_cmd_argv_ftype mi_cmd_data_list_register_values
mi_cmd_argv_ftype mi_cmd_break_passcount
mi_cmd_argv_ftype mi_cmd_env_pwd
const char * name
Definition: mi-cmds.h:139
mi_cmd_argv_ftype mi_cmd_catch_exception
mi_cmd_argv_ftype mi_cmd_file_list_exec_source_file
mi_cmd_argv_ftype mi_cmd_gdb_exit
struct mi_cmd_stats stats
Definition: mi-cmds.c:207
mi_cmd_argv_ftype mi_cmd_target_file_delete
mi_cmd_argv_ftype mi_cmd_var_info_num_children
mi_cmd_argv_ftype mi_cmd_exec_next_instruction
mi_cmd_argv_ftype mi_cmd_exec_jump
mi_cmd_argv_ftype mi_cmd_disassemble
mi_cmd_argv_ftype mi_cmd_inferior_tty_show
mi_cmd_argv_ftype mi_cmd_trace_stop
mi_cmd_argv_ftype mi_cmd_info_os
mi_cmd_argv_ftype mi_cmd_info_gdb_mi_command
struct ui_file * gdb_stdlog
Definition: main.c:73
mi_cmd_argv_ftype mi_cmd_enable_frame_filters
mi_cmd_argv_ftype mi_cmd_var_assign
struct mi_cmd * mi_lookup(const char *command)
Definition: mi-cmds.c:194
void _initialize_mi_cmds(void)
Definition: mi-cmds.c:277
mi_cmd_argv_ftype mi_cmd_break_commands
static struct mi_cmd ** mi_table
Definition: mi-cmds.c:184
mi_cmd_argv_ftype mi_cmd_var_show_format
mi_cmd_argv_ftype mi_cmd_var_set_frozen
mi_cmd_argv_ftype mi_cmd_exec_next
mi_cmd_argv_ftype mi_cmd_env_dir
mi_cmd_argv_ftype mi_cmd_dprintf_insert
static struct mi_cmd ** lookup_table(const char *command)
Definition: mi-cmds.c:212
#define DEF_MI_CMD_CLI(NAME, CLI_NAME, ARGS_P)
mi_cmd_argv_ftype mi_cmd_trace_find
mi_cmd_argv_ftype mi_cmd_data_read_memory_bytes
mi_cmd_argv_ftype mi_cmd_exec_finish
mi_cmd_argv_ftype mi_cmd_catch_unload
static void build_table(struct mi_cmd *commands)
Definition: mi-cmds.c:244
mi_cmd_argv_ftype mi_cmd_exec_interrupt
mi_cmd_argv_ftype mi_cmd_trace_status
mi_cmd_argv_ftype mi_cmd_var_list_children
mi_cmd_argv_ftype mi_cmd_trace_frame_collected
mi_cmd_argv_ftype mi_cmd_target_file_get
mi_cmd_argv_ftype mi_cmd_exec_step_instruction
mi_cmd_argv_ftype mi_cmd_remove_inferior
mi_cmd_argv_ftype mi_cmd_exec_return
#define DEF_MI_CMD_MI_1(NAME, MI_FUNC, CALLED)
mi_cmd_argv_ftype mi_cmd_var_set_update_range
mi_cmd_argv_ftype mi_cmd_stack_list_locals
mi_cmd_argv_ftype mi_cmd_thread_list_ids
mi_cmd_argv_ftype mi_cmd_var_evaluate_expression
mi_cmd_argv_ftype mi_cmd_thread_select