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 | ||
4b9b3959 AC |
410 | void |
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 | ||
44ea7b70 JB |
437 | /* The "maintenance list" command is defined as a prefix, with |
438 | allow_unknown 0. Therefore, its own definition is called only for | |
439 | "maintenance list" with no args. */ | |
440 | ||
441 | /* ARGSUSED */ | |
442 | static void | |
443 | maintenance_list_command (char *arg, int from_tty) | |
444 | { | |
445 | printf_unfiltered ("\"maintenance list\" must be followed by the name of a list command.\n"); | |
446 | help_list (maintenancelistlist, "maintenance list ", -1, gdb_stdout); | |
447 | } | |
448 | ||
c906108c SS |
449 | /* The "maintenance translate-address" command converts a section and address |
450 | to a symbol. This can be called in two ways: | |
c5aa993b JM |
451 | maintenance translate-address <secname> <addr> |
452 | or maintenance translate-address <addr> | |
453 | */ | |
c906108c SS |
454 | |
455 | static void | |
fba45db2 | 456 | maintenance_translate_address (char *arg, int from_tty) |
c906108c SS |
457 | { |
458 | CORE_ADDR address; | |
459 | asection *sect; | |
460 | char *p; | |
461 | struct minimal_symbol *sym; | |
462 | struct objfile *objfile; | |
463 | ||
464 | if (arg == NULL || *arg == 0) | |
465 | error ("requires argument (address or section + address)"); | |
466 | ||
467 | sect = NULL; | |
468 | p = arg; | |
469 | ||
470 | if (!isdigit (*p)) | |
471 | { /* See if we have a valid section name */ | |
c5aa993b | 472 | while (*p && !isspace (*p)) /* Find end of section name */ |
c906108c SS |
473 | p++; |
474 | if (*p == '\000') /* End of command? */ | |
475 | error ("Need to specify <section-name> and <address>"); | |
476 | *p++ = '\000'; | |
c5aa993b JM |
477 | while (isspace (*p)) |
478 | p++; /* Skip whitespace */ | |
c906108c SS |
479 | |
480 | ALL_OBJFILES (objfile) | |
c5aa993b JM |
481 | { |
482 | sect = bfd_get_section_by_name (objfile->obfd, arg); | |
483 | if (sect != NULL) | |
484 | break; | |
485 | } | |
c906108c SS |
486 | |
487 | if (!sect) | |
488 | error ("Unknown section %s.", arg); | |
489 | } | |
490 | ||
491 | address = parse_and_eval_address (p); | |
492 | ||
493 | if (sect) | |
494 | sym = lookup_minimal_symbol_by_pc_section (address, sect); | |
495 | else | |
496 | sym = lookup_minimal_symbol_by_pc (address); | |
497 | ||
498 | if (sym) | |
d4f3574e | 499 | printf_filtered ("%s+%s\n", |
de5ad195 | 500 | SYMBOL_PRINT_NAME (sym), |
d4f3574e | 501 | paddr_u (address - SYMBOL_VALUE_ADDRESS (sym))); |
c906108c | 502 | else if (sect) |
d4f3574e | 503 | printf_filtered ("no symbol at %s:0x%s\n", sect->name, paddr (address)); |
c906108c | 504 | else |
d4f3574e | 505 | printf_filtered ("no symbol at 0x%s\n", paddr (address)); |
c906108c SS |
506 | |
507 | return; | |
508 | } | |
509 | ||
56382845 | 510 | |
c114dcd5 | 511 | /* When a command is deprecated the user will be warned the first time |
33f91161 AC |
512 | the command is used. If possible, a replacement will be |
513 | offered. */ | |
56382845 FN |
514 | |
515 | static void | |
516 | maintenance_deprecate (char *args, int from_tty) | |
517 | { | |
518 | if (args == NULL || *args == '\0') | |
519 | { | |
520 | printf_unfiltered ("\"maintenance deprecate\" takes an argument, \n\ | |
521 | the command you want to deprecate, and optionally the replacement command \n\ | |
522 | enclosed in quotes.\n"); | |
523 | } | |
33f91161 | 524 | |
56382845 FN |
525 | maintenance_do_deprecate (args, 1); |
526 | ||
527 | } | |
528 | ||
529 | ||
530 | static void | |
531 | maintenance_undeprecate (char *args, int from_tty) | |
532 | { | |
533 | if (args == NULL || *args == '\0') | |
534 | { | |
535 | printf_unfiltered ("\"maintenance undeprecate\" takes an argument, \n\ | |
536 | the command you want to undeprecate.\n"); | |
537 | } | |
33f91161 | 538 | |
56382845 | 539 | maintenance_do_deprecate (args, 0); |
33f91161 | 540 | |
56382845 FN |
541 | } |
542 | ||
33f91161 AC |
543 | /* You really shouldn't be using this. It is just for the testsuite. |
544 | Rather, you should use deprecate_cmd() when the command is created | |
545 | in _initialize_blah(). | |
546 | ||
547 | This function deprecates a command and optionally assigns it a | |
548 | replacement. */ | |
549 | ||
8399535b | 550 | static void |
33f91161 AC |
551 | maintenance_do_deprecate (char *text, int deprecate) |
552 | { | |
553 | ||
554 | struct cmd_list_element *alias = NULL; | |
555 | struct cmd_list_element *prefix_cmd = NULL; | |
556 | struct cmd_list_element *cmd = NULL; | |
557 | ||
558 | char *start_ptr = NULL; | |
559 | char *end_ptr = NULL; | |
56382845 | 560 | int len; |
33f91161 AC |
561 | char *replacement = NULL; |
562 | ||
1c689132 DB |
563 | if (text == NULL) |
564 | return; | |
56382845 | 565 | |
33f91161 AC |
566 | if (!lookup_cmd_composition (text, &alias, &prefix_cmd, &cmd)) |
567 | { | |
568 | printf_filtered ("Can't find command '%s' to deprecate.\n", text); | |
569 | return; | |
570 | } | |
56382845 | 571 | |
56382845 FN |
572 | if (deprecate) |
573 | { | |
574 | /* look for a replacement command */ | |
80ce1ecb AC |
575 | start_ptr = strchr (text, '\"'); |
576 | if (start_ptr != NULL) | |
33f91161 AC |
577 | { |
578 | start_ptr++; | |
80ce1ecb AC |
579 | end_ptr = strrchr (start_ptr, '\"'); |
580 | if (end_ptr != NULL) | |
33f91161 AC |
581 | { |
582 | len = end_ptr - start_ptr; | |
583 | start_ptr[len] = '\0'; | |
584 | replacement = xstrdup (start_ptr); | |
585 | } | |
586 | } | |
56382845 | 587 | } |
33f91161 | 588 | |
56382845 FN |
589 | if (!start_ptr || !end_ptr) |
590 | replacement = NULL; | |
33f91161 AC |
591 | |
592 | ||
56382845 | 593 | /* If they used an alias, we only want to deprecate the alias. |
33f91161 | 594 | |
56382845 FN |
595 | Note the MALLOCED_REPLACEMENT test. If the command's replacement |
596 | string was allocated at compile time we don't want to free the | |
33f91161 | 597 | memory. */ |
56382845 FN |
598 | if (alias) |
599 | { | |
33f91161 | 600 | |
56382845 | 601 | if (alias->flags & MALLOCED_REPLACEMENT) |
b8c9b27d | 602 | xfree (alias->replacement); |
33f91161 | 603 | |
56382845 | 604 | if (deprecate) |
33f91161 | 605 | alias->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED); |
56382845 | 606 | else |
33f91161 AC |
607 | alias->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED); |
608 | alias->replacement = replacement; | |
56382845 FN |
609 | alias->flags |= MALLOCED_REPLACEMENT; |
610 | return; | |
611 | } | |
612 | else if (cmd) | |
613 | { | |
614 | if (cmd->flags & MALLOCED_REPLACEMENT) | |
b8c9b27d | 615 | xfree (cmd->replacement); |
56382845 FN |
616 | |
617 | if (deprecate) | |
33f91161 | 618 | cmd->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED); |
56382845 | 619 | else |
33f91161 AC |
620 | cmd->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED); |
621 | cmd->replacement = replacement; | |
56382845 FN |
622 | cmd->flags |= MALLOCED_REPLACEMENT; |
623 | return; | |
624 | } | |
625 | } | |
626 | ||
4f337972 AC |
627 | /* Maintenance set/show framework. */ |
628 | ||
629 | static struct cmd_list_element *maintenance_set_cmdlist; | |
630 | static struct cmd_list_element *maintenance_show_cmdlist; | |
631 | ||
632 | static void | |
633 | maintenance_set_cmd (char *args, int from_tty) | |
634 | { | |
635 | printf_unfiltered ("\"maintenance set\" must be followed by the name of a set command.\n"); | |
636 | help_list (maintenance_set_cmdlist, "maintenance set ", -1, gdb_stdout); | |
637 | } | |
638 | ||
639 | static void | |
640 | maintenance_show_cmd (char *args, int from_tty) | |
641 | { | |
642 | cmd_show_list (maintenance_show_cmdlist, from_tty, ""); | |
643 | } | |
644 | ||
4f337972 AC |
645 | /* Profiling support. */ |
646 | ||
647 | static int maintenance_profile_p; | |
d9feb4e7 DJ |
648 | |
649 | #if defined (HAVE_MONSTARTUP) && defined (HAVE__MCLEANUP) | |
650 | ||
b0b1c2c0 MK |
651 | #ifdef HAVE__ETEXT |
652 | extern char _etext; | |
653 | #define TEXTEND &_etext | |
654 | #else | |
655 | extern char etext; | |
656 | #define TEXTEND &etext | |
657 | #endif | |
658 | ||
d28f9cdf DJ |
659 | static int profiling_state; |
660 | ||
661 | static void | |
662 | mcleanup_wrapper (void) | |
663 | { | |
664 | extern void _mcleanup (void); | |
665 | ||
666 | if (profiling_state) | |
667 | _mcleanup (); | |
668 | } | |
4f337972 AC |
669 | |
670 | static void | |
671 | maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c) | |
672 | { | |
d28f9cdf DJ |
673 | if (maintenance_profile_p == profiling_state) |
674 | return; | |
675 | ||
676 | profiling_state = maintenance_profile_p; | |
677 | ||
678 | if (maintenance_profile_p) | |
679 | { | |
680 | static int profiling_initialized; | |
681 | ||
682 | extern void monstartup (unsigned long, unsigned long); | |
d28f9cdf DJ |
683 | extern int main(); |
684 | ||
685 | if (!profiling_initialized) | |
686 | { | |
687 | atexit (mcleanup_wrapper); | |
688 | profiling_initialized = 1; | |
689 | } | |
690 | ||
691 | /* "main" is now always the first function in the text segment, so use | |
692 | its address for monstartup. */ | |
b0b1c2c0 | 693 | monstartup ((unsigned long) &main, (unsigned long) TEXTEND); |
d28f9cdf DJ |
694 | } |
695 | else | |
696 | { | |
697 | extern void _mcleanup (void); | |
698 | _mcleanup (); | |
699 | } | |
4f337972 | 700 | } |
d9feb4e7 DJ |
701 | #else |
702 | static void | |
703 | maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c) | |
704 | { | |
51ee2ddc | 705 | error ("Profiling support is not available on this system."); |
d9feb4e7 DJ |
706 | } |
707 | #endif | |
56382845 | 708 | |
c906108c | 709 | void |
fba45db2 | 710 | _initialize_maint_cmds (void) |
c906108c | 711 | { |
4f337972 AC |
712 | struct cmd_list_element *tmpcmd; |
713 | ||
c906108c SS |
714 | add_prefix_cmd ("maintenance", class_maintenance, maintenance_command, |
715 | "Commands for use by GDB maintainers.\n\ | |
716 | Includes commands to dump specific internal GDB structures in\n\ | |
717 | a human readable form, to cause GDB to deliberately dump core,\n\ | |
5a24b7e3 | 718 | to test internal functions such as the C++/ObjC demangler, etc.", |
c906108c SS |
719 | &maintenancelist, "maintenance ", 0, |
720 | &cmdlist); | |
721 | ||
722 | add_com_alias ("mt", "maintenance", class_maintenance, 1); | |
723 | ||
724 | add_prefix_cmd ("info", class_maintenance, maintenance_info_command, | |
c5aa993b | 725 | "Commands for showing internal info about the program being debugged.", |
c906108c SS |
726 | &maintenanceinfolist, "maintenance info ", 0, |
727 | &maintenancelist); | |
90515c23 | 728 | add_alias_cmd ("i", "info", class_maintenance, 1, &maintenancelist); |
c906108c SS |
729 | |
730 | add_cmd ("sections", class_maintenance, maintenance_info_sections, | |
c5ad026a | 731 | "List the BFD sections of the exec and core files. \n\ |
e3d3bfda MS |
732 | Arguments may be any combination of:\n\ |
733 | [one or more section names]\n\ | |
734 | ALLOC LOAD RELOC READONLY CODE DATA ROM CONSTRUCTOR\n\ | |
735 | HAS_CONTENTS NEVER_LOAD COFF_SHARED_LIBRARY IS_COMMON\n\ | |
736 | Sections matching any argument will be listed (no argument\n\ | |
737 | implies all sections). In addition, the special argument\n\ | |
738 | ALLOBJ\n\ | |
739 | lists all sections from all object files, including shared libraries.", | |
c906108c SS |
740 | &maintenanceinfolist); |
741 | ||
742 | add_prefix_cmd ("print", class_maintenance, maintenance_print_command, | |
743 | "Maintenance command for printing GDB internal state.", | |
744 | &maintenanceprintlist, "maintenance print ", 0, | |
745 | &maintenancelist); | |
746 | ||
44ea7b70 JB |
747 | add_prefix_cmd ("list", class_maintenance, maintenance_list_command, |
748 | "Maintenance command for listing GDB internal state.", | |
749 | &maintenancelistlist, "maintenance list ", 0, | |
750 | &maintenancelist); | |
751 | ||
4f337972 AC |
752 | add_prefix_cmd ("set", class_maintenance, maintenance_set_cmd, "\ |
753 | Set GDB internal variables used by the GDB maintainer.\n\ | |
754 | Configure variables internal to GDB that aid in GDB's maintenance", | |
755 | &maintenance_set_cmdlist, "maintenance set ", | |
756 | 0/*allow-unknown*/, | |
757 | &maintenancelist); | |
758 | ||
759 | add_prefix_cmd ("show", class_maintenance, maintenance_show_cmd, "\ | |
760 | Show GDB internal variables used by the GDB maintainer.\n\ | |
761 | Configure variables internal to GDB that aid in GDB's maintenance", | |
762 | &maintenance_show_cmdlist, "maintenance show ", | |
763 | 0/*allow-unknown*/, | |
764 | &maintenancelist); | |
765 | ||
c906108c SS |
766 | #ifndef _WIN32 |
767 | add_cmd ("dump-me", class_maintenance, maintenance_dump_me, | |
768 | "Get fatal error; make debugger dump its core.\n\ | |
8308e54c | 769 | GDB sets its handling of SIGQUIT back to SIG_DFL and then sends\n\ |
c906108c SS |
770 | itself a SIGQUIT signal.", |
771 | &maintenancelist); | |
772 | #endif | |
773 | ||
7be570e7 JM |
774 | add_cmd ("internal-error", class_maintenance, maintenance_internal_error, |
775 | "Give GDB an internal error.\n\ | |
776 | Cause GDB to behave as if an internal error was detected.", | |
777 | &maintenancelist); | |
778 | ||
dec43320 AC |
779 | add_cmd ("internal-warning", class_maintenance, maintenance_internal_warning, |
780 | "Give GDB an internal warning.\n\ | |
781 | Cause GDB to behave as if an internal warning was reported.", | |
782 | &maintenancelist); | |
783 | ||
c906108c | 784 | add_cmd ("demangle", class_maintenance, maintenance_demangle, |
5a24b7e3 | 785 | "Demangle a C++/ObjC mangled name.\n\ |
c906108c SS |
786 | Call internal GDB demangler routine to demangle a C++ link name\n\ |
787 | and prints the result.", | |
788 | &maintenancelist); | |
789 | ||
790 | add_cmd ("time", class_maintenance, maintenance_time_display, | |
791 | "Set the display of time usage.\n\ | |
792 | If nonzero, will cause the execution time for each command to be\n\ | |
793 | displayed, following the command's output.", | |
794 | &maintenancelist); | |
795 | ||
796 | add_cmd ("space", class_maintenance, maintenance_space_display, | |
797 | "Set the display of space usage.\n\ | |
798 | If nonzero, will cause the execution space for each command to be\n\ | |
799 | displayed, following the command's output.", | |
800 | &maintenancelist); | |
801 | ||
802 | add_cmd ("type", class_maintenance, maintenance_print_type, | |
803 | "Print a type chain for a given symbol.\n\ | |
804 | For each node in a type chain, print the raw data for each member of\n\ | |
805 | the type structure, and the interpretation of the data.", | |
806 | &maintenanceprintlist); | |
807 | ||
808 | add_cmd ("symbols", class_maintenance, maintenance_print_symbols, | |
809 | "Print dump of current symbol definitions.\n\ | |
810 | Entries in the full symbol table are dumped to file OUTFILE.\n\ | |
811 | If a SOURCE file is specified, dump only that file's symbols.", | |
812 | &maintenanceprintlist); | |
813 | ||
814 | add_cmd ("msymbols", class_maintenance, maintenance_print_msymbols, | |
815 | "Print dump of current minimal symbol definitions.\n\ | |
816 | Entries in the minimal symbol table are dumped to file OUTFILE.\n\ | |
817 | If a SOURCE file is specified, dump only that file's minimal symbols.", | |
818 | &maintenanceprintlist); | |
819 | ||
820 | add_cmd ("psymbols", class_maintenance, maintenance_print_psymbols, | |
821 | "Print dump of current partial symbol definitions.\n\ | |
822 | Entries in the partial symbol table are dumped to file OUTFILE.\n\ | |
823 | If a SOURCE file is specified, dump only that file's partial symbols.", | |
824 | &maintenanceprintlist); | |
825 | ||
826 | add_cmd ("objfiles", class_maintenance, maintenance_print_objfiles, | |
827 | "Print dump of current object file definitions.", | |
828 | &maintenanceprintlist); | |
829 | ||
44ea7b70 JB |
830 | add_cmd ("symtabs", class_maintenance, maintenance_list_symtabs, |
831 | "List the full symbol tables for all object files.\n\ | |
832 | This does not include information about individual symbols, blocks, or\n\ | |
833 | linetables --- just the symbol table structures themselves.\n\ | |
834 | With an argument REGEXP, list the symbol tables whose names that match that.", | |
835 | &maintenancelistlist); | |
836 | ||
837 | add_cmd ("psymtabs", class_maintenance, maintenance_list_psymtabs, | |
838 | "List the partial symbol tables for all object files.\n\ | |
839 | This does not include information about individual partial symbols,\n\ | |
840 | just the symbol table structures themselves.", | |
841 | &maintenancelistlist); | |
842 | ||
c906108c SS |
843 | add_cmd ("statistics", class_maintenance, maintenance_print_statistics, |
844 | "Print statistics about internal gdb state.", | |
845 | &maintenanceprintlist); | |
846 | ||
4b9b3959 AC |
847 | add_cmd ("architecture", class_maintenance, maintenance_print_architecture, |
848 | "Print the internal architecture configuration.\ | |
849 | Takes an optional file parameter.", | |
850 | &maintenanceprintlist); | |
851 | ||
c906108c SS |
852 | add_cmd ("check-symtabs", class_maintenance, maintenance_check_symtabs, |
853 | "Check consistency of psymtabs and symtabs.", | |
854 | &maintenancelist); | |
855 | ||
856 | add_cmd ("translate-address", class_maintenance, maintenance_translate_address, | |
857 | "Translate a section name and address to a symbol.", | |
858 | &maintenancelist); | |
859 | ||
56382845 | 860 | add_cmd ("deprecate", class_maintenance, maintenance_deprecate, |
33f91161 | 861 | "Deprecate a command. Note that this is just in here so the \n\ |
56382845 FN |
862 | testsuite can check the comamnd deprecator. You probably shouldn't use this,\n\ |
863 | rather you should use the C function deprecate_cmd(). If you decide you \n\ | |
6f122dc9 | 864 | want to use it: maintenance deprecate 'commandname' \"replacement\". The \n\ |
56382845 FN |
865 | replacement is optional.", &maintenancelist); |
866 | ||
867 | add_cmd ("undeprecate", class_maintenance, maintenance_undeprecate, | |
33f91161 | 868 | "Undeprecate a command. Note that this is just in here so the \n\ |
56382845 | 869 | testsuite can check the comamnd deprecator. You probably shouldn't use this,\n\ |
33f91161 AC |
870 | If you decide you want to use it: maintenance undeprecate 'commandname'", |
871 | &maintenancelist); | |
56382845 | 872 | |
c906108c | 873 | add_show_from_set ( |
c5aa993b JM |
874 | add_set_cmd ("watchdog", class_maintenance, var_zinteger, (char *) &watchdog, |
875 | "Set watchdog timer.\n\ | |
c906108c SS |
876 | When non-zero, this timeout is used instead of waiting forever for a target to\n\ |
877 | finish a low-level step or continue operation. If the specified amount of time\n\ | |
878 | passes without a response from the target, an error occurs.", &setlist), | |
c5aa993b | 879 | &showlist); |
4f337972 AC |
880 | |
881 | ||
d28f9cdf DJ |
882 | add_setshow_boolean_cmd ("profile", class_maintenance, |
883 | &maintenance_profile_p, | |
884 | "Set internal profiling.\n" | |
885 | "When enabled GDB is profiled.", | |
886 | "Show internal profiling.\n", | |
887 | maintenance_set_profile_cmd, NULL, | |
888 | &maintenance_set_cmdlist, | |
889 | &maintenance_show_cmdlist); | |
c906108c | 890 | } |