1 /* Support for GDB maintenance commands.
2
3 Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
4 2002, 2003, 2004 Free Software Foundation, Inc.
5
6 Written by Fred Fish at Cygnus Support.
7
8 This file is part of GDB.
9
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.
14
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.
19
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. */
24
25
26 #include "defs.h"
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"
35 #include "expression.h" /* For language.h */
36 #include "language.h"
37 #include "symfile.h"
38 #include "objfiles.h"
39 #include "value.h"
40
41 #include "cli/cli-decode.h"
42
43 extern void _initialize_maint_cmds (void);
44
45 static void maintenance_command (char *, int);
46
47 static void maintenance_dump_me (char *, int);
48
49 static void maintenance_internal_error (char *args, int from_tty);
50
51 static void maintenance_demangle (char *, int);
52
53 static void maintenance_time_display (char *, int);
54
55 static void maintenance_space_display (char *, int);
56
57 static void maintenance_info_command (char *, int);
58
59 static void maintenance_info_sections (char *, int);
60
61 static void maintenance_print_command (char *, int);
62
63 static void maintenance_do_deprecate (char *, int);
64
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
75 LOCAL FUNCTION
76
77 maintenance_command -- access the maintenance subcommands
78
79 SYNOPSIS
80
81 void maintenance_command (char *args, int from_tty)
82
83 DESCRIPTION
84
85 */
86
87 static void
maintenance_command(char * args,int from_tty)88 maintenance_command (char *args, int from_tty)
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 static void
maintenance_dump_me(char * args,int from_tty)96 maintenance_dump_me (char *args, int from_tty)
97 {
98 if (query ("Should GDB dump core? "))
99 {
100 #ifdef __DJGPP__
101 /* SIGQUIT by default is ignored, so use SIGABRT instead. */
102 signal (SIGABRT, SIG_DFL);
103 kill (getpid (), SIGABRT);
104 #else
105 signal (SIGQUIT, SIG_DFL);
106 kill (getpid (), SIGQUIT);
107 #endif
108 }
109 }
110 #endif
111
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
maintenance_internal_error(char * args,int from_tty)118 maintenance_internal_error (char *args, int from_tty)
119 {
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
maintenance_internal_warning(char * args,int from_tty)129 maintenance_internal_warning (char *args, int from_tty)
130 {
131 internal_warning (__FILE__, __LINE__, "%s", (args == NULL ? "" : args));
132 }
133
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) */
141
142 static void
maintenance_demangle(char * args,int from_tty)143 maintenance_demangle (char *args, int from_tty)
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 {
153 demangled = language_demangle (current_language, args,
154 DMGL_ANSI | DMGL_PARAMS);
155 if (demangled != NULL)
156 {
157 printf_unfiltered ("%s\n", demangled);
158 xfree (demangled);
159 }
160 else
161 {
162 printf_unfiltered ("Can't demangle \"%s\"\n", args);
163 }
164 }
165 }
166
167 static void
maintenance_time_display(char * args,int from_tty)168 maintenance_time_display (char *args, int from_tty)
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
maintenance_space_display(char * args,int from_tty)179 maintenance_space_display (char *args, int from_tty)
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
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. */
192
193 static void
maintenance_info_command(char * arg,int from_tty)194 maintenance_info_command (char *arg, int from_tty)
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
200 /* Mini tokenizing lexer for 'maint info sections' command. */
201
202 static int
match_substring(const char * string,const char * substr)203 match_substring (const char *string, const char *substr)
204 {
205 int substr_len = strlen(substr);
206 const char *tok;
207
208 while ((tok = strstr (string, substr)) != NULL)
209 {
210 /* Got a partial match. Is it a whole word? */
211 if (tok == string
212 || tok[-1] == ' '
213 || tok[-1] == '\t')
214 {
215 /* Token is delimited at the front... */
216 if (tok[substr_len] == ' '
217 || tok[substr_len] == '\t'
218 || tok[substr_len] == '\0')
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
230 static int
match_bfd_flags(char * string,flagword flags)231 match_bfd_flags (char *string, flagword flags)
232 {
233 if (flags & SEC_ALLOC)
234 if (match_substring (string, "ALLOC"))
235 return 1;
236 if (flags & SEC_LOAD)
237 if (match_substring (string, "LOAD"))
238 return 1;
239 if (flags & SEC_RELOC)
240 if (match_substring (string, "RELOC"))
241 return 1;
242 if (flags & SEC_READONLY)
243 if (match_substring (string, "READONLY"))
244 return 1;
245 if (flags & SEC_CODE)
246 if (match_substring (string, "CODE"))
247 return 1;
248 if (flags & SEC_DATA)
249 if (match_substring (string, "DATA"))
250 return 1;
251 if (flags & SEC_ROM)
252 if (match_substring (string, "ROM"))
253 return 1;
254 if (flags & SEC_CONSTRUCTOR)
255 if (match_substring (string, "CONSTRUCTOR"))
256 return 1;
257 if (flags & SEC_HAS_CONTENTS)
258 if (match_substring (string, "HAS_CONTENTS"))
259 return 1;
260 if (flags & SEC_NEVER_LOAD)
261 if (match_substring (string, "NEVER_LOAD"))
262 return 1;
263 if (flags & SEC_COFF_SHARED_LIBRARY)
264 if (match_substring (string, "COFF_SHARED_LIBRARY"))
265 return 1;
266 if (flags & SEC_IS_COMMON)
267 if (match_substring (string, "IS_COMMON"))
268 return 1;
269
270 return 0;
271 }
272
273 static void
print_bfd_flags(flagword flags)274 print_bfd_flags (flagword flags)
275 {
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");
300 }
301
302 static void
maint_print_section_info(const char * name,flagword flags,CORE_ADDR addr,CORE_ADDR endaddr,unsigned long filepos)303 maint_print_section_info (const char *name, flagword flags,
304 CORE_ADDR addr, CORE_ADDR endaddr,
305 unsigned long filepos)
306 {
307 /* FIXME-32x64: Need print_address_numeric with field width. */
308 printf_filtered (" 0x%s", paddr (addr));
309 printf_filtered ("->0x%s", paddr (endaddr));
310 printf_filtered (" at %s",
311 hex_string_custom ((unsigned long) filepos, 8));
312 printf_filtered (": %s", name);
313 print_bfd_flags (flags);
314 printf_filtered ("\n");
315 }
316
317 static void
print_bfd_section_info(bfd * abfd,asection * asect,void * arg)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
325 if (arg == NULL || *((char *) arg) == '\0'
326 || match_substring ((char *) arg, name)
327 || match_bfd_flags ((char *) arg, flags))
328 {
329 CORE_ADDR addr, endaddr;
330
331 addr = bfd_section_vma (abfd, asect);
332 endaddr = addr + bfd_section_size (abfd, asect);
333 maint_print_section_info (name, flags, addr, endaddr, asect->filepos);
334 }
335 }
336
337 static void
print_objfile_section_info(bfd * abfd,struct obj_section * asect,char * string)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);
344
345 if (string == NULL || *string == '\0'
346 || match_substring (string, name)
347 || match_bfd_flags (string, flags))
348 {
349 maint_print_section_info (name, flags, asect->addr, asect->endaddr,
350 asect->the_bfd_section->filepos);
351 }
352 }
353
354 static void
maintenance_info_sections(char * arg,int from_tty)355 maintenance_info_sections (char *arg, int from_tty)
356 {
357 if (exec_bfd)
358 {
359 printf_filtered ("Exec file:\n");
360 printf_filtered (" `%s', ", bfd_get_filename (exec_bfd));
361 wrap_here (" ");
362 printf_filtered ("file type %s.\n", bfd_get_target (exec_bfd));
363 if (arg && *arg && match_substring (arg, "ALLOBJ"))
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);
387 }
388
389 if (core_bfd)
390 {
391 printf_filtered ("Core file:\n");
392 printf_filtered (" `%s', ", bfd_get_filename (core_bfd));
393 wrap_here (" ");
394 printf_filtered ("file type %s.\n", bfd_get_target (core_bfd));
395 bfd_map_over_sections (core_bfd, print_bfd_section_info, arg);
396 }
397 }
398
399 void
maintenance_print_statistics(char * args,int from_tty)400 maintenance_print_statistics (char *args, int from_tty)
401 {
402 print_objfile_statistics ();
403 print_symbol_bcache_statistics ();
404 }
405
406 static void
maintenance_print_architecture(char * args,int from_tty)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
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. */
424
425 static void
maintenance_print_command(char * arg,int from_tty)426 maintenance_print_command (char *arg, int from_tty)
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:
434 maintenance translate-address <secname> <addr>
435 or maintenance translate-address <addr>
436 */
437
438 static void
maintenance_translate_address(char * arg,int from_tty)439 maintenance_translate_address (char *arg, int from_tty)
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 */
455 while (*p && !isspace (*p)) /* Find end of section name */
456 p++;
457 if (*p == '\000') /* End of command? */
458 error ("Need to specify <section-name> and <address>");
459 *p++ = '\000';
460 while (isspace (*p))
461 p++; /* Skip whitespace */
462
463 ALL_OBJFILES (objfile)
464 {
465 sect = bfd_get_section_by_name (objfile->obfd, arg);
466 if (sect != NULL)
467 break;
468 }
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)
482 printf_filtered ("%s+%s\n",
483 SYMBOL_PRINT_NAME (sym),
484 paddr_u (address - SYMBOL_VALUE_ADDRESS (sym)));
485 else if (sect)
486 printf_filtered ("no symbol at %s:0x%s\n", sect->name, paddr (address));
487 else
488 printf_filtered ("no symbol at 0x%s\n", paddr (address));
489
490 return;
491 }
492
493
494 /* When a command is deprecated the user will be warned the first time
495 the command is used. If possible, a replacement will be
496 offered. */
497
498 static void
maintenance_deprecate(char * args,int from_tty)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 }
507
508 maintenance_do_deprecate (args, 1);
509
510 }
511
512
513 static void
maintenance_undeprecate(char * args,int from_tty)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 }
521
522 maintenance_do_deprecate (args, 0);
523
524 }
525
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
533 static void
maintenance_do_deprecate(char * text,int deprecate)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;
543 int len;
544 char *replacement = NULL;
545
546 if (text == NULL)
547 return;
548
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 }
554
555 if (deprecate)
556 {
557 /* look for a replacement command */
558 start_ptr = strchr (text, '\"');
559 if (start_ptr != NULL)
560 {
561 start_ptr++;
562 end_ptr = strrchr (start_ptr, '\"');
563 if (end_ptr != NULL)
564 {
565 len = end_ptr - start_ptr;
566 start_ptr[len] = '\0';
567 replacement = xstrdup (start_ptr);
568 }
569 }
570 }
571
572 if (!start_ptr || !end_ptr)
573 replacement = NULL;
574
575
576 /* If they used an alias, we only want to deprecate the alias.
577
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
580 memory. */
581 if (alias)
582 {
583
584 if (alias->flags & MALLOCED_REPLACEMENT)
585 xfree (alias->replacement);
586
587 if (deprecate)
588 alias->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED);
589 else
590 alias->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED);
591 alias->replacement = replacement;
592 alias->flags |= MALLOCED_REPLACEMENT;
593 return;
594 }
595 else if (cmd)
596 {
597 if (cmd->flags & MALLOCED_REPLACEMENT)
598 xfree (cmd->replacement);
599
600 if (deprecate)
601 cmd->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED);
602 else
603 cmd->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED);
604 cmd->replacement = replacement;
605 cmd->flags |= MALLOCED_REPLACEMENT;
606 return;
607 }
608 }
609
610 /* Maintenance set/show framework. */
611
612 struct cmd_list_element *maintenance_set_cmdlist;
613 struct cmd_list_element *maintenance_show_cmdlist;
614
615 static void
maintenance_set_cmd(char * args,int from_tty)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
maintenance_show_cmd(char * args,int from_tty)623 maintenance_show_cmd (char *args, int from_tty)
624 {
625 cmd_show_list (maintenance_show_cmdlist, from_tty, "");
626 }
627
628 /* Profiling support. */
629
630 static int maintenance_profile_p;
631
632 #if defined (HAVE_MONSTARTUP) && defined (HAVE__MCLEANUP)
633
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
642 static int profiling_state;
643
644 static void
mcleanup_wrapper(void)645 mcleanup_wrapper (void)
646 {
647 extern void _mcleanup (void);
648
649 if (profiling_state)
650 _mcleanup ();
651 }
652
653 static void
maintenance_set_profile_cmd(char * args,int from_tty,struct cmd_list_element * c)654 maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c)
655 {
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);
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. */
676 monstartup ((unsigned long) &main, (unsigned long) TEXTEND);
677 }
678 else
679 {
680 extern void _mcleanup (void);
681 _mcleanup ();
682 }
683 }
684 #else
685 static void
maintenance_set_profile_cmd(char * args,int from_tty,struct cmd_list_element * c)686 maintenance_set_profile_cmd (char *args, int from_tty, struct cmd_list_element *c)
687 {
688 error ("Profiling support is not available on this system.");
689 }
690 #endif
691
692 void
_initialize_maint_cmds(void)693 _initialize_maint_cmds (void)
694 {
695 struct cmd_list_element *tmpcmd;
696
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\
701 to test internal functions such as the C++/ObjC demangler, etc.",
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,
708 "Commands for showing internal info about the program being debugged.",
709 &maintenanceinfolist, "maintenance info ", 0,
710 &maintenancelist);
711 add_alias_cmd ("i", "info", class_maintenance, 1, &maintenancelist);
712
713 add_cmd ("sections", class_maintenance, maintenance_info_sections,
714 "List the BFD sections of the exec and core files. \n\
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.",
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
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
744 #ifndef _WIN32
745 add_cmd ("dump-me", class_maintenance, maintenance_dump_me,
746 "Get fatal error; make debugger dump its core.\n\
747 GDB sets its handling of SIGQUIT back to SIG_DFL and then sends\n\
748 itself a SIGQUIT signal.",
749 &maintenancelist);
750 #endif
751
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
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
762 add_cmd ("demangle", class_maintenance, maintenance_demangle,
763 "Demangle a C++/ObjC mangled name.\n\
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
808 add_cmd ("symtabs", class_maintenance, maintenance_info_symtabs,
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.",
813 &maintenanceinfolist);
814
815 add_cmd ("psymtabs", class_maintenance, maintenance_info_psymtabs,
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.",
819 &maintenanceinfolist);
820
821 add_cmd ("statistics", class_maintenance, maintenance_print_statistics,
822 "Print statistics about internal gdb state.",
823 &maintenanceprintlist);
824
825 add_cmd ("architecture", class_maintenance, maintenance_print_architecture,
826 "Print the internal architecture configuration.\
827 Takes an optional file parameter.",
828 &maintenanceprintlist);
829
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
838 add_cmd ("deprecate", class_maintenance, maintenance_deprecate,
839 "Deprecate a command. Note that this is just in here so the \n\
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\
842 want to use it: maintenance deprecate 'commandname' \"replacement\". The \n\
843 replacement is optional.", &maintenancelist);
844
845 add_cmd ("undeprecate", class_maintenance, maintenance_undeprecate,
846 "Undeprecate a command. Note that this is just in here so the \n\
847 testsuite can check the comamnd deprecator. You probably shouldn't use this,\n\
848 If you decide you want to use it: maintenance undeprecate 'commandname'",
849 &maintenancelist);
850
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);
860
861
862 add_setshow_boolean_cmd ("profile", class_maintenance,
863 &maintenance_profile_p, "\
864 Set internal profiling.", "\
865 Show internal profiling.", "\
866 When enabled GDB is profiled.", "\
867 Internal profiling is %s.",
868 maintenance_set_profile_cmd, NULL,
869 &maintenance_set_cmdlist,
870 &maintenance_show_cmdlist);
871 }
872