]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/maint.c
daily update
[thirdparty/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>
bd712aed
DE
27#include <sys/time.h>
28#include <time.h>
c906108c
SS
29#include "command.h"
30#include "gdbcmd.h"
31#include "symtab.h"
bd712aed 32#include "block.h"
c906108c
SS
33#include "gdbtypes.h"
34#include "demangle.h"
35#include "gdbcore.h"
c5aa993b 36#include "expression.h" /* For language.h */
c906108c
SS
37#include "language.h"
38#include "symfile.h"
39#include "objfiles.h"
40#include "value.h"
c14c28ba 41#include "gdb_assert.h"
bd712aed
DE
42#include "top.h"
43#include "timeval-utils.h"
44#include "maint.h"
c906108c 45
18a642a1 46#include "cli/cli-decode.h"
529480d0 47#include "cli/cli-utils.h"
bd712aed 48#include "cli/cli-setshow.h"
18a642a1 49
a14ed312 50extern void _initialize_maint_cmds (void);
392a587b 51
a14ed312 52static void maintenance_command (char *, int);
c906108c 53
a14ed312 54static void maintenance_internal_error (char *args, int from_tty);
7be570e7 55
a14ed312 56static void maintenance_demangle (char *, int);
c906108c 57
a14ed312 58static void maintenance_time_display (char *, int);
c906108c 59
a14ed312 60static void maintenance_space_display (char *, int);
c906108c 61
a14ed312 62static void maintenance_info_command (char *, int);
c906108c 63
a14ed312 64static void maintenance_info_sections (char *, int);
c906108c 65
a14ed312 66static void maintenance_print_command (char *, int);
c906108c 67
1c689132
DB
68static void maintenance_do_deprecate (char *, int);
69
c906108c
SS
70/* Set this to the maximum number of seconds to wait instead of waiting forever
71 in target_wait(). If this timer times out, then it generates an error and
72 the command is aborted. This replaces most of the need for timeouts in the
73 GDB test suite, and makes it possible to distinguish between a hung target
74 and one with slow communications. */
75
76int watchdog = 0;
920d2a44
AC
77static void
78show_watchdog (struct ui_file *file, int from_tty,
79 struct cmd_list_element *c, const char *value)
80{
81 fprintf_filtered (file, _("Watchdog timer is %s.\n"), value);
82}
c906108c 83
7f86f058 84/* Access the maintenance subcommands. */
c906108c
SS
85
86static void
fba45db2 87maintenance_command (char *args, int from_tty)
c906108c 88{
3e43a32a
MS
89 printf_unfiltered (_("\"maintenance\" must be followed by "
90 "the name of a maintenance command.\n"));
c906108c
SS
91 help_list (maintenancelist, "maintenance ", -1, gdb_stdout);
92}
93
94#ifndef _WIN32
c906108c 95static void
fba45db2 96maintenance_dump_me (char *args, int from_tty)
c906108c 97{
9e2f0ad4 98 if (query (_("Should GDB dump core? ")))
c906108c 99 {
7be570e7
JM
100#ifdef __DJGPP__
101 /* SIGQUIT by default is ignored, so use SIGABRT instead. */
102 signal (SIGABRT, SIG_DFL);
103 kill (getpid (), SIGABRT);
104#else
c906108c
SS
105 signal (SIGQUIT, SIG_DFL);
106 kill (getpid (), SIGQUIT);
7be570e7 107#endif
c906108c
SS
108 }
109}
110#endif
111
7be570e7
JM
112/* Stimulate the internal error mechanism that GDB uses when an
113 internal problem is detected. Allows testing of the mechanism.
114 Also useful when the user wants to drop a core file but not exit
025bb325 115 GDB. */
7be570e7
JM
116
117static void
118maintenance_internal_error (char *args, int from_tty)
119{
dec43320
AC
120 internal_error (__FILE__, __LINE__, "%s", (args == NULL ? "" : args));
121}
122
123/* Stimulate the internal error mechanism that GDB uses when an
124 internal problem is detected. Allows testing of the mechanism.
125 Also useful when the user wants to drop a core file but not exit
025bb325 126 GDB. */
dec43320
AC
127
128static void
129maintenance_internal_warning (char *args, int from_tty)
130{
131 internal_warning (__FILE__, __LINE__, "%s", (args == NULL ? "" : args));
7be570e7
JM
132}
133
33f91161
AC
134/* Someday we should allow demangling for things other than just
135 explicit strings. For example, we might want to be able to specify
136 the address of a string in either GDB's process space or the
137 debuggee's process space, and have gdb fetch and demangle that
138 string. If we have a char* pointer "ptr" that points to a string,
139 we might want to be able to given just the name and have GDB
025bb325 140 demangle and print what it points to, etc. (FIXME) */
c906108c
SS
141
142static void
fba45db2 143maintenance_demangle (char *args, int from_tty)
c906108c
SS
144{
145 char *demangled;
146
147 if (args == NULL || *args == '\0')
148 {
3e43a32a
MS
149 printf_unfiltered (_("\"maintenance demangle\" takes "
150 "an argument to demangle.\n"));
c906108c
SS
151 }
152 else
153 {
9a3d7dfd
AF
154 demangled = language_demangle (current_language, args,
155 DMGL_ANSI | DMGL_PARAMS);
c906108c
SS
156 if (demangled != NULL)
157 {
158 printf_unfiltered ("%s\n", demangled);
b8c9b27d 159 xfree (demangled);
c906108c
SS
160 }
161 else
162 {
a3f17187 163 printf_unfiltered (_("Can't demangle \"%s\"\n"), args);
c906108c
SS
164 }
165 }
166}
167
168static void
fba45db2 169maintenance_time_display (char *args, int from_tty)
c906108c 170{
c906108c 171 if (args == NULL || *args == '\0')
a3f17187 172 printf_unfiltered (_("\"maintenance time\" takes a numeric argument.\n"));
c906108c 173 else
bd712aed 174 set_per_command_time (strtol (args, NULL, 10));
c906108c
SS
175}
176
177static void
fba45db2 178maintenance_space_display (char *args, int from_tty)
c906108c 179{
c906108c
SS
180 if (args == NULL || *args == '\0')
181 printf_unfiltered ("\"maintenance space\" takes a numeric argument.\n");
182 else
bd712aed 183 set_per_command_space (strtol (args, NULL, 10));
c906108c
SS
184}
185
33f91161
AC
186/* The "maintenance info" command is defined as a prefix, with
187 allow_unknown 0. Therefore, its own definition is called only for
188 "maintenance info" with no args. */
c906108c 189
c906108c 190static void
fba45db2 191maintenance_info_command (char *arg, int from_tty)
c906108c 192{
3e43a32a
MS
193 printf_unfiltered (_("\"maintenance info\" must be followed "
194 "by the name of an info command.\n"));
c906108c
SS
195 help_list (maintenanceinfolist, "maintenance info ", -1, gdb_stdout);
196}
197
a532ca62
MS
198/* Mini tokenizing lexer for 'maint info sections' command. */
199
200static int
473e38f3 201match_substring (const char *string, const char *substr)
a532ca62
MS
202{
203 int substr_len = strlen(substr);
473e38f3 204 const char *tok;
a532ca62
MS
205
206 while ((tok = strstr (string, substr)) != NULL)
207 {
025bb325 208 /* Got a partial match. Is it a whole word? */
b01d807c
MS
209 if (tok == string
210 || tok[-1] == ' '
211 || tok[-1] == '\t')
a532ca62 212 {
025bb325 213 /* Token is delimited at the front... */
b01d807c
MS
214 if (tok[substr_len] == ' '
215 || tok[substr_len] == '\t'
216 || tok[substr_len] == '\0')
a532ca62
MS
217 {
218 /* Token is delimited at the rear. Got a whole-word match. */
219 return 1;
220 }
221 }
222 /* Token didn't match as a whole word. Advance and try again. */
223 string = tok + 1;
224 }
225 return 0;
226}
227
43155bc1
MS
228static int
229match_bfd_flags (char *string, flagword flags)
c906108c 230{
43155bc1 231 if (flags & SEC_ALLOC)
a532ca62 232 if (match_substring (string, "ALLOC"))
43155bc1
MS
233 return 1;
234 if (flags & SEC_LOAD)
a532ca62 235 if (match_substring (string, "LOAD"))
43155bc1
MS
236 return 1;
237 if (flags & SEC_RELOC)
a532ca62 238 if (match_substring (string, "RELOC"))
43155bc1
MS
239 return 1;
240 if (flags & SEC_READONLY)
a532ca62 241 if (match_substring (string, "READONLY"))
43155bc1
MS
242 return 1;
243 if (flags & SEC_CODE)
a532ca62 244 if (match_substring (string, "CODE"))
43155bc1
MS
245 return 1;
246 if (flags & SEC_DATA)
a532ca62 247 if (match_substring (string, "DATA"))
43155bc1
MS
248 return 1;
249 if (flags & SEC_ROM)
a532ca62 250 if (match_substring (string, "ROM"))
43155bc1
MS
251 return 1;
252 if (flags & SEC_CONSTRUCTOR)
a532ca62 253 if (match_substring (string, "CONSTRUCTOR"))
43155bc1
MS
254 return 1;
255 if (flags & SEC_HAS_CONTENTS)
a532ca62 256 if (match_substring (string, "HAS_CONTENTS"))
43155bc1
MS
257 return 1;
258 if (flags & SEC_NEVER_LOAD)
a532ca62 259 if (match_substring (string, "NEVER_LOAD"))
43155bc1
MS
260 return 1;
261 if (flags & SEC_COFF_SHARED_LIBRARY)
a532ca62 262 if (match_substring (string, "COFF_SHARED_LIBRARY"))
43155bc1
MS
263 return 1;
264 if (flags & SEC_IS_COMMON)
a532ca62 265 if (match_substring (string, "IS_COMMON"))
43155bc1 266 return 1;
c906108c 267
43155bc1
MS
268 return 0;
269}
c906108c 270
43155bc1
MS
271static void
272print_bfd_flags (flagword flags)
273{
c906108c
SS
274 if (flags & SEC_ALLOC)
275 printf_filtered (" ALLOC");
276 if (flags & SEC_LOAD)
277 printf_filtered (" LOAD");
278 if (flags & SEC_RELOC)
279 printf_filtered (" RELOC");
280 if (flags & SEC_READONLY)
281 printf_filtered (" READONLY");
282 if (flags & SEC_CODE)
283 printf_filtered (" CODE");
284 if (flags & SEC_DATA)
285 printf_filtered (" DATA");
286 if (flags & SEC_ROM)
287 printf_filtered (" ROM");
288 if (flags & SEC_CONSTRUCTOR)
289 printf_filtered (" CONSTRUCTOR");
290 if (flags & SEC_HAS_CONTENTS)
291 printf_filtered (" HAS_CONTENTS");
292 if (flags & SEC_NEVER_LOAD)
293 printf_filtered (" NEVER_LOAD");
294 if (flags & SEC_COFF_SHARED_LIBRARY)
295 printf_filtered (" COFF_SHARED_LIBRARY");
296 if (flags & SEC_IS_COMMON)
297 printf_filtered (" IS_COMMON");
43155bc1
MS
298}
299
300static void
67a2b77e
AC
301maint_print_section_info (const char *name, flagword flags,
302 CORE_ADDR addr, CORE_ADDR endaddr,
5af949e3 303 unsigned long filepos, int addr_size)
43155bc1 304{
5af949e3
UW
305 printf_filtered (" %s", hex_string_custom (addr, addr_size));
306 printf_filtered ("->%s", hex_string_custom (endaddr, addr_size));
3ab13650 307 printf_filtered (" at %s",
bb599908 308 hex_string_custom ((unsigned long) filepos, 8));
e3d3bfda
MS
309 printf_filtered (": %s", name);
310 print_bfd_flags (flags);
311 printf_filtered ("\n");
312}
c906108c 313
e3d3bfda
MS
314static void
315print_bfd_section_info (bfd *abfd,
316 asection *asect,
317 void *arg)
318{
319 flagword flags = bfd_get_section_flags (abfd, asect);
320 const char *name = bfd_section_name (abfd, asect);
321
b01d807c
MS
322 if (arg == NULL || *((char *) arg) == '\0'
323 || match_substring ((char *) arg, name)
324 || match_bfd_flags ((char *) arg, flags))
e3d3bfda 325 {
5af949e3
UW
326 struct gdbarch *gdbarch = gdbarch_from_bfd (abfd);
327 int addr_size = gdbarch_addr_bit (gdbarch) / 8;
e3d3bfda
MS
328 CORE_ADDR addr, endaddr;
329
330 addr = bfd_section_vma (abfd, asect);
331 endaddr = addr + bfd_section_size (abfd, asect);
8625fc1b 332 printf_filtered (" [%d] ", gdb_bfd_section_index (abfd, asect));
5af949e3
UW
333 maint_print_section_info (name, flags, addr, endaddr,
334 asect->filepos, addr_size);
e3d3bfda
MS
335 }
336}
337
338static void
339print_objfile_section_info (bfd *abfd,
340 struct obj_section *asect,
341 char *string)
342{
343 flagword flags = bfd_get_section_flags (abfd, asect->the_bfd_section);
344 const char *name = bfd_section_name (abfd, asect->the_bfd_section);
43155bc1 345
b01d807c
MS
346 if (string == NULL || *string == '\0'
347 || match_substring (string, name)
348 || match_bfd_flags (string, flags))
43155bc1 349 {
5af949e3
UW
350 struct gdbarch *gdbarch = gdbarch_from_bfd (abfd);
351 int addr_size = gdbarch_addr_bit (gdbarch) / 8;
b8d56208 352
f1f6aadf
PA
353 maint_print_section_info (name, flags,
354 obj_section_addr (asect),
355 obj_section_endaddr (asect),
5af949e3
UW
356 asect->the_bfd_section->filepos,
357 addr_size);
43155bc1 358 }
c906108c
SS
359}
360
c906108c 361static void
fba45db2 362maintenance_info_sections (char *arg, int from_tty)
c906108c
SS
363{
364 if (exec_bfd)
365 {
a3f17187 366 printf_filtered (_("Exec file:\n"));
c5aa993b 367 printf_filtered (" `%s', ", bfd_get_filename (exec_bfd));
c906108c 368 wrap_here (" ");
a3f17187 369 printf_filtered (_("file type %s.\n"), bfd_get_target (exec_bfd));
a532ca62 370 if (arg && *arg && match_substring (arg, "ALLOBJ"))
e3d3bfda
MS
371 {
372 struct objfile *ofile;
373 struct obj_section *osect;
374
375 /* Only this function cares about the 'ALLOBJ' argument;
376 if 'ALLOBJ' is the only argument, discard it rather than
377 passing it down to print_objfile_section_info (which
378 wouldn't know how to handle it). */
379 if (strcmp (arg, "ALLOBJ") == 0)
380 arg = NULL;
381
382 ALL_OBJFILES (ofile)
383 {
a3f17187 384 printf_filtered (_(" Object file: %s\n"),
e3d3bfda
MS
385 bfd_get_filename (ofile->obfd));
386 ALL_OBJFILE_OSECTIONS (ofile, osect)
387 {
388 print_objfile_section_info (ofile->obfd, osect, arg);
389 }
390 }
391 }
392 else
393 bfd_map_over_sections (exec_bfd, print_bfd_section_info, arg);
c906108c
SS
394 }
395
396 if (core_bfd)
397 {
a3f17187 398 printf_filtered (_("Core file:\n"));
c5aa993b 399 printf_filtered (" `%s', ", bfd_get_filename (core_bfd));
c906108c 400 wrap_here (" ");
a3f17187 401 printf_filtered (_("file type %s.\n"), bfd_get_target (core_bfd));
e3d3bfda 402 bfd_map_over_sections (core_bfd, print_bfd_section_info, arg);
c906108c
SS
403 }
404}
405
025cfdb2 406static void
fba45db2 407maintenance_print_statistics (char *args, int from_tty)
c906108c
SS
408{
409 print_objfile_statistics ();
410 print_symbol_bcache_statistics ();
411}
412
b9362cc7 413static void
4b9b3959
AC
414maintenance_print_architecture (char *args, int from_tty)
415{
e17c207e
UW
416 struct gdbarch *gdbarch = get_current_arch ();
417
4b9b3959 418 if (args == NULL)
e17c207e 419 gdbarch_dump (gdbarch, gdb_stdout);
4b9b3959
AC
420 else
421 {
724b958c 422 struct cleanup *cleanups;
4b9b3959 423 struct ui_file *file = gdb_fopen (args, "w");
b8d56208 424
4b9b3959 425 if (file == NULL)
e2e0b3e5 426 perror_with_name (_("maintenance print architecture"));
724b958c 427 cleanups = make_cleanup_ui_file_delete (file);
e17c207e 428 gdbarch_dump (gdbarch, file);
724b958c 429 do_cleanups (cleanups);
4b9b3959
AC
430 }
431}
432
33f91161
AC
433/* The "maintenance print" command is defined as a prefix, with
434 allow_unknown 0. Therefore, its own definition is called only for
435 "maintenance print" with no args. */
c906108c 436
c906108c 437static void
fba45db2 438maintenance_print_command (char *arg, int from_tty)
c906108c 439{
3e43a32a
MS
440 printf_unfiltered (_("\"maintenance print\" must be followed "
441 "by the name of a print command.\n"));
c906108c
SS
442 help_list (maintenanceprintlist, "maintenance print ", -1, gdb_stdout);
443}
444
445/* The "maintenance translate-address" command converts a section and address
446 to a symbol. This can be called in two ways:
c5aa993b 447 maintenance translate-address <secname> <addr>
025bb325 448 or maintenance translate-address <addr>. */
c906108c
SS
449
450static void
fba45db2 451maintenance_translate_address (char *arg, int from_tty)
c906108c
SS
452{
453 CORE_ADDR address;
714835d5 454 struct obj_section *sect;
c906108c 455 char *p;
7cbd4a93 456 struct bound_minimal_symbol sym;
c906108c
SS
457 struct objfile *objfile;
458
459 if (arg == NULL || *arg == 0)
8a3fe4f8 460 error (_("requires argument (address or section + address)"));
c906108c
SS
461
462 sect = NULL;
463 p = arg;
464
465 if (!isdigit (*p))
025bb325
MS
466 { /* See if we have a valid section name. */
467 while (*p && !isspace (*p)) /* Find end of section name. */
c906108c 468 p++;
025bb325 469 if (*p == '\000') /* End of command? */
8a3fe4f8 470 error (_("Need to specify <section-name> and <address>"));
c906108c 471 *p++ = '\000';
529480d0 472 p = skip_spaces (p);
c906108c 473
714835d5 474 ALL_OBJSECTIONS (objfile, sect)
c5aa993b 475 {
714835d5 476 if (strcmp (sect->the_bfd_section->name, arg) == 0)
c5aa993b
JM
477 break;
478 }
c906108c 479
15c99a44 480 if (!objfile)
8a3fe4f8 481 error (_("Unknown section %s."), arg);
c906108c
SS
482 }
483
484 address = parse_and_eval_address (p);
485
486 if (sect)
487 sym = lookup_minimal_symbol_by_pc_section (address, sect);
488 else
489 sym = lookup_minimal_symbol_by_pc (address);
490
7cbd4a93 491 if (sym.minsym)
c14c28ba 492 {
7cbd4a93 493 const char *symbol_name = SYMBOL_PRINT_NAME (sym.minsym);
3e43a32a 494 const char *symbol_offset
7cbd4a93 495 = pulongest (address - SYMBOL_VALUE_ADDRESS (sym.minsym));
c14c28ba 496
e27d198c 497 sect = SYMBOL_OBJ_SECTION(sym.objfile, sym.minsym);
c14c28ba
PP
498 if (sect != NULL)
499 {
500 const char *section_name;
501 const char *obj_name;
502
503 gdb_assert (sect->the_bfd_section && sect->the_bfd_section->name);
504 section_name = sect->the_bfd_section->name;
505
4262abfb
JK
506 gdb_assert (sect->objfile && objfile_name (sect->objfile));
507 obj_name = objfile_name (sect->objfile);
c14c28ba
PP
508
509 if (MULTI_OBJFILE_P ())
510 printf_filtered (_("%s + %s in section %s of %s\n"),
3e43a32a
MS
511 symbol_name, symbol_offset,
512 section_name, obj_name);
c14c28ba
PP
513 else
514 printf_filtered (_("%s + %s in section %s\n"),
515 symbol_name, symbol_offset, section_name);
516 }
517 else
518 printf_filtered (_("%s + %s\n"), symbol_name, symbol_offset);
519 }
c906108c 520 else if (sect)
5af949e3
UW
521 printf_filtered (_("no symbol at %s:%s\n"),
522 sect->the_bfd_section->name, hex_string (address));
c906108c 523 else
5af949e3 524 printf_filtered (_("no symbol at %s\n"), hex_string (address));
c906108c
SS
525
526 return;
527}
528
56382845 529
c114dcd5 530/* When a command is deprecated the user will be warned the first time
33f91161 531 the command is used. If possible, a replacement will be
025bb325 532 offered. */
56382845
FN
533
534static void
535maintenance_deprecate (char *args, int from_tty)
536{
537 if (args == NULL || *args == '\0')
538 {
cce7e648
PA
539 printf_unfiltered (_("\"maintenance deprecate\" takes an argument,\n\
540the command you want to deprecate, and optionally the replacement command\n\
a3f17187 541enclosed in quotes.\n"));
56382845 542 }
33f91161 543
56382845
FN
544 maintenance_do_deprecate (args, 1);
545
546}
547
548
549static void
550maintenance_undeprecate (char *args, int from_tty)
551{
552 if (args == NULL || *args == '\0')
553 {
a3f17187
AC
554 printf_unfiltered (_("\"maintenance undeprecate\" takes an argument, \n\
555the command you want to undeprecate.\n"));
56382845 556 }
33f91161 557
56382845 558 maintenance_do_deprecate (args, 0);
33f91161 559
56382845
FN
560}
561
025bb325 562/* You really shouldn't be using this. It is just for the testsuite.
33f91161
AC
563 Rather, you should use deprecate_cmd() when the command is created
564 in _initialize_blah().
565
566 This function deprecates a command and optionally assigns it a
567 replacement. */
568
8399535b 569static void
33f91161
AC
570maintenance_do_deprecate (char *text, int deprecate)
571{
33f91161
AC
572 struct cmd_list_element *alias = NULL;
573 struct cmd_list_element *prefix_cmd = NULL;
574 struct cmd_list_element *cmd = NULL;
575
576 char *start_ptr = NULL;
577 char *end_ptr = NULL;
56382845 578 int len;
33f91161
AC
579 char *replacement = NULL;
580
1c689132
DB
581 if (text == NULL)
582 return;
56382845 583
33f91161
AC
584 if (!lookup_cmd_composition (text, &alias, &prefix_cmd, &cmd))
585 {
a3f17187 586 printf_filtered (_("Can't find command '%s' to deprecate.\n"), text);
33f91161
AC
587 return;
588 }
56382845 589
56382845
FN
590 if (deprecate)
591 {
025bb325 592 /* Look for a replacement command. */
80ce1ecb
AC
593 start_ptr = strchr (text, '\"');
594 if (start_ptr != NULL)
33f91161
AC
595 {
596 start_ptr++;
80ce1ecb
AC
597 end_ptr = strrchr (start_ptr, '\"');
598 if (end_ptr != NULL)
33f91161
AC
599 {
600 len = end_ptr - start_ptr;
601 start_ptr[len] = '\0';
602 replacement = xstrdup (start_ptr);
603 }
604 }
56382845 605 }
33f91161 606
56382845
FN
607 if (!start_ptr || !end_ptr)
608 replacement = NULL;
33f91161
AC
609
610
56382845 611 /* If they used an alias, we only want to deprecate the alias.
33f91161 612
56382845
FN
613 Note the MALLOCED_REPLACEMENT test. If the command's replacement
614 string was allocated at compile time we don't want to free the
025bb325 615 memory. */
56382845
FN
616 if (alias)
617 {
56382845 618 if (alias->flags & MALLOCED_REPLACEMENT)
b8c9b27d 619 xfree (alias->replacement);
33f91161 620
56382845 621 if (deprecate)
33f91161 622 alias->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED);
56382845 623 else
33f91161
AC
624 alias->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED);
625 alias->replacement = replacement;
56382845
FN
626 alias->flags |= MALLOCED_REPLACEMENT;
627 return;
628 }
629 else if (cmd)
630 {
631 if (cmd->flags & MALLOCED_REPLACEMENT)
b8c9b27d 632 xfree (cmd->replacement);
56382845
FN
633
634 if (deprecate)
33f91161 635 cmd->flags |= (DEPRECATED_WARN_USER | CMD_DEPRECATED);
56382845 636 else
33f91161
AC
637 cmd->flags &= ~(DEPRECATED_WARN_USER | CMD_DEPRECATED);
638 cmd->replacement = replacement;
56382845
FN
639 cmd->flags |= MALLOCED_REPLACEMENT;
640 return;
641 }
240f9570 642 xfree (replacement);
56382845
FN
643}
644
4f337972
AC
645/* Maintenance set/show framework. */
646
ae038cb0
DJ
647struct cmd_list_element *maintenance_set_cmdlist;
648struct cmd_list_element *maintenance_show_cmdlist;
4f337972
AC
649
650static void
651maintenance_set_cmd (char *args, int from_tty)
652{
3e43a32a
MS
653 printf_unfiltered (_("\"maintenance set\" must be followed "
654 "by the name of a set command.\n"));
4f337972
AC
655 help_list (maintenance_set_cmdlist, "maintenance set ", -1, gdb_stdout);
656}
657
658static void
659maintenance_show_cmd (char *args, int from_tty)
660{
661 cmd_show_list (maintenance_show_cmdlist, from_tty, "");
662}
663
4f337972
AC
664/* Profiling support. */
665
666static int maintenance_profile_p;
920d2a44
AC
667static void
668show_maintenance_profile_p (struct ui_file *file, int from_tty,
669 struct cmd_list_element *c, const char *value)
670{
671 fprintf_filtered (file, _("Internal profiling is %s.\n"), value);
672}
d9feb4e7 673
b0b1c2c0
MK
674#ifdef HAVE__ETEXT
675extern char _etext;
676#define TEXTEND &_etext
01fe12f6 677#elif defined (HAVE_ETEXT)
b0b1c2c0
MK
678extern char etext;
679#define TEXTEND &etext
680#endif
681
01fe12f6
JB
682#if defined (HAVE_MONSTARTUP) && defined (HAVE__MCLEANUP) && defined (TEXTEND)
683
d28f9cdf
DJ
684static int profiling_state;
685
686static void
687mcleanup_wrapper (void)
688{
689 extern void _mcleanup (void);
690
691 if (profiling_state)
692 _mcleanup ();
693}
4f337972
AC
694
695static void
3e43a32a
MS
696maintenance_set_profile_cmd (char *args, int from_tty,
697 struct cmd_list_element *c)
4f337972 698{
d28f9cdf
DJ
699 if (maintenance_profile_p == profiling_state)
700 return;
701
702 profiling_state = maintenance_profile_p;
703
704 if (maintenance_profile_p)
705 {
706 static int profiling_initialized;
707
708 extern void monstartup (unsigned long, unsigned long);
d28f9cdf
DJ
709 extern int main();
710
711 if (!profiling_initialized)
712 {
713 atexit (mcleanup_wrapper);
714 profiling_initialized = 1;
715 }
716
717 /* "main" is now always the first function in the text segment, so use
718 its address for monstartup. */
b0b1c2c0 719 monstartup ((unsigned long) &main, (unsigned long) TEXTEND);
d28f9cdf
DJ
720 }
721 else
722 {
723 extern void _mcleanup (void);
b8d56208 724
d28f9cdf
DJ
725 _mcleanup ();
726 }
4f337972 727}
d9feb4e7
DJ
728#else
729static void
3e43a32a
MS
730maintenance_set_profile_cmd (char *args, int from_tty,
731 struct cmd_list_element *c)
d9feb4e7 732{
8a3fe4f8 733 error (_("Profiling support is not available on this system."));
d9feb4e7
DJ
734}
735#endif
bd712aed
DE
736\f
737/* If nonzero, display time usage both at startup and for each command. */
56382845 738
bd712aed
DE
739static int per_command_time;
740
741/* If nonzero, display space usage both at startup and for each command. */
742
743static int per_command_space;
744
745/* If nonzero, display basic symtab stats for each command. */
746
747static int per_command_symtab;
748
749/* mt per-command commands. */
750
751static struct cmd_list_element *per_command_setlist;
752static struct cmd_list_element *per_command_showlist;
753
754/* Records a run time and space usage to be used as a base for
755 reporting elapsed time or change in space. */
756
757struct cmd_stats
758{
759 /* Zero if the saved time is from the beginning of GDB execution.
760 One if from the beginning of an individual command execution. */
761 int msg_type;
762 /* Track whether the stat was enabled at the start of the command
763 so that we can avoid printing anything if it gets turned on by
764 the current command. */
765 int time_enabled : 1;
766 int space_enabled : 1;
767 int symtab_enabled : 1;
768 long start_cpu_time;
769 struct timeval start_wall_time;
770 long start_space;
771 /* Total number of symtabs (over all objfiles). */
772 int start_nr_symtabs;
773 /* Of those, a count of just the primary ones. */
774 int start_nr_primary_symtabs;
775 /* Total number of blocks. */
776 int start_nr_blocks;
777};
778
779/* Set whether to display time statistics to NEW_VALUE
780 (non-zero means true). */
781
782void
783set_per_command_time (int new_value)
784{
785 per_command_time = new_value;
786}
787
788/* Set whether to display space statistics to NEW_VALUE
789 (non-zero means true). */
790
791void
792set_per_command_space (int new_value)
793{
794 per_command_space = new_value;
795}
796
797/* Count the number of symtabs and blocks. */
798
799static void
800count_symtabs_and_blocks (int *nr_symtabs_ptr, int *nr_primary_symtabs_ptr,
801 int *nr_blocks_ptr)
802{
803 struct objfile *o;
804 struct symtab *s;
805 int nr_symtabs = 0;
806 int nr_primary_symtabs = 0;
807 int nr_blocks = 0;
808
809 ALL_SYMTABS (o, s)
810 {
811 ++nr_symtabs;
812 if (s->primary)
813 {
814 ++nr_primary_symtabs;
815 nr_blocks += BLOCKVECTOR_NBLOCKS (BLOCKVECTOR (s));
816 }
817 }
818
819 *nr_symtabs_ptr = nr_symtabs;
820 *nr_primary_symtabs_ptr = nr_primary_symtabs;
821 *nr_blocks_ptr = nr_blocks;
822}
823
824/* As indicated by display_time and display_space, report GDB's elapsed time
825 and space usage from the base time and space provided in ARG, which
826 must be a pointer to a struct cmd_stat. This function is intended
827 to be called as a cleanup. */
828
829static void
830report_command_stats (void *arg)
831{
832 struct cmd_stats *start_stats = (struct cmd_stats *) arg;
833 int msg_type = start_stats->msg_type;
834
835 if (start_stats->time_enabled)
836 {
837 long cmd_time = get_run_time () - start_stats->start_cpu_time;
838 struct timeval now_wall_time, delta_wall_time, wait_time;
839
840 gettimeofday (&now_wall_time, NULL);
841 timeval_sub (&delta_wall_time,
842 &now_wall_time, &start_stats->start_wall_time);
843
844 /* Subtract time spend in prompt_for_continue from walltime. */
845 wait_time = get_prompt_for_continue_wait_time ();
846 timeval_sub (&delta_wall_time, &delta_wall_time, &wait_time);
847
848 printf_unfiltered (msg_type == 0
849 ? _("Startup time: %ld.%06ld (cpu), %ld.%06ld (wall)\n")
850 : _("Command execution time: %ld.%06ld (cpu), %ld.%06ld (wall)\n"),
851 cmd_time / 1000000, cmd_time % 1000000,
852 (long) delta_wall_time.tv_sec,
853 (long) delta_wall_time.tv_usec);
854 }
855
856 if (start_stats->space_enabled)
857 {
858#ifdef HAVE_SBRK
859 char *lim = (char *) sbrk (0);
860
861 long space_now = lim - lim_at_start;
862 long space_diff = space_now - start_stats->start_space;
863
864 printf_unfiltered (msg_type == 0
865 ? _("Space used: %ld (%s%ld during startup)\n")
866 : _("Space used: %ld (%s%ld for this command)\n"),
867 space_now,
868 (space_diff >= 0 ? "+" : ""),
869 space_diff);
870#endif
871 }
872
873 if (start_stats->symtab_enabled)
874 {
875 int nr_symtabs, nr_primary_symtabs, nr_blocks;
876
877 count_symtabs_and_blocks (&nr_symtabs, &nr_primary_symtabs, &nr_blocks);
878 printf_unfiltered (_("#symtabs: %d (+%d),"
879 " #primary symtabs: %d (+%d),"
880 " #blocks: %d (+%d)\n"),
881 nr_symtabs,
882 nr_symtabs - start_stats->start_nr_symtabs,
883 nr_primary_symtabs,
884 nr_primary_symtabs - start_stats->start_nr_primary_symtabs,
885 nr_blocks,
886 nr_blocks - start_stats->start_nr_blocks);
887 }
888}
889
890/* Create a cleanup that reports time and space used since its creation.
891 MSG_TYPE is zero for gdb startup, otherwise it is one(1) to report
892 data for individual commands. */
893
894struct cleanup *
895make_command_stats_cleanup (int msg_type)
896{
897 struct cmd_stats *new_stat;
898
899 /* Early exit if we're not reporting any stats. */
900 if (!per_command_time
901 && !per_command_space
902 && !per_command_symtab)
903 return make_cleanup (null_cleanup, 0);
904
905 new_stat = XZALLOC (struct cmd_stats);
906
907 new_stat->msg_type = msg_type;
908
909 if (per_command_space)
910 {
911#ifdef HAVE_SBRK
912 char *lim = (char *) sbrk (0);
913 new_stat->start_space = lim - lim_at_start;
914 new_stat->space_enabled = 1;
915#endif
916 }
917
918 if (per_command_time)
919 {
920 new_stat->start_cpu_time = get_run_time ();
921 gettimeofday (&new_stat->start_wall_time, NULL);
922 new_stat->time_enabled = 1;
923 }
924
925 if (per_command_symtab)
926 {
927 int nr_symtabs, nr_primary_symtabs, nr_blocks;
928
929 count_symtabs_and_blocks (&nr_symtabs, &nr_primary_symtabs, &nr_blocks);
930 new_stat->start_nr_symtabs = nr_symtabs;
931 new_stat->start_nr_primary_symtabs = nr_primary_symtabs;
932 new_stat->start_nr_blocks = nr_blocks;
933 new_stat->symtab_enabled = 1;
934 }
935
936 /* Initalize timer to keep track of how long we waited for the user. */
937 reset_prompt_for_continue_wait_time ();
938
939 return make_cleanup_dtor (report_command_stats, new_stat, xfree);
940}
941
942/* Handle unknown "mt set per-command" arguments.
943 In this case have "mt set per-command on|off" affect every setting. */
944
945static void
946set_per_command_cmd (char *args, int from_tty)
947{
948 struct cmd_list_element *list;
949 size_t length;
950 int val;
951
952 val = parse_cli_boolean_value (args);
953 if (val < 0)
954 error (_("Bad value for 'mt set per-command no'."));
955
956 for (list = per_command_setlist; list != NULL; list = list->next)
957 if (list->var_type == var_boolean)
958 {
959 gdb_assert (list->type == set_cmd);
960 do_set_command (args, from_tty, list);
961 }
962}
963
964/* Command "show per-command" displays summary of all the current
965 "show per-command " settings. */
966
967static void
968show_per_command_cmd (char *args, int from_tty)
969{
970 cmd_show_list (per_command_showlist, from_tty, "");
971}
972\f
c906108c 973void
fba45db2 974_initialize_maint_cmds (void)
c906108c 975{
1bedd215
AC
976 add_prefix_cmd ("maintenance", class_maintenance, maintenance_command, _("\
977Commands for use by GDB maintainers.\n\
c906108c
SS
978Includes commands to dump specific internal GDB structures in\n\
979a human readable form, to cause GDB to deliberately dump core,\n\
1bedd215 980to test internal functions such as the C++/ObjC demangler, etc."),
c906108c
SS
981 &maintenancelist, "maintenance ", 0,
982 &cmdlist);
983
984 add_com_alias ("mt", "maintenance", class_maintenance, 1);
985
1bedd215
AC
986 add_prefix_cmd ("info", class_maintenance, maintenance_info_command, _("\
987Commands for showing internal info about the program being debugged."),
c906108c
SS
988 &maintenanceinfolist, "maintenance info ", 0,
989 &maintenancelist);
90515c23 990 add_alias_cmd ("i", "info", class_maintenance, 1, &maintenancelist);
c906108c 991
1a966eab
AC
992 add_cmd ("sections", class_maintenance, maintenance_info_sections, _("\
993List the BFD sections of the exec and core files. \n\
e3d3bfda
MS
994Arguments may be any combination of:\n\
995 [one or more section names]\n\
996 ALLOC LOAD RELOC READONLY CODE DATA ROM CONSTRUCTOR\n\
997 HAS_CONTENTS NEVER_LOAD COFF_SHARED_LIBRARY IS_COMMON\n\
998Sections matching any argument will be listed (no argument\n\
999implies all sections). In addition, the special argument\n\
1000 ALLOBJ\n\
1a966eab 1001lists all sections from all object files, including shared libraries."),
c906108c
SS
1002 &maintenanceinfolist);
1003
1004 add_prefix_cmd ("print", class_maintenance, maintenance_print_command,
1bedd215 1005 _("Maintenance command for printing GDB internal state."),
c906108c
SS
1006 &maintenanceprintlist, "maintenance print ", 0,
1007 &maintenancelist);
1008
1bedd215 1009 add_prefix_cmd ("set", class_maintenance, maintenance_set_cmd, _("\
4f337972 1010Set GDB internal variables used by the GDB maintainer.\n\
1bedd215 1011Configure variables internal to GDB that aid in GDB's maintenance"),
4f337972
AC
1012 &maintenance_set_cmdlist, "maintenance set ",
1013 0/*allow-unknown*/,
1014 &maintenancelist);
1015
1bedd215 1016 add_prefix_cmd ("show", class_maintenance, maintenance_show_cmd, _("\
4f337972 1017Show GDB internal variables used by the GDB maintainer.\n\
1bedd215 1018Configure variables internal to GDB that aid in GDB's maintenance"),
4f337972
AC
1019 &maintenance_show_cmdlist, "maintenance show ",
1020 0/*allow-unknown*/,
1021 &maintenancelist);
1022
c906108c 1023#ifndef _WIN32
1a966eab
AC
1024 add_cmd ("dump-me", class_maintenance, maintenance_dump_me, _("\
1025Get fatal error; make debugger dump its core.\n\
8308e54c 1026GDB sets its handling of SIGQUIT back to SIG_DFL and then sends\n\
1a966eab 1027itself a SIGQUIT signal."),
c906108c
SS
1028 &maintenancelist);
1029#endif
1030
1a966eab
AC
1031 add_cmd ("internal-error", class_maintenance,
1032 maintenance_internal_error, _("\
1033Give GDB an internal error.\n\
1034Cause GDB to behave as if an internal error was detected."),
7be570e7
JM
1035 &maintenancelist);
1036
1a966eab
AC
1037 add_cmd ("internal-warning", class_maintenance,
1038 maintenance_internal_warning, _("\
1039Give GDB an internal warning.\n\
1040Cause GDB to behave as if an internal warning was reported."),
dec43320
AC
1041 &maintenancelist);
1042
1a966eab
AC
1043 add_cmd ("demangle", class_maintenance, maintenance_demangle, _("\
1044Demangle a C++/ObjC mangled name.\n\
c906108c 1045Call internal GDB demangler routine to demangle a C++ link name\n\
1a966eab 1046and prints the result."),
c906108c
SS
1047 &maintenancelist);
1048
bd712aed
DE
1049 add_prefix_cmd ("per-command", class_maintenance, set_per_command_cmd, _("\
1050Per-command statistics settings."),
1051 &per_command_setlist, "set per-command ",
1052 1/*allow-unknown*/, &maintenance_set_cmdlist);
1053
1054 add_prefix_cmd ("per-command", class_maintenance, show_per_command_cmd, _("\
1055Show per-command statistics settings."),
1056 &per_command_showlist, "show per-command ",
1057 0/*allow-unknown*/, &maintenance_show_cmdlist);
1058
1059 add_setshow_boolean_cmd ("time", class_maintenance,
1060 &per_command_time, _("\
1061Set whether to display per-command execution time."), _("\
1062Show whether to display per-command execution time."),
1063 _("\
1064If enabled, the execution time for each command will be\n\
1065displayed following the command's output."),
1066 NULL, NULL,
1067 &per_command_setlist, &per_command_showlist);
1068
1069 add_setshow_boolean_cmd ("space", class_maintenance,
1070 &per_command_space, _("\
1071Set whether to display per-command space usage."), _("\
1072Show whether to display per-command space usage."),
1073 _("\
1074If enabled, the space usage for each command will be\n\
1075displayed following the command's output."),
1076 NULL, NULL,
1077 &per_command_setlist, &per_command_showlist);
1078
1079 add_setshow_boolean_cmd ("symtab", class_maintenance,
1080 &per_command_symtab, _("\
1081Set whether to display per-command symtab statistics."), _("\
1082Show whether to display per-command symtab statistics."),
1083 _("\
1084If enabled, the basic symtab statistics for each command will be\n\
1085displayed following the command's output."),
1086 NULL, NULL,
1087 &per_command_setlist, &per_command_showlist);
1088
1089 /* This is equivalent to "mt set per-command time on".
1090 Kept because some people are used to typing "mt time 1". */
1a966eab
AC
1091 add_cmd ("time", class_maintenance, maintenance_time_display, _("\
1092Set the display of time usage.\n\
c906108c 1093If nonzero, will cause the execution time for each command to be\n\
1a966eab 1094displayed, following the command's output."),
c906108c
SS
1095 &maintenancelist);
1096
bd712aed
DE
1097 /* This is equivalent to "mt set per-command space on".
1098 Kept because some people are used to typing "mt space 1". */
1a966eab
AC
1099 add_cmd ("space", class_maintenance, maintenance_space_display, _("\
1100Set the display of space usage.\n\
c906108c 1101If nonzero, will cause the execution space for each command to be\n\
1a966eab 1102displayed, following the command's output."),
c906108c
SS
1103 &maintenancelist);
1104
1a966eab
AC
1105 add_cmd ("type", class_maintenance, maintenance_print_type, _("\
1106Print a type chain for a given symbol.\n\
c906108c 1107For each node in a type chain, print the raw data for each member of\n\
1a966eab 1108the type structure, and the interpretation of the data."),
c906108c
SS
1109 &maintenanceprintlist);
1110
c906108c 1111 add_cmd ("statistics", class_maintenance, maintenance_print_statistics,
1a966eab 1112 _("Print statistics about internal gdb state."),
c906108c
SS
1113 &maintenanceprintlist);
1114
1a966eab
AC
1115 add_cmd ("architecture", class_maintenance,
1116 maintenance_print_architecture, _("\
1117Print the internal architecture configuration.\n\
1118Takes an optional file parameter."),
4b9b3959
AC
1119 &maintenanceprintlist);
1120
3e43a32a
MS
1121 add_cmd ("translate-address", class_maintenance,
1122 maintenance_translate_address,
1a966eab 1123 _("Translate a section name and address to a symbol."),
c906108c
SS
1124 &maintenancelist);
1125
1a966eab
AC
1126 add_cmd ("deprecate", class_maintenance, maintenance_deprecate, _("\
1127Deprecate a command. Note that this is just in here so the \n\
ef4cb050 1128testsuite can check the command deprecator. You probably shouldn't use this,\n\
56382845 1129rather you should use the C function deprecate_cmd(). If you decide you \n\
6f122dc9 1130want to use it: maintenance deprecate 'commandname' \"replacement\". The \n\
1a966eab 1131replacement is optional."), &maintenancelist);
56382845 1132
1a966eab
AC
1133 add_cmd ("undeprecate", class_maintenance, maintenance_undeprecate, _("\
1134Undeprecate a command. Note that this is just in here so the \n\
ef4cb050 1135testsuite can check the command deprecator. You probably shouldn't use this,\n\
1a966eab 1136If you decide you want to use it: maintenance undeprecate 'commandname'"),
33f91161 1137 &maintenancelist);
56382845 1138
85c07804
AC
1139 add_setshow_zinteger_cmd ("watchdog", class_maintenance, &watchdog, _("\
1140Set watchdog timer."), _("\
1141Show watchdog timer."), _("\
cb1a6d5f
AC
1142When non-zero, this timeout is used instead of waiting forever for a target\n\
1143to finish a low-level step or continue operation. If the specified amount\n\
85c07804
AC
1144of time passes without a response from the target, an error occurs."),
1145 NULL,
920d2a44 1146 show_watchdog,
85c07804 1147 &setlist, &showlist);
4f337972 1148
d28f9cdf 1149 add_setshow_boolean_cmd ("profile", class_maintenance,
7915a72c
AC
1150 &maintenance_profile_p, _("\
1151Set internal profiling."), _("\
1152Show internal profiling."), _("\
1153When enabled GDB is profiled."),
2c5b56ce 1154 maintenance_set_profile_cmd,
920d2a44 1155 show_maintenance_profile_p,
d28f9cdf
DJ
1156 &maintenance_set_cmdlist,
1157 &maintenance_show_cmdlist);
c906108c 1158}