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