gdb/maint.c

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