Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Support for GDB maintenance commands. |
d28f9cdf | 2 | Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2002, 2003 |
b6ba6518 | 3 | Free Software Foundation, Inc. |
c906108c SS |
4 | Written by Fred Fish at Cygnus Support. |
5 | ||
c5aa993b | 6 | This file is part of GDB. |
c906108c | 7 | |
c5aa993b JM |
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 2 of the License, or | |
11 | (at your option) any later version. | |
c906108c | 12 | |
c5aa993b JM |
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. | |
c906108c | 17 | |
c5aa993b JM |
18 | You should have received a copy of the GNU General Public License |
19 | along with this program; if not, write to the Free Software | |
20 | Foundation, Inc., 59 Temple Place - Suite 330, | |
21 | Boston, MA 02111-1307, USA. */ | |
c906108c SS |
22 | |
23 | ||
24 | #include "defs.h" | |
c906108c SS |
25 | #include <ctype.h> |
26 | #include <signal.h> | |
27 | #include "command.h" | |
28 | #include "gdbcmd.h" | |
29 | #include "symtab.h" | |
30 | #include "gdbtypes.h" | |
31 | #include "demangle.h" | |
32 | #include "gdbcore.h" | |
c5aa993b | 33 | #include "expression.h" /* For language.h */ |
c906108c SS |
34 | #include "language.h" |
35 | #include "symfile.h" | |
36 | #include "objfiles.h" | |
37 | #include "value.h" | |
38 | ||
18a642a1 AC |
39 | #include "cli/cli-decode.h" |
40 | ||
a14ed312 | 41 | extern void _initialize_maint_cmds (void); |
392a587b | 42 | |
a14ed312 | 43 | static void maintenance_command (char *, int); |
c906108c | 44 | |
a14ed312 | 45 | static void maintenance_dump_me (char *, int); |
c906108c | 46 | |
a14ed312 | 47 | static void maintenance_internal_error (char *args, int from_tty); |
7be570e7 | 48 | |
a14ed312 | 49 | static void maintenance_demangle (char *, int); |
c906108c | 50 | |
a14ed312 | 51 | static void maintenance_time_display (char *, int); |
c906108c | 52 | |
a14ed312 | 53 | static void maintenance_space_display (char *, int); |
c906108c | 54 | |
a14ed312 | 55 | static void maintenance_info_command (char *, int); |
c906108c | 56 | |
43155bc1 | 57 | static void print_section_table (bfd *, asection *, void *); |
c906108c | 58 | |
a14ed312 | 59 | static void maintenance_info_sections (char *, int); |
c906108c | 60 | |
a14ed312 | 61 | static void maintenance_print_command (char *, int); |
c906108c | 62 | |
1c689132 DB |
63 | static void maintenance_do_deprecate (char *, int); |
64 | ||
c906108c SS |
65 | /* Set this to the maximum number of seconds to wait instead of waiting forever |
66 | in target_wait(). If this timer times out, then it generates an error and | |
67 | the command is aborted. This replaces most of the need for timeouts in the | |
68 | GDB test suite, and makes it possible to distinguish between a hung target | |
69 | and one with slow communications. */ | |
70 | ||
71 | int watchdog = 0; | |
72 | ||
73 | /* | |
74 | ||
c5aa993b | 75 | LOCAL FUNCTION |
c906108c | 76 | |
c5aa993b | 77 | maintenance_command -- access the maintenance subcommands |
c906108c | 78 | |
c5aa993b | 79 | SYNOPSIS |
c906108c | 80 | |
c5aa993b | 81 | void maintenance_command (char *args, int from_tty) |
c906108c | 82 | |
c5aa993b | 83 | DESCRIPTION |
c906108c | 84 | |
c5aa993b | 85 | */ |
c906108c SS |
86 | |
87 | static void | |
fba45db2 | 88 | maintenance_command (char *args, int from_tty) |
c906108c SS |
89 | { |
90 | printf_unfiltered ("\"maintenance\" must be followed by the name of a maintenance command.\n"); | |
91 | help_list (maintenancelist, "maintenance ", -1, gdb_stdout); | |
92 | } | |
93 | ||
94 | #ifndef _WIN32 | |
95 | /* ARGSUSED */ | |
96 | static void | |
fba45db2 | 97 | maintenance_dump_me (char *args, int from_tty) |
c906108c SS |
98 | { |
99 | if (query ("Should GDB dump core? ")) | |
100 | { | |
7be570e7 JM |
101 | #ifdef __DJGPP__ |
102 | /* SIGQUIT by default is ignored, so use SIGABRT instead. */ | |
103 | signal (SIGABRT, SIG_DFL); | |
104 | kill (getpid (), SIGABRT); | |
105 | #else | |
c906108c SS |
106 | signal (SIGQUIT, SIG_DFL); |
107 | kill (getpid (), SIGQUIT); | |
7be570e7 | 108 | #endif |
c906108c SS |
109 | } |
110 | } | |
111 | #endif | |
112 | ||
7be570e7 JM |
113 | /* Stimulate the internal error mechanism that GDB uses when an |
114 | internal problem is detected. Allows testing of the mechanism. | |
115 | Also useful when the user wants to drop a core file but not exit | |
116 | GDB. */ | |
117 | ||
118 | static void | |
119 | maintenance_internal_error (char *args, int from_tty) | |
120 | { | |
dec43320 AC |
121 | internal_error (__FILE__, __LINE__, "%s", (args == NULL ? "" : args)); |
122 | } | |
123 | ||
124 | /* Stimulate the internal error mechanism that GDB uses when an | |
125 | internal problem is detected. Allows testing of the mechanism. | |
126 | Also useful when the user wants to drop a core file but not exit | |
127 | GDB. */ | |
128 | ||
129 | static void | |
130 | maintenance_internal_warning (char *args, int from_tty) | |
131 | { | |
132 | internal_warning (__FILE__, __LINE__, "%s", (args == NULL ? "" : args)); | |
7be570e7 JM |
133 | } |
134 | ||
33f91161 AC |
135 | /* Someday we should allow demangling for things other than just |
136 | explicit strings. For example, we might want to be able to specify | |
137 | the address of a string in either GDB's process space or the | |
138 | debuggee's process space, and have gdb fetch and demangle that | |
139 | string. If we have a char* pointer "ptr" that points to a string, | |
140 | we might want to be able to given just the name and have GDB | |
141 | demangle and print what it points to, etc. (FIXME) */ | |
c906108c SS |
142 | |
143 | static void | |
fba45db2 | 144 | maintenance_demangle (char *args, int from_tty) |
c906108c SS |
145 | { |
146 | char *demangled; | |
147 | ||
148 | if (args == NULL || *args == '\0') | |
149 | { | |
150 | printf_unfiltered ("\"maintenance demangle\" takes an argument to demangle.\n"); | |
151 | } | |
152 | else | |
153 | { | |
9a3d7dfd AF |
154 | demangled = language_demangle (current_language, args, |
155 | DMGL_ANSI | DMGL_PARAMS); | |
c906108c SS |
156 | if (demangled != NULL) |
157 | { | |
158 | printf_unfiltered ("%s\n", demangled); | |
b8c9b27d | 159 | xfree (demangled); |
c906108c SS |
160 | } |
161 | else | |
162 | { | |
163 | printf_unfiltered ("Can't demangle \"%s\"\n", args); | |
164 | } | |
165 | } | |
166 | } | |
167 | ||
168 | static void | |
fba45db2 | 169 | maintenance_time_display (char *args, int from_tty) |
c906108c SS |
170 | { |
171 | extern int display_time; | |
172 | ||
173 | if (args == NULL || *args == '\0') | |
174 | printf_unfiltered ("\"maintenance time\" takes a numeric argument.\n"); | |
175 | else | |
176 | display_time = strtol (args, NULL, 10); | |
177 | } | |
178 | ||
179 | static void | |
fba45db2 | 180 | maintenance_space_display (char *args, int from_tty) |
c906108c SS |
181 | { |
182 | extern int display_space; | |
183 | ||
184 | if (args == NULL || *args == '\0') | |
185 | printf_unfiltered ("\"maintenance space\" takes a numeric argument.\n"); | |
186 | else | |
187 | display_space = strtol (args, NULL, 10); | |
188 | } | |
189 | ||
33f91161 AC |
190 | /* The "maintenance info" command is defined as a prefix, with |
191 | allow_unknown 0. Therefore, its own definition is called only for | |
192 | "maintenance info" with no args. */ | |
c906108c SS |
193 | |
194 | /* ARGSUSED */ | |
195 | static void | |
fba45db2 | 196 | maintenance_info_command (char *arg, int from_tty) |
c906108c SS |
197 | { |
198 | printf_unfiltered ("\"maintenance info\" must be followed by the name of an info command.\n"); | |
199 | help_list (maintenanceinfolist, "maintenance info ", -1, gdb_stdout); | |
200 | } | |
201 | ||
a532ca62 MS |
202 | /* Mini tokenizing lexer for 'maint info sections' command. */ |
203 | ||
204 | static int | |
473e38f3 | 205 | match_substring (const char *string, const char *substr) |
a532ca62 MS |
206 | { |
207 | int substr_len = strlen(substr); | |
473e38f3 | 208 | const char *tok; |
a532ca62 MS |
209 | |
210 | while ((tok = strstr (string, substr)) != NULL) | |
211 | { | |
212 | /* Got a partial match. Is it a whole word? */ | |
b01d807c MS |
213 | if (tok == string |
214 | || tok[-1] == ' ' | |
215 | || tok[-1] == '\t') | |
a532ca62 MS |
216 | { |
217 | /* Token is delimited at the front... */ | |
b01d807c MS |
218 | if (tok[substr_len] == ' ' |
219 | || tok[substr_len] == '\t' | |
220 | || tok[substr_len] == '\0') | |
a532ca62 MS |
221 | { |
222 | /* Token is delimited at the rear. Got a whole-word match. */ | |
223 | return 1; | |
224 | } | |
225 | } | |
226 | /* Token didn't match as a whole word. Advance and try again. */ | |
227 | string = tok + 1; | |
228 | } | |
229 | return 0; | |
230 | } | |
231 | ||
43155bc1 MS |
232 | static int |
233 | match_bfd_flags (char *string, flagword flags) | |
c906108c | 234 | { |
43155bc1 | 235 | if (flags & SEC_ALLOC) |
a532ca62 | 236 | if (match_substring (string, "ALLOC")) |
43155bc1 MS |
237 | return 1; |
238 | if (flags & SEC_LOAD) | |
a532ca62 | 239 | if (match_substring (string, "LOAD")) |
43155bc1 MS |
240 | return 1; |
241 | if (flags & SEC_RELOC) | |
a532ca62 | 242 | if (match_substring (string, "RELOC")) |
43155bc1 MS |
243 | return 1; |
244 | if (flags & SEC_READONLY) | |
a532ca62 | 245 | if (match_substring (string, "READONLY")) |
43155bc1 MS |
246 | return 1; |
247 | if (flags & SEC_CODE) | |
a532ca62 | 248 | if (match_substring (string, "CODE")) |
43155bc1 MS |
249 | return 1; |
250 | if (flags & SEC_DATA) | |
a532ca62 | 251 | if (match_substring (string, "DATA")) |
43155bc1 MS |
252 | return 1; |
253 | if (flags & SEC_ROM) | |
a532ca62 | 254 | if (match_substring (string, "ROM")) |
43155bc1 MS |
255 | return 1; |
256 | if (flags & SEC_CONSTRUCTOR) | |
a532ca62 | 257 | if (match_substring (string, "CONSTRUCTOR")) |
43155bc1 MS |
258 | return 1; |
259 | if (flags & SEC_HAS_CONTENTS) | |
a532ca62 | 260 | if (match_substring (string, "HAS_CONTENTS")) |
43155bc1 MS |
261 | return 1; |
262 | if (flags & SEC_NEVER_LOAD) | |
a532ca62 | 263 | if (match_substring (string, "NEVER_LOAD")) |
43155bc1 MS |
264 | return 1; |
265 | if (flags & SEC_COFF_SHARED_LIBRARY) | |
a532ca62 | 266 | if (match_substring (string, "COFF_SHARED_LIBRARY")) |
43155bc1 MS |
267 | return 1; |
268 | if (flags & SEC_IS_COMMON) | |
a532ca62 | 269 | if (match_substring (string, "IS_COMMON")) |
43155bc1 | 270 | return 1; |
c906108c | 271 | |
43155bc1 MS |
272 | return 0; |
273 | } | |
c906108c | 274 | |
43155bc1 MS |
275 | static void |
276 | print_bfd_flags (flagword flags) | |
277 | { | |
c906108c SS |
278 | if (flags & SEC_ALLOC) |
279 | printf_filtered (" ALLOC"); | |
280 | if (flags & SEC_LOAD) | |
281 | printf_filtered (" LOAD"); | |
282 | if (flags & SEC_RELOC) | |
283 | printf_filtered (" RELOC"); | |
284 | if (flags & SEC_READONLY) | |
285 | printf_filtered (" READONLY"); | |
286 | if (flags & SEC_CODE) | |
287 | printf_filtered (" CODE"); | |
288 | if (flags & SEC_DATA) | |
289 | printf_filtered (" DATA"); | |
290 | if (flags & SEC_ROM) | |
291 | printf_filtered (" ROM"); | |
292 | if (flags & SEC_CONSTRUCTOR) | |
293 | printf_filtered (" CONSTRUCTOR"); | |
294 | if (flags & SEC_HAS_CONTENTS) | |
295 | printf_filtered (" HAS_CONTENTS"); | |
296 | if (flags & SEC_NEVER_LOAD) | |
297 | printf_filtered (" NEVER_LOAD"); | |
298 | if (flags & SEC_COFF_SHARED_LIBRARY) | |
299 | printf_filtered (" COFF_SHARED_LIBRARY"); | |
300 | if (flags & SEC_IS_COMMON) | |
301 | printf_filtered (" IS_COMMON"); | |
43155bc1 MS |
302 | } |
303 | ||
304 | static void | |
67a2b77e AC |
305 | maint_print_section_info (const char *name, flagword flags, |
306 | CORE_ADDR addr, CORE_ADDR endaddr, | |
307 | unsigned long filepos) | |
43155bc1 | 308 | { |
e3d3bfda MS |
309 | /* FIXME-32x64: Need print_address_numeric with field width. */ |
310 | printf_filtered (" 0x%s", paddr (addr)); | |
311 | printf_filtered ("->0x%s", paddr (endaddr)); | |
3ab13650 | 312 | printf_filtered (" at %s", |
e3d3bfda MS |
313 | local_hex_string_custom ((unsigned long) filepos, "08l")); |
314 | printf_filtered (": %s", name); | |
315 | print_bfd_flags (flags); | |
316 | printf_filtered ("\n"); | |
317 | } | |
c906108c | 318 | |
e3d3bfda MS |
319 | static void |
320 | print_bfd_section_info (bfd *abfd, | |
321 | asection *asect, | |
322 | void *arg) | |
323 | { | |
324 | flagword flags = bfd_get_section_flags (abfd, asect); | |
325 | const char *name = bfd_section_name (abfd, asect); | |
326 | ||
b01d807c MS |
327 | if (arg == NULL || *((char *) arg) == '\0' |
328 | || match_substring ((char *) arg, name) | |
329 | || match_bfd_flags ((char *) arg, flags)) | |
e3d3bfda MS |
330 | { |
331 | CORE_ADDR addr, endaddr; | |
332 | ||
333 | addr = bfd_section_vma (abfd, asect); | |
334 | endaddr = addr + bfd_section_size (abfd, asect); | |
67a2b77e | 335 | maint_print_section_info (name, flags, addr, endaddr, asect->filepos); |
e3d3bfda MS |
336 | } |
337 | } | |
338 | ||
339 | static void | |
340 | print_objfile_section_info (bfd *abfd, | |
341 | struct obj_section *asect, | |
342 | char *string) | |
343 | { | |
344 | flagword flags = bfd_get_section_flags (abfd, asect->the_bfd_section); | |
345 | const char *name = bfd_section_name (abfd, asect->the_bfd_section); | |
43155bc1 | 346 | |
b01d807c MS |
347 | if (string == NULL || *string == '\0' |
348 | || match_substring (string, name) | |
349 | || match_bfd_flags (string, flags)) | |
43155bc1 | 350 | { |
67a2b77e | 351 | maint_print_section_info (name, flags, asect->addr, asect->endaddr, |
e3d3bfda | 352 | asect->the_bfd_section->filepos); |
43155bc1 | 353 | } |
c906108c SS |
354 | } |
355 | ||
356 | /* ARGSUSED */ | |
357 | static void | |
fba45db2 | 358 | maintenance_info_sections (char *arg, int from_tty) |
c906108c SS |
359 | { |
360 | if (exec_bfd) | |
361 | { | |
362 | printf_filtered ("Exec file:\n"); | |
c5aa993b | 363 | printf_filtered (" `%s', ", bfd_get_filename (exec_bfd)); |
c906108c | 364 | wrap_here (" "); |
c5aa993b | 365 | printf_filtered ("file type %s.\n", bfd_get_target (exec_bfd)); |
a532ca62 | 366 | if (arg && *arg && match_substring (arg, "ALLOBJ")) |
e3d3bfda MS |
367 | { |
368 | struct objfile *ofile; | |
369 | struct obj_section *osect; | |
370 | ||
371 | /* Only this function cares about the 'ALLOBJ' argument; | |
372 | if 'ALLOBJ' is the only argument, discard it rather than | |
373 | passing it down to print_objfile_section_info (which | |
374 | wouldn't know how to handle it). */ | |
375 | if (strcmp (arg, "ALLOBJ") == 0) | |
376 | arg = NULL; | |
377 | ||
378 | ALL_OBJFILES (ofile) | |
379 | { | |
380 | printf_filtered (" Object file: %s\n", | |
381 | bfd_get_filename (ofile->obfd)); | |
382 | ALL_OBJFILE_OSECTIONS (ofile, osect) | |
383 | { | |
384 | print_objfile_section_info (ofile->obfd, osect, arg); | |
385 | } | |
386 | } | |
387 | } | |
388 | else | |
389 | bfd_map_over_sections (exec_bfd, print_bfd_section_info, arg); | |
c906108c SS |
390 | } |
391 | ||
392 | if (core_bfd) | |
393 | { | |
394 | printf_filtered ("Core file:\n"); | |
c5aa993b | 395 | printf_filtered (" `%s', ", bfd_get_filename (core_bfd)); |
c906108c | 396 | wrap_here (" "); |
c5aa993b | 397 | printf_filtered ("file type %s.\n", bfd_get_target (core_bfd)); |
e3d3bfda | 398 | bfd_map_over_sections (core_bfd, print_bfd_section_info, arg); |
c906108c SS |
399 | } |
400 | } | |
401 | ||
402 | /* ARGSUSED */ | |
403 | void | |
fba45db2 | 404 | maintenance_print_statistics (char *args, int from_tty) |
c906108c SS |
405 | { |
406 | print_objfile_statistics (); | |
407 | print_symbol_bcache_statistics (); | |
408 | } | |
409 | ||
b9362cc7 | 410 | static void |
4b9b3959 AC |
411 | maintenance_print_architecture (char *args, int from_tty) |
412 | { | |
413 | if (args == NULL) | |
414 | gdbarch_dump (current_gdbarch, gdb_stdout); | |
415 | else | |
416 | { | |
417 | struct ui_file *file = gdb_fopen (args, "w"); | |
418 | if (file == NULL) | |
419 | perror_with_name ("maintenance print architecture"); | |
420 | gdbarch_dump (current_gdbarch, file); | |
421 | ui_file_delete (file); | |
422 | } | |
423 | } | |
424 | ||
33f91161 AC |
425 | /* The "maintenance print" command is defined as a prefix, with |
426 | allow_unknown 0. Therefore, its own definition is called only for | |
427 | "maintenance print" with no args. */ | |
c906108c SS |
428 | |
429 | /* ARGSUSED */ | |
430 | static void | |
fba45db2 | 431 | maintenance_print_command (char *arg, int from_tty) |
c906108c SS |
432 | { |
433 | printf_unfiltered ("\"maintenance print\" must be followed by the name of a print command.\n"); | |
434 | help_list (maintenanceprintlist, "maintenance print ", -1, gdb_stdout); | |
435 | } | |
436 | ||
437 | /* The "maintenance translate-address" command converts a section and address | |
438 | to a symbol. This can be called in two ways: | |
c5aa993b JM |
439 | maintenance translate-address <secname> <addr> |
440 | or maintenance translate-address <addr> | |
441 | */ | |
c906108c SS |
442 | |
443 | static void | |
fba45db2 | 444 | maintenance_translate_address (char *arg, int from_tty) |
c906108c SS |
445 | { |
446 | CORE_ADDR address; | |
447 | asection *sect; | |
448 | char *p; | |
449 | struct minimal_symbol *sym; | |
450 | struct objfile *objfile; | |
451 | ||
452 | if (arg == NULL || *arg == 0) | |
453 | error ("requires argument (address or section + address)"); | |
454 | ||
455 | sect = NULL; | |
456 | p = arg; | |
457 | ||
458 | if (!isdigit (*p)) | |
459 | { /* See if we have a valid section name */ | |
c5aa993b | 460 | while (*p && !isspace (*p)) /* Find end of section name */ |
c906108c SS |
461 | p++; |
462 | if (*p == '\000') /* End of command? */ | |
463 | error ("Need to specify <section-name> and <address>"); | |
464 | *p++ = '\000'; | |
c5aa993b JM |
465 | while (isspace (*p)) |
466 | p++; /* Skip whitespace */ | |
c906108c SS |
467 | |
468 | ALL_OBJFILES (objfile) | |
c5aa993b JM |
469 | { |
470 | sect = bfd_get_section_by_name (objfile->obfd, arg); | |
471 | if (sect != NULL) | |
472 | break; | |
473 | } | |
c906108c SS |
474 | |
475 | if (!sect) | |
476 | error ("Unknown section %s.", arg); | |
477 | } | |
478 | ||
479 | address = parse_and_eval_address (p); | |
480 | ||
481 | if (sect) | |
482 | sym = lookup_minimal_symbol_by_pc_section (address, sect); | |
483 | else | |
484 | sym = lookup_minimal_symbol_by_pc (address); | |
485 | ||
486 | if (sym) | |
d4f3574e | 487 | printf_filtered ("%s+%s\n", |
de5ad195 | 488 | SYMBOL_PRINT_NAME (sym), |
d4f3574e | 489 | paddr_u (address - SYMBOL_VALUE_ADDRESS (sym))); |
c906108c | 490 | else if (sect) |
d4f3574e | 491 | printf_filtered ("no symbol at %s:0x%s\n", sect->name, paddr (address)); |
c906108c | 492 | else |
d4f3574e | 493 | printf_filtered ("no symbol at 0x%s\n", paddr (address)); |
c906108c SS |
494 | |
495 | return; | |
496 | } | |
497 | ||
56382845 | 498 | |
c114dcd5 | 499 | /* When a command is deprecated the user will be warned the first time |
33f91161 AC |
500 | the command is used. If possible, a replacement will be |
501 | offered. */ | |
56382845 FN |
502 | |
503 | static void | |
504 | maintenance_deprecate (char *args, int from_tty) | |
505 | { | |
506 | if (args == NULL || *args == '\0') | |
507 | { | |
508 | printf_unfiltered ("\"maintenance deprecate\" takes an argument, \n\ | |
509 | the command you want to deprecate, and optionally the replacement command \n\ | |
510 | enclosed in quotes.\n"); | |
511 | } | |
33f91161 | 512 | |
56382845 FN |
513 | maintenance_do_deprecate (args, 1); |
514 | ||
515 | } | |
516 | ||
517 | ||
518 | static void | |
519 | maintenance_undeprecate (char *args, int from_tty) | |
520 | { | |
521 | if (args == NULL || *args == '\0') | |
522 | { | |
523 | printf_unfiltered ("\"maintenance undeprecate\" takes an argument, \n\ | |
524 | the command you want to undeprecate.\n"); | |
525 | } | |
33f91161 | 526 | |
56382845 | 527 | maintenance_do_deprecate (args, 0); |
33f91161 | 528 | |
56382845 FN |
529 | } |
530 | ||
33f91161 AC |
531 | /* You really shouldn't be using this. It is just for the testsuite. |
532 | Rather, you should use deprecate_cmd() when the command is created | |
533 | in _initialize_blah(). | |
534 | ||
535 | This function deprecates a command and optionally assigns it a | |
536 | replacement. */ | |
537 | ||
8399535b | 538 | static void |
33f91161 AC |
539 | maintenance_do_deprecate (char *text, int deprecate) |
540 | { | |
541 | ||
542 | struct cmd_list_element *alias = NULL; | |
543 | struct cmd_list_element *prefix_cmd = NULL; | |
544 | struct cmd_list_element *cmd = NULL; | |
545 | ||
546 | char *start_ptr = NULL; | |
547 | char *end_ptr = NULL; | |
56382845 | 548 | int len; |
33f91161 AC |
549 | char *replacement = NULL; |
550 | ||
1c689132 DB |
551 | if (text == NULL) |
552 | return; | |
56382845 | 553 | |
33f91161 AC |
554 | if (!lookup_cmd_composition (text, &alias, &prefix_cmd, &cmd)) |
555 | { | |
556 | printf_filtered ("Can't find command '%s' to deprecate.\n", text); | |
557 | return; | |
558 | } | |
56382845 | 559 | |
56382845 FN |
560 | if (deprecate) |
561 | { | |
562 | /* look for a replacement command */ | |
80ce1ecb AC |
563 | start_ptr = strchr (text, '\"'); |
564 | if (start_ptr != NULL) | |
33f91161 AC |
565 | { |
566 | start_ptr++; | |
80ce1ecb AC |
567 | end_ptr = strrchr (start_ptr, '\"'); |
568 | if (end_ptr != NULL) | |
33f91161 AC |
569 | { |
570 | len = end_ptr - start_ptr; | |
571 | start_ptr[len] = '\0'; | |
572 | replacement = xstrdup (start_ptr); | |
573 | } | |
574 | } | |
56382845 | 575 | } |
33f91161 | 576 | |
56382845 FN |
577 | if (!start_ptr || !end_ptr) |
578 | replacement = NULL; | |
33f91161 AC |
579 | |
580 | ||
56382845 | 581 | /* If they used an alias, we only want to deprecate the alias. |
33f91161 | 582 | |
56382845 FN |
583 | Note the MALLOCED_REPLACEMENT test. If the command's replacement |
584 | string was allocated at compile time we don't want to free the | |
33f91161 | 585 | memory. */ |
56382845 FN |
586 | if (alias) |
587 | { | |
33f91161 | 588 | |
56382845 | 589 | if (alias->flags & MALLOCED_REPLACEMENT) |
b8c9b27d | 590 | xfree (alias->replacement); |
33f91161 | 591 | |
56382845 | 592 | if (deprecate) |
33f91161 | 593 | alias->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED); |
56382845 | 594 | else |
33f91161 AC |
595 | alias->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED); |
596 | alias->replacement = replacement; | |
56382845 FN |
597 | alias->flags |= MALLOCED_REPLACEMENT; |
598 | return; | |
599 | } | |
600 | else if (cmd) | |
601 | { | |
602 | if (cmd->flags & MALLOCED_REPLACEMENT) | |
b8c9b27d | 603 | xfree (cmd->replacement); |
56382845 FN |
604 | |
605 | if (deprecate) | |
33f91161 | 606 | cmd->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED); |
56382845 | 607 | else |
33f91161 AC |
608 | cmd->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED); |
609 | cmd->replacement = replacement; | |
56382845 FN |
610 | cmd->flags |= MALLOCED_REPLACEMENT; |
611 | return; | |
612 | } | |
613 | } | |
614 | ||
4f337972 AC |
615 | /* Maintenance set/show framework. */ |
616 | ||
617 | static struct cmd_list_element *maintenance_set_cmdlist; | |
618 | static struct cmd_list_element *maintenance_show_cmdlist; | |
619 | ||
620 | static void | |
621 | maintenance_set_cmd (char *args, int from_tty) | |
622 | { | |
623 | printf_unfiltered ("\"maintenance set\" must be followed by the name of a set command.\n"); | |
624 | help_list (maintenance_set_cmdlist, "maintenance set ", -1, gdb_stdout); | |
625 | } | |
626 | ||
627 | static void | |
628 | maintenance_show_cmd (char *args, int from_tty) | |
629 | { | |
630 | cmd_show_list (maintenance_show_cmdlist, from_tty, ""); | |
631 | } | |
632 | ||
4f337972 AC |
633 | /* Profiling support. */ |
634 | ||
635 | static int maintenance_profile_p; | |
d9feb4e7 DJ |
636 | |
637 | #if defined (HAVE_MONSTARTUP) && defined (HAVE__MCLEANUP) | |
638 | ||
b0b1c2c0 MK |
639 | #ifdef HAVE__ETEXT |
640 | extern char _etext; | |
641 | #define TEXTEND &_etext | |
642 | #else | |
643 | extern char etext; | |
644 | #define TEXTEND &etext | |
645 | #endif | |
646 | ||
d28f9cdf DJ |
647 | static int profiling_state; |
648 | ||
649 | static void | |
650 | mcleanup_wrapper (void) | |
651 | { | |
652 | extern void _mcleanup (void); | |
653 | ||
654 | if (profiling_state) | |
655 | _mcleanup (); | |
656 | } | |
4f337972 AC |
657 | |
658 | static void | |
659 | maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c) | |
660 | { | |
d28f9cdf DJ |
661 | if (maintenance_profile_p == profiling_state) |
662 | return; | |
663 | ||
664 | profiling_state = maintenance_profile_p; | |
665 | ||
666 | if (maintenance_profile_p) | |
667 | { | |
668 | static int profiling_initialized; | |
669 | ||
670 | extern void monstartup (unsigned long, unsigned long); | |
d28f9cdf DJ |
671 | extern int main(); |
672 | ||
673 | if (!profiling_initialized) | |
674 | { | |
675 | atexit (mcleanup_wrapper); | |
676 | profiling_initialized = 1; | |
677 | } | |
678 | ||
679 | /* "main" is now always the first function in the text segment, so use | |
680 | its address for monstartup. */ | |
b0b1c2c0 | 681 | monstartup ((unsigned long) &main, (unsigned long) TEXTEND); |
d28f9cdf DJ |
682 | } |
683 | else | |
684 | { | |
685 | extern void _mcleanup (void); | |
686 | _mcleanup (); | |
687 | } | |
4f337972 | 688 | } |
d9feb4e7 DJ |
689 | #else |
690 | static void | |
691 | maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c) | |
692 | { | |
51ee2ddc | 693 | error ("Profiling support is not available on this system."); |
d9feb4e7 DJ |
694 | } |
695 | #endif | |
56382845 | 696 | |
c906108c | 697 | void |
fba45db2 | 698 | _initialize_maint_cmds (void) |
c906108c | 699 | { |
4f337972 AC |
700 | struct cmd_list_element *tmpcmd; |
701 | ||
c906108c SS |
702 | add_prefix_cmd ("maintenance", class_maintenance, maintenance_command, |
703 | "Commands for use by GDB maintainers.\n\ | |
704 | Includes commands to dump specific internal GDB structures in\n\ | |
705 | a human readable form, to cause GDB to deliberately dump core,\n\ | |
5a24b7e3 | 706 | to test internal functions such as the C++/ObjC demangler, etc.", |
c906108c SS |
707 | &maintenancelist, "maintenance ", 0, |
708 | &cmdlist); | |
709 | ||
710 | add_com_alias ("mt", "maintenance", class_maintenance, 1); | |
711 | ||
712 | add_prefix_cmd ("info", class_maintenance, maintenance_info_command, | |
c5aa993b | 713 | "Commands for showing internal info about the program being debugged.", |
c906108c SS |
714 | &maintenanceinfolist, "maintenance info ", 0, |
715 | &maintenancelist); | |
90515c23 | 716 | add_alias_cmd ("i", "info", class_maintenance, 1, &maintenancelist); |
c906108c SS |
717 | |
718 | add_cmd ("sections", class_maintenance, maintenance_info_sections, | |
c5ad026a | 719 | "List the BFD sections of the exec and core files. \n\ |
e3d3bfda MS |
720 | Arguments may be any combination of:\n\ |
721 | [one or more section names]\n\ | |
722 | ALLOC LOAD RELOC READONLY CODE DATA ROM CONSTRUCTOR\n\ | |
723 | HAS_CONTENTS NEVER_LOAD COFF_SHARED_LIBRARY IS_COMMON\n\ | |
724 | Sections matching any argument will be listed (no argument\n\ | |
725 | implies all sections). In addition, the special argument\n\ | |
726 | ALLOBJ\n\ | |
727 | lists all sections from all object files, including shared libraries.", | |
c906108c SS |
728 | &maintenanceinfolist); |
729 | ||
730 | add_prefix_cmd ("print", class_maintenance, maintenance_print_command, | |
731 | "Maintenance command for printing GDB internal state.", | |
732 | &maintenanceprintlist, "maintenance print ", 0, | |
733 | &maintenancelist); | |
734 | ||
4f337972 AC |
735 | add_prefix_cmd ("set", class_maintenance, maintenance_set_cmd, "\ |
736 | Set GDB internal variables used by the GDB maintainer.\n\ | |
737 | Configure variables internal to GDB that aid in GDB's maintenance", | |
738 | &maintenance_set_cmdlist, "maintenance set ", | |
739 | 0/*allow-unknown*/, | |
740 | &maintenancelist); | |
741 | ||
742 | add_prefix_cmd ("show", class_maintenance, maintenance_show_cmd, "\ | |
743 | Show GDB internal variables used by the GDB maintainer.\n\ | |
744 | Configure variables internal to GDB that aid in GDB's maintenance", | |
745 | &maintenance_show_cmdlist, "maintenance show ", | |
746 | 0/*allow-unknown*/, | |
747 | &maintenancelist); | |
748 | ||
c906108c SS |
749 | #ifndef _WIN32 |
750 | add_cmd ("dump-me", class_maintenance, maintenance_dump_me, | |
751 | "Get fatal error; make debugger dump its core.\n\ | |
8308e54c | 752 | GDB sets its handling of SIGQUIT back to SIG_DFL and then sends\n\ |
c906108c SS |
753 | itself a SIGQUIT signal.", |
754 | &maintenancelist); | |
755 | #endif | |
756 | ||
7be570e7 JM |
757 | add_cmd ("internal-error", class_maintenance, maintenance_internal_error, |
758 | "Give GDB an internal error.\n\ | |
759 | Cause GDB to behave as if an internal error was detected.", | |
760 | &maintenancelist); | |
761 | ||
dec43320 AC |
762 | add_cmd ("internal-warning", class_maintenance, maintenance_internal_warning, |
763 | "Give GDB an internal warning.\n\ | |
764 | Cause GDB to behave as if an internal warning was reported.", | |
765 | &maintenancelist); | |
766 | ||
c906108c | 767 | add_cmd ("demangle", class_maintenance, maintenance_demangle, |
5a24b7e3 | 768 | "Demangle a C++/ObjC mangled name.\n\ |
c906108c SS |
769 | Call internal GDB demangler routine to demangle a C++ link name\n\ |
770 | and prints the result.", | |
771 | &maintenancelist); | |
772 | ||
773 | add_cmd ("time", class_maintenance, maintenance_time_display, | |
774 | "Set the display of time usage.\n\ | |
775 | If nonzero, will cause the execution time for each command to be\n\ | |
776 | displayed, following the command's output.", | |
777 | &maintenancelist); | |
778 | ||
779 | add_cmd ("space", class_maintenance, maintenance_space_display, | |
780 | "Set the display of space usage.\n\ | |
781 | If nonzero, will cause the execution space for each command to be\n\ | |
782 | displayed, following the command's output.", | |
783 | &maintenancelist); | |
784 | ||
785 | add_cmd ("type", class_maintenance, maintenance_print_type, | |
786 | "Print a type chain for a given symbol.\n\ | |
787 | For each node in a type chain, print the raw data for each member of\n\ | |
788 | the type structure, and the interpretation of the data.", | |
789 | &maintenanceprintlist); | |
790 | ||
791 | add_cmd ("symbols", class_maintenance, maintenance_print_symbols, | |
792 | "Print dump of current symbol definitions.\n\ | |
793 | Entries in the full symbol table are dumped to file OUTFILE.\n\ | |
794 | If a SOURCE file is specified, dump only that file's symbols.", | |
795 | &maintenanceprintlist); | |
796 | ||
797 | add_cmd ("msymbols", class_maintenance, maintenance_print_msymbols, | |
798 | "Print dump of current minimal symbol definitions.\n\ | |
799 | Entries in the minimal symbol table are dumped to file OUTFILE.\n\ | |
800 | If a SOURCE file is specified, dump only that file's minimal symbols.", | |
801 | &maintenanceprintlist); | |
802 | ||
803 | add_cmd ("psymbols", class_maintenance, maintenance_print_psymbols, | |
804 | "Print dump of current partial symbol definitions.\n\ | |
805 | Entries in the partial symbol table are dumped to file OUTFILE.\n\ | |
806 | If a SOURCE file is specified, dump only that file's partial symbols.", | |
807 | &maintenanceprintlist); | |
808 | ||
809 | add_cmd ("objfiles", class_maintenance, maintenance_print_objfiles, | |
810 | "Print dump of current object file definitions.", | |
811 | &maintenanceprintlist); | |
812 | ||
5e7b2f39 | 813 | add_cmd ("symtabs", class_maintenance, maintenance_info_symtabs, |
44ea7b70 JB |
814 | "List the full symbol tables for all object files.\n\ |
815 | This does not include information about individual symbols, blocks, or\n\ | |
816 | linetables --- just the symbol table structures themselves.\n\ | |
817 | With an argument REGEXP, list the symbol tables whose names that match that.", | |
5e7b2f39 | 818 | &maintenanceinfolist); |
44ea7b70 | 819 | |
5e7b2f39 | 820 | add_cmd ("psymtabs", class_maintenance, maintenance_info_psymtabs, |
44ea7b70 JB |
821 | "List the partial symbol tables for all object files.\n\ |
822 | This does not include information about individual partial symbols,\n\ | |
823 | just the symbol table structures themselves.", | |
5e7b2f39 | 824 | &maintenanceinfolist); |
44ea7b70 | 825 | |
c906108c SS |
826 | add_cmd ("statistics", class_maintenance, maintenance_print_statistics, |
827 | "Print statistics about internal gdb state.", | |
828 | &maintenanceprintlist); | |
829 | ||
4b9b3959 AC |
830 | add_cmd ("architecture", class_maintenance, maintenance_print_architecture, |
831 | "Print the internal architecture configuration.\ | |
832 | Takes an optional file parameter.", | |
833 | &maintenanceprintlist); | |
834 | ||
c906108c SS |
835 | add_cmd ("check-symtabs", class_maintenance, maintenance_check_symtabs, |
836 | "Check consistency of psymtabs and symtabs.", | |
837 | &maintenancelist); | |
838 | ||
839 | add_cmd ("translate-address", class_maintenance, maintenance_translate_address, | |
840 | "Translate a section name and address to a symbol.", | |
841 | &maintenancelist); | |
842 | ||
56382845 | 843 | add_cmd ("deprecate", class_maintenance, maintenance_deprecate, |
33f91161 | 844 | "Deprecate a command. Note that this is just in here so the \n\ |
56382845 FN |
845 | testsuite can check the comamnd deprecator. You probably shouldn't use this,\n\ |
846 | rather you should use the C function deprecate_cmd(). If you decide you \n\ | |
6f122dc9 | 847 | want to use it: maintenance deprecate 'commandname' \"replacement\". The \n\ |
56382845 FN |
848 | replacement is optional.", &maintenancelist); |
849 | ||
850 | add_cmd ("undeprecate", class_maintenance, maintenance_undeprecate, | |
33f91161 | 851 | "Undeprecate a command. Note that this is just in here so the \n\ |
56382845 | 852 | testsuite can check the comamnd deprecator. You probably shouldn't use this,\n\ |
33f91161 AC |
853 | If you decide you want to use it: maintenance undeprecate 'commandname'", |
854 | &maintenancelist); | |
56382845 | 855 | |
c906108c | 856 | add_show_from_set ( |
c5aa993b JM |
857 | add_set_cmd ("watchdog", class_maintenance, var_zinteger, (char *) &watchdog, |
858 | "Set watchdog timer.\n\ | |
c906108c SS |
859 | When non-zero, this timeout is used instead of waiting forever for a target to\n\ |
860 | finish a low-level step or continue operation. If the specified amount of time\n\ | |
861 | passes without a response from the target, an error occurs.", &setlist), | |
c5aa993b | 862 | &showlist); |
4f337972 AC |
863 | |
864 | ||
d28f9cdf DJ |
865 | add_setshow_boolean_cmd ("profile", class_maintenance, |
866 | &maintenance_profile_p, | |
867 | "Set internal profiling.\n" | |
868 | "When enabled GDB is profiled.", | |
869 | "Show internal profiling.\n", | |
870 | maintenance_set_profile_cmd, NULL, | |
871 | &maintenance_set_cmdlist, | |
872 | &maintenance_show_cmdlist); | |
c906108c | 873 | } |