1 /* Print values for GNU debugger GDB.
3 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
5 2008 Free Software Foundation, Inc.
7 This file is part of GDB.
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
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
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.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 #include "gdb_string.h"
29 #include "expression.h"
33 #include "breakpoint.h"
37 #include "symfile.h" /* for overlay functions */
38 #include "objfiles.h" /* ditto */
39 #include "completer.h" /* for completion functions */
41 #include "gdb_assert.h"
47 #include "tui/tui.h" /* For tui_active et.al. */
50 #if defined(__MINGW32__)
51 # define USE_PRINTF_I64 1
52 # define PRINTF_HAS_LONG_LONG
54 # define USE_PRINTF_I64 0
57 extern int asm_demangle; /* Whether to demangle syms in asm printouts */
58 extern int addressprint; /* Whether to print hex addresses in HLL " */
67 /* Last specified output format. */
69 static char last_format = 'x';
71 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
73 static char last_size = 'w';
75 /* Default address to examine next. */
77 static CORE_ADDR next_address;
79 /* Number of delay instructions following current disassembled insn. */
81 static int branch_delay_insns;
83 /* Last address examined. */
85 static CORE_ADDR last_examine_address;
87 /* Contents of last address examined.
88 This is not valid past the end of the `x' command! */
90 static struct value *last_examine_value;
92 /* Largest offset between a symbolic value and an address, that will be
93 printed as `0x1234 <symbol+offset>'. */
95 static unsigned int max_symbolic_offset = UINT_MAX;
97 show_max_symbolic_offset (struct ui_file *file, int from_tty,
98 struct cmd_list_element *c, const char *value)
100 fprintf_filtered (file, _("\
101 The largest offset that will be printed in <symbol+1234> form is %s.\n"),
105 /* Append the source filename and linenumber of the symbol when
106 printing a symbolic value as `<symbol at filename:linenum>' if set. */
107 static int print_symbol_filename = 0;
109 show_print_symbol_filename (struct ui_file *file, int from_tty,
110 struct cmd_list_element *c, const char *value)
112 fprintf_filtered (file, _("\
113 Printing of source filename and line number with <symbol> is %s.\n"),
117 /* Number of auto-display expression currently being displayed.
118 So that we can disable it if we get an error or a signal within it.
119 -1 when not doing one. */
121 int current_display_number;
123 /* Flag to low-level print routines that this value is being printed
124 in an epoch window. We'd like to pass this as a parameter, but
125 every routine would need to take it. Perhaps we can encapsulate
126 this in the I/O stream once we have GNU stdio. */
132 /* Chain link to next auto-display item. */
133 struct display *next;
134 /* Expression to be evaluated and displayed. */
135 struct expression *exp;
136 /* Item number of this auto-display item. */
138 /* Display format specified. */
139 struct format_data format;
140 /* Innermost block required by this expression when evaluated */
142 /* Status of this display (enabled or disabled) */
146 /* Chain of expressions whose values should be displayed
147 automatically each time the program stops. */
149 static struct display *display_chain;
151 static int display_number;
153 /* Prototypes for exported functions. */
155 void output_command (char *, int);
157 void _initialize_printcmd (void);
159 /* Prototypes for local functions. */
161 static void do_one_display (struct display *);
164 /* Decode a format specification. *STRING_PTR should point to it.
165 OFORMAT and OSIZE are used as defaults for the format and size
166 if none are given in the format specification.
167 If OSIZE is zero, then the size field of the returned value
168 should be set only if a size is explicitly specified by the
170 The structure returned describes all the data
171 found in the specification. In addition, *STRING_PTR is advanced
172 past the specification and past all whitespace following it. */
174 static struct format_data
175 decode_format (char **string_ptr, int oformat, int osize)
177 struct format_data val;
178 char *p = *string_ptr;
184 if (*p >= '0' && *p <= '9')
185 val.count = atoi (p);
186 while (*p >= '0' && *p <= '9')
189 /* Now process size or format letters that follow. */
193 if (*p == 'b' || *p == 'h' || *p == 'w' || *p == 'g')
195 else if (*p >= 'a' && *p <= 'z')
201 while (*p == ' ' || *p == '\t')
205 /* Set defaults for format and size if not specified. */
206 if (val.format == '?')
210 /* Neither has been specified. */
211 val.format = oformat;
215 /* If a size is specified, any format makes a reasonable
216 default except 'i'. */
217 val.format = oformat == 'i' ? 'x' : oformat;
219 else if (val.size == '?')
224 /* Pick the appropriate size for an address. */
225 if (gdbarch_ptr_bit (current_gdbarch) == 64)
226 val.size = osize ? 'g' : osize;
227 else if (gdbarch_ptr_bit (current_gdbarch) == 32)
228 val.size = osize ? 'w' : osize;
229 else if (gdbarch_ptr_bit (current_gdbarch) == 16)
230 val.size = osize ? 'h' : osize;
232 /* Bad value for gdbarch_ptr_bit. */
233 internal_error (__FILE__, __LINE__,
234 _("failed internal consistency check"));
237 /* Floating point has to be word or giantword. */
238 if (osize == 'w' || osize == 'g')
241 /* Default it to giantword if the last used size is not
243 val.size = osize ? 'g' : osize;
246 /* Characters default to one byte. */
247 val.size = osize ? 'b' : osize;
250 /* The default is the size most recently specified. */
257 /* Print value VAL on stream according to FORMAT, a letter or 0.
258 Do not end with a newline.
259 0 means print VAL according to its own type.
260 SIZE is the letter for the size of datum being printed.
261 This is used to pad hex numbers so they line up. SIZE is 0
262 for print / output and set for examine. */
265 print_formatted (struct value *val, int format, int size,
266 struct ui_file *stream)
268 struct type *type = check_typedef (value_type (val));
269 int len = TYPE_LENGTH (type);
271 if (VALUE_LVAL (val) == lval_memory)
272 next_address = VALUE_ADDRESS (val) + len;
279 /* FIXME: Need to handle wchar_t's here... */
280 next_address = VALUE_ADDRESS (val)
281 + val_print_string (VALUE_ADDRESS (val), -1, 1, stream);
285 /* We often wrap here if there are long symbolic names. */
287 next_address = (VALUE_ADDRESS (val)
288 + gdb_print_insn (VALUE_ADDRESS (val), stream,
289 &branch_delay_insns));
294 if (format == 0 || format == 's'
295 || TYPE_CODE (type) == TYPE_CODE_REF
296 || TYPE_CODE (type) == TYPE_CODE_ARRAY
297 || TYPE_CODE (type) == TYPE_CODE_STRING
298 || TYPE_CODE (type) == TYPE_CODE_STRUCT
299 || TYPE_CODE (type) == TYPE_CODE_UNION
300 || TYPE_CODE (type) == TYPE_CODE_NAMESPACE)
301 /* If format is 0, use the 'natural' format for that type of
302 value. If the type is non-scalar, we have to use language
303 rules to print it as a series of scalars. */
304 value_print (val, stream, format, Val_pretty_default);
306 /* User specified format, so don't look to the the type to
307 tell us what to do. */
308 print_scalar_formatted (value_contents (val), type,
309 format, size, stream);
312 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
313 according to letters FORMAT and SIZE on STREAM.
314 FORMAT may not be zero. Formats s and i are not supported at this level.
316 This is how the elements of an array or structure are printed
320 print_scalar_formatted (const void *valaddr, struct type *type,
321 int format, int size, struct ui_file *stream)
323 LONGEST val_long = 0;
324 unsigned int len = TYPE_LENGTH (type);
325 enum bfd_endian byte_order = gdbarch_byte_order (current_gdbarch);
327 /* If we get here with a string format, try again without it. Go
328 all the way back to the language printers, which may call us
332 val_print (type, valaddr, 0, 0, stream, 0, 0, 0, Val_pretty_default,
337 if (len > sizeof(LONGEST) &&
338 (TYPE_CODE (type) == TYPE_CODE_INT
339 || TYPE_CODE (type) == TYPE_CODE_ENUM))
344 print_octal_chars (stream, valaddr, len, byte_order);
348 print_decimal_chars (stream, valaddr, len, byte_order);
351 print_binary_chars (stream, valaddr, len, byte_order);
354 print_hex_chars (stream, valaddr, len, byte_order);
357 print_char_chars (stream, valaddr, len, byte_order);
365 val_long = unpack_long (type, valaddr);
367 /* If the value is a pointer, and pointers and addresses are not the
368 same, then at this point, the value's length (in target bytes) is
369 gdbarch_addr_bit/TARGET_CHAR_BIT, not TYPE_LENGTH (type). */
370 if (TYPE_CODE (type) == TYPE_CODE_PTR)
371 len = gdbarch_addr_bit (current_gdbarch) / TARGET_CHAR_BIT;
373 /* If we are printing it as unsigned, truncate it in case it is actually
374 a negative signed value (e.g. "print/u (short)-1" should print 65535
375 (if shorts are 16 bits) instead of 4294967295). */
378 if (len < sizeof (LONGEST))
379 val_long &= ((LONGEST) 1 << HOST_CHAR_BIT * len) - 1;
387 /* No size specified, like in print. Print varying # of digits. */
388 print_longest (stream, 'x', 1, val_long);
397 print_longest (stream, size, 1, val_long);
400 error (_("Undefined output size \"%c\"."), size);
405 print_longest (stream, 'd', 1, val_long);
409 print_longest (stream, 'u', 0, val_long);
414 print_longest (stream, 'o', 1, val_long);
416 fprintf_filtered (stream, "0");
421 CORE_ADDR addr = unpack_pointer (type, valaddr);
422 print_address (addr, stream);
427 if (TYPE_UNSIGNED (type))
431 utype = builtin_type (current_gdbarch)->builtin_true_unsigned_char;
432 value_print (value_from_longest (utype, val_long),
433 stream, 0, Val_pretty_default);
436 value_print (value_from_longest (builtin_type_true_char, val_long),
437 stream, 0, Val_pretty_default);
441 if (len == TYPE_LENGTH (builtin_type_float))
442 type = builtin_type_float;
443 else if (len == TYPE_LENGTH (builtin_type_double))
444 type = builtin_type_double;
445 else if (len == TYPE_LENGTH (builtin_type_long_double))
446 type = builtin_type_long_double;
447 print_floating (valaddr, type, stream);
451 internal_error (__FILE__, __LINE__,
452 _("failed internal consistency check"));
455 /* Binary; 't' stands for "two". */
457 char bits[8 * (sizeof val_long) + 1];
458 char buf[8 * (sizeof val_long) + 32];
463 width = 8 * (sizeof val_long);
480 error (_("Undefined output size \"%c\"."), size);
486 bits[width] = (val_long & 1) ? '1' : '0';
491 while (*cp && *cp == '0')
497 fputs_filtered (buf, stream);
502 error (_("Undefined output format \"%c\"."), format);
506 /* Specify default address for `x' command.
507 The `info lines' command uses this. */
510 set_next_address (CORE_ADDR addr)
514 /* Make address available to the user as $_. */
515 set_internalvar (lookup_internalvar ("_"),
516 value_from_pointer (lookup_pointer_type (builtin_type_void),
520 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
521 after LEADIN. Print nothing if no symbolic name is found nearby.
522 Optionally also print source file and line number, if available.
523 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
524 or to interpret it as a possible C++ name and convert it back to source
525 form. However note that DO_DEMANGLE can be overridden by the specific
526 settings of the demangle and asm_demangle variables. */
529 print_address_symbolic (CORE_ADDR addr, struct ui_file *stream,
530 int do_demangle, char *leadin)
533 char *filename = NULL;
538 /* Throw away both name and filename. */
539 struct cleanup *cleanup_chain = make_cleanup (free_current_contents, &name);
540 make_cleanup (free_current_contents, &filename);
542 if (build_address_symbolic (addr, do_demangle, &name, &offset,
543 &filename, &line, &unmapped))
545 do_cleanups (cleanup_chain);
549 fputs_filtered (leadin, stream);
551 fputs_filtered ("<*", stream);
553 fputs_filtered ("<", stream);
554 fputs_filtered (name, stream);
556 fprintf_filtered (stream, "+%u", (unsigned int) offset);
558 /* Append source filename and line number if desired. Give specific
559 line # of this addr, if we have it; else line # of the nearest symbol. */
560 if (print_symbol_filename && filename != NULL)
563 fprintf_filtered (stream, " at %s:%d", filename, line);
565 fprintf_filtered (stream, " in %s", filename);
568 fputs_filtered ("*>", stream);
570 fputs_filtered (">", stream);
572 do_cleanups (cleanup_chain);
575 /* Given an address ADDR return all the elements needed to print the
576 address in a symbolic form. NAME can be mangled or not depending
577 on DO_DEMANGLE (and also on the asm_demangle global variable,
578 manipulated via ''set print asm-demangle''). Return 0 in case of
579 success, when all the info in the OUT paramters is valid. Return 1
582 build_address_symbolic (CORE_ADDR addr, /* IN */
583 int do_demangle, /* IN */
584 char **name, /* OUT */
585 int *offset, /* OUT */
586 char **filename, /* OUT */
588 int *unmapped) /* OUT */
590 struct minimal_symbol *msymbol;
591 struct symbol *symbol;
592 CORE_ADDR name_location = 0;
593 asection *section = 0;
594 char *name_temp = "";
596 /* Let's say it is unmapped. */
599 /* Determine if the address is in an overlay, and whether it is
601 if (overlay_debugging)
603 section = find_pc_overlay (addr);
604 if (pc_in_unmapped_range (addr, section))
607 addr = overlay_mapped_address (addr, section);
611 /* First try to find the address in the symbol table, then
612 in the minsyms. Take the closest one. */
614 /* This is defective in the sense that it only finds text symbols. So
615 really this is kind of pointless--we should make sure that the
616 minimal symbols have everything we need (by changing that we could
617 save some memory, but for many debug format--ELF/DWARF or
618 anything/stabs--it would be inconvenient to eliminate those minimal
620 msymbol = lookup_minimal_symbol_by_pc_section (addr, section);
621 symbol = find_pc_sect_function (addr, section);
625 name_location = BLOCK_START (SYMBOL_BLOCK_VALUE (symbol));
626 if (do_demangle || asm_demangle)
627 name_temp = SYMBOL_PRINT_NAME (symbol);
629 name_temp = DEPRECATED_SYMBOL_NAME (symbol);
634 if (SYMBOL_VALUE_ADDRESS (msymbol) > name_location || symbol == NULL)
636 /* The msymbol is closer to the address than the symbol;
637 use the msymbol instead. */
639 name_location = SYMBOL_VALUE_ADDRESS (msymbol);
640 if (do_demangle || asm_demangle)
641 name_temp = SYMBOL_PRINT_NAME (msymbol);
643 name_temp = DEPRECATED_SYMBOL_NAME (msymbol);
646 if (symbol == NULL && msymbol == NULL)
649 /* If the nearest symbol is too far away, don't print anything symbolic. */
651 /* For when CORE_ADDR is larger than unsigned int, we do math in
652 CORE_ADDR. But when we detect unsigned wraparound in the
653 CORE_ADDR math, we ignore this test and print the offset,
654 because addr+max_symbolic_offset has wrapped through the end
655 of the address space back to the beginning, giving bogus comparison. */
656 if (addr > name_location + max_symbolic_offset
657 && name_location + max_symbolic_offset > name_location)
660 *offset = addr - name_location;
662 *name = xstrdup (name_temp);
664 if (print_symbol_filename)
666 struct symtab_and_line sal;
668 sal = find_pc_sect_line (addr, section, 0);
672 *filename = xstrdup (sal.symtab->filename);
679 /* Print address ADDR on STREAM. USE_LOCAL means the same thing as for
682 deprecated_print_address_numeric (CORE_ADDR addr, int use_local,
683 struct ui_file *stream)
686 fputs_filtered (paddress (addr), stream);
689 int addr_bit = gdbarch_addr_bit (current_gdbarch);
691 if (addr_bit < (sizeof (CORE_ADDR) * HOST_CHAR_BIT))
692 addr &= ((CORE_ADDR) 1 << addr_bit) - 1;
693 print_longest (stream, 'x', 0, (ULONGEST) addr);
697 /* Print address ADDR symbolically on STREAM.
698 First print it as a number. Then perhaps print
699 <SYMBOL + OFFSET> after the number. */
702 print_address (CORE_ADDR addr, struct ui_file *stream)
704 fputs_filtered (paddress (addr), stream);
705 print_address_symbolic (addr, stream, asm_demangle, " ");
708 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
709 controls whether to print the symbolic name "raw" or demangled.
710 Global setting "addressprint" controls whether to print hex address
714 print_address_demangle (CORE_ADDR addr, struct ui_file *stream,
719 fprintf_filtered (stream, "0");
721 else if (addressprint)
723 fputs_filtered (paddress (addr), stream);
724 print_address_symbolic (addr, stream, do_demangle, " ");
728 print_address_symbolic (addr, stream, do_demangle, "");
733 /* These are the types that $__ will get after an examine command of one
736 static struct type *examine_i_type;
738 static struct type *examine_b_type;
739 static struct type *examine_h_type;
740 static struct type *examine_w_type;
741 static struct type *examine_g_type;
743 /* Examine data at address ADDR in format FMT.
744 Fetch it from memory and print on gdb_stdout. */
747 do_examine (struct format_data fmt, CORE_ADDR addr)
752 struct type *val_type = NULL;
761 /* String or instruction format implies fetch single bytes
762 regardless of the specified size. */
763 if (format == 's' || format == 'i')
767 val_type = examine_i_type;
768 else if (size == 'b')
769 val_type = examine_b_type;
770 else if (size == 'h')
771 val_type = examine_h_type;
772 else if (size == 'w')
773 val_type = examine_w_type;
774 else if (size == 'g')
775 val_type = examine_g_type;
782 if (format == 's' || format == 'i')
785 /* Print as many objects as specified in COUNT, at most maxelts per line,
786 with the address of the next one at the start of each line. */
791 print_address (next_address, gdb_stdout);
792 printf_filtered (":");
797 printf_filtered ("\t");
798 /* Note that print_formatted sets next_address for the next
800 last_examine_address = next_address;
802 if (last_examine_value)
803 value_free (last_examine_value);
805 /* The value to be displayed is not fetched greedily.
806 Instead, to avoid the possibility of a fetched value not
807 being used, its retrieval is delayed until the print code
808 uses it. When examining an instruction stream, the
809 disassembler will perform its own memory fetch using just
810 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
811 the disassembler be modified so that LAST_EXAMINE_VALUE
812 is left with the byte sequence from the last complete
813 instruction fetched from memory? */
814 last_examine_value = value_at_lazy (val_type, next_address);
816 if (last_examine_value)
817 release_value (last_examine_value);
819 print_formatted (last_examine_value, format, size, gdb_stdout);
821 /* Display any branch delay slots following the final insn. */
822 if (format == 'i' && count == 1)
823 count += branch_delay_insns;
825 printf_filtered ("\n");
826 gdb_flush (gdb_stdout);
831 validate_format (struct format_data fmt, char *cmdname)
834 error (_("Size letters are meaningless in \"%s\" command."), cmdname);
836 error (_("Item count other than 1 is meaningless in \"%s\" command."),
838 if (fmt.format == 'i')
839 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
840 fmt.format, cmdname);
843 /* Evaluate string EXP as an expression in the current language and
844 print the resulting value. EXP may contain a format specifier as the
845 first argument ("/x myvar" for example, to print myvar in hex). */
848 print_command_1 (char *exp, int inspect, int voidprint)
850 struct expression *expr;
851 struct cleanup *old_chain = 0;
854 struct format_data fmt;
857 /* Pass inspect flag to the rest of the print routines in a global
859 inspect_it = inspect;
861 if (exp && *exp == '/')
864 fmt = decode_format (&exp, last_format, 0);
865 validate_format (fmt, "print");
866 last_format = format = fmt.format;
878 expr = parse_expression (exp);
879 old_chain = make_cleanup (free_current_contents, &expr);
881 val = evaluate_expression (expr);
884 val = access_value_history (0);
886 if (voidprint || (val && value_type (val) &&
887 TYPE_CODE (value_type (val)) != TYPE_CODE_VOID))
889 int histindex = record_latest_value (val);
892 annotate_value_history_begin (histindex, value_type (val));
894 annotate_value_begin (value_type (val));
897 printf_unfiltered ("\031(gdb-makebuffer \"%s\" %d '(\"",
899 else if (histindex >= 0)
900 printf_filtered ("$%d = ", histindex);
903 annotate_value_history_value ();
905 print_formatted (val, format, fmt.size, gdb_stdout);
906 printf_filtered ("\n");
909 annotate_value_history_end ();
911 annotate_value_end ();
914 printf_unfiltered ("\") )\030");
918 do_cleanups (old_chain);
919 inspect_it = 0; /* Reset print routines to normal. */
923 print_command (char *exp, int from_tty)
925 print_command_1 (exp, 0, 1);
928 /* Same as print, except in epoch, it gets its own window. */
930 inspect_command (char *exp, int from_tty)
932 extern int epoch_interface;
934 print_command_1 (exp, epoch_interface, 1);
937 /* Same as print, except it doesn't print void results. */
939 call_command (char *exp, int from_tty)
941 print_command_1 (exp, 0, 0);
945 output_command (char *exp, int from_tty)
947 struct expression *expr;
948 struct cleanup *old_chain;
951 struct format_data fmt;
955 if (exp && *exp == '/')
958 fmt = decode_format (&exp, 0, 0);
959 validate_format (fmt, "output");
963 expr = parse_expression (exp);
964 old_chain = make_cleanup (free_current_contents, &expr);
966 val = evaluate_expression (expr);
968 annotate_value_begin (value_type (val));
970 print_formatted (val, format, fmt.size, gdb_stdout);
972 annotate_value_end ();
975 gdb_flush (gdb_stdout);
977 do_cleanups (old_chain);
981 set_command (char *exp, int from_tty)
983 struct expression *expr = parse_expression (exp);
984 struct cleanup *old_chain =
985 make_cleanup (free_current_contents, &expr);
986 evaluate_expression (expr);
987 do_cleanups (old_chain);
991 sym_info (char *arg, int from_tty)
993 struct minimal_symbol *msymbol;
994 struct objfile *objfile;
995 struct obj_section *osect;
997 CORE_ADDR addr, sect_addr;
1002 error_no_arg (_("address"));
1004 addr = parse_and_eval_address (arg);
1005 ALL_OBJSECTIONS (objfile, osect)
1007 /* Only process each object file once, even if there's a separate
1009 if (objfile->separate_debug_objfile_backlink)
1012 sect = osect->the_bfd_section;
1013 sect_addr = overlay_mapped_address (addr, sect);
1015 if (osect->addr <= sect_addr && sect_addr < osect->endaddr &&
1016 (msymbol = lookup_minimal_symbol_by_pc_section (sect_addr, sect)))
1019 offset = sect_addr - SYMBOL_VALUE_ADDRESS (msymbol);
1021 printf_filtered ("%s + %u in ",
1022 SYMBOL_PRINT_NAME (msymbol), offset);
1024 printf_filtered ("%s in ",
1025 SYMBOL_PRINT_NAME (msymbol));
1026 if (pc_in_unmapped_range (addr, sect))
1027 printf_filtered (_("load address range of "));
1028 if (section_is_overlay (sect))
1029 printf_filtered (_("%s overlay "),
1030 section_is_mapped (sect) ? "mapped" : "unmapped");
1031 printf_filtered (_("section %s"), sect->name);
1032 printf_filtered ("\n");
1036 printf_filtered (_("No symbol matches %s.\n"), arg);
1040 address_info (char *exp, int from_tty)
1043 struct minimal_symbol *msymbol;
1046 CORE_ADDR load_addr;
1047 int is_a_field_of_this; /* C++: lookup_symbol sets this to nonzero
1048 if exp is a field of `this'. */
1051 error (_("Argument required."));
1053 sym = lookup_symbol (exp, get_selected_block (0), VAR_DOMAIN,
1054 &is_a_field_of_this);
1057 if (is_a_field_of_this)
1059 printf_filtered ("Symbol \"");
1060 fprintf_symbol_filtered (gdb_stdout, exp,
1061 current_language->la_language, DMGL_ANSI);
1062 printf_filtered ("\" is a field of the local class variable ");
1063 if (current_language->la_language == language_objc)
1064 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1066 printf_filtered ("`this'\n");
1070 msymbol = lookup_minimal_symbol (exp, NULL, NULL);
1072 if (msymbol != NULL)
1074 load_addr = SYMBOL_VALUE_ADDRESS (msymbol);
1076 printf_filtered ("Symbol \"");
1077 fprintf_symbol_filtered (gdb_stdout, exp,
1078 current_language->la_language, DMGL_ANSI);
1079 printf_filtered ("\" is at ");
1080 fputs_filtered (paddress (load_addr), gdb_stdout);
1081 printf_filtered (" in a file compiled without debugging");
1082 section = SYMBOL_BFD_SECTION (msymbol);
1083 if (section_is_overlay (section))
1085 load_addr = overlay_unmapped_address (load_addr, section);
1086 printf_filtered (",\n -- loaded at ");
1087 fputs_filtered (paddress (load_addr), gdb_stdout);
1088 printf_filtered (" in overlay section %s", section->name);
1090 printf_filtered (".\n");
1093 error (_("No symbol \"%s\" in current context."), exp);
1097 printf_filtered ("Symbol \"");
1098 fprintf_symbol_filtered (gdb_stdout, DEPRECATED_SYMBOL_NAME (sym),
1099 current_language->la_language, DMGL_ANSI);
1100 printf_filtered ("\" is ");
1101 val = SYMBOL_VALUE (sym);
1102 section = SYMBOL_BFD_SECTION (sym);
1104 switch (SYMBOL_CLASS (sym))
1107 case LOC_CONST_BYTES:
1108 printf_filtered ("constant");
1112 printf_filtered ("a label at address ");
1113 fputs_filtered (paddress (load_addr = SYMBOL_VALUE_ADDRESS (sym)),
1115 if (section_is_overlay (section))
1117 load_addr = overlay_unmapped_address (load_addr, section);
1118 printf_filtered (",\n -- loaded at ");
1119 fputs_filtered (paddress (load_addr), gdb_stdout);
1120 printf_filtered (" in overlay section %s", section->name);
1125 case LOC_COMPUTED_ARG:
1126 /* FIXME: cagney/2004-01-26: It should be possible to
1127 unconditionally call the SYMBOL_OPS method when available.
1128 Unfortunately DWARF 2 stores the frame-base (instead of the
1129 function) location in a function's symbol. Oops! For the
1130 moment enable this when/where applicable. */
1131 SYMBOL_OPS (sym)->describe_location (sym, gdb_stdout);
1135 printf_filtered (_("a variable in register %s"),
1136 gdbarch_register_name (current_gdbarch, val));
1140 printf_filtered (_("static storage at address "));
1141 fputs_filtered (paddress (load_addr = SYMBOL_VALUE_ADDRESS (sym)),
1143 if (section_is_overlay (section))
1145 load_addr = overlay_unmapped_address (load_addr, section);
1146 printf_filtered (_(",\n -- loaded at "));
1147 fputs_filtered (paddress (load_addr), gdb_stdout);
1148 printf_filtered (_(" in overlay section %s"), section->name);
1153 printf_filtered (_("an argument in register %s"),
1154 gdbarch_register_name (current_gdbarch, val));
1157 case LOC_REGPARM_ADDR:
1158 printf_filtered (_("address of an argument in register %s"),
1159 gdbarch_register_name (current_gdbarch, val));
1163 printf_filtered (_("an argument at offset %ld"), val);
1167 printf_filtered (_("a local variable at frame offset %ld"), val);
1171 printf_filtered (_("a reference argument at offset %ld"), val);
1175 printf_filtered (_("a typedef"));
1179 printf_filtered (_("a function at address "));
1180 load_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1181 fputs_filtered (paddress (load_addr), gdb_stdout);
1182 if (section_is_overlay (section))
1184 load_addr = overlay_unmapped_address (load_addr, section);
1185 printf_filtered (_(",\n -- loaded at "));
1186 fputs_filtered (paddress (load_addr), gdb_stdout);
1187 printf_filtered (_(" in overlay section %s"), section->name);
1191 case LOC_UNRESOLVED:
1193 struct minimal_symbol *msym;
1195 msym = lookup_minimal_symbol (DEPRECATED_SYMBOL_NAME (sym), NULL, NULL);
1197 printf_filtered ("unresolved");
1200 section = SYMBOL_BFD_SECTION (msym);
1201 printf_filtered (_("static storage at address "));
1202 load_addr = SYMBOL_VALUE_ADDRESS (msym);
1203 fputs_filtered (paddress (load_addr), gdb_stdout);
1204 if (section_is_overlay (section))
1206 load_addr = overlay_unmapped_address (load_addr, section);
1207 printf_filtered (_(",\n -- loaded at "));
1208 fputs_filtered (paddress (load_addr), gdb_stdout);
1209 printf_filtered (_(" in overlay section %s"), section->name);
1215 case LOC_OPTIMIZED_OUT:
1216 printf_filtered (_("optimized out"));
1220 printf_filtered (_("of unknown (botched) type"));
1223 printf_filtered (".\n");
1228 x_command (char *exp, int from_tty)
1230 struct expression *expr;
1231 struct format_data fmt;
1232 struct cleanup *old_chain;
1235 fmt.format = last_format;
1236 fmt.size = last_size;
1239 if (exp && *exp == '/')
1242 fmt = decode_format (&exp, last_format, last_size);
1245 /* If we have an expression, evaluate it and use it as the address. */
1247 if (exp != 0 && *exp != 0)
1249 expr = parse_expression (exp);
1250 /* Cause expression not to be there any more if this command is
1251 repeated with Newline. But don't clobber a user-defined
1252 command's definition. */
1255 old_chain = make_cleanup (free_current_contents, &expr);
1256 val = evaluate_expression (expr);
1257 if (TYPE_CODE (value_type (val)) == TYPE_CODE_REF)
1258 val = value_ind (val);
1259 /* In rvalue contexts, such as this, functions are coerced into
1260 pointers to functions. This makes "x/i main" work. */
1261 if (/* last_format == 'i' && */
1262 TYPE_CODE (value_type (val)) == TYPE_CODE_FUNC
1263 && VALUE_LVAL (val) == lval_memory)
1264 next_address = VALUE_ADDRESS (val);
1266 next_address = value_as_address (val);
1267 do_cleanups (old_chain);
1270 do_examine (fmt, next_address);
1272 /* If the examine succeeds, we remember its size and format for next
1274 last_size = fmt.size;
1275 last_format = fmt.format;
1277 /* Set a couple of internal variables if appropriate. */
1278 if (last_examine_value)
1280 /* Make last address examined available to the user as $_. Use
1281 the correct pointer type. */
1282 struct type *pointer_type
1283 = lookup_pointer_type (value_type (last_examine_value));
1284 set_internalvar (lookup_internalvar ("_"),
1285 value_from_pointer (pointer_type,
1286 last_examine_address));
1288 /* Make contents of last address examined available to the user
1289 as $__. If the last value has not been fetched from memory
1290 then don't fetch it now; instead mark it by voiding the $__
1292 if (value_lazy (last_examine_value))
1293 set_internalvar (lookup_internalvar ("__"),
1294 allocate_value (builtin_type_void));
1296 set_internalvar (lookup_internalvar ("__"), last_examine_value);
1301 /* Add an expression to the auto-display chain.
1302 Specify the expression. */
1305 display_command (char *exp, int from_tty)
1307 struct format_data fmt;
1308 struct expression *expr;
1309 struct display *new;
1313 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1315 if (tui_active && exp != NULL && *exp == '$')
1316 display_it = (tui_set_layout_for_display_command (exp) == TUI_FAILURE);
1330 fmt = decode_format (&exp, 0, 0);
1331 if (fmt.size && fmt.format == 0)
1333 if (fmt.format == 'i' || fmt.format == 's')
1343 innermost_block = 0;
1344 expr = parse_expression (exp);
1346 new = (struct display *) xmalloc (sizeof (struct display));
1349 new->block = innermost_block;
1350 new->next = display_chain;
1351 new->number = ++display_number;
1354 display_chain = new;
1356 if (from_tty && target_has_execution)
1357 do_one_display (new);
1364 free_display (struct display *d)
1370 /* Clear out the display_chain. Done when new symtabs are loaded,
1371 since this invalidates the types stored in many expressions. */
1374 clear_displays (void)
1378 while ((d = display_chain) != NULL)
1381 display_chain = d->next;
1386 /* Delete the auto-display number NUM. */
1389 delete_display (int num)
1391 struct display *d1, *d;
1394 error (_("No display number %d."), num);
1396 if (display_chain->number == num)
1399 display_chain = d1->next;
1403 for (d = display_chain;; d = d->next)
1406 error (_("No display number %d."), num);
1407 if (d->next->number == num)
1417 /* Delete some values from the auto-display chain.
1418 Specify the element numbers. */
1421 undisplay_command (char *args, int from_tty)
1429 if (query ("Delete all auto-display expressions? "))
1438 while (*p1 >= '0' && *p1 <= '9')
1440 if (*p1 && *p1 != ' ' && *p1 != '\t')
1441 error (_("Arguments must be display numbers."));
1445 delete_display (num);
1448 while (*p == ' ' || *p == '\t')
1454 /* Display a single auto-display.
1455 Do nothing if the display cannot be printed in the current context,
1456 or if the display is disabled. */
1459 do_one_display (struct display *d)
1461 int within_current_scope;
1463 if (d->enabled_p == 0)
1467 within_current_scope = contained_in (get_selected_block (0), d->block);
1469 within_current_scope = 1;
1470 if (!within_current_scope)
1473 current_display_number = d->number;
1475 annotate_display_begin ();
1476 printf_filtered ("%d", d->number);
1477 annotate_display_number_end ();
1478 printf_filtered (": ");
1484 annotate_display_format ();
1486 printf_filtered ("x/");
1487 if (d->format.count != 1)
1488 printf_filtered ("%d", d->format.count);
1489 printf_filtered ("%c", d->format.format);
1490 if (d->format.format != 'i' && d->format.format != 's')
1491 printf_filtered ("%c", d->format.size);
1492 printf_filtered (" ");
1494 annotate_display_expression ();
1496 print_expression (d->exp, gdb_stdout);
1497 annotate_display_expression_end ();
1499 if (d->format.count != 1 || d->format.format == 'i')
1500 printf_filtered ("\n");
1502 printf_filtered (" ");
1504 val = evaluate_expression (d->exp);
1505 addr = value_as_address (val);
1506 if (d->format.format == 'i')
1507 addr = gdbarch_addr_bits_remove (current_gdbarch, addr);
1509 annotate_display_value ();
1511 do_examine (d->format, addr);
1515 annotate_display_format ();
1517 if (d->format.format)
1518 printf_filtered ("/%c ", d->format.format);
1520 annotate_display_expression ();
1522 print_expression (d->exp, gdb_stdout);
1523 annotate_display_expression_end ();
1525 printf_filtered (" = ");
1527 annotate_display_expression ();
1529 print_formatted (evaluate_expression (d->exp),
1530 d->format.format, d->format.size, gdb_stdout);
1531 printf_filtered ("\n");
1534 annotate_display_end ();
1536 gdb_flush (gdb_stdout);
1537 current_display_number = -1;
1540 /* Display all of the values on the auto-display chain which can be
1541 evaluated in the current scope. */
1548 for (d = display_chain; d; d = d->next)
1552 /* Delete the auto-display which we were in the process of displaying.
1553 This is done when there is an error or a signal. */
1556 disable_display (int num)
1560 for (d = display_chain; d; d = d->next)
1561 if (d->number == num)
1566 printf_unfiltered (_("No display number %d.\n"), num);
1570 disable_current_display (void)
1572 if (current_display_number >= 0)
1574 disable_display (current_display_number);
1575 fprintf_unfiltered (gdb_stderr, _("\
1576 Disabling display %d to avoid infinite recursion.\n"),
1577 current_display_number);
1579 current_display_number = -1;
1583 display_info (char *ignore, int from_tty)
1588 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1590 printf_filtered (_("Auto-display expressions now in effect:\n\
1591 Num Enb Expression\n"));
1593 for (d = display_chain; d; d = d->next)
1595 printf_filtered ("%d: %c ", d->number, "ny"[(int) d->enabled_p]);
1597 printf_filtered ("/%d%c%c ", d->format.count, d->format.size,
1599 else if (d->format.format)
1600 printf_filtered ("/%c ", d->format.format);
1601 print_expression (d->exp, gdb_stdout);
1602 if (d->block && !contained_in (get_selected_block (0), d->block))
1603 printf_filtered (_(" (cannot be evaluated in the current context)"));
1604 printf_filtered ("\n");
1605 gdb_flush (gdb_stdout);
1610 enable_display (char *args, int from_tty)
1619 for (d = display_chain; d; d = d->next)
1626 while (*p1 >= '0' && *p1 <= '9')
1628 if (*p1 && *p1 != ' ' && *p1 != '\t')
1629 error (_("Arguments must be display numbers."));
1633 for (d = display_chain; d; d = d->next)
1634 if (d->number == num)
1639 printf_unfiltered (_("No display number %d.\n"), num);
1642 while (*p == ' ' || *p == '\t')
1648 disable_display_command (char *args, int from_tty)
1656 for (d = display_chain; d; d = d->next)
1663 while (*p1 >= '0' && *p1 <= '9')
1665 if (*p1 && *p1 != ' ' && *p1 != '\t')
1666 error (_("Arguments must be display numbers."));
1668 disable_display (atoi (p));
1671 while (*p == ' ' || *p == '\t')
1677 /* Print the value in stack frame FRAME of a variable specified by a
1681 print_variable_value (struct symbol *var, struct frame_info *frame,
1682 struct ui_file *stream)
1684 struct value *val = read_var_value (var, frame);
1686 value_print (val, stream, 0, Val_pretty_default);
1690 printf_command (char *arg, int from_tty)
1694 char *string = NULL;
1695 struct value **val_args;
1697 char *current_substring;
1699 int allocated_args = 20;
1700 struct cleanup *old_cleanups;
1702 val_args = xmalloc (allocated_args * sizeof (struct value *));
1703 old_cleanups = make_cleanup (free_current_contents, &val_args);
1706 error_no_arg (_("format-control string and values to print"));
1708 /* Skip white space before format string */
1709 while (*s == ' ' || *s == '\t')
1712 /* A format string should follow, enveloped in double quotes. */
1714 error (_("Bad format string, missing '\"'."));
1716 /* Parse the format-control string and copy it into the string STRING,
1717 processing some kinds of escape sequence. */
1719 f = string = (char *) alloca (strlen (s) + 1);
1727 error (_("Bad format string, non-terminated '\"'."));
1760 /* ??? TODO: handle other escape sequences */
1761 error (_("Unrecognized escape character \\%c in format string."),
1771 /* Skip over " and following space and comma. */
1774 while (*s == ' ' || *s == '\t')
1777 if (*s != ',' && *s != 0)
1778 error (_("Invalid argument syntax"));
1782 while (*s == ' ' || *s == '\t')
1785 /* Need extra space for the '\0's. Doubling the size is sufficient. */
1786 substrings = alloca (strlen (string) * 2);
1787 current_substring = substrings;
1790 /* Now scan the string for %-specs and see what kinds of args they want.
1791 argclass[I] classifies the %-specs so we can give printf_filtered
1792 something of the right size. */
1796 int_arg, long_arg, long_long_arg, ptr_arg, string_arg,
1797 double_arg, long_double_arg, decfloat_arg
1799 enum argclass *argclass;
1800 enum argclass this_argclass;
1805 argclass = (enum argclass *) alloca (strlen (s) * sizeof *argclass);
1812 int seen_hash = 0, seen_zero = 0, lcount = 0, seen_prec = 0;
1813 int seen_space = 0, seen_plus = 0;
1814 int seen_big_l = 0, seen_h = 0, seen_big_h = 0;
1815 int seen_big_d = 0, seen_double_big_d = 0;
1818 /* Check the validity of the format specifier, and work
1819 out what argument it expects. We only accept C89
1820 format strings, with the exception of long long (which
1821 we autoconf for). */
1823 /* Skip over "%%". */
1830 /* The first part of a format specifier is a set of flag
1832 while (strchr ("0-+ #", *f))
1845 /* The next part of a format specifier is a width. */
1846 while (strchr ("0123456789", *f))
1849 /* The next part of a format specifier is a precision. */
1854 while (strchr ("0123456789", *f))
1858 /* The next part of a format specifier is a length modifier. */
1879 /* Decimal32 modifier. */
1885 /* Decimal64 and Decimal128 modifiers. */
1890 /* Check for a Decimal128. */
1894 seen_double_big_d = 1;
1910 if (seen_space || seen_plus)
1917 this_argclass = int_arg;
1918 else if (lcount == 1)
1919 this_argclass = long_arg;
1921 this_argclass = long_long_arg;
1928 this_argclass = int_arg;
1929 if (lcount || seen_h || seen_big_l)
1931 if (seen_prec || seen_zero || seen_space || seen_plus)
1936 this_argclass = ptr_arg;
1937 if (lcount || seen_h || seen_big_l)
1939 if (seen_prec || seen_zero || seen_space || seen_plus)
1944 this_argclass = string_arg;
1945 if (lcount || seen_h || seen_big_l)
1947 if (seen_zero || seen_space || seen_plus)
1956 if (seen_big_h || seen_big_d || seen_double_big_d)
1957 this_argclass = decfloat_arg;
1958 else if (seen_big_l)
1959 this_argclass = long_double_arg;
1961 this_argclass = double_arg;
1963 if (lcount || seen_h)
1968 error (_("`*' not supported for precision or width in printf"));
1971 error (_("Format specifier `n' not supported in printf"));
1974 error (_("Incomplete format specifier at end of format string"));
1977 error (_("Unrecognized format specifier '%c' in printf"), *f);
1981 error (_("Inappropriate modifiers to format specifier '%c' in printf"),
1986 if (lcount > 1 && USE_PRINTF_I64)
1988 /* Windows' printf does support long long, but not the usual way.
1989 Convert %lld to %I64d. */
1990 int length_before_ll = f - last_arg - 1 - lcount;
1991 strncpy (current_substring, last_arg, length_before_ll);
1992 strcpy (current_substring + length_before_ll, "I64");
1993 current_substring[length_before_ll + 3] =
1994 last_arg[length_before_ll + lcount];
1995 current_substring += length_before_ll + 4;
1999 strncpy (current_substring, last_arg, f - last_arg);
2000 current_substring += f - last_arg;
2002 *current_substring++ = '\0';
2004 argclass[nargs_wanted++] = this_argclass;
2007 /* Now, parse all arguments and evaluate them.
2008 Store the VALUEs in VAL_ARGS. */
2013 if (nargs == allocated_args)
2014 val_args = (struct value **) xrealloc ((char *) val_args,
2015 (allocated_args *= 2)
2016 * sizeof (struct value *));
2018 val_args[nargs] = parse_to_comma_and_eval (&s1);
2020 /* If format string wants a float, unchecked-convert the value to
2021 floating point of the same size */
2023 if (argclass[nargs] == double_arg)
2025 struct type *type = value_type (val_args[nargs]);
2026 if (TYPE_LENGTH (type) == sizeof (float))
2027 deprecated_set_value_type (val_args[nargs], builtin_type_float);
2028 if (TYPE_LENGTH (type) == sizeof (double))
2029 deprecated_set_value_type (val_args[nargs], builtin_type_double);
2037 if (nargs != nargs_wanted)
2038 error (_("Wrong number of arguments for specified format-string"));
2040 /* Now actually print them. */
2041 current_substring = substrings;
2042 for (i = 0; i < nargs; i++)
2044 switch (argclass[i])
2051 tem = value_as_address (val_args[i]);
2053 /* This is a %s argument. Find the length of the string. */
2058 read_memory (tem + j, &c, 1);
2063 /* Copy the string contents into a string inside GDB. */
2064 str = (gdb_byte *) alloca (j + 1);
2066 read_memory (tem, str, j);
2069 printf_filtered (current_substring, (char *) str);
2074 double val = value_as_double (val_args[i]);
2075 printf_filtered (current_substring, val);
2078 case long_double_arg:
2079 #ifdef HAVE_LONG_DOUBLE
2081 long double val = value_as_double (val_args[i]);
2082 printf_filtered (current_substring, val);
2086 error (_("long double not supported in printf"));
2089 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2091 long long val = value_as_long (val_args[i]);
2092 printf_filtered (current_substring, val);
2096 error (_("long long not supported in printf"));
2100 int val = value_as_long (val_args[i]);
2101 printf_filtered (current_substring, val);
2106 long val = value_as_long (val_args[i]);
2107 printf_filtered (current_substring, val);
2111 /* Handles decimal floating values. */
2114 const gdb_byte *param_ptr = value_contents (val_args[i]);
2115 #if defined (PRINTF_HAS_DECFLOAT)
2116 /* If we have native support for Decimal floating
2117 printing, handle it here. */
2118 printf_filtered (current_substring, param_ptr);
2121 /* As a workaround until vasprintf has native support for DFP
2122 we convert the DFP values to string and print them using
2123 the %s format specifier. */
2126 int nnull_chars = 0;
2128 /* Parameter data. */
2129 struct type *param_type = value_type (val_args[i]);
2130 unsigned int param_len = TYPE_LENGTH (param_type);
2132 /* DFP output data. */
2133 struct value *dfp_value = NULL;
2137 struct type *dfp_type = NULL;
2138 char decstr[MAX_DECIMAL_STRING];
2140 /* Points to the end of the string so that we can go back
2141 and check for DFP length modifiers. */
2142 eos = current_substring + strlen (current_substring);
2144 /* Look for the float/double format specifier. */
2145 while (*eos != 'f' && *eos != 'e' && *eos != 'E'
2146 && *eos != 'g' && *eos != 'G')
2151 /* Search for the '%' char and extract the size and type of
2152 the output decimal value based on its modifiers
2153 (%Hf, %Df, %DDf). */
2154 while (*--sos != '%')
2159 dfp_type = builtin_type (current_gdbarch)->builtin_decfloat;
2161 else if (*sos == 'D' && *(sos - 1) == 'D')
2164 dfp_type = builtin_type (current_gdbarch)->builtin_declong;
2170 dfp_type = builtin_type (current_gdbarch)->builtin_decdouble;
2174 /* Replace %Hf, %Df and %DDf with %s's. */
2177 /* Go through the whole format string and pull the correct
2178 number of chars back to compensate for the change in the
2179 format specifier. */
2180 while (nnull_chars < nargs - i)
2188 /* Conversion between different DFP types. */
2189 if (TYPE_CODE (param_type) == TYPE_CODE_DECFLOAT)
2190 decimal_convert (param_ptr, param_len, dec, dfp_len);
2192 /* If this is a non-trivial conversion, just output 0.
2193 A correct converted value can be displayed by explicitly
2194 casting to a DFP type. */
2195 decimal_from_string (dec, dfp_len, "0");
2197 dfp_value = value_from_decfloat (dfp_type, dec);
2199 dfp_ptr = (gdb_byte *) value_contents (dfp_value);
2201 decimal_to_string (dfp_ptr, dfp_len, decstr);
2203 /* Print the DFP value. */
2204 printf_filtered (current_substring, decstr);
2212 /* We avoid the host's %p because pointers are too
2213 likely to be the wrong size. The only interesting
2214 modifier for %p is a width; extract that, and then
2215 handle %p as glibc would: %#x or a literal "(nil)". */
2217 char *p, *fmt, *fmt_p;
2218 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2219 long long val = value_as_long (val_args[i]);
2221 long val = value_as_long (val_args[i]);
2224 fmt = alloca (strlen (current_substring) + 5);
2226 /* Copy up to the leading %. */
2227 p = current_substring;
2231 int is_percent = (*p == '%');
2245 /* Copy any width. */
2246 while (*p >= '0' && *p < '9')
2249 gdb_assert (*p == 'p' && *(p + 1) == '\0');
2252 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2258 printf_filtered (fmt, val);
2264 printf_filtered (fmt, "(nil)");
2270 internal_error (__FILE__, __LINE__,
2271 _("failed internal consistency check"));
2273 /* Skip to the next substring. */
2274 current_substring += strlen (current_substring) + 1;
2276 /* Print the portion of the format string after the last argument. */
2277 puts_filtered (last_arg);
2279 do_cleanups (old_cleanups);
2283 _initialize_printcmd (void)
2285 struct cmd_list_element *c;
2287 current_display_number = -1;
2289 add_info ("address", address_info,
2290 _("Describe where symbol SYM is stored."));
2292 add_info ("symbol", sym_info, _("\
2293 Describe what symbol is at location ADDR.\n\
2294 Only for symbols with fixed locations (global or static scope)."));
2296 add_com ("x", class_vars, x_command, _("\
2297 Examine memory: x/FMT ADDRESS.\n\
2298 ADDRESS is an expression for the memory address to examine.\n\
2299 FMT is a repeat count followed by a format letter and a size letter.\n\
2300 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2301 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
2302 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2303 The specified number of objects of the specified size are printed\n\
2304 according to the format.\n\n\
2305 Defaults for format and size letters are those previously used.\n\
2306 Default count is 1. Default address is following last thing printed\n\
2307 with this command or \"print\"."));
2310 add_com ("whereis", class_vars, whereis_command,
2311 _("Print line number and file of definition of variable."));
2314 add_info ("display", display_info, _("\
2315 Expressions to display when program stops, with code numbers."));
2317 add_cmd ("undisplay", class_vars, undisplay_command, _("\
2318 Cancel some expressions to be displayed when program stops.\n\
2319 Arguments are the code numbers of the expressions to stop displaying.\n\
2320 No argument means cancel all automatic-display expressions.\n\
2321 \"delete display\" has the same effect as this command.\n\
2322 Do \"info display\" to see current list of code numbers."),
2325 add_com ("display", class_vars, display_command, _("\
2326 Print value of expression EXP each time the program stops.\n\
2327 /FMT may be used before EXP as in the \"print\" command.\n\
2328 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2329 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2330 and examining is done as in the \"x\" command.\n\n\
2331 With no argument, display all currently requested auto-display expressions.\n\
2332 Use \"undisplay\" to cancel display requests previously made."));
2334 add_cmd ("display", class_vars, enable_display, _("\
2335 Enable some expressions to be displayed when program stops.\n\
2336 Arguments are the code numbers of the expressions to resume displaying.\n\
2337 No argument means enable all automatic-display expressions.\n\
2338 Do \"info display\" to see current list of code numbers."), &enablelist);
2340 add_cmd ("display", class_vars, disable_display_command, _("\
2341 Disable some expressions to be displayed when program stops.\n\
2342 Arguments are the code numbers of the expressions to stop displaying.\n\
2343 No argument means disable all automatic-display expressions.\n\
2344 Do \"info display\" to see current list of code numbers."), &disablelist);
2346 add_cmd ("display", class_vars, undisplay_command, _("\
2347 Cancel some expressions to be displayed when program stops.\n\
2348 Arguments are the code numbers of the expressions to stop displaying.\n\
2349 No argument means cancel all automatic-display expressions.\n\
2350 Do \"info display\" to see current list of code numbers."), &deletelist);
2352 add_com ("printf", class_vars, printf_command, _("\
2353 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2354 This is useful for formatted output in user-defined commands."));
2356 add_com ("output", class_vars, output_command, _("\
2357 Like \"print\" but don't put in value history and don't print newline.\n\
2358 This is useful in user-defined commands."));
2360 add_prefix_cmd ("set", class_vars, set_command, _("\
2361 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2362 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2363 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2364 with $), a register (a few standard names starting with $), or an actual\n\
2365 variable in the program being debugged. EXP is any valid expression.\n\
2366 Use \"set variable\" for variables with names identical to set subcommands.\n\
2368 With a subcommand, this command modifies parts of the gdb environment.\n\
2369 You can see these environment settings with the \"show\" command."),
2370 &setlist, "set ", 1, &cmdlist);
2372 add_com ("assign", class_vars, set_command, _("\
2373 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2374 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2375 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2376 with $), a register (a few standard names starting with $), or an actual\n\
2377 variable in the program being debugged. EXP is any valid expression.\n\
2378 Use \"set variable\" for variables with names identical to set subcommands.\n\
2379 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2380 You can see these environment settings with the \"show\" command."));
2382 /* "call" is the same as "set", but handy for dbx users to call fns. */
2383 c = add_com ("call", class_vars, call_command, _("\
2384 Call a function in the program.\n\
2385 The argument is the function name and arguments, in the notation of the\n\
2386 current working language. The result is printed and saved in the value\n\
2387 history, if it is not void."));
2388 set_cmd_completer (c, location_completer);
2390 add_cmd ("variable", class_vars, set_command, _("\
2391 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2392 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2393 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2394 with $), a register (a few standard names starting with $), or an actual\n\
2395 variable in the program being debugged. EXP is any valid expression.\n\
2396 This may usually be abbreviated to simply \"set\"."),
2399 c = add_com ("print", class_vars, print_command, _("\
2400 Print value of expression EXP.\n\
2401 Variables accessible are those of the lexical environment of the selected\n\
2402 stack frame, plus all those whose scope is global or an entire file.\n\
2404 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2405 $$NUM refers to NUM'th value back from the last one.\n\
2406 Names starting with $ refer to registers (with the values they would have\n\
2407 if the program were to return to the stack frame now selected, restoring\n\
2408 all registers saved by frames farther in) or else to debugger\n\
2409 \"convenience\" variables (any such name not a known register).\n\
2410 Use assignment expressions to give values to convenience variables.\n\
2412 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2413 @ is a binary operator for treating consecutive data objects\n\
2414 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2415 element is FOO, whose second element is stored in the space following\n\
2416 where FOO is stored, etc. FOO must be an expression whose value\n\
2417 resides in memory.\n\
2419 EXP may be preceded with /FMT, where FMT is a format letter\n\
2420 but no count or size letter (see \"x\" command)."));
2421 set_cmd_completer (c, location_completer);
2422 add_com_alias ("p", "print", class_vars, 1);
2424 c = add_com ("inspect", class_vars, inspect_command, _("\
2425 Same as \"print\" command, except that if you are running in the epoch\n\
2426 environment, the value is printed in its own window."));
2427 set_cmd_completer (c, location_completer);
2429 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class,
2430 &max_symbolic_offset, _("\
2431 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2432 Show the largest offset that will be printed in <symbol+1234> form."), NULL,
2434 show_max_symbolic_offset,
2435 &setprintlist, &showprintlist);
2436 add_setshow_boolean_cmd ("symbol-filename", no_class,
2437 &print_symbol_filename, _("\
2438 Set printing of source filename and line number with <symbol>."), _("\
2439 Show printing of source filename and line number with <symbol>."), NULL,
2441 show_print_symbol_filename,
2442 &setprintlist, &showprintlist);
2444 /* For examine/instruction a single byte quantity is specified as
2445 the data. This avoids problems with value_at_lazy() requiring a
2446 valid data type (and rejecting VOID). */
2447 examine_i_type = init_type (TYPE_CODE_INT, 1, 0, "examine_i_type", NULL);
2449 examine_b_type = init_type (TYPE_CODE_INT, 1, 0, "examine_b_type", NULL);
2450 examine_h_type = init_type (TYPE_CODE_INT, 2, 0, "examine_h_type", NULL);
2451 examine_w_type = init_type (TYPE_CODE_INT, 4, 0, "examine_w_type", NULL);
2452 examine_g_type = init_type (TYPE_CODE_INT, 8, 0, "examine_g_type", NULL);