gdb/maint.c

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