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