[binutils.git] / gdb / maint.c

/* Support for GDB maintenance commands.
   Copyright 1992, 1993, 1994 Free Software Foundation, Inc.
   Written by Fred Fish at Cygnus Support.

   This file is part of GDB.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  */


#include "defs.h"
#include <ctype.h>
#include <signal.h>
#include "command.h"
#include "gdbcmd.h"
#include "symtab.h"
#include "gdbtypes.h"
#include "demangle.h"
#include "gdbcore.h"
#include "expression.h"		/* For language.h */
#include "language.h"
#include "symfile.h"
#include "objfiles.h"
#include "value.h"

#ifdef HAVE_UNISTD_H
#include <unistd.h>
#endif

extern void _initialize_maint_cmds PARAMS ((void));

static void maintenance_command PARAMS ((char *, int));

static void maintenance_dump_me PARAMS ((char *, int));

static void maintenance_demangle PARAMS ((char *, int));

static void maintenance_time_display PARAMS ((char *, int));

static void maintenance_space_display PARAMS ((char *, int));

static void maintenance_info_command PARAMS ((char *, int));

static void print_section_table PARAMS ((bfd *, asection *, PTR));

static void maintenance_info_sections PARAMS ((char *, int));

static void maintenance_print_command PARAMS ((char *, int));

/* Set this to the maximum number of seconds to wait instead of waiting forever
   in target_wait().  If this timer times out, then it generates an error and
   the command is aborted.  This replaces most of the need for timeouts in the
   GDB test suite, and makes it possible to distinguish between a hung target
   and one with slow communications.  */

int watchdog = 0;

/*

   LOCAL FUNCTION

   maintenance_command -- access the maintenance subcommands

   SYNOPSIS

   void maintenance_command (char *args, int from_tty)

   DESCRIPTION

 */

static void
maintenance_command (args, from_tty)
     char *args;
     int from_tty;
{
  printf_unfiltered ("\"maintenance\" must be followed by the name of a maintenance command.\n");
  help_list (maintenancelist, "maintenance ", -1, gdb_stdout);
}

#ifndef _WIN32
/* ARGSUSED */
static void
maintenance_dump_me (args, from_tty)
     char *args;
     int from_tty;
{
  if (query ("Should GDB dump core? "))
    {
      signal (SIGQUIT, SIG_DFL);
      kill (getpid (), SIGQUIT);
    }
}
#endif

/*  Someday we should allow demangling for things other than just
   explicit strings.  For example, we might want to be able to
   specify the address of a string in either GDB's process space
   or the debuggee's process space, and have gdb fetch and demangle
   that string.  If we have a char* pointer "ptr" that points to
   a string, we might want to be able to given just the name and
   have GDB demangle and print what it points to, etc.  (FIXME) */

static void
maintenance_demangle (args, from_tty)
     char *args;
     int from_tty;
{
  char *demangled;

  if (args == NULL || *args == '\0')
    {
      printf_unfiltered ("\"maintenance demangle\" takes an argument to demangle.\n");
    }
  else
    {
      demangled = cplus_demangle (args, DMGL_ANSI | DMGL_PARAMS);
      if (demangled != NULL)
	{
	  printf_unfiltered ("%s\n", demangled);
	  free (demangled);
	}
      else
	{
	  printf_unfiltered ("Can't demangle \"%s\"\n", args);
	}
    }
}

static void
maintenance_time_display (args, from_tty)
     char *args;
     int from_tty;
{
  extern int display_time;

  if (args == NULL || *args == '\0')
    printf_unfiltered ("\"maintenance time\" takes a numeric argument.\n");
  else
    display_time = strtol (args, NULL, 10);
}

static void
maintenance_space_display (args, from_tty)
     char *args;
     int from_tty;
{
  extern int display_space;

  if (args == NULL || *args == '\0')
    printf_unfiltered ("\"maintenance space\" takes a numeric argument.\n");
  else
    display_space = strtol (args, NULL, 10);
}

/* The "maintenance info" command is defined as a prefix, with allow_unknown 0.
   Therefore, its own definition is called only for "maintenance info" with
   no args.  */

/* ARGSUSED */
static void
maintenance_info_command (arg, from_tty)
     char *arg;
     int from_tty;
{
  printf_unfiltered ("\"maintenance info\" must be followed by the name of an info command.\n");
  help_list (maintenanceinfolist, "maintenance info ", -1, gdb_stdout);
}

static void
print_section_table (abfd, asect, ignore)
     bfd *abfd;
     asection *asect;
     PTR ignore;
{
  flagword flags;

  flags = bfd_get_section_flags (abfd, asect);

  /* FIXME-32x64: Need print_address_numeric with field width.  */
  printf_filtered ("    %s",
		   local_hex_string_custom
		   ((unsigned long) bfd_section_vma (abfd, asect), "08l"));
  printf_filtered ("->%s",
		   local_hex_string_custom
		   ((unsigned long) (bfd_section_vma (abfd, asect)
				     + bfd_section_size (abfd, asect)),
		    "08l"));
  printf_filtered (" at %s",
		   local_hex_string_custom
		   ((unsigned long) asect->filepos, "08l"));
  printf_filtered (": %s", bfd_section_name (abfd, asect));

  if (flags & SEC_ALLOC)
    printf_filtered (" ALLOC");
  if (flags & SEC_LOAD)
    printf_filtered (" LOAD");
  if (flags & SEC_RELOC)
    printf_filtered (" RELOC");
  if (flags & SEC_READONLY)
    printf_filtered (" READONLY");
  if (flags & SEC_CODE)
    printf_filtered (" CODE");
  if (flags & SEC_DATA)
    printf_filtered (" DATA");
  if (flags & SEC_ROM)
    printf_filtered (" ROM");
  if (flags & SEC_CONSTRUCTOR)
    printf_filtered (" CONSTRUCTOR");
  if (flags & SEC_HAS_CONTENTS)
    printf_filtered (" HAS_CONTENTS");
  if (flags & SEC_NEVER_LOAD)
    printf_filtered (" NEVER_LOAD");
  if (flags & SEC_COFF_SHARED_LIBRARY)
    printf_filtered (" COFF_SHARED_LIBRARY");
  if (flags & SEC_IS_COMMON)
    printf_filtered (" IS_COMMON");

  printf_filtered ("\n");
}

/* ARGSUSED */
static void
maintenance_info_sections (arg, from_tty)
     char *arg;
     int from_tty;
{
  if (exec_bfd)
    {
      printf_filtered ("Exec file:\n");
      printf_filtered ("    `%s', ", bfd_get_filename (exec_bfd));
      wrap_here ("        ");
      printf_filtered ("file type %s.\n", bfd_get_target (exec_bfd));
      bfd_map_over_sections (exec_bfd, print_section_table, 0);
    }

  if (core_bfd)
    {
      printf_filtered ("Core file:\n");
      printf_filtered ("    `%s', ", bfd_get_filename (core_bfd));
      wrap_here ("        ");
      printf_filtered ("file type %s.\n", bfd_get_target (core_bfd));
      bfd_map_over_sections (core_bfd, print_section_table, 0);
    }
}

/* ARGSUSED */
void
maintenance_print_statistics (args, from_tty)
     char *args;
     int from_tty;
{
  print_objfile_statistics ();
  print_symbol_bcache_statistics ();
}

/* The "maintenance print" command is defined as a prefix, with allow_unknown
   0.  Therefore, its own definition is called only for "maintenance print"
   with no args.  */

/* ARGSUSED */
static void
maintenance_print_command (arg, from_tty)
     char *arg;
     int from_tty;
{
  printf_unfiltered ("\"maintenance print\" must be followed by the name of a print command.\n");
  help_list (maintenanceprintlist, "maintenance print ", -1, gdb_stdout);
}

/* The "maintenance translate-address" command converts a section and address
   to a symbol.  This can be called in two ways:
   maintenance translate-address <secname> <addr>
   or   maintenance translate-address <addr>
 */

static void
maintenance_translate_address (arg, from_tty)
     char *arg;
     int from_tty;
{
  CORE_ADDR address;
  asection *sect;
  char *p;
  struct minimal_symbol *sym;
  struct objfile *objfile;

  if (arg == NULL || *arg == 0)
    error ("requires argument (address or section + address)");

  sect = NULL;
  p = arg;

  if (!isdigit (*p))
    {				/* See if we have a valid section name */
      while (*p && !isspace (*p))	/* Find end of section name */
	p++;
      if (*p == '\000')		/* End of command? */
	error ("Need to specify <section-name> and <address>");
      *p++ = '\000';
      while (isspace (*p))
	p++;			/* Skip whitespace */

      ALL_OBJFILES (objfile)
      {
	sect = bfd_get_section_by_name (objfile->obfd, arg);
	if (sect != NULL)
	  break;
      }

      if (!sect)
	error ("Unknown section %s.", arg);
    }

  address = parse_and_eval_address (p);

  if (sect)
    sym = lookup_minimal_symbol_by_pc_section (address, sect);
  else
    sym = lookup_minimal_symbol_by_pc (address);

  if (sym)
    printf_filtered ("%s+%u\n",
		     SYMBOL_SOURCE_NAME (sym),
		     address - SYMBOL_VALUE_ADDRESS (sym));
  else if (sect)
    printf_filtered ("no symbol at %s:0x%08x\n", sect->name, address);
  else
    printf_filtered ("no symbol at 0x%08x\n", address);

  return;
}

void
_initialize_maint_cmds ()
{
  add_prefix_cmd ("maintenance", class_maintenance, maintenance_command,
		  "Commands for use by GDB maintainers.\n\
Includes commands to dump specific internal GDB structures in\n\
a human readable form, to cause GDB to deliberately dump core,\n\
to test internal functions such as the C++ demangler, etc.",
		  &maintenancelist, "maintenance ", 0,
		  &cmdlist);

  add_com_alias ("mt", "maintenance", class_maintenance, 1);

  add_prefix_cmd ("info", class_maintenance, maintenance_info_command,
     "Commands for showing internal info about the program being debugged.",
		  &maintenanceinfolist, "maintenance info ", 0,
		  &maintenancelist);

  add_cmd ("sections", class_maintenance, maintenance_info_sections,
	   "List the BFD sections of the exec and core files.",
	   &maintenanceinfolist);

  add_prefix_cmd ("print", class_maintenance, maintenance_print_command,
		  "Maintenance command for printing GDB internal state.",
		  &maintenanceprintlist, "maintenance print ", 0,
		  &maintenancelist);

#ifndef _WIN32
  add_cmd ("dump-me", class_maintenance, maintenance_dump_me,
	   "Get fatal error; make debugger dump its core.\n\
GDB sets it's handling of SIGQUIT back to SIG_DFL and then sends\n\
itself a SIGQUIT signal.",
	   &maintenancelist);
#endif

  add_cmd ("demangle", class_maintenance, maintenance_demangle,
	   "Demangle a C++ mangled name.\n\
Call internal GDB demangler routine to demangle a C++ link name\n\
and prints the result.",
	   &maintenancelist);

  add_cmd ("time", class_maintenance, maintenance_time_display,
	   "Set the display of time usage.\n\
If nonzero, will cause the execution time for each command to be\n\
displayed, following the command's output.",
	   &maintenancelist);

  add_cmd ("space", class_maintenance, maintenance_space_display,
	   "Set the display of space usage.\n\
If nonzero, will cause the execution space for each command to be\n\
displayed, following the command's output.",
	   &maintenancelist);

  add_cmd ("type", class_maintenance, maintenance_print_type,
	   "Print a type chain for a given symbol.\n\
For each node in a type chain, print the raw data for each member of\n\
the type structure, and the interpretation of the data.",
	   &maintenanceprintlist);

  add_cmd ("symbols", class_maintenance, maintenance_print_symbols,
	   "Print dump of current symbol definitions.\n\
Entries in the full symbol table are dumped to file OUTFILE.\n\
If a SOURCE file is specified, dump only that file's symbols.",
	   &maintenanceprintlist);

  add_cmd ("msymbols", class_maintenance, maintenance_print_msymbols,
	   "Print dump of current minimal symbol definitions.\n\
Entries in the minimal symbol table are dumped to file OUTFILE.\n\
If a SOURCE file is specified, dump only that file's minimal symbols.",
	   &maintenanceprintlist);

  add_cmd ("psymbols", class_maintenance, maintenance_print_psymbols,
	   "Print dump of current partial symbol definitions.\n\
Entries in the partial symbol table are dumped to file OUTFILE.\n\
If a SOURCE file is specified, dump only that file's partial symbols.",
	   &maintenanceprintlist);

  add_cmd ("objfiles", class_maintenance, maintenance_print_objfiles,
	   "Print dump of current object file definitions.",
	   &maintenanceprintlist);

  add_cmd ("statistics", class_maintenance, maintenance_print_statistics,
	   "Print statistics about internal gdb state.",
	   &maintenanceprintlist);

  add_cmd ("check-symtabs", class_maintenance, maintenance_check_symtabs,
	   "Check consistency of psymtabs and symtabs.",
	   &maintenancelist);

  add_cmd ("translate-address", class_maintenance, maintenance_translate_address,
	   "Translate a section name and address to a symbol.",
	   &maintenancelist);

  add_show_from_set (
		      add_set_cmd ("watchdog", class_maintenance, var_zinteger, (char *) &watchdog,
				   "Set watchdog timer.\n\
When non-zero, this timeout is used instead of waiting forever for a target to\n\
finish a low-level step or continue operation.  If the specified amount of time\n\
passes without a response from the target, an error occurs.", &setlist),
		      &showlist);
}
Commit	Line	Data
c906108c SS	1	/* Support for GDB maintenance commands.
	2	Copyright 1992, 1993, 1994 Free Software Foundation, Inc.
	3	Written by Fred Fish at Cygnus Support.
	4
c5aa993b	5	This file is part of GDB.
c906108c	6
c5aa993b JM	7	This program is free software; you can redistribute it and/or modify
	8	it under the terms of the GNU General Public License as published by
	9	the Free Software Foundation; either version 2 of the License, or
	10	(at your option) any later version.
c906108c	11
c5aa993b JM	12	This program is distributed in the hope that it will be useful,
	13	but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	GNU General Public License for more details.
c906108c	16
c5aa993b JM	17	You should have received a copy of the GNU General Public License
	18	along with this program; if not, write to the Free Software
	19	Foundation, Inc., 59 Temple Place - Suite 330,
	20	Boston, MA 02111-1307, USA. */
c906108c SS	21
	22
	23	#include "defs.h"
c906108c SS	24	#include <ctype.h>
	25	#include <signal.h>
	26	#include "command.h"
	27	#include "gdbcmd.h"
	28	#include "symtab.h"
	29	#include "gdbtypes.h"
	30	#include "demangle.h"
	31	#include "gdbcore.h"
c5aa993b	32	#include "expression.h" /* For language.h */
c906108c SS	33	#include "language.h"
	34	#include "symfile.h"
	35	#include "objfiles.h"
	36	#include "value.h"
	37
	38	#ifdef HAVE_UNISTD_H
	39	#include <unistd.h>
	40	#endif
	41
392a587b JM	42	extern void _initialize_maint_cmds PARAMS ((void));
392a587b JM	43
c906108c SS	44	static void maintenance_command PARAMS ((char *, int));
	45
	46	static void maintenance_dump_me PARAMS ((char *, int));
	47
	48	static void maintenance_demangle PARAMS ((char *, int));
	49
	50	static void maintenance_time_display PARAMS ((char *, int));
	51
	52	static void maintenance_space_display PARAMS ((char *, int));
	53
	54	static void maintenance_info_command PARAMS ((char *, int));
	55
	56	static void print_section_table PARAMS ((bfd , asection , PTR));
	57
	58	static void maintenance_info_sections PARAMS ((char *, int));
	59
	60	static void maintenance_print_command PARAMS ((char *, int));
	61
	62	/* Set this to the maximum number of seconds to wait instead of waiting forever
	63	in target_wait(). If this timer times out, then it generates an error and
	64	the command is aborted. This replaces most of the need for timeouts in the
	65	GDB test suite, and makes it possible to distinguish between a hung target
	66	and one with slow communications. */
	67
	68	int watchdog = 0;
	69
	70	/*
	71
c5aa993b	72	LOCAL FUNCTION
c906108c	73
c5aa993b	74	maintenance_command -- access the maintenance subcommands
c906108c	75
c5aa993b	76	SYNOPSIS
c906108c	77
c5aa993b	78	void maintenance_command (char *args, int from_tty)
c906108c	79
c5aa993b	80	DESCRIPTION
c906108c	81
c5aa993b	82	*/
c906108c SS	83
	84	static void
	85	maintenance_command (args, from_tty)
	86	char *args;
	87	int from_tty;
	88	{
	89	printf_unfiltered ("\"maintenance\" must be followed by the name of a maintenance command.\n");
	90	help_list (maintenancelist, "maintenance ", -1, gdb_stdout);
	91	}
	92
	93	#ifndef _WIN32
	94	/* ARGSUSED */
	95	static void
	96	maintenance_dump_me (args, from_tty)
	97	char *args;
	98	int from_tty;
	99	{
	100	if (query ("Should GDB dump core? "))
	101	{
	102	signal (SIGQUIT, SIG_DFL);
	103	kill (getpid (), SIGQUIT);
	104	}
	105	}
	106	#endif
	107
	108	/* Someday we should allow demangling for things other than just
c5aa993b JM	109	explicit strings. For example, we might want to be able to
	110	specify the address of a string in either GDB's process space
	111	or the debuggee's process space, and have gdb fetch and demangle
	112	that string. If we have a char* pointer "ptr" that points to
	113	a string, we might want to be able to given just the name and
	114	have GDB demangle and print what it points to, etc. (FIXME) */
c906108c SS	115
	116	static void
	117	maintenance_demangle (args, from_tty)
	118	char *args;
	119	int from_tty;
	120	{
	121	char *demangled;
	122
	123	if (args == NULL \|\| *args == '\0')
	124	{
	125	printf_unfiltered ("\"maintenance demangle\" takes an argument to demangle.\n");
	126	}
	127	else
	128	{
	129	demangled = cplus_demangle (args, DMGL_ANSI \| DMGL_PARAMS);
	130	if (demangled != NULL)
	131	{
	132	printf_unfiltered ("%s\n", demangled);
	133	free (demangled);
	134	}
	135	else
	136	{
	137	printf_unfiltered ("Can't demangle \"%s\"\n", args);
	138	}
	139	}
	140	}
	141
	142	static void
	143	maintenance_time_display (args, from_tty)
	144	char *args;
	145	int from_tty;
	146	{
	147	extern int display_time;
	148
	149	if (args == NULL \|\| *args == '\0')
	150	printf_unfiltered ("\"maintenance time\" takes a numeric argument.\n");
	151	else
	152	display_time = strtol (args, NULL, 10);
	153	}
	154
	155	static void
	156	maintenance_space_display (args, from_tty)
	157	char *args;
	158	int from_tty;
	159	{
	160	extern int display_space;
	161
	162	if (args == NULL \|\| *args == '\0')
	163	printf_unfiltered ("\"maintenance space\" takes a numeric argument.\n");
	164	else
	165	display_space = strtol (args, NULL, 10);
	166	}
	167
	168	/* The "maintenance info" command is defined as a prefix, with allow_unknown 0.
	169	Therefore, its own definition is called only for "maintenance info" with
	170	no args. */
	171
	172	/* ARGSUSED */
	173	static void
	174	maintenance_info_command (arg, from_tty)
	175	char *arg;
	176	int from_tty;
	177	{
	178	printf_unfiltered ("\"maintenance info\" must be followed by the name of an info command.\n");
179	help_list (maintenanceinfolist, "maintenance info ", -1, gdb_stdout);
180	}
181
182	static void
183	print_section_table (abfd, asect, ignore)
184	bfd *abfd;
185	asection *asect;
186	PTR ignore;
187	{
188	flagword flags;
189
190	flags = bfd_get_section_flags (abfd, asect);
191
192	/* FIXME-32x64: Need print_address_numeric with field width. */
193	printf_filtered (" %s",
194	local_hex_string_custom
c5aa993b	195	((unsigned long) bfd_section_vma (abfd, asect), "08l"));
c906108c SS	196	printf_filtered ("->%s",
c906108c SS	197	local_hex_string_custom
c5aa993b JM	198	((unsigned long) (bfd_section_vma (abfd, asect)
	199	+ bfd_section_size (abfd, asect)),
	200	"08l"));
c906108c SS	201	printf_filtered (" at %s",
c906108c SS	202	local_hex_string_custom
c5aa993b	203	((unsigned long) asect->filepos, "08l"));
c906108c SS	204	printf_filtered (": %s", bfd_section_name (abfd, asect));
	205
	206	if (flags & SEC_ALLOC)
	207	printf_filtered (" ALLOC");
	208	if (flags & SEC_LOAD)
	209	printf_filtered (" LOAD");
	210	if (flags & SEC_RELOC)
	211	printf_filtered (" RELOC");
	212	if (flags & SEC_READONLY)
	213	printf_filtered (" READONLY");
	214	if (flags & SEC_CODE)
	215	printf_filtered (" CODE");
	216	if (flags & SEC_DATA)
	217	printf_filtered (" DATA");
	218	if (flags & SEC_ROM)
	219	printf_filtered (" ROM");
	220	if (flags & SEC_CONSTRUCTOR)
	221	printf_filtered (" CONSTRUCTOR");
	222	if (flags & SEC_HAS_CONTENTS)
	223	printf_filtered (" HAS_CONTENTS");
	224	if (flags & SEC_NEVER_LOAD)
	225	printf_filtered (" NEVER_LOAD");
	226	if (flags & SEC_COFF_SHARED_LIBRARY)
	227	printf_filtered (" COFF_SHARED_LIBRARY");
	228	if (flags & SEC_IS_COMMON)
	229	printf_filtered (" IS_COMMON");
	230
	231	printf_filtered ("\n");
	232	}
	233
	234	/* ARGSUSED */
	235	static void
	236	maintenance_info_sections (arg, from_tty)
	237	char *arg;
	238	int from_tty;
	239	{
	240	if (exec_bfd)
	241	{
	242	printf_filtered ("Exec file:\n");
c5aa993b	243	printf_filtered (" `%s', ", bfd_get_filename (exec_bfd));
c906108c	244	wrap_here (" ");
c5aa993b JM	245	printf_filtered ("file type %s.\n", bfd_get_target (exec_bfd));
c5aa993b JM	246	bfd_map_over_sections (exec_bfd, print_section_table, 0);
c906108c SS	247	}
	248
	249	if (core_bfd)
	250	{
	251	printf_filtered ("Core file:\n");
c5aa993b	252	printf_filtered (" `%s', ", bfd_get_filename (core_bfd));
c906108c	253	wrap_here (" ");
c5aa993b JM	254	printf_filtered ("file type %s.\n", bfd_get_target (core_bfd));
c5aa993b JM	255	bfd_map_over_sections (core_bfd, print_section_table, 0);
c906108c SS	256	}
	257	}
	258
	259	/* ARGSUSED */
	260	void
	261	maintenance_print_statistics (args, from_tty)
	262	char *args;
	263	int from_tty;
	264	{
	265	print_objfile_statistics ();
	266	print_symbol_bcache_statistics ();
	267	}
	268
	269	/* The "maintenance print" command is defined as a prefix, with allow_unknown
	270	0. Therefore, its own definition is called only for "maintenance print"
	271	with no args. */
	272
	273	/* ARGSUSED */
	274	static void
	275	maintenance_print_command (arg, from_tty)
	276	char *arg;
	277	int from_tty;
	278	{
	279	printf_unfiltered ("\"maintenance print\" must be followed by the name of a print command.\n");
	280	help_list (maintenanceprintlist, "maintenance print ", -1, gdb_stdout);
	281	}
	282
	283	/* The "maintenance translate-address" command converts a section and address
	284	to a symbol. This can be called in two ways:
c5aa993b JM	285	maintenance translate-address <secname> <addr>
	286	or maintenance translate-address <addr>
	287	*/
c906108c SS	288
	289	static void
	290	maintenance_translate_address (arg, from_tty)
	291	char *arg;
	292	int from_tty;
	293	{
	294	CORE_ADDR address;
	295	asection *sect;
	296	char *p;
	297	struct minimal_symbol *sym;
	298	struct objfile *objfile;
	299
	300	if (arg == NULL \|\| *arg == 0)
	301	error ("requires argument (address or section + address)");
	302
	303	sect = NULL;
	304	p = arg;
	305
	306	if (!isdigit (*p))
	307	{ /* See if we have a valid section name */
c5aa993b	308	while (p && !isspace (p)) /* Find end of section name */
c906108c SS	309	p++;
	310	if (p == '\000') / End of command? */
	311	error ("Need to specify <section-name> and <address>");
	312	*p++ = '\000';
c5aa993b JM	313	while (isspace (*p))
c5aa993b JM	314	p++; /* Skip whitespace */
c906108c SS	315
c906108c SS	316	ALL_OBJFILES (objfile)
c5aa993b JM	317	{
	318	sect = bfd_get_section_by_name (objfile->obfd, arg);
	319	if (sect != NULL)
	320	break;
	321	}
c906108c SS	322
	323	if (!sect)
	324	error ("Unknown section %s.", arg);
	325	}
	326
	327	address = parse_and_eval_address (p);
	328
	329	if (sect)
	330	sym = lookup_minimal_symbol_by_pc_section (address, sect);
	331	else
	332	sym = lookup_minimal_symbol_by_pc (address);
	333
	334	if (sym)
c5aa993b JM	335	printf_filtered ("%s+%u\n",
c5aa993b JM	336	SYMBOL_SOURCE_NAME (sym),
c906108c SS	337	address - SYMBOL_VALUE_ADDRESS (sym));
	338	else if (sect)
	339	printf_filtered ("no symbol at %s:0x%08x\n", sect->name, address);
	340	else
	341	printf_filtered ("no symbol at 0x%08x\n", address);
	342
	343	return;
	344	}
	345
c906108c SS	346	void
	347	_initialize_maint_cmds ()
	348	{
c906108c SS	349	add_prefix_cmd ("maintenance", class_maintenance, maintenance_command,
	350	"Commands for use by GDB maintainers.\n\
	351	Includes commands to dump specific internal GDB structures in\n\
	352	a human readable form, to cause GDB to deliberately dump core,\n\
	353	to test internal functions such as the C++ demangler, etc.",
	354	&maintenancelist, "maintenance ", 0,
	355	&cmdlist);
	356
	357	add_com_alias ("mt", "maintenance", class_maintenance, 1);
	358
	359	add_prefix_cmd ("info", class_maintenance, maintenance_info_command,
c5aa993b	360	"Commands for showing internal info about the program being debugged.",
c906108c SS	361	&maintenanceinfolist, "maintenance info ", 0,
	362	&maintenancelist);
	363
	364	add_cmd ("sections", class_maintenance, maintenance_info_sections,
	365	"List the BFD sections of the exec and core files.",
	366	&maintenanceinfolist);
	367
	368	add_prefix_cmd ("print", class_maintenance, maintenance_print_command,
	369	"Maintenance command for printing GDB internal state.",
	370	&maintenanceprintlist, "maintenance print ", 0,
	371	&maintenancelist);
	372
	373	#ifndef _WIN32
	374	add_cmd ("dump-me", class_maintenance, maintenance_dump_me,
	375	"Get fatal error; make debugger dump its core.\n\
	376	GDB sets it's handling of SIGQUIT back to SIG_DFL and then sends\n\
	377	itself a SIGQUIT signal.",
	378	&maintenancelist);
	379	#endif
	380
	381	add_cmd ("demangle", class_maintenance, maintenance_demangle,
	382	"Demangle a C++ mangled name.\n\
	383	Call internal GDB demangler routine to demangle a C++ link name\n\
	384	and prints the result.",
	385	&maintenancelist);
	386
	387	add_cmd ("time", class_maintenance, maintenance_time_display,
	388	"Set the display of time usage.\n\
	389	If nonzero, will cause the execution time for each command to be\n\
	390	displayed, following the command's output.",
	391	&maintenancelist);
	392
	393	add_cmd ("space", class_maintenance, maintenance_space_display,
	394	"Set the display of space usage.\n\
	395	If nonzero, will cause the execution space for each command to be\n\
	396	displayed, following the command's output.",
	397	&maintenancelist);
	398
	399	add_cmd ("type", class_maintenance, maintenance_print_type,
	400	"Print a type chain for a given symbol.\n\
	401	For each node in a type chain, print the raw data for each member of\n\
	402	the type structure, and the interpretation of the data.",
	403	&maintenanceprintlist);
	404
	405	add_cmd ("symbols", class_maintenance, maintenance_print_symbols,
	406	"Print dump of current symbol definitions.\n\
	407	Entries in the full symbol table are dumped to file OUTFILE.\n\
	408	If a SOURCE file is specified, dump only that file's symbols.",
	409	&maintenanceprintlist);
	410
	411	add_cmd ("msymbols", class_maintenance, maintenance_print_msymbols,
	412	"Print dump of current minimal symbol definitions.\n\
	413	Entries in the minimal symbol table are dumped to file OUTFILE.\n\
	414	If a SOURCE file is specified, dump only that file's minimal symbols.",
	415	&maintenanceprintlist);
	416
	417	add_cmd ("psymbols", class_maintenance, maintenance_print_psymbols,
	418	"Print dump of current partial symbol definitions.\n\
	419	Entries in the partial symbol table are dumped to file OUTFILE.\n\
	420	If a SOURCE file is specified, dump only that file's partial symbols.",
	421	&maintenanceprintlist);
	422
	423	add_cmd ("objfiles", class_maintenance, maintenance_print_objfiles,
	424	"Print dump of current object file definitions.",
425	&maintenanceprintlist);
426
427	add_cmd ("statistics", class_maintenance, maintenance_print_statistics,
428	"Print statistics about internal gdb state.",
429	&maintenanceprintlist);
430
431	add_cmd ("check-symtabs", class_maintenance, maintenance_check_symtabs,
432	"Check consistency of psymtabs and symtabs.",
433	&maintenancelist);
434
435	add_cmd ("translate-address", class_maintenance, maintenance_translate_address,
436	"Translate a section name and address to a symbol.",
437	&maintenancelist);
438
439	add_show_from_set (
c5aa993b JM	440	add_set_cmd ("watchdog", class_maintenance, var_zinteger, (char *) &watchdog,
c5aa993b JM	441	"Set watchdog timer.\n\
c906108c SS	442	When non-zero, this timeout is used instead of waiting forever for a target to\n\
	443	finish a low-level step or continue operation. If the specified amount of time\n\
	444	passes without a response from the target, an error occurs.", &setlist),
c5aa993b	445	&showlist);
c906108c	446	}