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