1 /* Print values for GNU debugger GDB.
3 Copyright (C) 1986-2013 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "gdb_string.h"
27 #include "expression.h"
31 #include "breakpoint.h"
33 #include "gdb-demangle.h"
36 #include "symfile.h" /* for overlay functions */
37 #include "objfiles.h" /* ditto */
38 #include "completer.h" /* for completion functions */
40 #include "gdb_assert.h"
45 #include "exceptions.h"
48 #include "parser-defs.h"
50 #include "arch-utils.h"
51 #include "cli/cli-utils.h"
56 #include "tui/tui.h" /* For tui_active et al. */
65 /* True if the value should be printed raw -- that is, bypassing
66 python-based formatters. */
70 /* Last specified output format. */
72 static char last_format = 0;
74 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
76 static char last_size = 'w';
78 /* Default address to examine next, and associated architecture. */
80 static struct gdbarch *next_gdbarch;
81 static CORE_ADDR next_address;
83 /* Number of delay instructions following current disassembled insn. */
85 static int branch_delay_insns;
87 /* Last address examined. */
89 static CORE_ADDR last_examine_address;
91 /* Contents of last address examined.
92 This is not valid past the end of the `x' command! */
94 static struct value *last_examine_value;
96 /* Largest offset between a symbolic value and an address, that will be
97 printed as `0x1234 <symbol+offset>'. */
99 static unsigned int max_symbolic_offset = UINT_MAX;
101 show_max_symbolic_offset (struct ui_file *file, int from_tty,
102 struct cmd_list_element *c, const char *value)
104 fprintf_filtered (file,
105 _("The largest offset that will be "
106 "printed in <symbol+1234> form is %s.\n"),
110 /* Append the source filename and linenumber of the symbol when
111 printing a symbolic value as `<symbol at filename:linenum>' if set. */
112 static int print_symbol_filename = 0;
114 show_print_symbol_filename (struct ui_file *file, int from_tty,
115 struct cmd_list_element *c, const char *value)
117 fprintf_filtered (file, _("Printing of source filename and "
118 "line number with <symbol> is %s.\n"),
122 /* Number of auto-display expression currently being displayed.
123 So that we can disable it if we get a signal within it.
124 -1 when not doing one. */
126 static int current_display_number;
130 /* Chain link to next auto-display item. */
131 struct display *next;
133 /* The expression as the user typed it. */
136 /* Expression to be evaluated and displayed. */
137 struct expression *exp;
139 /* Item number of this auto-display item. */
142 /* Display format specified. */
143 struct format_data format;
145 /* Program space associated with `block'. */
146 struct program_space *pspace;
148 /* Innermost block required by this expression when evaluated. */
149 const struct block *block;
151 /* Status of this display (enabled or disabled). */
155 /* Chain of expressions whose values should be displayed
156 automatically each time the program stops. */
158 static struct display *display_chain;
160 static int display_number;
162 /* Walk the following statement or block through all displays.
163 ALL_DISPLAYS_SAFE does so even if the statement deletes the current
166 #define ALL_DISPLAYS(B) \
167 for (B = display_chain; B; B = B->next)
169 #define ALL_DISPLAYS_SAFE(B,TMP) \
170 for (B = display_chain; \
171 B ? (TMP = B->next, 1): 0; \
174 /* Prototypes for exported functions. */
176 void _initialize_printcmd (void);
178 /* Prototypes for local functions. */
180 static void do_one_display (struct display *);
183 /* Decode a format specification. *STRING_PTR should point to it.
184 OFORMAT and OSIZE are used as defaults for the format and size
185 if none are given in the format specification.
186 If OSIZE is zero, then the size field of the returned value
187 should be set only if a size is explicitly specified by the
189 The structure returned describes all the data
190 found in the specification. In addition, *STRING_PTR is advanced
191 past the specification and past all whitespace following it. */
193 static struct format_data
194 decode_format (const char **string_ptr, int oformat, int osize)
196 struct format_data val;
197 const char *p = *string_ptr;
204 if (*p >= '0' && *p <= '9')
205 val.count = atoi (p);
206 while (*p >= '0' && *p <= '9')
209 /* Now process size or format letters that follow. */
213 if (*p == 'b' || *p == 'h' || *p == 'w' || *p == 'g')
220 else if (*p >= 'a' && *p <= 'z')
226 while (*p == ' ' || *p == '\t')
230 /* Set defaults for format and size if not specified. */
231 if (val.format == '?')
235 /* Neither has been specified. */
236 val.format = oformat;
240 /* If a size is specified, any format makes a reasonable
241 default except 'i'. */
242 val.format = oformat == 'i' ? 'x' : oformat;
244 else if (val.size == '?')
248 /* Pick the appropriate size for an address. This is deferred
249 until do_examine when we know the actual architecture to use.
250 A special size value of 'a' is used to indicate this case. */
251 val.size = osize ? 'a' : osize;
254 /* Floating point has to be word or giantword. */
255 if (osize == 'w' || osize == 'g')
258 /* Default it to giantword if the last used size is not
260 val.size = osize ? 'g' : osize;
263 /* Characters default to one byte. */
264 val.size = osize ? 'b' : osize;
267 /* Display strings with byte size chars unless explicitly
273 /* The default is the size most recently specified. */
280 /* Print value VAL on stream according to OPTIONS.
281 Do not end with a newline.
282 SIZE is the letter for the size of datum being printed.
283 This is used to pad hex numbers so they line up. SIZE is 0
284 for print / output and set for examine. */
287 print_formatted (struct value *val, int size,
288 const struct value_print_options *options,
289 struct ui_file *stream)
291 struct type *type = check_typedef (value_type (val));
292 int len = TYPE_LENGTH (type);
294 if (VALUE_LVAL (val) == lval_memory)
295 next_address = value_address (val) + len;
299 switch (options->format)
303 struct type *elttype = value_type (val);
305 next_address = (value_address (val)
306 + val_print_string (elttype, NULL,
307 value_address (val), -1,
308 stream, options) * len);
313 /* We often wrap here if there are long symbolic names. */
315 next_address = (value_address (val)
316 + gdb_print_insn (get_type_arch (type),
317 value_address (val), stream,
318 &branch_delay_insns));
323 if (options->format == 0 || options->format == 's'
324 || TYPE_CODE (type) == TYPE_CODE_REF
325 || TYPE_CODE (type) == TYPE_CODE_ARRAY
326 || TYPE_CODE (type) == TYPE_CODE_STRING
327 || TYPE_CODE (type) == TYPE_CODE_STRUCT
328 || TYPE_CODE (type) == TYPE_CODE_UNION
329 || TYPE_CODE (type) == TYPE_CODE_NAMESPACE)
330 value_print (val, stream, options);
332 /* User specified format, so don't look to the type to tell us
334 val_print_scalar_formatted (type,
335 value_contents_for_printing (val),
336 value_embedded_offset (val),
338 options, size, stream);
341 /* Return builtin floating point type of same length as TYPE.
342 If no such type is found, return TYPE itself. */
344 float_type_from_length (struct type *type)
346 struct gdbarch *gdbarch = get_type_arch (type);
347 const struct builtin_type *builtin = builtin_type (gdbarch);
349 if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_float))
350 type = builtin->builtin_float;
351 else if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_double))
352 type = builtin->builtin_double;
353 else if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_long_double))
354 type = builtin->builtin_long_double;
359 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
360 according to OPTIONS and SIZE on STREAM. Formats s and i are not
361 supported at this level. */
364 print_scalar_formatted (const void *valaddr, struct type *type,
365 const struct value_print_options *options,
366 int size, struct ui_file *stream)
368 struct gdbarch *gdbarch = get_type_arch (type);
369 LONGEST val_long = 0;
370 unsigned int len = TYPE_LENGTH (type);
371 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
373 /* String printing should go through val_print_scalar_formatted. */
374 gdb_assert (options->format != 's');
376 if (len > sizeof(LONGEST) &&
377 (TYPE_CODE (type) == TYPE_CODE_INT
378 || TYPE_CODE (type) == TYPE_CODE_ENUM))
380 switch (options->format)
383 print_octal_chars (stream, valaddr, len, byte_order);
387 print_decimal_chars (stream, valaddr, len, byte_order);
390 print_binary_chars (stream, valaddr, len, byte_order);
393 print_hex_chars (stream, valaddr, len, byte_order);
396 print_char_chars (stream, type, valaddr, len, byte_order);
403 if (options->format != 'f')
404 val_long = unpack_long (type, valaddr);
406 /* If the value is a pointer, and pointers and addresses are not the
407 same, then at this point, the value's length (in target bytes) is
408 gdbarch_addr_bit/TARGET_CHAR_BIT, not TYPE_LENGTH (type). */
409 if (TYPE_CODE (type) == TYPE_CODE_PTR)
410 len = gdbarch_addr_bit (gdbarch) / TARGET_CHAR_BIT;
412 /* If we are printing it as unsigned, truncate it in case it is actually
413 a negative signed value (e.g. "print/u (short)-1" should print 65535
414 (if shorts are 16 bits) instead of 4294967295). */
415 if (options->format != 'd' || TYPE_UNSIGNED (type))
417 if (len < sizeof (LONGEST))
418 val_long &= ((LONGEST) 1 << HOST_CHAR_BIT * len) - 1;
421 switch (options->format)
426 /* No size specified, like in print. Print varying # of digits. */
427 print_longest (stream, 'x', 1, val_long);
436 print_longest (stream, size, 1, val_long);
439 error (_("Undefined output size \"%c\"."), size);
444 print_longest (stream, 'd', 1, val_long);
448 print_longest (stream, 'u', 0, val_long);
453 print_longest (stream, 'o', 1, val_long);
455 fprintf_filtered (stream, "0");
460 CORE_ADDR addr = unpack_pointer (type, valaddr);
462 print_address (gdbarch, addr, stream);
468 struct value_print_options opts = *options;
471 if (TYPE_UNSIGNED (type))
472 type = builtin_type (gdbarch)->builtin_true_unsigned_char;
474 type = builtin_type (gdbarch)->builtin_true_char;
476 value_print (value_from_longest (type, val_long), stream, &opts);
481 type = float_type_from_length (type);
482 print_floating (valaddr, type, stream);
486 internal_error (__FILE__, __LINE__,
487 _("failed internal consistency check"));
490 /* Binary; 't' stands for "two". */
492 char bits[8 * (sizeof val_long) + 1];
493 char buf[8 * (sizeof val_long) + 32];
498 width = 8 * (sizeof val_long);
515 error (_("Undefined output size \"%c\"."), size);
521 bits[width] = (val_long & 1) ? '1' : '0';
526 while (*cp && *cp == '0')
531 strncpy (buf, cp, sizeof (bits));
532 fputs_filtered (buf, stream);
537 print_hex_chars (stream, valaddr, len, byte_order);
541 error (_("Undefined output format \"%c\"."), options->format);
545 /* Specify default address for `x' command.
546 The `info lines' command uses this. */
549 set_next_address (struct gdbarch *gdbarch, CORE_ADDR addr)
551 struct type *ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
553 next_gdbarch = gdbarch;
556 /* Make address available to the user as $_. */
557 set_internalvar (lookup_internalvar ("_"),
558 value_from_pointer (ptr_type, addr));
561 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
562 after LEADIN. Print nothing if no symbolic name is found nearby.
563 Optionally also print source file and line number, if available.
564 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
565 or to interpret it as a possible C++ name and convert it back to source
566 form. However note that DO_DEMANGLE can be overridden by the specific
567 settings of the demangle and asm_demangle variables. Returns
568 non-zero if anything was printed; zero otherwise. */
571 print_address_symbolic (struct gdbarch *gdbarch, CORE_ADDR addr,
572 struct ui_file *stream,
573 int do_demangle, char *leadin)
576 char *filename = NULL;
581 /* Throw away both name and filename. */
582 struct cleanup *cleanup_chain = make_cleanup (free_current_contents, &name);
583 make_cleanup (free_current_contents, &filename);
585 if (build_address_symbolic (gdbarch, addr, do_demangle, &name, &offset,
586 &filename, &line, &unmapped))
588 do_cleanups (cleanup_chain);
592 fputs_filtered (leadin, stream);
594 fputs_filtered ("<*", stream);
596 fputs_filtered ("<", stream);
597 fputs_filtered (name, stream);
599 fprintf_filtered (stream, "+%u", (unsigned int) offset);
601 /* Append source filename and line number if desired. Give specific
602 line # of this addr, if we have it; else line # of the nearest symbol. */
603 if (print_symbol_filename && filename != NULL)
606 fprintf_filtered (stream, " at %s:%d", filename, line);
608 fprintf_filtered (stream, " in %s", filename);
611 fputs_filtered ("*>", stream);
613 fputs_filtered (">", stream);
615 do_cleanups (cleanup_chain);
619 /* Given an address ADDR return all the elements needed to print the
620 address in a symbolic form. NAME can be mangled or not depending
621 on DO_DEMANGLE (and also on the asm_demangle global variable,
622 manipulated via ''set print asm-demangle''). Return 0 in case of
623 success, when all the info in the OUT paramters is valid. Return 1
626 build_address_symbolic (struct gdbarch *gdbarch,
627 CORE_ADDR addr, /* IN */
628 int do_demangle, /* IN */
629 char **name, /* OUT */
630 int *offset, /* OUT */
631 char **filename, /* OUT */
633 int *unmapped) /* OUT */
635 struct minimal_symbol *msymbol;
636 struct symbol *symbol;
637 CORE_ADDR name_location = 0;
638 struct obj_section *section = NULL;
639 const char *name_temp = "";
641 /* Let's say it is mapped (not unmapped). */
644 /* Determine if the address is in an overlay, and whether it is
646 if (overlay_debugging)
648 section = find_pc_overlay (addr);
649 if (pc_in_unmapped_range (addr, section))
652 addr = overlay_mapped_address (addr, section);
656 /* First try to find the address in the symbol table, then
657 in the minsyms. Take the closest one. */
659 /* This is defective in the sense that it only finds text symbols. So
660 really this is kind of pointless--we should make sure that the
661 minimal symbols have everything we need (by changing that we could
662 save some memory, but for many debug format--ELF/DWARF or
663 anything/stabs--it would be inconvenient to eliminate those minimal
665 msymbol = lookup_minimal_symbol_by_pc_section (addr, section).minsym;
666 symbol = find_pc_sect_function (addr, section);
670 /* If this is a function (i.e. a code address), strip out any
671 non-address bits. For instance, display a pointer to the
672 first instruction of a Thumb function as <function>; the
673 second instruction will be <function+2>, even though the
674 pointer is <function+3>. This matches the ISA behavior. */
675 addr = gdbarch_addr_bits_remove (gdbarch, addr);
677 name_location = BLOCK_START (SYMBOL_BLOCK_VALUE (symbol));
678 if (do_demangle || asm_demangle)
679 name_temp = SYMBOL_PRINT_NAME (symbol);
681 name_temp = SYMBOL_LINKAGE_NAME (symbol);
685 && MSYMBOL_HAS_SIZE (msymbol)
686 && MSYMBOL_SIZE (msymbol) == 0
687 && MSYMBOL_TYPE (msymbol) != mst_text
688 && MSYMBOL_TYPE (msymbol) != mst_text_gnu_ifunc
689 && MSYMBOL_TYPE (msymbol) != mst_file_text)
694 if (SYMBOL_VALUE_ADDRESS (msymbol) > name_location || symbol == NULL)
696 /* If this is a function (i.e. a code address), strip out any
697 non-address bits. For instance, display a pointer to the
698 first instruction of a Thumb function as <function>; the
699 second instruction will be <function+2>, even though the
700 pointer is <function+3>. This matches the ISA behavior. */
701 if (MSYMBOL_TYPE (msymbol) == mst_text
702 || MSYMBOL_TYPE (msymbol) == mst_text_gnu_ifunc
703 || MSYMBOL_TYPE (msymbol) == mst_file_text
704 || MSYMBOL_TYPE (msymbol) == mst_solib_trampoline)
705 addr = gdbarch_addr_bits_remove (gdbarch, addr);
707 /* The msymbol is closer to the address than the symbol;
708 use the msymbol instead. */
710 name_location = SYMBOL_VALUE_ADDRESS (msymbol);
711 if (do_demangle || asm_demangle)
712 name_temp = SYMBOL_PRINT_NAME (msymbol);
714 name_temp = SYMBOL_LINKAGE_NAME (msymbol);
717 if (symbol == NULL && msymbol == NULL)
720 /* If the nearest symbol is too far away, don't print anything symbolic. */
722 /* For when CORE_ADDR is larger than unsigned int, we do math in
723 CORE_ADDR. But when we detect unsigned wraparound in the
724 CORE_ADDR math, we ignore this test and print the offset,
725 because addr+max_symbolic_offset has wrapped through the end
726 of the address space back to the beginning, giving bogus comparison. */
727 if (addr > name_location + max_symbolic_offset
728 && name_location + max_symbolic_offset > name_location)
731 *offset = addr - name_location;
733 *name = xstrdup (name_temp);
735 if (print_symbol_filename)
737 struct symtab_and_line sal;
739 sal = find_pc_sect_line (addr, section, 0);
743 *filename = xstrdup (symtab_to_filename_for_display (sal.symtab));
751 /* Print address ADDR symbolically on STREAM.
752 First print it as a number. Then perhaps print
753 <SYMBOL + OFFSET> after the number. */
756 print_address (struct gdbarch *gdbarch,
757 CORE_ADDR addr, struct ui_file *stream)
759 fputs_filtered (paddress (gdbarch, addr), stream);
760 print_address_symbolic (gdbarch, addr, stream, asm_demangle, " ");
763 /* Return a prefix for instruction address:
764 "=> " for current instruction, else " ". */
767 pc_prefix (CORE_ADDR addr)
769 if (has_stack_frames ())
771 struct frame_info *frame;
774 frame = get_selected_frame (NULL);
775 if (get_frame_pc_if_available (frame, &pc) && pc == addr)
781 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
782 controls whether to print the symbolic name "raw" or demangled.
783 Return non-zero if anything was printed; zero otherwise. */
786 print_address_demangle (const struct value_print_options *opts,
787 struct gdbarch *gdbarch, CORE_ADDR addr,
788 struct ui_file *stream, int do_demangle)
790 if (opts->addressprint)
792 fputs_filtered (paddress (gdbarch, addr), stream);
793 print_address_symbolic (gdbarch, addr, stream, do_demangle, " ");
797 return print_address_symbolic (gdbarch, addr, stream, do_demangle, "");
803 /* Examine data at address ADDR in format FMT.
804 Fetch it from memory and print on gdb_stdout. */
807 do_examine (struct format_data fmt, struct gdbarch *gdbarch, CORE_ADDR addr)
812 struct type *val_type = NULL;
815 struct value_print_options opts;
820 next_gdbarch = gdbarch;
823 /* Instruction format implies fetch single bytes
824 regardless of the specified size.
825 The case of strings is handled in decode_format, only explicit
826 size operator are not changed to 'b'. */
832 /* Pick the appropriate size for an address. */
833 if (gdbarch_ptr_bit (next_gdbarch) == 64)
835 else if (gdbarch_ptr_bit (next_gdbarch) == 32)
837 else if (gdbarch_ptr_bit (next_gdbarch) == 16)
840 /* Bad value for gdbarch_ptr_bit. */
841 internal_error (__FILE__, __LINE__,
842 _("failed internal consistency check"));
846 val_type = builtin_type (next_gdbarch)->builtin_int8;
847 else if (size == 'h')
848 val_type = builtin_type (next_gdbarch)->builtin_int16;
849 else if (size == 'w')
850 val_type = builtin_type (next_gdbarch)->builtin_int32;
851 else if (size == 'g')
852 val_type = builtin_type (next_gdbarch)->builtin_int64;
856 struct type *char_type = NULL;
858 /* Search for "char16_t" or "char32_t" types or fall back to 8-bit char
859 if type is not found. */
861 char_type = builtin_type (next_gdbarch)->builtin_char16;
862 else if (size == 'w')
863 char_type = builtin_type (next_gdbarch)->builtin_char32;
865 val_type = char_type;
868 if (size != '\0' && size != 'b')
869 warning (_("Unable to display strings with "
870 "size '%c', using 'b' instead."), size);
872 val_type = builtin_type (next_gdbarch)->builtin_int8;
881 if (format == 's' || format == 'i')
884 get_formatted_print_options (&opts, format);
886 /* Print as many objects as specified in COUNT, at most maxelts per line,
887 with the address of the next one at the start of each line. */
893 fputs_filtered (pc_prefix (next_address), gdb_stdout);
894 print_address (next_gdbarch, next_address, gdb_stdout);
895 printf_filtered (":");
900 printf_filtered ("\t");
901 /* Note that print_formatted sets next_address for the next
903 last_examine_address = next_address;
905 if (last_examine_value)
906 value_free (last_examine_value);
908 /* The value to be displayed is not fetched greedily.
909 Instead, to avoid the possibility of a fetched value not
910 being used, its retrieval is delayed until the print code
911 uses it. When examining an instruction stream, the
912 disassembler will perform its own memory fetch using just
913 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
914 the disassembler be modified so that LAST_EXAMINE_VALUE
915 is left with the byte sequence from the last complete
916 instruction fetched from memory? */
917 last_examine_value = value_at_lazy (val_type, next_address);
919 if (last_examine_value)
920 release_value (last_examine_value);
922 print_formatted (last_examine_value, size, &opts, gdb_stdout);
924 /* Display any branch delay slots following the final insn. */
925 if (format == 'i' && count == 1)
926 count += branch_delay_insns;
928 printf_filtered ("\n");
929 gdb_flush (gdb_stdout);
934 validate_format (struct format_data fmt, char *cmdname)
937 error (_("Size letters are meaningless in \"%s\" command."), cmdname);
939 error (_("Item count other than 1 is meaningless in \"%s\" command."),
941 if (fmt.format == 'i')
942 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
943 fmt.format, cmdname);
946 /* Evaluate string EXP as an expression in the current language and
947 print the resulting value. EXP may contain a format specifier as the
948 first argument ("/x myvar" for example, to print myvar in hex). */
951 print_command_1 (const char *exp, int voidprint)
953 struct expression *expr;
954 struct cleanup *old_chain = make_cleanup (null_cleanup, NULL);
957 struct format_data fmt;
959 if (exp && *exp == '/')
962 fmt = decode_format (&exp, last_format, 0);
963 validate_format (fmt, "print");
964 last_format = format = fmt.format;
976 expr = parse_expression (exp);
977 make_cleanup (free_current_contents, &expr);
978 val = evaluate_expression (expr);
981 val = access_value_history (0);
983 if (voidprint || (val && value_type (val) &&
984 TYPE_CODE (value_type (val)) != TYPE_CODE_VOID))
986 struct value_print_options opts;
987 int histindex = record_latest_value (val);
990 annotate_value_history_begin (histindex, value_type (val));
992 annotate_value_begin (value_type (val));
995 printf_filtered ("$%d = ", histindex);
998 annotate_value_history_value ();
1000 get_formatted_print_options (&opts, format);
1003 print_formatted (val, fmt.size, &opts, gdb_stdout);
1004 printf_filtered ("\n");
1007 annotate_value_history_end ();
1009 annotate_value_end ();
1012 do_cleanups (old_chain);
1016 print_command (char *exp, int from_tty)
1018 print_command_1 (exp, 1);
1021 /* Same as print, except it doesn't print void results. */
1023 call_command (char *exp, int from_tty)
1025 print_command_1 (exp, 0);
1028 /* Implementation of the "output" command. */
1031 output_command (char *exp, int from_tty)
1033 output_command_const (exp, from_tty);
1036 /* Like output_command, but takes a const string as argument. */
1039 output_command_const (const char *exp, int from_tty)
1041 struct expression *expr;
1042 struct cleanup *old_chain;
1045 struct format_data fmt;
1046 struct value_print_options opts;
1051 if (exp && *exp == '/')
1054 fmt = decode_format (&exp, 0, 0);
1055 validate_format (fmt, "output");
1056 format = fmt.format;
1059 expr = parse_expression (exp);
1060 old_chain = make_cleanup (free_current_contents, &expr);
1062 val = evaluate_expression (expr);
1064 annotate_value_begin (value_type (val));
1066 get_formatted_print_options (&opts, format);
1068 print_formatted (val, fmt.size, &opts, gdb_stdout);
1070 annotate_value_end ();
1073 gdb_flush (gdb_stdout);
1075 do_cleanups (old_chain);
1079 set_command (char *exp, int from_tty)
1081 struct expression *expr = parse_expression (exp);
1082 struct cleanup *old_chain =
1083 make_cleanup (free_current_contents, &expr);
1085 if (expr->nelts >= 1)
1086 switch (expr->elts[0].opcode)
1088 case UNOP_PREINCREMENT:
1089 case UNOP_POSTINCREMENT:
1090 case UNOP_PREDECREMENT:
1091 case UNOP_POSTDECREMENT:
1093 case BINOP_ASSIGN_MODIFY:
1098 (_("Expression is not an assignment (and might have no effect)"));
1101 evaluate_expression (expr);
1102 do_cleanups (old_chain);
1106 sym_info (char *arg, int from_tty)
1108 struct minimal_symbol *msymbol;
1109 struct objfile *objfile;
1110 struct obj_section *osect;
1111 CORE_ADDR addr, sect_addr;
1113 unsigned int offset;
1116 error_no_arg (_("address"));
1118 addr = parse_and_eval_address (arg);
1119 ALL_OBJSECTIONS (objfile, osect)
1121 /* Only process each object file once, even if there's a separate
1123 if (objfile->separate_debug_objfile_backlink)
1126 sect_addr = overlay_mapped_address (addr, osect);
1128 if (obj_section_addr (osect) <= sect_addr
1129 && sect_addr < obj_section_endaddr (osect)
1131 = lookup_minimal_symbol_by_pc_section (sect_addr, osect).minsym))
1133 const char *obj_name, *mapped, *sec_name, *msym_name;
1135 struct cleanup *old_chain;
1138 offset = sect_addr - SYMBOL_VALUE_ADDRESS (msymbol);
1139 mapped = section_is_mapped (osect) ? _("mapped") : _("unmapped");
1140 sec_name = osect->the_bfd_section->name;
1141 msym_name = SYMBOL_PRINT_NAME (msymbol);
1143 /* Don't print the offset if it is zero.
1144 We assume there's no need to handle i18n of "sym + offset". */
1146 loc_string = xstrprintf ("%s + %u", msym_name, offset);
1148 loc_string = xstrprintf ("%s", msym_name);
1150 /* Use a cleanup to free loc_string in case the user quits
1151 a pagination request inside printf_filtered. */
1152 old_chain = make_cleanup (xfree, loc_string);
1154 gdb_assert (osect->objfile && objfile_name (osect->objfile));
1155 obj_name = objfile_name (osect->objfile);
1157 if (MULTI_OBJFILE_P ())
1158 if (pc_in_unmapped_range (addr, osect))
1159 if (section_is_overlay (osect))
1160 printf_filtered (_("%s in load address range of "
1161 "%s overlay section %s of %s\n"),
1162 loc_string, mapped, sec_name, obj_name);
1164 printf_filtered (_("%s in load address range of "
1165 "section %s of %s\n"),
1166 loc_string, sec_name, obj_name);
1168 if (section_is_overlay (osect))
1169 printf_filtered (_("%s in %s overlay section %s of %s\n"),
1170 loc_string, mapped, sec_name, obj_name);
1172 printf_filtered (_("%s in section %s of %s\n"),
1173 loc_string, sec_name, obj_name);
1175 if (pc_in_unmapped_range (addr, osect))
1176 if (section_is_overlay (osect))
1177 printf_filtered (_("%s in load address range of %s overlay "
1179 loc_string, mapped, sec_name);
1181 printf_filtered (_("%s in load address range of section %s\n"),
1182 loc_string, sec_name);
1184 if (section_is_overlay (osect))
1185 printf_filtered (_("%s in %s overlay section %s\n"),
1186 loc_string, mapped, sec_name);
1188 printf_filtered (_("%s in section %s\n"),
1189 loc_string, sec_name);
1191 do_cleanups (old_chain);
1195 printf_filtered (_("No symbol matches %s.\n"), arg);
1199 address_info (char *exp, int from_tty)
1201 struct gdbarch *gdbarch;
1204 struct bound_minimal_symbol msymbol;
1206 struct obj_section *section;
1207 CORE_ADDR load_addr, context_pc = 0;
1208 struct field_of_this_result is_a_field_of_this;
1211 error (_("Argument required."));
1213 sym = lookup_symbol (exp, get_selected_block (&context_pc), VAR_DOMAIN,
1214 &is_a_field_of_this);
1217 if (is_a_field_of_this.type != NULL)
1219 printf_filtered ("Symbol \"");
1220 fprintf_symbol_filtered (gdb_stdout, exp,
1221 current_language->la_language, DMGL_ANSI);
1222 printf_filtered ("\" is a field of the local class variable ");
1223 if (current_language->la_language == language_objc)
1224 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1226 printf_filtered ("`this'\n");
1230 msymbol = lookup_bound_minimal_symbol (exp);
1232 if (msymbol.minsym != NULL)
1234 struct objfile *objfile = msymbol.objfile;
1236 gdbarch = get_objfile_arch (objfile);
1237 load_addr = SYMBOL_VALUE_ADDRESS (msymbol.minsym);
1239 printf_filtered ("Symbol \"");
1240 fprintf_symbol_filtered (gdb_stdout, exp,
1241 current_language->la_language, DMGL_ANSI);
1242 printf_filtered ("\" is at ");
1243 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1244 printf_filtered (" in a file compiled without debugging");
1245 section = SYMBOL_OBJ_SECTION (objfile, msymbol.minsym);
1246 if (section_is_overlay (section))
1248 load_addr = overlay_unmapped_address (load_addr, section);
1249 printf_filtered (",\n -- loaded at ");
1250 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1251 printf_filtered (" in overlay section %s",
1252 section->the_bfd_section->name);
1254 printf_filtered (".\n");
1257 error (_("No symbol \"%s\" in current context."), exp);
1261 printf_filtered ("Symbol \"");
1262 fprintf_symbol_filtered (gdb_stdout, SYMBOL_PRINT_NAME (sym),
1263 current_language->la_language, DMGL_ANSI);
1264 printf_filtered ("\" is ");
1265 val = SYMBOL_VALUE (sym);
1266 section = SYMBOL_OBJ_SECTION (SYMBOL_OBJFILE (sym), sym);
1267 gdbarch = get_objfile_arch (SYMBOL_SYMTAB (sym)->objfile);
1269 if (SYMBOL_COMPUTED_OPS (sym) != NULL)
1271 SYMBOL_COMPUTED_OPS (sym)->describe_location (sym, context_pc,
1273 printf_filtered (".\n");
1277 switch (SYMBOL_CLASS (sym))
1280 case LOC_CONST_BYTES:
1281 printf_filtered ("constant");
1285 printf_filtered ("a label at address ");
1286 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1287 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1288 if (section_is_overlay (section))
1290 load_addr = overlay_unmapped_address (load_addr, section);
1291 printf_filtered (",\n -- loaded at ");
1292 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1293 printf_filtered (" in overlay section %s",
1294 section->the_bfd_section->name);
1299 gdb_assert_not_reached (_("LOC_COMPUTED variable missing a method"));
1302 /* GDBARCH is the architecture associated with the objfile the symbol
1303 is defined in; the target architecture may be different, and may
1304 provide additional registers. However, we do not know the target
1305 architecture at this point. We assume the objfile architecture
1306 will contain all the standard registers that occur in debug info
1308 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1310 if (SYMBOL_IS_ARGUMENT (sym))
1311 printf_filtered (_("an argument in register %s"),
1312 gdbarch_register_name (gdbarch, regno));
1314 printf_filtered (_("a variable in register %s"),
1315 gdbarch_register_name (gdbarch, regno));
1319 printf_filtered (_("static storage at address "));
1320 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1321 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1322 if (section_is_overlay (section))
1324 load_addr = overlay_unmapped_address (load_addr, section);
1325 printf_filtered (_(",\n -- loaded at "));
1326 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1327 printf_filtered (_(" in overlay section %s"),
1328 section->the_bfd_section->name);
1332 case LOC_REGPARM_ADDR:
1333 /* Note comment at LOC_REGISTER. */
1334 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1335 printf_filtered (_("address of an argument in register %s"),
1336 gdbarch_register_name (gdbarch, regno));
1340 printf_filtered (_("an argument at offset %ld"), val);
1344 printf_filtered (_("a local variable at frame offset %ld"), val);
1348 printf_filtered (_("a reference argument at offset %ld"), val);
1352 printf_filtered (_("a typedef"));
1356 printf_filtered (_("a function at address "));
1357 load_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1358 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1359 if (section_is_overlay (section))
1361 load_addr = overlay_unmapped_address (load_addr, section);
1362 printf_filtered (_(",\n -- loaded at "));
1363 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1364 printf_filtered (_(" in overlay section %s"),
1365 section->the_bfd_section->name);
1369 case LOC_UNRESOLVED:
1371 struct bound_minimal_symbol msym;
1373 msym = lookup_minimal_symbol_and_objfile (SYMBOL_LINKAGE_NAME (sym));
1374 if (msym.minsym == NULL)
1375 printf_filtered ("unresolved");
1378 section = SYMBOL_OBJ_SECTION (msym.objfile, msym.minsym);
1379 load_addr = SYMBOL_VALUE_ADDRESS (msym.minsym);
1382 && (section->the_bfd_section->flags & SEC_THREAD_LOCAL) != 0)
1383 printf_filtered (_("a thread-local variable at offset %s "
1384 "in the thread-local storage for `%s'"),
1385 paddress (gdbarch, load_addr),
1386 objfile_name (section->objfile));
1389 printf_filtered (_("static storage at address "));
1390 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1391 if (section_is_overlay (section))
1393 load_addr = overlay_unmapped_address (load_addr, section);
1394 printf_filtered (_(",\n -- loaded at "));
1395 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1396 printf_filtered (_(" in overlay section %s"),
1397 section->the_bfd_section->name);
1404 case LOC_OPTIMIZED_OUT:
1405 printf_filtered (_("optimized out"));
1409 printf_filtered (_("of unknown (botched) type"));
1412 printf_filtered (".\n");
1417 x_command (char *exp, int from_tty)
1419 struct expression *expr;
1420 struct format_data fmt;
1421 struct cleanup *old_chain;
1424 fmt.format = last_format ? last_format : 'x';
1425 fmt.size = last_size;
1429 if (exp && *exp == '/')
1431 const char *tmp = exp + 1;
1433 fmt = decode_format (&tmp, last_format, last_size);
1437 /* If we have an expression, evaluate it and use it as the address. */
1439 if (exp != 0 && *exp != 0)
1441 expr = parse_expression (exp);
1442 /* Cause expression not to be there any more if this command is
1443 repeated with Newline. But don't clobber a user-defined
1444 command's definition. */
1447 old_chain = make_cleanup (free_current_contents, &expr);
1448 val = evaluate_expression (expr);
1449 if (TYPE_CODE (value_type (val)) == TYPE_CODE_REF)
1450 val = coerce_ref (val);
1451 /* In rvalue contexts, such as this, functions are coerced into
1452 pointers to functions. This makes "x/i main" work. */
1453 if (/* last_format == 'i' && */
1454 TYPE_CODE (value_type (val)) == TYPE_CODE_FUNC
1455 && VALUE_LVAL (val) == lval_memory)
1456 next_address = value_address (val);
1458 next_address = value_as_address (val);
1460 next_gdbarch = expr->gdbarch;
1461 do_cleanups (old_chain);
1465 error_no_arg (_("starting display address"));
1467 do_examine (fmt, next_gdbarch, next_address);
1469 /* If the examine succeeds, we remember its size and format for next
1470 time. Set last_size to 'b' for strings. */
1471 if (fmt.format == 's')
1474 last_size = fmt.size;
1475 last_format = fmt.format;
1477 /* Set a couple of internal variables if appropriate. */
1478 if (last_examine_value)
1480 /* Make last address examined available to the user as $_. Use
1481 the correct pointer type. */
1482 struct type *pointer_type
1483 = lookup_pointer_type (value_type (last_examine_value));
1484 set_internalvar (lookup_internalvar ("_"),
1485 value_from_pointer (pointer_type,
1486 last_examine_address));
1488 /* Make contents of last address examined available to the user
1489 as $__. If the last value has not been fetched from memory
1490 then don't fetch it now; instead mark it by voiding the $__
1492 if (value_lazy (last_examine_value))
1493 clear_internalvar (lookup_internalvar ("__"));
1495 set_internalvar (lookup_internalvar ("__"), last_examine_value);
1500 /* Add an expression to the auto-display chain.
1501 Specify the expression. */
1504 display_command (char *arg, int from_tty)
1506 struct format_data fmt;
1507 struct expression *expr;
1508 struct display *new;
1510 const char *exp = arg;
1513 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1515 if (tui_active && exp != NULL && *exp == '$')
1516 display_it = (tui_set_layout_for_display_command (exp) == TUI_FAILURE);
1530 fmt = decode_format (&exp, 0, 0);
1531 if (fmt.size && fmt.format == 0)
1533 if (fmt.format == 'i' || fmt.format == 's')
1544 innermost_block = NULL;
1545 expr = parse_expression (exp);
1547 new = (struct display *) xmalloc (sizeof (struct display));
1549 new->exp_string = xstrdup (exp);
1551 new->block = innermost_block;
1552 new->pspace = current_program_space;
1553 new->next = display_chain;
1554 new->number = ++display_number;
1557 display_chain = new;
1559 if (from_tty && target_has_execution)
1560 do_one_display (new);
1567 free_display (struct display *d)
1569 xfree (d->exp_string);
1574 /* Clear out the display_chain. Done when new symtabs are loaded,
1575 since this invalidates the types stored in many expressions. */
1578 clear_displays (void)
1582 while ((d = display_chain) != NULL)
1584 display_chain = d->next;
1589 /* Delete the auto-display DISPLAY. */
1592 delete_display (struct display *display)
1596 gdb_assert (display != NULL);
1598 if (display_chain == display)
1599 display_chain = display->next;
1602 if (d->next == display)
1604 d->next = display->next;
1608 free_display (display);
1611 /* Call FUNCTION on each of the displays whose numbers are given in
1612 ARGS. DATA is passed unmodified to FUNCTION. */
1615 map_display_numbers (char *args,
1616 void (*function) (struct display *,
1620 struct get_number_or_range_state state;
1624 error_no_arg (_("one or more display numbers"));
1626 init_number_or_range (&state, args);
1628 while (!state.finished)
1630 char *p = state.string;
1632 num = get_number_or_range (&state);
1634 warning (_("bad display number at or near '%s'"), p);
1637 struct display *d, *tmp;
1639 ALL_DISPLAYS_SAFE (d, tmp)
1640 if (d->number == num)
1643 printf_unfiltered (_("No display number %d.\n"), num);
1650 /* Callback for map_display_numbers, that deletes a display. */
1653 do_delete_display (struct display *d, void *data)
1658 /* "undisplay" command. */
1661 undisplay_command (char *args, int from_tty)
1665 if (query (_("Delete all auto-display expressions? ")))
1671 map_display_numbers (args, do_delete_display, NULL);
1675 /* Display a single auto-display.
1676 Do nothing if the display cannot be printed in the current context,
1677 or if the display is disabled. */
1680 do_one_display (struct display *d)
1682 struct cleanup *old_chain;
1683 int within_current_scope;
1685 if (d->enabled_p == 0)
1688 /* The expression carries the architecture that was used at parse time.
1689 This is a problem if the expression depends on architecture features
1690 (e.g. register numbers), and the current architecture is now different.
1691 For example, a display statement like "display/i $pc" is expected to
1692 display the PC register of the current architecture, not the arch at
1693 the time the display command was given. Therefore, we re-parse the
1694 expression if the current architecture has changed. */
1695 if (d->exp != NULL && d->exp->gdbarch != get_current_arch ())
1704 volatile struct gdb_exception ex;
1706 TRY_CATCH (ex, RETURN_MASK_ALL)
1708 innermost_block = NULL;
1709 d->exp = parse_expression (d->exp_string);
1710 d->block = innermost_block;
1714 /* Can't re-parse the expression. Disable this display item. */
1716 warning (_("Unable to display \"%s\": %s"),
1717 d->exp_string, ex.message);
1724 if (d->pspace == current_program_space)
1725 within_current_scope = contained_in (get_selected_block (0), d->block);
1727 within_current_scope = 0;
1730 within_current_scope = 1;
1731 if (!within_current_scope)
1734 old_chain = make_cleanup_restore_integer (¤t_display_number);
1735 current_display_number = d->number;
1737 annotate_display_begin ();
1738 printf_filtered ("%d", d->number);
1739 annotate_display_number_end ();
1740 printf_filtered (": ");
1743 volatile struct gdb_exception ex;
1745 annotate_display_format ();
1747 printf_filtered ("x/");
1748 if (d->format.count != 1)
1749 printf_filtered ("%d", d->format.count);
1750 printf_filtered ("%c", d->format.format);
1751 if (d->format.format != 'i' && d->format.format != 's')
1752 printf_filtered ("%c", d->format.size);
1753 printf_filtered (" ");
1755 annotate_display_expression ();
1757 puts_filtered (d->exp_string);
1758 annotate_display_expression_end ();
1760 if (d->format.count != 1 || d->format.format == 'i')
1761 printf_filtered ("\n");
1763 printf_filtered (" ");
1765 annotate_display_value ();
1767 TRY_CATCH (ex, RETURN_MASK_ERROR)
1772 val = evaluate_expression (d->exp);
1773 addr = value_as_address (val);
1774 if (d->format.format == 'i')
1775 addr = gdbarch_addr_bits_remove (d->exp->gdbarch, addr);
1776 do_examine (d->format, d->exp->gdbarch, addr);
1779 fprintf_filtered (gdb_stdout, _("<error: %s>\n"), ex.message);
1783 struct value_print_options opts;
1784 volatile struct gdb_exception ex;
1786 annotate_display_format ();
1788 if (d->format.format)
1789 printf_filtered ("/%c ", d->format.format);
1791 annotate_display_expression ();
1793 puts_filtered (d->exp_string);
1794 annotate_display_expression_end ();
1796 printf_filtered (" = ");
1798 annotate_display_expression ();
1800 get_formatted_print_options (&opts, d->format.format);
1801 opts.raw = d->format.raw;
1803 TRY_CATCH (ex, RETURN_MASK_ERROR)
1807 val = evaluate_expression (d->exp);
1808 print_formatted (val, d->format.size, &opts, gdb_stdout);
1811 fprintf_filtered (gdb_stdout, _("<error: %s>"), ex.message);
1812 printf_filtered ("\n");
1815 annotate_display_end ();
1817 gdb_flush (gdb_stdout);
1818 do_cleanups (old_chain);
1821 /* Display all of the values on the auto-display chain which can be
1822 evaluated in the current scope. */
1829 for (d = display_chain; d; d = d->next)
1833 /* Delete the auto-display which we were in the process of displaying.
1834 This is done when there is an error or a signal. */
1837 disable_display (int num)
1841 for (d = display_chain; d; d = d->next)
1842 if (d->number == num)
1847 printf_unfiltered (_("No display number %d.\n"), num);
1851 disable_current_display (void)
1853 if (current_display_number >= 0)
1855 disable_display (current_display_number);
1856 fprintf_unfiltered (gdb_stderr,
1857 _("Disabling display %d to "
1858 "avoid infinite recursion.\n"),
1859 current_display_number);
1861 current_display_number = -1;
1865 display_info (char *ignore, int from_tty)
1870 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1872 printf_filtered (_("Auto-display expressions now in effect:\n\
1873 Num Enb Expression\n"));
1875 for (d = display_chain; d; d = d->next)
1877 printf_filtered ("%d: %c ", d->number, "ny"[(int) d->enabled_p]);
1879 printf_filtered ("/%d%c%c ", d->format.count, d->format.size,
1881 else if (d->format.format)
1882 printf_filtered ("/%c ", d->format.format);
1883 puts_filtered (d->exp_string);
1884 if (d->block && !contained_in (get_selected_block (0), d->block))
1885 printf_filtered (_(" (cannot be evaluated in the current context)"));
1886 printf_filtered ("\n");
1887 gdb_flush (gdb_stdout);
1891 /* Callback fo map_display_numbers, that enables or disables the
1892 passed in display D. */
1895 do_enable_disable_display (struct display *d, void *data)
1897 d->enabled_p = *(int *) data;
1900 /* Implamentation of both the "disable display" and "enable display"
1901 commands. ENABLE decides what to do. */
1904 enable_disable_display_command (char *args, int from_tty, int enable)
1911 d->enabled_p = enable;
1915 map_display_numbers (args, do_enable_disable_display, &enable);
1918 /* The "enable display" command. */
1921 enable_display_command (char *args, int from_tty)
1923 enable_disable_display_command (args, from_tty, 1);
1926 /* The "disable display" command. */
1929 disable_display_command (char *args, int from_tty)
1931 enable_disable_display_command (args, from_tty, 0);
1934 /* display_chain items point to blocks and expressions. Some expressions in
1935 turn may point to symbols.
1936 Both symbols and blocks are obstack_alloc'd on objfile_stack, and are
1937 obstack_free'd when a shared library is unloaded.
1938 Clear pointers that are about to become dangling.
1939 Both .exp and .block fields will be restored next time we need to display
1940 an item by re-parsing .exp_string field in the new execution context. */
1943 clear_dangling_display_expressions (struct so_list *solib)
1945 struct objfile *objfile = solib->objfile;
1948 /* With no symbol file we cannot have a block or expression from it. */
1949 if (objfile == NULL)
1951 if (objfile->separate_debug_objfile_backlink)
1952 objfile = objfile->separate_debug_objfile_backlink;
1953 gdb_assert (objfile->pspace == solib->pspace);
1955 for (d = display_chain; d != NULL; d = d->next)
1957 if (d->pspace != solib->pspace)
1960 if (lookup_objfile_from_block (d->block) == objfile
1961 || (d->exp && exp_uses_objfile (d->exp, objfile)))
1971 /* Print the value in stack frame FRAME of a variable specified by a
1972 struct symbol. NAME is the name to print; if NULL then VAR's print
1973 name will be used. STREAM is the ui_file on which to print the
1974 value. INDENT specifies the number of indent levels to print
1975 before printing the variable name.
1977 This function invalidates FRAME. */
1980 print_variable_and_value (const char *name, struct symbol *var,
1981 struct frame_info *frame,
1982 struct ui_file *stream, int indent)
1984 volatile struct gdb_exception except;
1987 name = SYMBOL_PRINT_NAME (var);
1989 fprintf_filtered (stream, "%s%s = ", n_spaces (2 * indent), name);
1990 TRY_CATCH (except, RETURN_MASK_ERROR)
1993 struct value_print_options opts;
1995 val = read_var_value (var, frame);
1996 get_user_print_options (&opts);
1998 common_val_print (val, stream, indent, &opts, current_language);
2000 /* common_val_print invalidates FRAME when a pretty printer calls inferior
2004 if (except.reason < 0)
2005 fprintf_filtered(stream, "<error reading variable %s (%s)>", name,
2007 fprintf_filtered (stream, "\n");
2010 /* Subroutine of ui_printf to simplify it.
2011 Print VALUE to STREAM using FORMAT.
2012 VALUE is a C-style string on the target. */
2015 printf_c_string (struct ui_file *stream, const char *format,
2016 struct value *value)
2022 tem = value_as_address (value);
2024 /* This is a %s argument. Find the length of the string. */
2030 read_memory (tem + j, &c, 1);
2035 /* Copy the string contents into a string inside GDB. */
2036 str = (gdb_byte *) alloca (j + 1);
2038 read_memory (tem, str, j);
2041 fprintf_filtered (stream, format, (char *) str);
2044 /* Subroutine of ui_printf to simplify it.
2045 Print VALUE to STREAM using FORMAT.
2046 VALUE is a wide C-style string on the target. */
2049 printf_wide_c_string (struct ui_file *stream, const char *format,
2050 struct value *value)
2055 struct gdbarch *gdbarch = get_type_arch (value_type (value));
2056 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2057 struct type *wctype = lookup_typename (current_language, gdbarch,
2058 "wchar_t", NULL, 0);
2059 int wcwidth = TYPE_LENGTH (wctype);
2060 gdb_byte *buf = alloca (wcwidth);
2061 struct obstack output;
2062 struct cleanup *inner_cleanup;
2064 tem = value_as_address (value);
2066 /* This is a %s argument. Find the length of the string. */
2067 for (j = 0;; j += wcwidth)
2070 read_memory (tem + j, buf, wcwidth);
2071 if (extract_unsigned_integer (buf, wcwidth, byte_order) == 0)
2075 /* Copy the string contents into a string inside GDB. */
2076 str = (gdb_byte *) alloca (j + wcwidth);
2078 read_memory (tem, str, j);
2079 memset (&str[j], 0, wcwidth);
2081 obstack_init (&output);
2082 inner_cleanup = make_cleanup_obstack_free (&output);
2084 convert_between_encodings (target_wide_charset (gdbarch),
2087 &output, translit_char);
2088 obstack_grow_str0 (&output, "");
2090 fprintf_filtered (stream, format, obstack_base (&output));
2091 do_cleanups (inner_cleanup);
2094 /* Subroutine of ui_printf to simplify it.
2095 Print VALUE, a decimal floating point value, to STREAM using FORMAT. */
2098 printf_decfloat (struct ui_file *stream, const char *format,
2099 struct value *value)
2101 const gdb_byte *param_ptr = value_contents (value);
2103 #if defined (PRINTF_HAS_DECFLOAT)
2104 /* If we have native support for Decimal floating
2105 printing, handle it here. */
2106 fprintf_filtered (stream, format, param_ptr);
2108 /* As a workaround until vasprintf has native support for DFP
2109 we convert the DFP values to string and print them using
2110 the %s format specifier. */
2113 /* Parameter data. */
2114 struct type *param_type = value_type (value);
2115 struct gdbarch *gdbarch = get_type_arch (param_type);
2116 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2118 /* DFP output data. */
2119 struct value *dfp_value = NULL;
2123 struct type *dfp_type = NULL;
2124 char decstr[MAX_DECIMAL_STRING];
2126 /* Points to the end of the string so that we can go back
2127 and check for DFP length modifiers. */
2128 p = format + strlen (format);
2130 /* Look for the float/double format specifier. */
2131 while (*p != 'f' && *p != 'e' && *p != 'E'
2132 && *p != 'g' && *p != 'G')
2135 /* Search for the '%' char and extract the size and type of
2136 the output decimal value based on its modifiers
2137 (%Hf, %Df, %DDf). */
2143 dfp_type = builtin_type (gdbarch)->builtin_decfloat;
2145 else if (*p == 'D' && *(p - 1) == 'D')
2148 dfp_type = builtin_type (gdbarch)->builtin_declong;
2154 dfp_type = builtin_type (gdbarch)->builtin_decdouble;
2158 /* Conversion between different DFP types. */
2159 if (TYPE_CODE (param_type) == TYPE_CODE_DECFLOAT)
2160 decimal_convert (param_ptr, TYPE_LENGTH (param_type),
2161 byte_order, dec, dfp_len, byte_order);
2163 /* If this is a non-trivial conversion, just output 0.
2164 A correct converted value can be displayed by explicitly
2165 casting to a DFP type. */
2166 decimal_from_string (dec, dfp_len, byte_order, "0");
2168 dfp_value = value_from_decfloat (dfp_type, dec);
2170 dfp_ptr = (gdb_byte *) value_contents (dfp_value);
2172 decimal_to_string (dfp_ptr, dfp_len, byte_order, decstr);
2174 /* Print the DFP value. */
2175 fprintf_filtered (stream, "%s", decstr);
2179 /* Subroutine of ui_printf to simplify it.
2180 Print VALUE, a target pointer, to STREAM using FORMAT. */
2183 printf_pointer (struct ui_file *stream, const char *format,
2184 struct value *value)
2186 /* We avoid the host's %p because pointers are too
2187 likely to be the wrong size. The only interesting
2188 modifier for %p is a width; extract that, and then
2189 handle %p as glibc would: %#x or a literal "(nil)". */
2193 #ifdef PRINTF_HAS_LONG_LONG
2194 long long val = value_as_long (value);
2196 long val = value_as_long (value);
2199 fmt = alloca (strlen (format) + 5);
2201 /* Copy up to the leading %. */
2206 int is_percent = (*p == '%');
2221 /* Copy any width. */
2222 while (*p >= '0' && *p < '9')
2225 gdb_assert (*p == 'p' && *(p + 1) == '\0');
2228 #ifdef PRINTF_HAS_LONG_LONG
2234 fprintf_filtered (stream, fmt, val);
2240 fprintf_filtered (stream, fmt, "(nil)");
2244 /* printf "printf format string" ARG to STREAM. */
2247 ui_printf (const char *arg, struct ui_file *stream)
2249 struct format_piece *fpieces;
2250 const char *s = arg;
2251 struct value **val_args;
2252 int allocated_args = 20;
2253 struct cleanup *old_cleanups;
2255 val_args = xmalloc (allocated_args * sizeof (struct value *));
2256 old_cleanups = make_cleanup (free_current_contents, &val_args);
2259 error_no_arg (_("format-control string and values to print"));
2261 s = skip_spaces_const (s);
2263 /* A format string should follow, enveloped in double quotes. */
2265 error (_("Bad format string, missing '\"'."));
2267 fpieces = parse_format_string (&s);
2269 make_cleanup (free_format_pieces_cleanup, &fpieces);
2272 error (_("Bad format string, non-terminated '\"'."));
2274 s = skip_spaces_const (s);
2276 if (*s != ',' && *s != 0)
2277 error (_("Invalid argument syntax"));
2281 s = skip_spaces_const (s);
2287 char *current_substring;
2290 for (fr = 0; fpieces[fr].string != NULL; fr++)
2291 if (fpieces[fr].argclass != literal_piece)
2294 /* Now, parse all arguments and evaluate them.
2295 Store the VALUEs in VAL_ARGS. */
2301 if (nargs == allocated_args)
2302 val_args = (struct value **) xrealloc ((char *) val_args,
2303 (allocated_args *= 2)
2304 * sizeof (struct value *));
2306 val_args[nargs] = parse_to_comma_and_eval (&s1);
2314 if (nargs != nargs_wanted)
2315 error (_("Wrong number of arguments for specified format-string"));
2317 /* Now actually print them. */
2319 for (fr = 0; fpieces[fr].string != NULL; fr++)
2321 current_substring = fpieces[fr].string;
2322 switch (fpieces[fr].argclass)
2325 printf_c_string (stream, current_substring, val_args[i]);
2327 case wide_string_arg:
2328 printf_wide_c_string (stream, current_substring, val_args[i]);
2332 struct gdbarch *gdbarch
2333 = get_type_arch (value_type (val_args[i]));
2334 struct type *wctype = lookup_typename (current_language, gdbarch,
2335 "wchar_t", NULL, 0);
2336 struct type *valtype;
2337 struct obstack output;
2338 struct cleanup *inner_cleanup;
2339 const gdb_byte *bytes;
2341 valtype = value_type (val_args[i]);
2342 if (TYPE_LENGTH (valtype) != TYPE_LENGTH (wctype)
2343 || TYPE_CODE (valtype) != TYPE_CODE_INT)
2344 error (_("expected wchar_t argument for %%lc"));
2346 bytes = value_contents (val_args[i]);
2348 obstack_init (&output);
2349 inner_cleanup = make_cleanup_obstack_free (&output);
2351 convert_between_encodings (target_wide_charset (gdbarch),
2353 bytes, TYPE_LENGTH (valtype),
2354 TYPE_LENGTH (valtype),
2355 &output, translit_char);
2356 obstack_grow_str0 (&output, "");
2358 fprintf_filtered (stream, current_substring,
2359 obstack_base (&output));
2360 do_cleanups (inner_cleanup);
2365 struct type *type = value_type (val_args[i]);
2369 /* If format string wants a float, unchecked-convert the value
2370 to floating point of the same size. */
2371 type = float_type_from_length (type);
2372 val = unpack_double (type, value_contents (val_args[i]), &inv);
2374 error (_("Invalid floating value found in program."));
2376 fprintf_filtered (stream, current_substring, (double) val);
2379 case long_double_arg:
2380 #ifdef HAVE_LONG_DOUBLE
2382 struct type *type = value_type (val_args[i]);
2386 /* If format string wants a float, unchecked-convert the value
2387 to floating point of the same size. */
2388 type = float_type_from_length (type);
2389 val = unpack_double (type, value_contents (val_args[i]), &inv);
2391 error (_("Invalid floating value found in program."));
2393 fprintf_filtered (stream, current_substring,
2398 error (_("long double not supported in printf"));
2401 #ifdef PRINTF_HAS_LONG_LONG
2403 long long val = value_as_long (val_args[i]);
2405 fprintf_filtered (stream, current_substring, val);
2409 error (_("long long not supported in printf"));
2413 int val = value_as_long (val_args[i]);
2415 fprintf_filtered (stream, current_substring, val);
2420 long val = value_as_long (val_args[i]);
2422 fprintf_filtered (stream, current_substring, val);
2425 /* Handles decimal floating values. */
2427 printf_decfloat (stream, current_substring, val_args[i]);
2430 printf_pointer (stream, current_substring, val_args[i]);
2433 /* Print a portion of the format string that has no
2434 directives. Note that this will not include any
2435 ordinary %-specs, but it might include "%%". That is
2436 why we use printf_filtered and not puts_filtered here.
2437 Also, we pass a dummy argument because some platforms
2438 have modified GCC to include -Wformat-security by
2439 default, which will warn here if there is no
2441 fprintf_filtered (stream, current_substring, 0);
2444 internal_error (__FILE__, __LINE__,
2445 _("failed internal consistency check"));
2447 /* Maybe advance to the next argument. */
2448 if (fpieces[fr].argclass != literal_piece)
2452 do_cleanups (old_cleanups);
2455 /* Implement the "printf" command. */
2458 printf_command (char *arg, int from_tty)
2460 ui_printf (arg, gdb_stdout);
2461 gdb_flush (gdb_stdout);
2464 /* Implement the "eval" command. */
2467 eval_command (char *arg, int from_tty)
2469 struct ui_file *ui_out = mem_fileopen ();
2470 struct cleanup *cleanups = make_cleanup_ui_file_delete (ui_out);
2473 ui_printf (arg, ui_out);
2475 expanded = ui_file_xstrdup (ui_out, NULL);
2476 make_cleanup (xfree, expanded);
2478 execute_command (expanded, from_tty);
2480 do_cleanups (cleanups);
2484 _initialize_printcmd (void)
2486 struct cmd_list_element *c;
2488 current_display_number = -1;
2490 observer_attach_solib_unloaded (clear_dangling_display_expressions);
2492 add_info ("address", address_info,
2493 _("Describe where symbol SYM is stored."));
2495 add_info ("symbol", sym_info, _("\
2496 Describe what symbol is at location ADDR.\n\
2497 Only for symbols with fixed locations (global or static scope)."));
2499 add_com ("x", class_vars, x_command, _("\
2500 Examine memory: x/FMT ADDRESS.\n\
2501 ADDRESS is an expression for the memory address to examine.\n\
2502 FMT is a repeat count followed by a format letter and a size letter.\n\
2503 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2504 t(binary), f(float), a(address), i(instruction), c(char), s(string)\n\
2505 and z(hex, zero padded on the left).\n\
2506 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2507 The specified number of objects of the specified size are printed\n\
2508 according to the format.\n\n\
2509 Defaults for format and size letters are those previously used.\n\
2510 Default count is 1. Default address is following last thing printed\n\
2511 with this command or \"print\"."));
2514 add_com ("whereis", class_vars, whereis_command,
2515 _("Print line number and file of definition of variable."));
2518 add_info ("display", display_info, _("\
2519 Expressions to display when program stops, with code numbers."));
2521 add_cmd ("undisplay", class_vars, undisplay_command, _("\
2522 Cancel some expressions to be displayed when program stops.\n\
2523 Arguments are the code numbers of the expressions to stop displaying.\n\
2524 No argument means cancel all automatic-display expressions.\n\
2525 \"delete display\" has the same effect as this command.\n\
2526 Do \"info display\" to see current list of code numbers."),
2529 add_com ("display", class_vars, display_command, _("\
2530 Print value of expression EXP each time the program stops.\n\
2531 /FMT may be used before EXP as in the \"print\" command.\n\
2532 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2533 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2534 and examining is done as in the \"x\" command.\n\n\
2535 With no argument, display all currently requested auto-display expressions.\n\
2536 Use \"undisplay\" to cancel display requests previously made."));
2538 add_cmd ("display", class_vars, enable_display_command, _("\
2539 Enable some expressions to be displayed when program stops.\n\
2540 Arguments are the code numbers of the expressions to resume displaying.\n\
2541 No argument means enable all automatic-display expressions.\n\
2542 Do \"info display\" to see current list of code numbers."), &enablelist);
2544 add_cmd ("display", class_vars, disable_display_command, _("\
2545 Disable some expressions to be displayed when program stops.\n\
2546 Arguments are the code numbers of the expressions to stop displaying.\n\
2547 No argument means disable all automatic-display expressions.\n\
2548 Do \"info display\" to see current list of code numbers."), &disablelist);
2550 add_cmd ("display", class_vars, undisplay_command, _("\
2551 Cancel some expressions to be displayed when program stops.\n\
2552 Arguments are the code numbers of the expressions to stop displaying.\n\
2553 No argument means cancel all automatic-display expressions.\n\
2554 Do \"info display\" to see current list of code numbers."), &deletelist);
2556 add_com ("printf", class_vars, printf_command, _("\
2557 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2558 This is useful for formatted output in user-defined commands."));
2560 add_com ("output", class_vars, output_command, _("\
2561 Like \"print\" but don't put in value history and don't print newline.\n\
2562 This is useful in user-defined commands."));
2564 add_prefix_cmd ("set", class_vars, set_command, _("\
2565 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2566 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2567 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2568 with $), a register (a few standard names starting with $), or an actual\n\
2569 variable in the program being debugged. EXP is any valid expression.\n\
2570 Use \"set variable\" for variables with names identical to set subcommands.\n\
2572 With a subcommand, this command modifies parts of the gdb environment.\n\
2573 You can see these environment settings with the \"show\" command."),
2574 &setlist, "set ", 1, &cmdlist);
2576 add_com ("assign", class_vars, set_command, _("\
2577 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2578 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2579 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2580 with $), a register (a few standard names starting with $), or an actual\n\
2581 variable in the program being debugged. EXP is any valid expression.\n\
2582 Use \"set variable\" for variables with names identical to set subcommands.\n\
2583 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2584 You can see these environment settings with the \"show\" command."));
2586 /* "call" is the same as "set", but handy for dbx users to call fns. */
2587 c = add_com ("call", class_vars, call_command, _("\
2588 Call a function in the program.\n\
2589 The argument is the function name and arguments, in the notation of the\n\
2590 current working language. The result is printed and saved in the value\n\
2591 history, if it is not void."));
2592 set_cmd_completer (c, expression_completer);
2594 add_cmd ("variable", class_vars, set_command, _("\
2595 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2596 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2597 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2598 with $), a register (a few standard names starting with $), or an actual\n\
2599 variable in the program being debugged. EXP is any valid expression.\n\
2600 This may usually be abbreviated to simply \"set\"."),
2603 c = add_com ("print", class_vars, print_command, _("\
2604 Print value of expression EXP.\n\
2605 Variables accessible are those of the lexical environment of the selected\n\
2606 stack frame, plus all those whose scope is global or an entire file.\n\
2608 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2609 $$NUM refers to NUM'th value back from the last one.\n\
2610 Names starting with $ refer to registers (with the values they would have\n\
2611 if the program were to return to the stack frame now selected, restoring\n\
2612 all registers saved by frames farther in) or else to debugger\n\
2613 \"convenience\" variables (any such name not a known register).\n\
2614 Use assignment expressions to give values to convenience variables.\n\
2616 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2617 @ is a binary operator for treating consecutive data objects\n\
2618 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2619 element is FOO, whose second element is stored in the space following\n\
2620 where FOO is stored, etc. FOO must be an expression whose value\n\
2621 resides in memory.\n\
2623 EXP may be preceded with /FMT, where FMT is a format letter\n\
2624 but no count or size letter (see \"x\" command)."));
2625 set_cmd_completer (c, expression_completer);
2626 add_com_alias ("p", "print", class_vars, 1);
2627 add_com_alias ("inspect", "print", class_vars, 1);
2629 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class,
2630 &max_symbolic_offset, _("\
2631 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2632 Show the largest offset that will be printed in <symbol+1234> form."), _("\
2633 Tell GDB to only display the symbolic form of an address if the\n\
2634 offset between the closest earlier symbol and the address is less than\n\
2635 the specified maximum offset. The default is \"unlimited\", which tells GDB\n\
2636 to always print the symbolic form of an address if any symbol precedes\n\
2637 it. Zero is equivalent to \"unlimited\"."),
2639 show_max_symbolic_offset,
2640 &setprintlist, &showprintlist);
2641 add_setshow_boolean_cmd ("symbol-filename", no_class,
2642 &print_symbol_filename, _("\
2643 Set printing of source filename and line number with <symbol>."), _("\
2644 Show printing of source filename and line number with <symbol>."), NULL,
2646 show_print_symbol_filename,
2647 &setprintlist, &showprintlist);
2649 add_com ("eval", no_class, eval_command, _("\
2650 Convert \"printf format string\", arg1, arg2, arg3, ..., argn to\n\
2651 a command line, and call it."));