1 /* Print values for GNU debugger GDB.
3 Copyright (C) 1986-2014 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/>. */
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 */
43 #include "exceptions.h"
46 #include "parser-defs.h"
48 #include "arch-utils.h"
49 #include "cli/cli-utils.h"
54 #include "tui/tui.h" /* For tui_active et al. */
63 /* True if the value should be printed raw -- that is, bypassing
64 python-based formatters. */
68 /* Last specified output format. */
70 static char last_format = 0;
72 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
74 static char last_size = 'w';
76 /* Default address to examine next, and associated architecture. */
78 static struct gdbarch *next_gdbarch;
79 static CORE_ADDR next_address;
81 /* Number of delay instructions following current disassembled insn. */
83 static int branch_delay_insns;
85 /* Last address examined. */
87 static CORE_ADDR last_examine_address;
89 /* Contents of last address examined.
90 This is not valid past the end of the `x' command! */
92 static struct value *last_examine_value;
94 /* Largest offset between a symbolic value and an address, that will be
95 printed as `0x1234 <symbol+offset>'. */
97 static unsigned int max_symbolic_offset = UINT_MAX;
99 show_max_symbolic_offset (struct ui_file *file, int from_tty,
100 struct cmd_list_element *c, const char *value)
102 fprintf_filtered (file,
103 _("The largest offset that will be "
104 "printed in <symbol+1234> form is %s.\n"),
108 /* Append the source filename and linenumber of the symbol when
109 printing a symbolic value as `<symbol at filename:linenum>' if set. */
110 static int print_symbol_filename = 0;
112 show_print_symbol_filename (struct ui_file *file, int from_tty,
113 struct cmd_list_element *c, const char *value)
115 fprintf_filtered (file, _("Printing of source filename and "
116 "line number with <symbol> is %s.\n"),
120 /* Number of auto-display expression currently being displayed.
121 So that we can disable it if we get a signal within it.
122 -1 when not doing one. */
124 static int current_display_number;
128 /* Chain link to next auto-display item. */
129 struct display *next;
131 /* The expression as the user typed it. */
134 /* Expression to be evaluated and displayed. */
135 struct expression *exp;
137 /* Item number of this auto-display item. */
140 /* Display format specified. */
141 struct format_data format;
143 /* Program space associated with `block'. */
144 struct program_space *pspace;
146 /* Innermost block required by this expression when evaluated. */
147 const struct block *block;
149 /* Status of this display (enabled or disabled). */
153 /* Chain of expressions whose values should be displayed
154 automatically each time the program stops. */
156 static struct display *display_chain;
158 static int display_number;
160 /* Walk the following statement or block through all displays.
161 ALL_DISPLAYS_SAFE does so even if the statement deletes the current
164 #define ALL_DISPLAYS(B) \
165 for (B = display_chain; B; B = B->next)
167 #define ALL_DISPLAYS_SAFE(B,TMP) \
168 for (B = display_chain; \
169 B ? (TMP = B->next, 1): 0; \
172 /* Prototypes for exported functions. */
174 void _initialize_printcmd (void);
176 /* Prototypes for local functions. */
178 static void do_one_display (struct display *);
181 /* Decode a format specification. *STRING_PTR should point to it.
182 OFORMAT and OSIZE are used as defaults for the format and size
183 if none are given in the format specification.
184 If OSIZE is zero, then the size field of the returned value
185 should be set only if a size is explicitly specified by the
187 The structure returned describes all the data
188 found in the specification. In addition, *STRING_PTR is advanced
189 past the specification and past all whitespace following it. */
191 static struct format_data
192 decode_format (const char **string_ptr, int oformat, int osize)
194 struct format_data val;
195 const char *p = *string_ptr;
202 if (*p >= '0' && *p <= '9')
203 val.count = atoi (p);
204 while (*p >= '0' && *p <= '9')
207 /* Now process size or format letters that follow. */
211 if (*p == 'b' || *p == 'h' || *p == 'w' || *p == 'g')
218 else if (*p >= 'a' && *p <= 'z')
224 while (*p == ' ' || *p == '\t')
228 /* Set defaults for format and size if not specified. */
229 if (val.format == '?')
233 /* Neither has been specified. */
234 val.format = oformat;
238 /* If a size is specified, any format makes a reasonable
239 default except 'i'. */
240 val.format = oformat == 'i' ? 'x' : oformat;
242 else if (val.size == '?')
246 /* Pick the appropriate size for an address. This is deferred
247 until do_examine when we know the actual architecture to use.
248 A special size value of 'a' is used to indicate this case. */
249 val.size = osize ? 'a' : osize;
252 /* Floating point has to be word or giantword. */
253 if (osize == 'w' || osize == 'g')
256 /* Default it to giantword if the last used size is not
258 val.size = osize ? 'g' : osize;
261 /* Characters default to one byte. */
262 val.size = osize ? 'b' : osize;
265 /* Display strings with byte size chars unless explicitly
271 /* The default is the size most recently specified. */
278 /* Print value VAL on stream according to OPTIONS.
279 Do not end with a newline.
280 SIZE is the letter for the size of datum being printed.
281 This is used to pad hex numbers so they line up. SIZE is 0
282 for print / output and set for examine. */
285 print_formatted (struct value *val, int size,
286 const struct value_print_options *options,
287 struct ui_file *stream)
289 struct type *type = check_typedef (value_type (val));
290 int len = TYPE_LENGTH (type);
292 if (VALUE_LVAL (val) == lval_memory)
293 next_address = value_address (val) + len;
297 switch (options->format)
301 struct type *elttype = value_type (val);
303 next_address = (value_address (val)
304 + val_print_string (elttype, NULL,
305 value_address (val), -1,
306 stream, options) * len);
311 /* We often wrap here if there are long symbolic names. */
313 next_address = (value_address (val)
314 + gdb_print_insn (get_type_arch (type),
315 value_address (val), stream,
316 &branch_delay_insns));
321 if (options->format == 0 || options->format == 's'
322 || TYPE_CODE (type) == TYPE_CODE_REF
323 || TYPE_CODE (type) == TYPE_CODE_ARRAY
324 || TYPE_CODE (type) == TYPE_CODE_STRING
325 || TYPE_CODE (type) == TYPE_CODE_STRUCT
326 || TYPE_CODE (type) == TYPE_CODE_UNION
327 || TYPE_CODE (type) == TYPE_CODE_NAMESPACE)
328 value_print (val, stream, options);
330 /* User specified format, so don't look to the type to tell us
332 val_print_scalar_formatted (type,
333 value_contents_for_printing (val),
334 value_embedded_offset (val),
336 options, size, stream);
339 /* Return builtin floating point type of same length as TYPE.
340 If no such type is found, return TYPE itself. */
342 float_type_from_length (struct type *type)
344 struct gdbarch *gdbarch = get_type_arch (type);
345 const struct builtin_type *builtin = builtin_type (gdbarch);
347 if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_float))
348 type = builtin->builtin_float;
349 else if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_double))
350 type = builtin->builtin_double;
351 else if (TYPE_LENGTH (type) == TYPE_LENGTH (builtin->builtin_long_double))
352 type = builtin->builtin_long_double;
357 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
358 according to OPTIONS and SIZE on STREAM. Formats s and i are not
359 supported at this level. */
362 print_scalar_formatted (const void *valaddr, struct type *type,
363 const struct value_print_options *options,
364 int size, struct ui_file *stream)
366 struct gdbarch *gdbarch = get_type_arch (type);
367 LONGEST val_long = 0;
368 unsigned int len = TYPE_LENGTH (type);
369 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
371 /* String printing should go through val_print_scalar_formatted. */
372 gdb_assert (options->format != 's');
374 if (len > sizeof(LONGEST) &&
375 (TYPE_CODE (type) == TYPE_CODE_INT
376 || TYPE_CODE (type) == TYPE_CODE_ENUM))
378 switch (options->format)
381 print_octal_chars (stream, valaddr, len, byte_order);
385 print_decimal_chars (stream, valaddr, len, byte_order);
388 print_binary_chars (stream, valaddr, len, byte_order);
391 print_hex_chars (stream, valaddr, len, byte_order);
394 print_char_chars (stream, type, valaddr, len, byte_order);
401 if (options->format != 'f')
402 val_long = unpack_long (type, valaddr);
404 /* If the value is a pointer, and pointers and addresses are not the
405 same, then at this point, the value's length (in target bytes) is
406 gdbarch_addr_bit/TARGET_CHAR_BIT, not TYPE_LENGTH (type). */
407 if (TYPE_CODE (type) == TYPE_CODE_PTR)
408 len = gdbarch_addr_bit (gdbarch) / TARGET_CHAR_BIT;
410 /* If we are printing it as unsigned, truncate it in case it is actually
411 a negative signed value (e.g. "print/u (short)-1" should print 65535
412 (if shorts are 16 bits) instead of 4294967295). */
413 if (options->format != 'd' || TYPE_UNSIGNED (type))
415 if (len < sizeof (LONGEST))
416 val_long &= ((LONGEST) 1 << HOST_CHAR_BIT * len) - 1;
419 switch (options->format)
424 /* No size specified, like in print. Print varying # of digits. */
425 print_longest (stream, 'x', 1, val_long);
434 print_longest (stream, size, 1, val_long);
437 error (_("Undefined output size \"%c\"."), size);
442 print_longest (stream, 'd', 1, val_long);
446 print_longest (stream, 'u', 0, val_long);
451 print_longest (stream, 'o', 1, val_long);
453 fprintf_filtered (stream, "0");
458 CORE_ADDR addr = unpack_pointer (type, valaddr);
460 print_address (gdbarch, addr, stream);
466 struct value_print_options opts = *options;
469 if (TYPE_UNSIGNED (type))
470 type = builtin_type (gdbarch)->builtin_true_unsigned_char;
472 type = builtin_type (gdbarch)->builtin_true_char;
474 value_print (value_from_longest (type, val_long), stream, &opts);
479 type = float_type_from_length (type);
480 print_floating (valaddr, type, stream);
484 internal_error (__FILE__, __LINE__,
485 _("failed internal consistency check"));
488 /* Binary; 't' stands for "two". */
490 char bits[8 * (sizeof val_long) + 1];
491 char buf[8 * (sizeof val_long) + 32];
496 width = 8 * (sizeof val_long);
513 error (_("Undefined output size \"%c\"."), size);
519 bits[width] = (val_long & 1) ? '1' : '0';
524 while (*cp && *cp == '0')
529 strncpy (buf, cp, sizeof (bits));
530 fputs_filtered (buf, stream);
535 print_hex_chars (stream, valaddr, len, byte_order);
539 error (_("Undefined output format \"%c\"."), options->format);
543 /* Specify default address for `x' command.
544 The `info lines' command uses this. */
547 set_next_address (struct gdbarch *gdbarch, CORE_ADDR addr)
549 struct type *ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
551 next_gdbarch = gdbarch;
554 /* Make address available to the user as $_. */
555 set_internalvar (lookup_internalvar ("_"),
556 value_from_pointer (ptr_type, addr));
559 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
560 after LEADIN. Print nothing if no symbolic name is found nearby.
561 Optionally also print source file and line number, if available.
562 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
563 or to interpret it as a possible C++ name and convert it back to source
564 form. However note that DO_DEMANGLE can be overridden by the specific
565 settings of the demangle and asm_demangle variables. Returns
566 non-zero if anything was printed; zero otherwise. */
569 print_address_symbolic (struct gdbarch *gdbarch, CORE_ADDR addr,
570 struct ui_file *stream,
571 int do_demangle, char *leadin)
574 char *filename = NULL;
579 /* Throw away both name and filename. */
580 struct cleanup *cleanup_chain = make_cleanup (free_current_contents, &name);
581 make_cleanup (free_current_contents, &filename);
583 if (build_address_symbolic (gdbarch, addr, do_demangle, &name, &offset,
584 &filename, &line, &unmapped))
586 do_cleanups (cleanup_chain);
590 fputs_filtered (leadin, stream);
592 fputs_filtered ("<*", stream);
594 fputs_filtered ("<", stream);
595 fputs_filtered (name, stream);
597 fprintf_filtered (stream, "+%u", (unsigned int) offset);
599 /* Append source filename and line number if desired. Give specific
600 line # of this addr, if we have it; else line # of the nearest symbol. */
601 if (print_symbol_filename && filename != NULL)
604 fprintf_filtered (stream, " at %s:%d", filename, line);
606 fprintf_filtered (stream, " in %s", filename);
609 fputs_filtered ("*>", stream);
611 fputs_filtered (">", stream);
613 do_cleanups (cleanup_chain);
617 /* Given an address ADDR return all the elements needed to print the
618 address in a symbolic form. NAME can be mangled or not depending
619 on DO_DEMANGLE (and also on the asm_demangle global variable,
620 manipulated via ''set print asm-demangle''). Return 0 in case of
621 success, when all the info in the OUT paramters is valid. Return 1
624 build_address_symbolic (struct gdbarch *gdbarch,
625 CORE_ADDR addr, /* IN */
626 int do_demangle, /* IN */
627 char **name, /* OUT */
628 int *offset, /* OUT */
629 char **filename, /* OUT */
631 int *unmapped) /* OUT */
633 struct bound_minimal_symbol msymbol;
634 struct symbol *symbol;
635 CORE_ADDR name_location = 0;
636 struct obj_section *section = NULL;
637 const char *name_temp = "";
639 /* Let's say it is mapped (not unmapped). */
642 /* Determine if the address is in an overlay, and whether it is
644 if (overlay_debugging)
646 section = find_pc_overlay (addr);
647 if (pc_in_unmapped_range (addr, section))
650 addr = overlay_mapped_address (addr, section);
654 /* First try to find the address in the symbol table, then
655 in the minsyms. Take the closest one. */
657 /* This is defective in the sense that it only finds text symbols. So
658 really this is kind of pointless--we should make sure that the
659 minimal symbols have everything we need (by changing that we could
660 save some memory, but for many debug format--ELF/DWARF or
661 anything/stabs--it would be inconvenient to eliminate those minimal
663 msymbol = lookup_minimal_symbol_by_pc_section (addr, section);
664 symbol = find_pc_sect_function (addr, section);
668 /* If this is a function (i.e. a code address), strip out any
669 non-address bits. For instance, display a pointer to the
670 first instruction of a Thumb function as <function>; the
671 second instruction will be <function+2>, even though the
672 pointer is <function+3>. This matches the ISA behavior. */
673 addr = gdbarch_addr_bits_remove (gdbarch, addr);
675 name_location = BLOCK_START (SYMBOL_BLOCK_VALUE (symbol));
676 if (do_demangle || asm_demangle)
677 name_temp = SYMBOL_PRINT_NAME (symbol);
679 name_temp = SYMBOL_LINKAGE_NAME (symbol);
682 if (msymbol.minsym != NULL
683 && MSYMBOL_HAS_SIZE (msymbol.minsym)
684 && MSYMBOL_SIZE (msymbol.minsym) == 0
685 && MSYMBOL_TYPE (msymbol.minsym) != mst_text
686 && MSYMBOL_TYPE (msymbol.minsym) != mst_text_gnu_ifunc
687 && MSYMBOL_TYPE (msymbol.minsym) != mst_file_text)
688 msymbol.minsym = NULL;
690 if (msymbol.minsym != NULL)
692 if (BMSYMBOL_VALUE_ADDRESS (msymbol) > name_location || symbol == NULL)
694 /* If this is a function (i.e. a code address), strip out any
695 non-address bits. For instance, display a pointer to the
696 first instruction of a Thumb function as <function>; the
697 second instruction will be <function+2>, even though the
698 pointer is <function+3>. This matches the ISA behavior. */
699 if (MSYMBOL_TYPE (msymbol.minsym) == mst_text
700 || MSYMBOL_TYPE (msymbol.minsym) == mst_text_gnu_ifunc
701 || MSYMBOL_TYPE (msymbol.minsym) == mst_file_text
702 || MSYMBOL_TYPE (msymbol.minsym) == mst_solib_trampoline)
703 addr = gdbarch_addr_bits_remove (gdbarch, addr);
705 /* The msymbol is closer to the address than the symbol;
706 use the msymbol instead. */
708 name_location = BMSYMBOL_VALUE_ADDRESS (msymbol);
709 if (do_demangle || asm_demangle)
710 name_temp = MSYMBOL_PRINT_NAME (msymbol.minsym);
712 name_temp = MSYMBOL_LINKAGE_NAME (msymbol.minsym);
715 if (symbol == NULL && msymbol.minsym == NULL)
718 /* If the nearest symbol is too far away, don't print anything symbolic. */
720 /* For when CORE_ADDR is larger than unsigned int, we do math in
721 CORE_ADDR. But when we detect unsigned wraparound in the
722 CORE_ADDR math, we ignore this test and print the offset,
723 because addr+max_symbolic_offset has wrapped through the end
724 of the address space back to the beginning, giving bogus comparison. */
725 if (addr > name_location + max_symbolic_offset
726 && name_location + max_symbolic_offset > name_location)
729 *offset = addr - name_location;
731 *name = xstrdup (name_temp);
733 if (print_symbol_filename)
735 struct symtab_and_line sal;
737 sal = find_pc_sect_line (addr, section, 0);
741 *filename = xstrdup (symtab_to_filename_for_display (sal.symtab));
749 /* Print address ADDR symbolically on STREAM.
750 First print it as a number. Then perhaps print
751 <SYMBOL + OFFSET> after the number. */
754 print_address (struct gdbarch *gdbarch,
755 CORE_ADDR addr, struct ui_file *stream)
757 fputs_filtered (paddress (gdbarch, addr), stream);
758 print_address_symbolic (gdbarch, addr, stream, asm_demangle, " ");
761 /* Return a prefix for instruction address:
762 "=> " for current instruction, else " ". */
765 pc_prefix (CORE_ADDR addr)
767 if (has_stack_frames ())
769 struct frame_info *frame;
772 frame = get_selected_frame (NULL);
773 if (get_frame_pc_if_available (frame, &pc) && pc == addr)
779 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
780 controls whether to print the symbolic name "raw" or demangled.
781 Return non-zero if anything was printed; zero otherwise. */
784 print_address_demangle (const struct value_print_options *opts,
785 struct gdbarch *gdbarch, CORE_ADDR addr,
786 struct ui_file *stream, int do_demangle)
788 if (opts->addressprint)
790 fputs_filtered (paddress (gdbarch, addr), stream);
791 print_address_symbolic (gdbarch, addr, stream, do_demangle, " ");
795 return print_address_symbolic (gdbarch, addr, stream, do_demangle, "");
801 /* Examine data at address ADDR in format FMT.
802 Fetch it from memory and print on gdb_stdout. */
805 do_examine (struct format_data fmt, struct gdbarch *gdbarch, CORE_ADDR addr)
810 struct type *val_type = NULL;
813 struct value_print_options opts;
818 next_gdbarch = gdbarch;
821 /* Instruction format implies fetch single bytes
822 regardless of the specified size.
823 The case of strings is handled in decode_format, only explicit
824 size operator are not changed to 'b'. */
830 /* Pick the appropriate size for an address. */
831 if (gdbarch_ptr_bit (next_gdbarch) == 64)
833 else if (gdbarch_ptr_bit (next_gdbarch) == 32)
835 else if (gdbarch_ptr_bit (next_gdbarch) == 16)
838 /* Bad value for gdbarch_ptr_bit. */
839 internal_error (__FILE__, __LINE__,
840 _("failed internal consistency check"));
844 val_type = builtin_type (next_gdbarch)->builtin_int8;
845 else if (size == 'h')
846 val_type = builtin_type (next_gdbarch)->builtin_int16;
847 else if (size == 'w')
848 val_type = builtin_type (next_gdbarch)->builtin_int32;
849 else if (size == 'g')
850 val_type = builtin_type (next_gdbarch)->builtin_int64;
854 struct type *char_type = NULL;
856 /* Search for "char16_t" or "char32_t" types or fall back to 8-bit char
857 if type is not found. */
859 char_type = builtin_type (next_gdbarch)->builtin_char16;
860 else if (size == 'w')
861 char_type = builtin_type (next_gdbarch)->builtin_char32;
863 val_type = char_type;
866 if (size != '\0' && size != 'b')
867 warning (_("Unable to display strings with "
868 "size '%c', using 'b' instead."), size);
870 val_type = builtin_type (next_gdbarch)->builtin_int8;
879 if (format == 's' || format == 'i')
882 get_formatted_print_options (&opts, format);
884 /* Print as many objects as specified in COUNT, at most maxelts per line,
885 with the address of the next one at the start of each line. */
891 fputs_filtered (pc_prefix (next_address), gdb_stdout);
892 print_address (next_gdbarch, next_address, gdb_stdout);
893 printf_filtered (":");
898 printf_filtered ("\t");
899 /* Note that print_formatted sets next_address for the next
901 last_examine_address = next_address;
903 if (last_examine_value)
904 value_free (last_examine_value);
906 /* The value to be displayed is not fetched greedily.
907 Instead, to avoid the possibility of a fetched value not
908 being used, its retrieval is delayed until the print code
909 uses it. When examining an instruction stream, the
910 disassembler will perform its own memory fetch using just
911 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
912 the disassembler be modified so that LAST_EXAMINE_VALUE
913 is left with the byte sequence from the last complete
914 instruction fetched from memory? */
915 last_examine_value = value_at_lazy (val_type, next_address);
917 if (last_examine_value)
918 release_value (last_examine_value);
920 print_formatted (last_examine_value, size, &opts, gdb_stdout);
922 /* Display any branch delay slots following the final insn. */
923 if (format == 'i' && count == 1)
924 count += branch_delay_insns;
926 printf_filtered ("\n");
927 gdb_flush (gdb_stdout);
932 validate_format (struct format_data fmt, char *cmdname)
935 error (_("Size letters are meaningless in \"%s\" command."), cmdname);
937 error (_("Item count other than 1 is meaningless in \"%s\" command."),
939 if (fmt.format == 'i')
940 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
941 fmt.format, cmdname);
944 /* Evaluate string EXP as an expression in the current language and
945 print the resulting value. EXP may contain a format specifier as the
946 first argument ("/x myvar" for example, to print myvar in hex). */
949 print_command_1 (const char *exp, int voidprint)
951 struct expression *expr;
952 struct cleanup *old_chain = make_cleanup (null_cleanup, NULL);
955 struct format_data fmt;
957 if (exp && *exp == '/')
960 fmt = decode_format (&exp, last_format, 0);
961 validate_format (fmt, "print");
962 last_format = format = fmt.format;
974 expr = parse_expression (exp);
975 make_cleanup (free_current_contents, &expr);
976 val = evaluate_expression (expr);
979 val = access_value_history (0);
981 if (voidprint || (val && value_type (val) &&
982 TYPE_CODE (value_type (val)) != TYPE_CODE_VOID))
984 struct value_print_options opts;
985 int histindex = record_latest_value (val);
987 annotate_value_history_begin (histindex, value_type (val));
989 printf_filtered ("$%d = ", histindex);
991 annotate_value_history_value ();
993 get_formatted_print_options (&opts, format);
996 print_formatted (val, fmt.size, &opts, gdb_stdout);
997 printf_filtered ("\n");
999 annotate_value_history_end ();
1002 do_cleanups (old_chain);
1006 print_command (char *exp, int from_tty)
1008 print_command_1 (exp, 1);
1011 /* Same as print, except it doesn't print void results. */
1013 call_command (char *exp, int from_tty)
1015 print_command_1 (exp, 0);
1018 /* Implementation of the "output" command. */
1021 output_command (char *exp, int from_tty)
1023 output_command_const (exp, from_tty);
1026 /* Like output_command, but takes a const string as argument. */
1029 output_command_const (const char *exp, int from_tty)
1031 struct expression *expr;
1032 struct cleanup *old_chain;
1035 struct format_data fmt;
1036 struct value_print_options opts;
1041 if (exp && *exp == '/')
1044 fmt = decode_format (&exp, 0, 0);
1045 validate_format (fmt, "output");
1046 format = fmt.format;
1049 expr = parse_expression (exp);
1050 old_chain = make_cleanup (free_current_contents, &expr);
1052 val = evaluate_expression (expr);
1054 annotate_value_begin (value_type (val));
1056 get_formatted_print_options (&opts, format);
1058 print_formatted (val, fmt.size, &opts, gdb_stdout);
1060 annotate_value_end ();
1063 gdb_flush (gdb_stdout);
1065 do_cleanups (old_chain);
1069 set_command (char *exp, int from_tty)
1071 struct expression *expr = parse_expression (exp);
1072 struct cleanup *old_chain =
1073 make_cleanup (free_current_contents, &expr);
1075 if (expr->nelts >= 1)
1076 switch (expr->elts[0].opcode)
1078 case UNOP_PREINCREMENT:
1079 case UNOP_POSTINCREMENT:
1080 case UNOP_PREDECREMENT:
1081 case UNOP_POSTDECREMENT:
1083 case BINOP_ASSIGN_MODIFY:
1088 (_("Expression is not an assignment (and might have no effect)"));
1091 evaluate_expression (expr);
1092 do_cleanups (old_chain);
1096 sym_info (char *arg, int from_tty)
1098 struct minimal_symbol *msymbol;
1099 struct objfile *objfile;
1100 struct obj_section *osect;
1101 CORE_ADDR addr, sect_addr;
1103 unsigned int offset;
1106 error_no_arg (_("address"));
1108 addr = parse_and_eval_address (arg);
1109 ALL_OBJSECTIONS (objfile, osect)
1111 /* Only process each object file once, even if there's a separate
1113 if (objfile->separate_debug_objfile_backlink)
1116 sect_addr = overlay_mapped_address (addr, osect);
1118 if (obj_section_addr (osect) <= sect_addr
1119 && sect_addr < obj_section_endaddr (osect)
1121 = lookup_minimal_symbol_by_pc_section (sect_addr, osect).minsym))
1123 const char *obj_name, *mapped, *sec_name, *msym_name;
1125 struct cleanup *old_chain;
1128 offset = sect_addr - MSYMBOL_VALUE_ADDRESS (objfile, msymbol);
1129 mapped = section_is_mapped (osect) ? _("mapped") : _("unmapped");
1130 sec_name = osect->the_bfd_section->name;
1131 msym_name = MSYMBOL_PRINT_NAME (msymbol);
1133 /* Don't print the offset if it is zero.
1134 We assume there's no need to handle i18n of "sym + offset". */
1136 loc_string = xstrprintf ("%s + %u", msym_name, offset);
1138 loc_string = xstrprintf ("%s", msym_name);
1140 /* Use a cleanup to free loc_string in case the user quits
1141 a pagination request inside printf_filtered. */
1142 old_chain = make_cleanup (xfree, loc_string);
1144 gdb_assert (osect->objfile && objfile_name (osect->objfile));
1145 obj_name = objfile_name (osect->objfile);
1147 if (MULTI_OBJFILE_P ())
1148 if (pc_in_unmapped_range (addr, osect))
1149 if (section_is_overlay (osect))
1150 printf_filtered (_("%s in load address range of "
1151 "%s overlay section %s of %s\n"),
1152 loc_string, mapped, sec_name, obj_name);
1154 printf_filtered (_("%s in load address range of "
1155 "section %s of %s\n"),
1156 loc_string, sec_name, obj_name);
1158 if (section_is_overlay (osect))
1159 printf_filtered (_("%s in %s overlay section %s of %s\n"),
1160 loc_string, mapped, sec_name, obj_name);
1162 printf_filtered (_("%s in section %s of %s\n"),
1163 loc_string, sec_name, obj_name);
1165 if (pc_in_unmapped_range (addr, osect))
1166 if (section_is_overlay (osect))
1167 printf_filtered (_("%s in load address range of %s overlay "
1169 loc_string, mapped, sec_name);
1171 printf_filtered (_("%s in load address range of section %s\n"),
1172 loc_string, sec_name);
1174 if (section_is_overlay (osect))
1175 printf_filtered (_("%s in %s overlay section %s\n"),
1176 loc_string, mapped, sec_name);
1178 printf_filtered (_("%s in section %s\n"),
1179 loc_string, sec_name);
1181 do_cleanups (old_chain);
1185 printf_filtered (_("No symbol matches %s.\n"), arg);
1189 address_info (char *exp, int from_tty)
1191 struct gdbarch *gdbarch;
1194 struct bound_minimal_symbol msymbol;
1196 struct obj_section *section;
1197 CORE_ADDR load_addr, context_pc = 0;
1198 struct field_of_this_result is_a_field_of_this;
1201 error (_("Argument required."));
1203 sym = lookup_symbol (exp, get_selected_block (&context_pc), VAR_DOMAIN,
1204 &is_a_field_of_this);
1207 if (is_a_field_of_this.type != NULL)
1209 printf_filtered ("Symbol \"");
1210 fprintf_symbol_filtered (gdb_stdout, exp,
1211 current_language->la_language, DMGL_ANSI);
1212 printf_filtered ("\" is a field of the local class variable ");
1213 if (current_language->la_language == language_objc)
1214 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1216 printf_filtered ("`this'\n");
1220 msymbol = lookup_bound_minimal_symbol (exp);
1222 if (msymbol.minsym != NULL)
1224 struct objfile *objfile = msymbol.objfile;
1226 gdbarch = get_objfile_arch (objfile);
1227 load_addr = BMSYMBOL_VALUE_ADDRESS (msymbol);
1229 printf_filtered ("Symbol \"");
1230 fprintf_symbol_filtered (gdb_stdout, exp,
1231 current_language->la_language, DMGL_ANSI);
1232 printf_filtered ("\" is at ");
1233 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1234 printf_filtered (" in a file compiled without debugging");
1235 section = MSYMBOL_OBJ_SECTION (objfile, msymbol.minsym);
1236 if (section_is_overlay (section))
1238 load_addr = overlay_unmapped_address (load_addr, section);
1239 printf_filtered (",\n -- loaded at ");
1240 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1241 printf_filtered (" in overlay section %s",
1242 section->the_bfd_section->name);
1244 printf_filtered (".\n");
1247 error (_("No symbol \"%s\" in current context."), exp);
1251 printf_filtered ("Symbol \"");
1252 fprintf_symbol_filtered (gdb_stdout, SYMBOL_PRINT_NAME (sym),
1253 current_language->la_language, DMGL_ANSI);
1254 printf_filtered ("\" is ");
1255 val = SYMBOL_VALUE (sym);
1256 section = SYMBOL_OBJ_SECTION (SYMBOL_OBJFILE (sym), sym);
1257 gdbarch = get_objfile_arch (SYMBOL_SYMTAB (sym)->objfile);
1259 if (SYMBOL_COMPUTED_OPS (sym) != NULL)
1261 SYMBOL_COMPUTED_OPS (sym)->describe_location (sym, context_pc,
1263 printf_filtered (".\n");
1267 switch (SYMBOL_CLASS (sym))
1270 case LOC_CONST_BYTES:
1271 printf_filtered ("constant");
1275 printf_filtered ("a label at address ");
1276 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1277 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1278 if (section_is_overlay (section))
1280 load_addr = overlay_unmapped_address (load_addr, section);
1281 printf_filtered (",\n -- loaded at ");
1282 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1283 printf_filtered (" in overlay section %s",
1284 section->the_bfd_section->name);
1289 gdb_assert_not_reached (_("LOC_COMPUTED variable missing a method"));
1292 /* GDBARCH is the architecture associated with the objfile the symbol
1293 is defined in; the target architecture may be different, and may
1294 provide additional registers. However, we do not know the target
1295 architecture at this point. We assume the objfile architecture
1296 will contain all the standard registers that occur in debug info
1298 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1300 if (SYMBOL_IS_ARGUMENT (sym))
1301 printf_filtered (_("an argument in register %s"),
1302 gdbarch_register_name (gdbarch, regno));
1304 printf_filtered (_("a variable in register %s"),
1305 gdbarch_register_name (gdbarch, regno));
1309 printf_filtered (_("static storage at address "));
1310 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1311 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1312 if (section_is_overlay (section))
1314 load_addr = overlay_unmapped_address (load_addr, section);
1315 printf_filtered (_(",\n -- loaded at "));
1316 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1317 printf_filtered (_(" in overlay section %s"),
1318 section->the_bfd_section->name);
1322 case LOC_REGPARM_ADDR:
1323 /* Note comment at LOC_REGISTER. */
1324 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1325 printf_filtered (_("address of an argument in register %s"),
1326 gdbarch_register_name (gdbarch, regno));
1330 printf_filtered (_("an argument at offset %ld"), val);
1334 printf_filtered (_("a local variable at frame offset %ld"), val);
1338 printf_filtered (_("a reference argument at offset %ld"), val);
1342 printf_filtered (_("a typedef"));
1346 printf_filtered (_("a function at address "));
1347 load_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1348 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1349 if (section_is_overlay (section))
1351 load_addr = overlay_unmapped_address (load_addr, section);
1352 printf_filtered (_(",\n -- loaded at "));
1353 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1354 printf_filtered (_(" in overlay section %s"),
1355 section->the_bfd_section->name);
1359 case LOC_UNRESOLVED:
1361 struct bound_minimal_symbol msym;
1363 msym = lookup_minimal_symbol_and_objfile (SYMBOL_LINKAGE_NAME (sym));
1364 if (msym.minsym == NULL)
1365 printf_filtered ("unresolved");
1368 section = MSYMBOL_OBJ_SECTION (msym.objfile, msym.minsym);
1369 load_addr = BMSYMBOL_VALUE_ADDRESS (msym);
1372 && (section->the_bfd_section->flags & SEC_THREAD_LOCAL) != 0)
1373 printf_filtered (_("a thread-local variable at offset %s "
1374 "in the thread-local storage for `%s'"),
1375 paddress (gdbarch, load_addr),
1376 objfile_name (section->objfile));
1379 printf_filtered (_("static storage at address "));
1380 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1381 if (section_is_overlay (section))
1383 load_addr = overlay_unmapped_address (load_addr, section);
1384 printf_filtered (_(",\n -- loaded at "));
1385 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1386 printf_filtered (_(" in overlay section %s"),
1387 section->the_bfd_section->name);
1394 case LOC_OPTIMIZED_OUT:
1395 printf_filtered (_("optimized out"));
1399 printf_filtered (_("of unknown (botched) type"));
1402 printf_filtered (".\n");
1407 x_command (char *exp, int from_tty)
1409 struct expression *expr;
1410 struct format_data fmt;
1411 struct cleanup *old_chain;
1414 fmt.format = last_format ? last_format : 'x';
1415 fmt.size = last_size;
1419 if (exp && *exp == '/')
1421 const char *tmp = exp + 1;
1423 fmt = decode_format (&tmp, last_format, last_size);
1427 /* If we have an expression, evaluate it and use it as the address. */
1429 if (exp != 0 && *exp != 0)
1431 expr = parse_expression (exp);
1432 /* Cause expression not to be there any more if this command is
1433 repeated with Newline. But don't clobber a user-defined
1434 command's definition. */
1437 old_chain = make_cleanup (free_current_contents, &expr);
1438 val = evaluate_expression (expr);
1439 if (TYPE_CODE (value_type (val)) == TYPE_CODE_REF)
1440 val = coerce_ref (val);
1441 /* In rvalue contexts, such as this, functions are coerced into
1442 pointers to functions. This makes "x/i main" work. */
1443 if (/* last_format == 'i' && */
1444 TYPE_CODE (value_type (val)) == TYPE_CODE_FUNC
1445 && VALUE_LVAL (val) == lval_memory)
1446 next_address = value_address (val);
1448 next_address = value_as_address (val);
1450 next_gdbarch = expr->gdbarch;
1451 do_cleanups (old_chain);
1455 error_no_arg (_("starting display address"));
1457 do_examine (fmt, next_gdbarch, next_address);
1459 /* If the examine succeeds, we remember its size and format for next
1460 time. Set last_size to 'b' for strings. */
1461 if (fmt.format == 's')
1464 last_size = fmt.size;
1465 last_format = fmt.format;
1467 /* Set a couple of internal variables if appropriate. */
1468 if (last_examine_value)
1470 /* Make last address examined available to the user as $_. Use
1471 the correct pointer type. */
1472 struct type *pointer_type
1473 = lookup_pointer_type (value_type (last_examine_value));
1474 set_internalvar (lookup_internalvar ("_"),
1475 value_from_pointer (pointer_type,
1476 last_examine_address));
1478 /* Make contents of last address examined available to the user
1479 as $__. If the last value has not been fetched from memory
1480 then don't fetch it now; instead mark it by voiding the $__
1482 if (value_lazy (last_examine_value))
1483 clear_internalvar (lookup_internalvar ("__"));
1485 set_internalvar (lookup_internalvar ("__"), last_examine_value);
1490 /* Add an expression to the auto-display chain.
1491 Specify the expression. */
1494 display_command (char *arg, int from_tty)
1496 struct format_data fmt;
1497 struct expression *expr;
1498 struct display *new;
1500 const char *exp = arg;
1503 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1505 if (tui_active && exp != NULL && *exp == '$')
1506 display_it = (tui_set_layout_for_display_command (exp) == TUI_FAILURE);
1520 fmt = decode_format (&exp, 0, 0);
1521 if (fmt.size && fmt.format == 0)
1523 if (fmt.format == 'i' || fmt.format == 's')
1534 innermost_block = NULL;
1535 expr = parse_expression (exp);
1537 new = (struct display *) xmalloc (sizeof (struct display));
1539 new->exp_string = xstrdup (exp);
1541 new->block = innermost_block;
1542 new->pspace = current_program_space;
1543 new->next = display_chain;
1544 new->number = ++display_number;
1547 display_chain = new;
1550 do_one_display (new);
1557 free_display (struct display *d)
1559 xfree (d->exp_string);
1564 /* Clear out the display_chain. Done when new symtabs are loaded,
1565 since this invalidates the types stored in many expressions. */
1568 clear_displays (void)
1572 while ((d = display_chain) != NULL)
1574 display_chain = d->next;
1579 /* Delete the auto-display DISPLAY. */
1582 delete_display (struct display *display)
1586 gdb_assert (display != NULL);
1588 if (display_chain == display)
1589 display_chain = display->next;
1592 if (d->next == display)
1594 d->next = display->next;
1598 free_display (display);
1601 /* Call FUNCTION on each of the displays whose numbers are given in
1602 ARGS. DATA is passed unmodified to FUNCTION. */
1605 map_display_numbers (char *args,
1606 void (*function) (struct display *,
1610 struct get_number_or_range_state state;
1614 error_no_arg (_("one or more display numbers"));
1616 init_number_or_range (&state, args);
1618 while (!state.finished)
1620 const char *p = state.string;
1622 num = get_number_or_range (&state);
1624 warning (_("bad display number at or near '%s'"), p);
1627 struct display *d, *tmp;
1629 ALL_DISPLAYS_SAFE (d, tmp)
1630 if (d->number == num)
1633 printf_unfiltered (_("No display number %d.\n"), num);
1640 /* Callback for map_display_numbers, that deletes a display. */
1643 do_delete_display (struct display *d, void *data)
1648 /* "undisplay" command. */
1651 undisplay_command (char *args, int from_tty)
1655 if (query (_("Delete all auto-display expressions? ")))
1661 map_display_numbers (args, do_delete_display, NULL);
1665 /* Display a single auto-display.
1666 Do nothing if the display cannot be printed in the current context,
1667 or if the display is disabled. */
1670 do_one_display (struct display *d)
1672 struct cleanup *old_chain;
1673 int within_current_scope;
1675 if (d->enabled_p == 0)
1678 /* The expression carries the architecture that was used at parse time.
1679 This is a problem if the expression depends on architecture features
1680 (e.g. register numbers), and the current architecture is now different.
1681 For example, a display statement like "display/i $pc" is expected to
1682 display the PC register of the current architecture, not the arch at
1683 the time the display command was given. Therefore, we re-parse the
1684 expression if the current architecture has changed. */
1685 if (d->exp != NULL && d->exp->gdbarch != get_current_arch ())
1694 volatile struct gdb_exception ex;
1696 TRY_CATCH (ex, RETURN_MASK_ALL)
1698 innermost_block = NULL;
1699 d->exp = parse_expression (d->exp_string);
1700 d->block = innermost_block;
1704 /* Can't re-parse the expression. Disable this display item. */
1706 warning (_("Unable to display \"%s\": %s"),
1707 d->exp_string, ex.message);
1714 if (d->pspace == current_program_space)
1715 within_current_scope = contained_in (get_selected_block (0), d->block);
1717 within_current_scope = 0;
1720 within_current_scope = 1;
1721 if (!within_current_scope)
1724 old_chain = make_cleanup_restore_integer (¤t_display_number);
1725 current_display_number = d->number;
1727 annotate_display_begin ();
1728 printf_filtered ("%d", d->number);
1729 annotate_display_number_end ();
1730 printf_filtered (": ");
1733 volatile struct gdb_exception ex;
1735 annotate_display_format ();
1737 printf_filtered ("x/");
1738 if (d->format.count != 1)
1739 printf_filtered ("%d", d->format.count);
1740 printf_filtered ("%c", d->format.format);
1741 if (d->format.format != 'i' && d->format.format != 's')
1742 printf_filtered ("%c", d->format.size);
1743 printf_filtered (" ");
1745 annotate_display_expression ();
1747 puts_filtered (d->exp_string);
1748 annotate_display_expression_end ();
1750 if (d->format.count != 1 || d->format.format == 'i')
1751 printf_filtered ("\n");
1753 printf_filtered (" ");
1755 annotate_display_value ();
1757 TRY_CATCH (ex, RETURN_MASK_ERROR)
1762 val = evaluate_expression (d->exp);
1763 addr = value_as_address (val);
1764 if (d->format.format == 'i')
1765 addr = gdbarch_addr_bits_remove (d->exp->gdbarch, addr);
1766 do_examine (d->format, d->exp->gdbarch, addr);
1769 fprintf_filtered (gdb_stdout, _("<error: %s>\n"), ex.message);
1773 struct value_print_options opts;
1774 volatile struct gdb_exception ex;
1776 annotate_display_format ();
1778 if (d->format.format)
1779 printf_filtered ("/%c ", d->format.format);
1781 annotate_display_expression ();
1783 puts_filtered (d->exp_string);
1784 annotate_display_expression_end ();
1786 printf_filtered (" = ");
1788 annotate_display_expression ();
1790 get_formatted_print_options (&opts, d->format.format);
1791 opts.raw = d->format.raw;
1793 TRY_CATCH (ex, RETURN_MASK_ERROR)
1797 val = evaluate_expression (d->exp);
1798 print_formatted (val, d->format.size, &opts, gdb_stdout);
1801 fprintf_filtered (gdb_stdout, _("<error: %s>"), ex.message);
1802 printf_filtered ("\n");
1805 annotate_display_end ();
1807 gdb_flush (gdb_stdout);
1808 do_cleanups (old_chain);
1811 /* Display all of the values on the auto-display chain which can be
1812 evaluated in the current scope. */
1819 for (d = display_chain; d; d = d->next)
1823 /* Delete the auto-display which we were in the process of displaying.
1824 This is done when there is an error or a signal. */
1827 disable_display (int num)
1831 for (d = display_chain; d; d = d->next)
1832 if (d->number == num)
1837 printf_unfiltered (_("No display number %d.\n"), num);
1841 disable_current_display (void)
1843 if (current_display_number >= 0)
1845 disable_display (current_display_number);
1846 fprintf_unfiltered (gdb_stderr,
1847 _("Disabling display %d to "
1848 "avoid infinite recursion.\n"),
1849 current_display_number);
1851 current_display_number = -1;
1855 display_info (char *ignore, int from_tty)
1860 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1862 printf_filtered (_("Auto-display expressions now in effect:\n\
1863 Num Enb Expression\n"));
1865 for (d = display_chain; d; d = d->next)
1867 printf_filtered ("%d: %c ", d->number, "ny"[(int) d->enabled_p]);
1869 printf_filtered ("/%d%c%c ", d->format.count, d->format.size,
1871 else if (d->format.format)
1872 printf_filtered ("/%c ", d->format.format);
1873 puts_filtered (d->exp_string);
1874 if (d->block && !contained_in (get_selected_block (0), d->block))
1875 printf_filtered (_(" (cannot be evaluated in the current context)"));
1876 printf_filtered ("\n");
1877 gdb_flush (gdb_stdout);
1881 /* Callback fo map_display_numbers, that enables or disables the
1882 passed in display D. */
1885 do_enable_disable_display (struct display *d, void *data)
1887 d->enabled_p = *(int *) data;
1890 /* Implamentation of both the "disable display" and "enable display"
1891 commands. ENABLE decides what to do. */
1894 enable_disable_display_command (char *args, int from_tty, int enable)
1901 d->enabled_p = enable;
1905 map_display_numbers (args, do_enable_disable_display, &enable);
1908 /* The "enable display" command. */
1911 enable_display_command (char *args, int from_tty)
1913 enable_disable_display_command (args, from_tty, 1);
1916 /* The "disable display" command. */
1919 disable_display_command (char *args, int from_tty)
1921 enable_disable_display_command (args, from_tty, 0);
1924 /* display_chain items point to blocks and expressions. Some expressions in
1925 turn may point to symbols.
1926 Both symbols and blocks are obstack_alloc'd on objfile_stack, and are
1927 obstack_free'd when a shared library is unloaded.
1928 Clear pointers that are about to become dangling.
1929 Both .exp and .block fields will be restored next time we need to display
1930 an item by re-parsing .exp_string field in the new execution context. */
1933 clear_dangling_display_expressions (struct objfile *objfile)
1936 struct program_space *pspace;
1938 /* With no symbol file we cannot have a block or expression from it. */
1939 if (objfile == NULL)
1941 pspace = objfile->pspace;
1942 if (objfile->separate_debug_objfile_backlink)
1944 objfile = objfile->separate_debug_objfile_backlink;
1945 gdb_assert (objfile->pspace == pspace);
1948 for (d = display_chain; d != NULL; d = d->next)
1950 if (d->pspace != pspace)
1953 if (lookup_objfile_from_block (d->block) == objfile
1954 || (d->exp && exp_uses_objfile (d->exp, objfile)))
1964 /* Print the value in stack frame FRAME of a variable specified by a
1965 struct symbol. NAME is the name to print; if NULL then VAR's print
1966 name will be used. STREAM is the ui_file on which to print the
1967 value. INDENT specifies the number of indent levels to print
1968 before printing the variable name.
1970 This function invalidates FRAME. */
1973 print_variable_and_value (const char *name, struct symbol *var,
1974 struct frame_info *frame,
1975 struct ui_file *stream, int indent)
1977 volatile struct gdb_exception except;
1980 name = SYMBOL_PRINT_NAME (var);
1982 fprintf_filtered (stream, "%s%s = ", n_spaces (2 * indent), name);
1983 TRY_CATCH (except, RETURN_MASK_ERROR)
1986 struct value_print_options opts;
1988 val = read_var_value (var, frame);
1989 get_user_print_options (&opts);
1991 common_val_print (val, stream, indent, &opts, current_language);
1993 /* common_val_print invalidates FRAME when a pretty printer calls inferior
1997 if (except.reason < 0)
1998 fprintf_filtered(stream, "<error reading variable %s (%s)>", name,
2000 fprintf_filtered (stream, "\n");
2003 /* Subroutine of ui_printf to simplify it.
2004 Print VALUE to STREAM using FORMAT.
2005 VALUE is a C-style string on the target. */
2008 printf_c_string (struct ui_file *stream, const char *format,
2009 struct value *value)
2015 tem = value_as_address (value);
2017 /* This is a %s argument. Find the length of the string. */
2023 read_memory (tem + j, &c, 1);
2028 /* Copy the string contents into a string inside GDB. */
2029 str = (gdb_byte *) alloca (j + 1);
2031 read_memory (tem, str, j);
2034 fprintf_filtered (stream, format, (char *) str);
2037 /* Subroutine of ui_printf to simplify it.
2038 Print VALUE to STREAM using FORMAT.
2039 VALUE is a wide C-style string on the target. */
2042 printf_wide_c_string (struct ui_file *stream, const char *format,
2043 struct value *value)
2048 struct gdbarch *gdbarch = get_type_arch (value_type (value));
2049 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2050 struct type *wctype = lookup_typename (current_language, gdbarch,
2051 "wchar_t", NULL, 0);
2052 int wcwidth = TYPE_LENGTH (wctype);
2053 gdb_byte *buf = alloca (wcwidth);
2054 struct obstack output;
2055 struct cleanup *inner_cleanup;
2057 tem = value_as_address (value);
2059 /* This is a %s argument. Find the length of the string. */
2060 for (j = 0;; j += wcwidth)
2063 read_memory (tem + j, buf, wcwidth);
2064 if (extract_unsigned_integer (buf, wcwidth, byte_order) == 0)
2068 /* Copy the string contents into a string inside GDB. */
2069 str = (gdb_byte *) alloca (j + wcwidth);
2071 read_memory (tem, str, j);
2072 memset (&str[j], 0, wcwidth);
2074 obstack_init (&output);
2075 inner_cleanup = make_cleanup_obstack_free (&output);
2077 convert_between_encodings (target_wide_charset (gdbarch),
2080 &output, translit_char);
2081 obstack_grow_str0 (&output, "");
2083 fprintf_filtered (stream, format, obstack_base (&output));
2084 do_cleanups (inner_cleanup);
2087 /* Subroutine of ui_printf to simplify it.
2088 Print VALUE, a decimal floating point value, to STREAM using FORMAT. */
2091 printf_decfloat (struct ui_file *stream, const char *format,
2092 struct value *value)
2094 const gdb_byte *param_ptr = value_contents (value);
2096 #if defined (PRINTF_HAS_DECFLOAT)
2097 /* If we have native support for Decimal floating
2098 printing, handle it here. */
2099 fprintf_filtered (stream, format, param_ptr);
2101 /* As a workaround until vasprintf has native support for DFP
2102 we convert the DFP values to string and print them using
2103 the %s format specifier. */
2106 /* Parameter data. */
2107 struct type *param_type = value_type (value);
2108 struct gdbarch *gdbarch = get_type_arch (param_type);
2109 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2111 /* DFP output data. */
2112 struct value *dfp_value = NULL;
2116 struct type *dfp_type = NULL;
2117 char decstr[MAX_DECIMAL_STRING];
2119 /* Points to the end of the string so that we can go back
2120 and check for DFP length modifiers. */
2121 p = format + strlen (format);
2123 /* Look for the float/double format specifier. */
2124 while (*p != 'f' && *p != 'e' && *p != 'E'
2125 && *p != 'g' && *p != 'G')
2128 /* Search for the '%' char and extract the size and type of
2129 the output decimal value based on its modifiers
2130 (%Hf, %Df, %DDf). */
2136 dfp_type = builtin_type (gdbarch)->builtin_decfloat;
2138 else if (*p == 'D' && *(p - 1) == 'D')
2141 dfp_type = builtin_type (gdbarch)->builtin_declong;
2147 dfp_type = builtin_type (gdbarch)->builtin_decdouble;
2151 /* Conversion between different DFP types. */
2152 if (TYPE_CODE (param_type) == TYPE_CODE_DECFLOAT)
2153 decimal_convert (param_ptr, TYPE_LENGTH (param_type),
2154 byte_order, dec, dfp_len, byte_order);
2156 /* If this is a non-trivial conversion, just output 0.
2157 A correct converted value can be displayed by explicitly
2158 casting to a DFP type. */
2159 decimal_from_string (dec, dfp_len, byte_order, "0");
2161 dfp_value = value_from_decfloat (dfp_type, dec);
2163 dfp_ptr = (gdb_byte *) value_contents (dfp_value);
2165 decimal_to_string (dfp_ptr, dfp_len, byte_order, decstr);
2167 /* Print the DFP value. */
2168 fprintf_filtered (stream, "%s", decstr);
2172 /* Subroutine of ui_printf to simplify it.
2173 Print VALUE, a target pointer, to STREAM using FORMAT. */
2176 printf_pointer (struct ui_file *stream, const char *format,
2177 struct value *value)
2179 /* We avoid the host's %p because pointers are too
2180 likely to be the wrong size. The only interesting
2181 modifier for %p is a width; extract that, and then
2182 handle %p as glibc would: %#x or a literal "(nil)". */
2186 #ifdef PRINTF_HAS_LONG_LONG
2187 long long val = value_as_long (value);
2189 long val = value_as_long (value);
2192 fmt = alloca (strlen (format) + 5);
2194 /* Copy up to the leading %. */
2199 int is_percent = (*p == '%');
2214 /* Copy any width. */
2215 while (*p >= '0' && *p < '9')
2218 gdb_assert (*p == 'p' && *(p + 1) == '\0');
2221 #ifdef PRINTF_HAS_LONG_LONG
2227 fprintf_filtered (stream, fmt, val);
2233 fprintf_filtered (stream, fmt, "(nil)");
2237 /* printf "printf format string" ARG to STREAM. */
2240 ui_printf (const char *arg, struct ui_file *stream)
2242 struct format_piece *fpieces;
2243 const char *s = arg;
2244 struct value **val_args;
2245 int allocated_args = 20;
2246 struct cleanup *old_cleanups;
2248 val_args = xmalloc (allocated_args * sizeof (struct value *));
2249 old_cleanups = make_cleanup (free_current_contents, &val_args);
2252 error_no_arg (_("format-control string and values to print"));
2254 s = skip_spaces_const (s);
2256 /* A format string should follow, enveloped in double quotes. */
2258 error (_("Bad format string, missing '\"'."));
2260 fpieces = parse_format_string (&s);
2262 make_cleanup (free_format_pieces_cleanup, &fpieces);
2265 error (_("Bad format string, non-terminated '\"'."));
2267 s = skip_spaces_const (s);
2269 if (*s != ',' && *s != 0)
2270 error (_("Invalid argument syntax"));
2274 s = skip_spaces_const (s);
2280 char *current_substring;
2283 for (fr = 0; fpieces[fr].string != NULL; fr++)
2284 if (fpieces[fr].argclass != literal_piece)
2287 /* Now, parse all arguments and evaluate them.
2288 Store the VALUEs in VAL_ARGS. */
2294 if (nargs == allocated_args)
2295 val_args = (struct value **) xrealloc ((char *) val_args,
2296 (allocated_args *= 2)
2297 * sizeof (struct value *));
2299 val_args[nargs] = parse_to_comma_and_eval (&s1);
2307 if (nargs != nargs_wanted)
2308 error (_("Wrong number of arguments for specified format-string"));
2310 /* Now actually print them. */
2312 for (fr = 0; fpieces[fr].string != NULL; fr++)
2314 current_substring = fpieces[fr].string;
2315 switch (fpieces[fr].argclass)
2318 printf_c_string (stream, current_substring, val_args[i]);
2320 case wide_string_arg:
2321 printf_wide_c_string (stream, current_substring, val_args[i]);
2325 struct gdbarch *gdbarch
2326 = get_type_arch (value_type (val_args[i]));
2327 struct type *wctype = lookup_typename (current_language, gdbarch,
2328 "wchar_t", NULL, 0);
2329 struct type *valtype;
2330 struct obstack output;
2331 struct cleanup *inner_cleanup;
2332 const gdb_byte *bytes;
2334 valtype = value_type (val_args[i]);
2335 if (TYPE_LENGTH (valtype) != TYPE_LENGTH (wctype)
2336 || TYPE_CODE (valtype) != TYPE_CODE_INT)
2337 error (_("expected wchar_t argument for %%lc"));
2339 bytes = value_contents (val_args[i]);
2341 obstack_init (&output);
2342 inner_cleanup = make_cleanup_obstack_free (&output);
2344 convert_between_encodings (target_wide_charset (gdbarch),
2346 bytes, TYPE_LENGTH (valtype),
2347 TYPE_LENGTH (valtype),
2348 &output, translit_char);
2349 obstack_grow_str0 (&output, "");
2351 fprintf_filtered (stream, current_substring,
2352 obstack_base (&output));
2353 do_cleanups (inner_cleanup);
2358 struct type *type = value_type (val_args[i]);
2362 /* If format string wants a float, unchecked-convert the value
2363 to floating point of the same size. */
2364 type = float_type_from_length (type);
2365 val = unpack_double (type, value_contents (val_args[i]), &inv);
2367 error (_("Invalid floating value found in program."));
2369 fprintf_filtered (stream, current_substring, (double) val);
2372 case long_double_arg:
2373 #ifdef HAVE_LONG_DOUBLE
2375 struct type *type = value_type (val_args[i]);
2379 /* If format string wants a float, unchecked-convert the value
2380 to floating point of the same size. */
2381 type = float_type_from_length (type);
2382 val = unpack_double (type, value_contents (val_args[i]), &inv);
2384 error (_("Invalid floating value found in program."));
2386 fprintf_filtered (stream, current_substring,
2391 error (_("long double not supported in printf"));
2394 #ifdef PRINTF_HAS_LONG_LONG
2396 long long val = value_as_long (val_args[i]);
2398 fprintf_filtered (stream, current_substring, val);
2402 error (_("long long not supported in printf"));
2406 int val = value_as_long (val_args[i]);
2408 fprintf_filtered (stream, current_substring, val);
2413 long val = value_as_long (val_args[i]);
2415 fprintf_filtered (stream, current_substring, val);
2418 /* Handles decimal floating values. */
2420 printf_decfloat (stream, current_substring, val_args[i]);
2423 printf_pointer (stream, current_substring, val_args[i]);
2426 /* Print a portion of the format string that has no
2427 directives. Note that this will not include any
2428 ordinary %-specs, but it might include "%%". That is
2429 why we use printf_filtered and not puts_filtered here.
2430 Also, we pass a dummy argument because some platforms
2431 have modified GCC to include -Wformat-security by
2432 default, which will warn here if there is no
2434 fprintf_filtered (stream, current_substring, 0);
2437 internal_error (__FILE__, __LINE__,
2438 _("failed internal consistency check"));
2440 /* Maybe advance to the next argument. */
2441 if (fpieces[fr].argclass != literal_piece)
2445 do_cleanups (old_cleanups);
2448 /* Implement the "printf" command. */
2451 printf_command (char *arg, int from_tty)
2453 ui_printf (arg, gdb_stdout);
2454 gdb_flush (gdb_stdout);
2457 /* Implement the "eval" command. */
2460 eval_command (char *arg, int from_tty)
2462 struct ui_file *ui_out = mem_fileopen ();
2463 struct cleanup *cleanups = make_cleanup_ui_file_delete (ui_out);
2466 ui_printf (arg, ui_out);
2468 expanded = ui_file_xstrdup (ui_out, NULL);
2469 make_cleanup (xfree, expanded);
2471 execute_command (expanded, from_tty);
2473 do_cleanups (cleanups);
2477 _initialize_printcmd (void)
2479 struct cmd_list_element *c;
2481 current_display_number = -1;
2483 observer_attach_free_objfile (clear_dangling_display_expressions);
2485 add_info ("address", address_info,
2486 _("Describe where symbol SYM is stored."));
2488 add_info ("symbol", sym_info, _("\
2489 Describe what symbol is at location ADDR.\n\
2490 Only for symbols with fixed locations (global or static scope)."));
2492 add_com ("x", class_vars, x_command, _("\
2493 Examine memory: x/FMT ADDRESS.\n\
2494 ADDRESS is an expression for the memory address to examine.\n\
2495 FMT is a repeat count followed by a format letter and a size letter.\n\
2496 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2497 t(binary), f(float), a(address), i(instruction), c(char), s(string)\n\
2498 and z(hex, zero padded on the left).\n\
2499 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2500 The specified number of objects of the specified size are printed\n\
2501 according to the format.\n\n\
2502 Defaults for format and size letters are those previously used.\n\
2503 Default count is 1. Default address is following last thing printed\n\
2504 with this command or \"print\"."));
2507 add_com ("whereis", class_vars, whereis_command,
2508 _("Print line number and file of definition of variable."));
2511 add_info ("display", display_info, _("\
2512 Expressions to display when program stops, with code numbers."));
2514 add_cmd ("undisplay", class_vars, undisplay_command, _("\
2515 Cancel some expressions to be displayed when program stops.\n\
2516 Arguments are the code numbers of the expressions to stop displaying.\n\
2517 No argument means cancel all automatic-display expressions.\n\
2518 \"delete display\" has the same effect as this command.\n\
2519 Do \"info display\" to see current list of code numbers."),
2522 add_com ("display", class_vars, display_command, _("\
2523 Print value of expression EXP each time the program stops.\n\
2524 /FMT may be used before EXP as in the \"print\" command.\n\
2525 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2526 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2527 and examining is done as in the \"x\" command.\n\n\
2528 With no argument, display all currently requested auto-display expressions.\n\
2529 Use \"undisplay\" to cancel display requests previously made."));
2531 add_cmd ("display", class_vars, enable_display_command, _("\
2532 Enable some expressions to be displayed when program stops.\n\
2533 Arguments are the code numbers of the expressions to resume displaying.\n\
2534 No argument means enable all automatic-display expressions.\n\
2535 Do \"info display\" to see current list of code numbers."), &enablelist);
2537 add_cmd ("display", class_vars, disable_display_command, _("\
2538 Disable some expressions to be displayed when program stops.\n\
2539 Arguments are the code numbers of the expressions to stop displaying.\n\
2540 No argument means disable all automatic-display expressions.\n\
2541 Do \"info display\" to see current list of code numbers."), &disablelist);
2543 add_cmd ("display", class_vars, undisplay_command, _("\
2544 Cancel some expressions to be displayed when program stops.\n\
2545 Arguments are the code numbers of the expressions to stop displaying.\n\
2546 No argument means cancel all automatic-display expressions.\n\
2547 Do \"info display\" to see current list of code numbers."), &deletelist);
2549 add_com ("printf", class_vars, printf_command, _("\
2550 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2551 This is useful for formatted output in user-defined commands."));
2553 add_com ("output", class_vars, output_command, _("\
2554 Like \"print\" but don't put in value history and don't print newline.\n\
2555 This is useful in user-defined commands."));
2557 add_prefix_cmd ("set", class_vars, set_command, _("\
2558 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2559 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2560 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2561 with $), a register (a few standard names starting with $), or an actual\n\
2562 variable in the program being debugged. EXP is any valid expression.\n\
2563 Use \"set variable\" for variables with names identical to set subcommands.\n\
2565 With a subcommand, this command modifies parts of the gdb environment.\n\
2566 You can see these environment settings with the \"show\" command."),
2567 &setlist, "set ", 1, &cmdlist);
2569 add_com ("assign", class_vars, set_command, _("\
2570 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2571 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2572 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2573 with $), a register (a few standard names starting with $), or an actual\n\
2574 variable in the program being debugged. EXP is any valid expression.\n\
2575 Use \"set variable\" for variables with names identical to set subcommands.\n\
2576 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2577 You can see these environment settings with the \"show\" command."));
2579 /* "call" is the same as "set", but handy for dbx users to call fns. */
2580 c = add_com ("call", class_vars, call_command, _("\
2581 Call a function in the program.\n\
2582 The argument is the function name and arguments, in the notation of the\n\
2583 current working language. The result is printed and saved in the value\n\
2584 history, if it is not void."));
2585 set_cmd_completer (c, expression_completer);
2587 add_cmd ("variable", class_vars, set_command, _("\
2588 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2589 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2590 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2591 with $), a register (a few standard names starting with $), or an actual\n\
2592 variable in the program being debugged. EXP is any valid expression.\n\
2593 This may usually be abbreviated to simply \"set\"."),
2596 c = add_com ("print", class_vars, print_command, _("\
2597 Print value of expression EXP.\n\
2598 Variables accessible are those of the lexical environment of the selected\n\
2599 stack frame, plus all those whose scope is global or an entire file.\n\
2601 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2602 $$NUM refers to NUM'th value back from the last one.\n\
2603 Names starting with $ refer to registers (with the values they would have\n\
2604 if the program were to return to the stack frame now selected, restoring\n\
2605 all registers saved by frames farther in) or else to debugger\n\
2606 \"convenience\" variables (any such name not a known register).\n\
2607 Use assignment expressions to give values to convenience variables.\n\
2609 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2610 @ is a binary operator for treating consecutive data objects\n\
2611 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2612 element is FOO, whose second element is stored in the space following\n\
2613 where FOO is stored, etc. FOO must be an expression whose value\n\
2614 resides in memory.\n\
2616 EXP may be preceded with /FMT, where FMT is a format letter\n\
2617 but no count or size letter (see \"x\" command)."));
2618 set_cmd_completer (c, expression_completer);
2619 add_com_alias ("p", "print", class_vars, 1);
2620 add_com_alias ("inspect", "print", class_vars, 1);
2622 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class,
2623 &max_symbolic_offset, _("\
2624 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2625 Show the largest offset that will be printed in <symbol+1234> form."), _("\
2626 Tell GDB to only display the symbolic form of an address if the\n\
2627 offset between the closest earlier symbol and the address is less than\n\
2628 the specified maximum offset. The default is \"unlimited\", which tells GDB\n\
2629 to always print the symbolic form of an address if any symbol precedes\n\
2630 it. Zero is equivalent to \"unlimited\"."),
2632 show_max_symbolic_offset,
2633 &setprintlist, &showprintlist);
2634 add_setshow_boolean_cmd ("symbol-filename", no_class,
2635 &print_symbol_filename, _("\
2636 Set printing of source filename and line number with <symbol>."), _("\
2637 Show printing of source filename and line number with <symbol>."), NULL,
2639 show_print_symbol_filename,
2640 &setprintlist, &showprintlist);
2642 add_com ("eval", no_class, eval_command, _("\
2643 Convert \"printf format string\", arg1, arg2, arg3, ..., argn to\n\
2644 a command line, and call it."));