1/* MI Command Set for GDB, the GNU debugger.
2
3   Copyright (C) 2000, 2001, 2003, 2007 Free Software Foundation, Inc.
4
5   Contributed by Cygnus Solutions (a Red Hat company).
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#include "defs.h"
23#include "top.h"
24#include "mi-cmds.h"
25#include "gdb_string.h"
26
27extern void _initialize_mi_cmds (void);
28struct mi_cmd;
29static struct mi_cmd **lookup_table (const char *command);
30static void build_table (struct mi_cmd *commands);
31
32
33struct mi_cmd mi_cmds[] =
34{
35  { "break-after", { "ignore", 1 }, NULL, NULL },
36  { "break-catch", { NULL, 0 }, NULL, NULL },
37  { "break-commands", { NULL, 0 }, NULL, NULL },
38  { "break-condition", { "cond", 1 }, NULL, NULL },
39  { "break-delete", { "delete breakpoint", 1 }, NULL, NULL },
40  { "break-disable", { "disable breakpoint", 1 }, NULL, NULL },
41  { "break-enable", { "enable breakpoint", 1 }, NULL, NULL },
42  { "break-info", { "info break", 1 }, NULL, NULL },
43  { "break-insert", { NULL, 0 }, 0, mi_cmd_break_insert},
44  { "break-list", { "info break", }, NULL, NULL },
45  { "break-watch", { NULL, 0 }, 0, mi_cmd_break_watch},
46  { "data-disassemble", { NULL, 0 }, 0, mi_cmd_disassemble},
47  { "data-evaluate-expression", { NULL, 0 }, 0, mi_cmd_data_evaluate_expression},
48  { "data-list-changed-registers", { NULL, 0 }, 0, mi_cmd_data_list_changed_registers},
49  { "data-list-register-names", { NULL, 0 }, 0, mi_cmd_data_list_register_names},
50  { "data-list-register-values", { NULL, 0 }, 0, mi_cmd_data_list_register_values},
51  { "data-read-memory", { NULL, 0 }, 0, mi_cmd_data_read_memory},
52  { "data-write-memory", { NULL, 0 }, 0, mi_cmd_data_write_memory},
53  { "data-write-register-values", { NULL, 0 }, 0, mi_cmd_data_write_register_values},
54  { "enable-timings", { NULL, 0 }, 0, mi_cmd_enable_timings},
55  { "environment-cd", { NULL, 0 }, 0, mi_cmd_env_cd},
56  { "environment-directory", { NULL, 0 }, 0, mi_cmd_env_dir},
57  { "environment-path", { NULL, 0 }, 0, mi_cmd_env_path},
58  { "environment-pwd", { NULL, 0 }, 0, mi_cmd_env_pwd},
59  { "exec-abort", { NULL, 0 }, NULL, NULL },
60  { "exec-arguments", { "set args", 1 }, NULL, NULL },
61  { "exec-continue", { NULL, 0 }, mi_cmd_exec_continue},
62  { "exec-finish", { NULL, 0 }, mi_cmd_exec_finish},
63  { "exec-interrupt", { NULL, 0 }, mi_cmd_exec_interrupt},
64  { "exec-next", { NULL, 0 }, mi_cmd_exec_next},
65  { "exec-next-instruction", { NULL, 0 }, mi_cmd_exec_next_instruction},
66  { "exec-return", { NULL, 0 }, mi_cmd_exec_return},
67  { "exec-run", { NULL, 0 }, mi_cmd_exec_run},
68  { "exec-show-arguments", { NULL, 0 }, NULL, NULL },
69  { "exec-signal", { NULL, 0 }, NULL, NULL },
70  { "exec-step", { NULL, 0 }, mi_cmd_exec_step},
71  { "exec-step-instruction", { NULL, 0 }, mi_cmd_exec_step_instruction},
72  { "exec-until", { NULL, 0 }, mi_cmd_exec_until},
73  { "file-clear", { NULL, 0 }, NULL, NULL },
74  { "file-exec-and-symbols", { "file", 1 }, NULL, NULL },
75  { "file-exec-file", { "exec-file", 1 }, NULL, NULL },
76  { "file-list-exec-sections", { NULL, 0 }, NULL, NULL },
77  { "file-list-exec-source-file", { NULL, 0 }, 0, mi_cmd_file_list_exec_source_file},
78  { "file-list-exec-source-files", { NULL, 0 }, NULL, mi_cmd_file_list_exec_source_files },
79  { "file-list-shared-libraries", { NULL, 0 }, NULL, NULL },
80  { "file-list-symbol-files", { NULL, 0 }, NULL, NULL },
81  { "file-symbol-file", { "symbol-file", 1 }, NULL, NULL },
82  { "gdb-complete", { NULL, 0 }, NULL, NULL },
83  { "gdb-exit", { NULL, 0 }, 0, mi_cmd_gdb_exit},
84  { "gdb-set", { "set", 1 }, NULL, NULL },
85  { "gdb-show", { "show", 1 }, NULL, NULL },
86  { "gdb-source", { NULL, 0 }, NULL, NULL },
87  { "gdb-version", { "show version", 0 }, 0 },
88  { "inferior-tty-set", { NULL, 0 }, NULL, mi_cmd_inferior_tty_set},
89  { "inferior-tty-show", { NULL, 0 }, NULL, mi_cmd_inferior_tty_show},
90  { "interpreter-exec", { NULL, 0 }, 0, mi_cmd_interpreter_exec},
91  { "overlay-auto", { NULL, 0 }, NULL, NULL },
92  { "overlay-list-mapping-state", { NULL, 0 }, NULL, NULL },
93  { "overlay-list-overlays", { NULL, 0 }, NULL, NULL },
94  { "overlay-map", { NULL, 0 }, NULL, NULL },
95  { "overlay-off", { NULL, 0 }, NULL, NULL },
96  { "overlay-on", { NULL, 0 }, NULL, NULL },
97  { "overlay-unmap", { NULL, 0 }, NULL, NULL },
98  { "signal-handle", { NULL, 0 }, NULL, NULL },
99  { "signal-list-handle-actions", { NULL, 0 }, NULL, NULL },
100  { "signal-list-signal-types", { NULL, 0 }, NULL, NULL },
101  { "stack-info-depth", { NULL, 0 }, 0, mi_cmd_stack_info_depth},
102  { "stack-info-frame", { NULL, 0 }, 0, mi_cmd_stack_info_frame},
103  { "stack-list-arguments", { NULL, 0 }, 0, mi_cmd_stack_list_args},
104  { "stack-list-exception-handlers", { NULL, 0 }, NULL, NULL },
105  { "stack-list-frames", { NULL, 0 }, 0, mi_cmd_stack_list_frames},
106  { "stack-list-locals", { NULL, 0 }, 0, mi_cmd_stack_list_locals},
107  { "stack-select-frame", { NULL, 0 }, 0, mi_cmd_stack_select_frame},
108  { "symbol-info-address", { NULL, 0 }, NULL, NULL },
109  { "symbol-info-file", { NULL, 0 }, NULL, NULL },
110  { "symbol-info-function", { NULL, 0 }, NULL, NULL },
111  { "symbol-info-line", { NULL, 0 }, NULL, NULL },
112  { "symbol-info-symbol", { NULL, 0 }, NULL, NULL },
113  { "symbol-list-functions", { NULL, 0 }, NULL, NULL },
114  { "symbol-list-lines", { NULL, 0 }, 0, mi_cmd_symbol_list_lines},
115  { "symbol-list-types", { NULL, 0 }, NULL, NULL },
116  { "symbol-list-variables", { NULL, 0 }, NULL, NULL },
117  { "symbol-locate", { NULL, 0 }, NULL, NULL },
118  { "symbol-type", { NULL, 0 }, NULL, NULL },
119  { "target-attach", { NULL, 0 }, NULL, NULL },
120  { "target-compare-sections", { NULL, 0 }, NULL, NULL },
121  { "target-detach", { "detach", 0 }, 0 },
122  { "target-disconnect", { "disconnect", 0 }, 0 },
123  { "target-download", { NULL, 0 }, mi_cmd_target_download},
124  { "target-exec-status", { NULL, 0 }, NULL, NULL },
125  { "target-list-available-targets", { NULL, 0 }, NULL, NULL },
126  { "target-list-current-targets", { NULL, 0 }, NULL, NULL },
127  { "target-list-parameters", { NULL, 0 }, NULL, NULL },
128  { "target-select", { NULL, 0 }, mi_cmd_target_select},
129  { "thread-info", { NULL, 0 }, NULL, NULL },
130  { "thread-list-all-threads", { NULL, 0 }, NULL, NULL },
131  { "thread-list-ids", { NULL, 0 }, 0, mi_cmd_thread_list_ids},
132  { "thread-select", { NULL, 0 }, 0, mi_cmd_thread_select},
133  { "trace-actions", { NULL, 0 }, NULL, NULL },
134  { "trace-delete", { NULL, 0 }, NULL, NULL },
135  { "trace-disable", { NULL, 0 }, NULL, NULL },
136  { "trace-dump", { NULL, 0 }, NULL, NULL },
137  { "trace-enable", { NULL, 0 }, NULL, NULL },
138  { "trace-exists", { NULL, 0 }, NULL, NULL },
139  { "trace-find", { NULL, 0 }, NULL, NULL },
140  { "trace-frame-number", { NULL, 0 }, NULL, NULL },
141  { "trace-info", { NULL, 0 }, NULL, NULL },
142  { "trace-insert", { NULL, 0 }, NULL, NULL },
143  { "trace-list", { NULL, 0 }, NULL, NULL },
144  { "trace-pass-count", { NULL, 0 }, NULL, NULL },
145  { "trace-save", { NULL, 0 }, NULL, NULL },
146  { "trace-start", { NULL, 0 }, NULL, NULL },
147  { "trace-stop", { NULL, 0 }, NULL, NULL },
148  { "var-assign", { NULL, 0 }, 0, mi_cmd_var_assign},
149  { "var-create", { NULL, 0 }, 0, mi_cmd_var_create},
150  { "var-delete", { NULL, 0 }, 0, mi_cmd_var_delete},
151  { "var-evaluate-expression", { NULL, 0 }, 0, mi_cmd_var_evaluate_expression},
152  { "var-info-path-expression", { NULL, 0 }, 0,
153    mi_cmd_var_info_path_expression},
154  { "var-info-expression", { NULL, 0 }, 0, mi_cmd_var_info_expression},
155  { "var-info-num-children", { NULL, 0 }, 0, mi_cmd_var_info_num_children},
156  { "var-info-type", { NULL, 0 }, 0, mi_cmd_var_info_type},
157  { "var-list-children", { NULL, 0 }, 0, mi_cmd_var_list_children},
158  { "var-set-format", { NULL, 0 }, 0, mi_cmd_var_set_format},
159  { "var-set-frozen", { NULL, 0 }, 0, mi_cmd_var_set_frozen},
160  { "var-show-attributes", { NULL, 0 }, 0, mi_cmd_var_show_attributes},
161  { "var-show-format", { NULL, 0 }, 0, mi_cmd_var_show_format},
162  { "var-update", { NULL, 0 }, 0, mi_cmd_var_update},
163  { NULL, }
164};
165
166/* Pointer to the mi command table (built at run time) */
167
168static struct mi_cmd **mi_table;
169
170/* A prime large enough to accomodate the entire command table */
171enum
172  {
173    MI_TABLE_SIZE = 227
174  };
175
176/* Exported function used to obtain info from the table */
177struct mi_cmd *
178mi_lookup (const char *command)
179{
180  return *lookup_table (command);
181}
182
183/* stat collecting */
184struct mi_cmd_stats
185{
186  int hit;
187  int miss;
188  int rehash;
189};
190struct mi_cmd_stats stats;
191
192/* our lookup function */
193static struct mi_cmd **
194lookup_table (const char *command)
195{
196  const char *chp;
197  unsigned int index = 0;
198  /* compute our hash */
199  for (chp = command; *chp; chp++)
200    {
201      /* some what arbitrary */
202      index = ((index << 6) + (unsigned int) *chp) % MI_TABLE_SIZE;
203    }
204  /* look it up */
205  while (1)
206    {
207      struct mi_cmd **entry = &mi_table[index];
208      if ((*entry) == 0)
209	{
210	  /* not found, return pointer to next free. */
211	  stats.miss++;
212	  return entry;
213	}
214      if (strcmp (command, (*entry)->name) == 0)
215	{
216	  stats.hit++;
217	  return entry;		/* found */
218	}
219      index = (index + 1) % MI_TABLE_SIZE;
220      stats.rehash++;
221    }
222}
223
224static void
225build_table (struct mi_cmd *commands)
226{
227  int nr_rehash = 0;
228  int nr_entries = 0;
229  struct mi_cmd *command;
230  int sizeof_table = sizeof (struct mi_cmd **) * MI_TABLE_SIZE;
231
232  mi_table = xmalloc (sizeof_table);
233  memset (mi_table, 0, sizeof_table);
234  for (command = commands; command->name != 0; command++)
235    {
236      struct mi_cmd **entry = lookup_table (command->name);
237      if (*entry)
238	internal_error (__FILE__, __LINE__,
239			_("command `%s' appears to be duplicated"),
240			command->name);
241      *entry = command;
242      if (0)
243	{
244	  fprintf_unfiltered (gdb_stdlog, "%-30s %2d\n",
245			      command->name, stats.rehash - nr_rehash);
246	}
247      nr_entries++;
248      nr_rehash = stats.rehash;
249    }
250  if (0)
251    {
252      fprintf_filtered (gdb_stdlog, "Average %3.1f\n",
253			(double) nr_rehash / (double) nr_entries);
254    }
255}
256
257void
258_initialize_mi_cmds (void)
259{
260  build_table (mi_cmds);
261  memset (&stats, 0, sizeof (stats));
262}
263