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