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 (char **string_ptr, int oformat, int osize)
196 struct format_data val;
197 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 error (_("Undefined output format \"%c\"."), options->format);
541 /* Specify default address for `x' command.
542 The `info lines' command uses this. */
545 set_next_address (struct gdbarch *gdbarch, CORE_ADDR addr)
547 struct type *ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
549 next_gdbarch = gdbarch;
552 /* Make address available to the user as $_. */
553 set_internalvar (lookup_internalvar ("_"),
554 value_from_pointer (ptr_type, addr));
557 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
558 after LEADIN. Print nothing if no symbolic name is found nearby.
559 Optionally also print source file and line number, if available.
560 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
561 or to interpret it as a possible C++ name and convert it back to source
562 form. However note that DO_DEMANGLE can be overridden by the specific
563 settings of the demangle and asm_demangle variables. Returns
564 non-zero if anything was printed; zero otherwise. */
567 print_address_symbolic (struct gdbarch *gdbarch, CORE_ADDR addr,
568 struct ui_file *stream,
569 int do_demangle, char *leadin)
572 char *filename = NULL;
577 /* Throw away both name and filename. */
578 struct cleanup *cleanup_chain = make_cleanup (free_current_contents, &name);
579 make_cleanup (free_current_contents, &filename);
581 if (build_address_symbolic (gdbarch, addr, do_demangle, &name, &offset,
582 &filename, &line, &unmapped))
584 do_cleanups (cleanup_chain);
588 fputs_filtered (leadin, stream);
590 fputs_filtered ("<*", stream);
592 fputs_filtered ("<", stream);
593 fputs_filtered (name, stream);
595 fprintf_filtered (stream, "+%u", (unsigned int) offset);
597 /* Append source filename and line number if desired. Give specific
598 line # of this addr, if we have it; else line # of the nearest symbol. */
599 if (print_symbol_filename && filename != NULL)
602 fprintf_filtered (stream, " at %s:%d", filename, line);
604 fprintf_filtered (stream, " in %s", filename);
607 fputs_filtered ("*>", stream);
609 fputs_filtered (">", stream);
611 do_cleanups (cleanup_chain);
615 /* Given an address ADDR return all the elements needed to print the
616 address in a symbolic form. NAME can be mangled or not depending
617 on DO_DEMANGLE (and also on the asm_demangle global variable,
618 manipulated via ''set print asm-demangle''). Return 0 in case of
619 success, when all the info in the OUT paramters is valid. Return 1
622 build_address_symbolic (struct gdbarch *gdbarch,
623 CORE_ADDR addr, /* IN */
624 int do_demangle, /* IN */
625 char **name, /* OUT */
626 int *offset, /* OUT */
627 char **filename, /* OUT */
629 int *unmapped) /* OUT */
631 struct minimal_symbol *msymbol;
632 struct symbol *symbol;
633 CORE_ADDR name_location = 0;
634 struct obj_section *section = NULL;
635 const char *name_temp = "";
637 /* Let's say it is mapped (not unmapped). */
640 /* Determine if the address is in an overlay, and whether it is
642 if (overlay_debugging)
644 section = find_pc_overlay (addr);
645 if (pc_in_unmapped_range (addr, section))
648 addr = overlay_mapped_address (addr, section);
652 /* First try to find the address in the symbol table, then
653 in the minsyms. Take the closest one. */
655 /* This is defective in the sense that it only finds text symbols. So
656 really this is kind of pointless--we should make sure that the
657 minimal symbols have everything we need (by changing that we could
658 save some memory, but for many debug format--ELF/DWARF or
659 anything/stabs--it would be inconvenient to eliminate those minimal
661 msymbol = lookup_minimal_symbol_by_pc_section (addr, section);
662 symbol = find_pc_sect_function (addr, section);
666 /* If this is a function (i.e. a code address), strip out any
667 non-address bits. For instance, display a pointer to the
668 first instruction of a Thumb function as <function>; the
669 second instruction will be <function+2>, even though the
670 pointer is <function+3>. This matches the ISA behavior. */
671 addr = gdbarch_addr_bits_remove (gdbarch, addr);
673 name_location = BLOCK_START (SYMBOL_BLOCK_VALUE (symbol));
674 if (do_demangle || asm_demangle)
675 name_temp = SYMBOL_PRINT_NAME (symbol);
677 name_temp = SYMBOL_LINKAGE_NAME (symbol);
681 && MSYMBOL_HAS_SIZE (msymbol)
682 && MSYMBOL_SIZE (msymbol) == 0
683 && MSYMBOL_TYPE (msymbol) != mst_text
684 && MSYMBOL_TYPE (msymbol) != mst_text_gnu_ifunc
685 && MSYMBOL_TYPE (msymbol) != mst_file_text)
690 if (SYMBOL_VALUE_ADDRESS (msymbol) > name_location || symbol == NULL)
692 /* The msymbol is closer to the address than the symbol;
693 use the msymbol instead. */
695 name_location = SYMBOL_VALUE_ADDRESS (msymbol);
696 if (do_demangle || asm_demangle)
697 name_temp = SYMBOL_PRINT_NAME (msymbol);
699 name_temp = SYMBOL_LINKAGE_NAME (msymbol);
702 if (symbol == NULL && msymbol == NULL)
705 /* If the nearest symbol is too far away, don't print anything symbolic. */
707 /* For when CORE_ADDR is larger than unsigned int, we do math in
708 CORE_ADDR. But when we detect unsigned wraparound in the
709 CORE_ADDR math, we ignore this test and print the offset,
710 because addr+max_symbolic_offset has wrapped through the end
711 of the address space back to the beginning, giving bogus comparison. */
712 if (addr > name_location + max_symbolic_offset
713 && name_location + max_symbolic_offset > name_location)
716 *offset = addr - name_location;
718 *name = xstrdup (name_temp);
720 if (print_symbol_filename)
722 struct symtab_and_line sal;
724 sal = find_pc_sect_line (addr, section, 0);
728 *filename = xstrdup (symtab_to_filename_for_display (sal.symtab));
736 /* Print address ADDR symbolically on STREAM.
737 First print it as a number. Then perhaps print
738 <SYMBOL + OFFSET> after the number. */
741 print_address (struct gdbarch *gdbarch,
742 CORE_ADDR addr, struct ui_file *stream)
744 fputs_filtered (paddress (gdbarch, addr), stream);
745 print_address_symbolic (gdbarch, addr, stream, asm_demangle, " ");
748 /* Return a prefix for instruction address:
749 "=> " for current instruction, else " ". */
752 pc_prefix (CORE_ADDR addr)
754 if (has_stack_frames ())
756 struct frame_info *frame;
759 frame = get_selected_frame (NULL);
760 if (get_frame_pc_if_available (frame, &pc) && pc == addr)
766 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
767 controls whether to print the symbolic name "raw" or demangled.
768 Return non-zero if anything was printed; zero otherwise. */
771 print_address_demangle (const struct value_print_options *opts,
772 struct gdbarch *gdbarch, CORE_ADDR addr,
773 struct ui_file *stream, int do_demangle)
775 if (opts->addressprint)
777 fputs_filtered (paddress (gdbarch, addr), stream);
778 print_address_symbolic (gdbarch, addr, stream, do_demangle, " ");
782 return print_address_symbolic (gdbarch, addr, stream, do_demangle, "");
788 /* Examine data at address ADDR in format FMT.
789 Fetch it from memory and print on gdb_stdout. */
792 do_examine (struct format_data fmt, struct gdbarch *gdbarch, CORE_ADDR addr)
797 struct type *val_type = NULL;
800 struct value_print_options opts;
805 next_gdbarch = gdbarch;
808 /* Instruction format implies fetch single bytes
809 regardless of the specified size.
810 The case of strings is handled in decode_format, only explicit
811 size operator are not changed to 'b'. */
817 /* Pick the appropriate size for an address. */
818 if (gdbarch_ptr_bit (next_gdbarch) == 64)
820 else if (gdbarch_ptr_bit (next_gdbarch) == 32)
822 else if (gdbarch_ptr_bit (next_gdbarch) == 16)
825 /* Bad value for gdbarch_ptr_bit. */
826 internal_error (__FILE__, __LINE__,
827 _("failed internal consistency check"));
831 val_type = builtin_type (next_gdbarch)->builtin_int8;
832 else if (size == 'h')
833 val_type = builtin_type (next_gdbarch)->builtin_int16;
834 else if (size == 'w')
835 val_type = builtin_type (next_gdbarch)->builtin_int32;
836 else if (size == 'g')
837 val_type = builtin_type (next_gdbarch)->builtin_int64;
841 struct type *char_type = NULL;
843 /* Search for "char16_t" or "char32_t" types or fall back to 8-bit char
844 if type is not found. */
846 char_type = builtin_type (next_gdbarch)->builtin_char16;
847 else if (size == 'w')
848 char_type = builtin_type (next_gdbarch)->builtin_char32;
850 val_type = char_type;
853 if (size != '\0' && size != 'b')
854 warning (_("Unable to display strings with "
855 "size '%c', using 'b' instead."), size);
857 val_type = builtin_type (next_gdbarch)->builtin_int8;
866 if (format == 's' || format == 'i')
869 get_formatted_print_options (&opts, format);
871 /* Print as many objects as specified in COUNT, at most maxelts per line,
872 with the address of the next one at the start of each line. */
878 fputs_filtered (pc_prefix (next_address), gdb_stdout);
879 print_address (next_gdbarch, next_address, gdb_stdout);
880 printf_filtered (":");
885 printf_filtered ("\t");
886 /* Note that print_formatted sets next_address for the next
888 last_examine_address = next_address;
890 if (last_examine_value)
891 value_free (last_examine_value);
893 /* The value to be displayed is not fetched greedily.
894 Instead, to avoid the possibility of a fetched value not
895 being used, its retrieval is delayed until the print code
896 uses it. When examining an instruction stream, the
897 disassembler will perform its own memory fetch using just
898 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
899 the disassembler be modified so that LAST_EXAMINE_VALUE
900 is left with the byte sequence from the last complete
901 instruction fetched from memory? */
902 last_examine_value = value_at_lazy (val_type, next_address);
904 if (last_examine_value)
905 release_value (last_examine_value);
907 print_formatted (last_examine_value, size, &opts, gdb_stdout);
909 /* Display any branch delay slots following the final insn. */
910 if (format == 'i' && count == 1)
911 count += branch_delay_insns;
913 printf_filtered ("\n");
914 gdb_flush (gdb_stdout);
919 validate_format (struct format_data fmt, char *cmdname)
922 error (_("Size letters are meaningless in \"%s\" command."), cmdname);
924 error (_("Item count other than 1 is meaningless in \"%s\" command."),
926 if (fmt.format == 'i')
927 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
928 fmt.format, cmdname);
931 /* Evaluate string EXP as an expression in the current language and
932 print the resulting value. EXP may contain a format specifier as the
933 first argument ("/x myvar" for example, to print myvar in hex). */
936 print_command_1 (char *exp, int voidprint)
938 struct expression *expr;
939 struct cleanup *old_chain = 0;
942 struct format_data fmt;
945 if (exp && *exp == '/')
948 fmt = decode_format (&exp, last_format, 0);
949 validate_format (fmt, "print");
950 last_format = format = fmt.format;
962 expr = parse_expression (exp);
963 old_chain = make_cleanup (free_current_contents, &expr);
965 val = evaluate_expression (expr);
968 val = access_value_history (0);
970 if (voidprint || (val && value_type (val) &&
971 TYPE_CODE (value_type (val)) != TYPE_CODE_VOID))
973 struct value_print_options opts;
974 int histindex = record_latest_value (val);
977 annotate_value_history_begin (histindex, value_type (val));
979 annotate_value_begin (value_type (val));
982 printf_filtered ("$%d = ", histindex);
985 annotate_value_history_value ();
987 get_formatted_print_options (&opts, format);
990 print_formatted (val, fmt.size, &opts, gdb_stdout);
991 printf_filtered ("\n");
994 annotate_value_history_end ();
996 annotate_value_end ();
1000 do_cleanups (old_chain);
1004 print_command (char *exp, int from_tty)
1006 print_command_1 (exp, 1);
1009 /* Same as print, except it doesn't print void results. */
1011 call_command (char *exp, int from_tty)
1013 print_command_1 (exp, 0);
1017 output_command (char *exp, int from_tty)
1019 struct expression *expr;
1020 struct cleanup *old_chain;
1023 struct format_data fmt;
1024 struct value_print_options opts;
1029 if (exp && *exp == '/')
1032 fmt = decode_format (&exp, 0, 0);
1033 validate_format (fmt, "output");
1034 format = fmt.format;
1037 expr = parse_expression (exp);
1038 old_chain = make_cleanup (free_current_contents, &expr);
1040 val = evaluate_expression (expr);
1042 annotate_value_begin (value_type (val));
1044 get_formatted_print_options (&opts, format);
1046 print_formatted (val, fmt.size, &opts, gdb_stdout);
1048 annotate_value_end ();
1051 gdb_flush (gdb_stdout);
1053 do_cleanups (old_chain);
1057 set_command (char *exp, int from_tty)
1059 struct expression *expr = parse_expression (exp);
1060 struct cleanup *old_chain =
1061 make_cleanup (free_current_contents, &expr);
1063 if (expr->nelts >= 1)
1064 switch (expr->elts[0].opcode)
1066 case UNOP_PREINCREMENT:
1067 case UNOP_POSTINCREMENT:
1068 case UNOP_PREDECREMENT:
1069 case UNOP_POSTDECREMENT:
1071 case BINOP_ASSIGN_MODIFY:
1076 (_("Expression is not an assignment (and might have no effect)"));
1079 evaluate_expression (expr);
1080 do_cleanups (old_chain);
1084 sym_info (char *arg, int from_tty)
1086 struct minimal_symbol *msymbol;
1087 struct objfile *objfile;
1088 struct obj_section *osect;
1089 CORE_ADDR addr, sect_addr;
1091 unsigned int offset;
1094 error_no_arg (_("address"));
1096 addr = parse_and_eval_address (arg);
1097 ALL_OBJSECTIONS (objfile, osect)
1099 /* Only process each object file once, even if there's a separate
1101 if (objfile->separate_debug_objfile_backlink)
1104 sect_addr = overlay_mapped_address (addr, osect);
1106 if (obj_section_addr (osect) <= sect_addr
1107 && sect_addr < obj_section_endaddr (osect)
1108 && (msymbol = lookup_minimal_symbol_by_pc_section (sect_addr, osect)))
1110 const char *obj_name, *mapped, *sec_name, *msym_name;
1112 struct cleanup *old_chain;
1115 offset = sect_addr - SYMBOL_VALUE_ADDRESS (msymbol);
1116 mapped = section_is_mapped (osect) ? _("mapped") : _("unmapped");
1117 sec_name = osect->the_bfd_section->name;
1118 msym_name = SYMBOL_PRINT_NAME (msymbol);
1120 /* Don't print the offset if it is zero.
1121 We assume there's no need to handle i18n of "sym + offset". */
1123 loc_string = xstrprintf ("%s + %u", msym_name, offset);
1125 loc_string = xstrprintf ("%s", msym_name);
1127 /* Use a cleanup to free loc_string in case the user quits
1128 a pagination request inside printf_filtered. */
1129 old_chain = make_cleanup (xfree, loc_string);
1131 gdb_assert (osect->objfile && osect->objfile->name);
1132 obj_name = osect->objfile->name;
1134 if (MULTI_OBJFILE_P ())
1135 if (pc_in_unmapped_range (addr, osect))
1136 if (section_is_overlay (osect))
1137 printf_filtered (_("%s in load address range of "
1138 "%s overlay section %s of %s\n"),
1139 loc_string, mapped, sec_name, obj_name);
1141 printf_filtered (_("%s in load address range of "
1142 "section %s of %s\n"),
1143 loc_string, sec_name, obj_name);
1145 if (section_is_overlay (osect))
1146 printf_filtered (_("%s in %s overlay section %s of %s\n"),
1147 loc_string, mapped, sec_name, obj_name);
1149 printf_filtered (_("%s in section %s of %s\n"),
1150 loc_string, sec_name, obj_name);
1152 if (pc_in_unmapped_range (addr, osect))
1153 if (section_is_overlay (osect))
1154 printf_filtered (_("%s in load address range of %s overlay "
1156 loc_string, mapped, sec_name);
1158 printf_filtered (_("%s in load address range of section %s\n"),
1159 loc_string, sec_name);
1161 if (section_is_overlay (osect))
1162 printf_filtered (_("%s in %s overlay section %s\n"),
1163 loc_string, mapped, sec_name);
1165 printf_filtered (_("%s in section %s\n"),
1166 loc_string, sec_name);
1168 do_cleanups (old_chain);
1172 printf_filtered (_("No symbol matches %s.\n"), arg);
1176 address_info (char *exp, int from_tty)
1178 struct gdbarch *gdbarch;
1181 struct minimal_symbol *msymbol;
1183 struct obj_section *section;
1184 CORE_ADDR load_addr, context_pc = 0;
1185 struct field_of_this_result is_a_field_of_this;
1188 error (_("Argument required."));
1190 sym = lookup_symbol (exp, get_selected_block (&context_pc), VAR_DOMAIN,
1191 &is_a_field_of_this);
1194 if (is_a_field_of_this.type != NULL)
1196 printf_filtered ("Symbol \"");
1197 fprintf_symbol_filtered (gdb_stdout, exp,
1198 current_language->la_language, DMGL_ANSI);
1199 printf_filtered ("\" is a field of the local class variable ");
1200 if (current_language->la_language == language_objc)
1201 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1203 printf_filtered ("`this'\n");
1207 msymbol = lookup_minimal_symbol (exp, NULL, NULL);
1209 if (msymbol != NULL)
1211 gdbarch = get_objfile_arch (msymbol_objfile (msymbol));
1212 load_addr = SYMBOL_VALUE_ADDRESS (msymbol);
1214 printf_filtered ("Symbol \"");
1215 fprintf_symbol_filtered (gdb_stdout, exp,
1216 current_language->la_language, DMGL_ANSI);
1217 printf_filtered ("\" is at ");
1218 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1219 printf_filtered (" in a file compiled without debugging");
1220 section = SYMBOL_OBJ_SECTION (msymbol);
1221 if (section_is_overlay (section))
1223 load_addr = overlay_unmapped_address (load_addr, section);
1224 printf_filtered (",\n -- loaded at ");
1225 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1226 printf_filtered (" in overlay section %s",
1227 section->the_bfd_section->name);
1229 printf_filtered (".\n");
1232 error (_("No symbol \"%s\" in current context."), exp);
1236 printf_filtered ("Symbol \"");
1237 fprintf_symbol_filtered (gdb_stdout, SYMBOL_PRINT_NAME (sym),
1238 current_language->la_language, DMGL_ANSI);
1239 printf_filtered ("\" is ");
1240 val = SYMBOL_VALUE (sym);
1241 section = SYMBOL_OBJ_SECTION (sym);
1242 gdbarch = get_objfile_arch (SYMBOL_SYMTAB (sym)->objfile);
1244 switch (SYMBOL_CLASS (sym))
1247 case LOC_CONST_BYTES:
1248 printf_filtered ("constant");
1252 printf_filtered ("a label at address ");
1253 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1254 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1255 if (section_is_overlay (section))
1257 load_addr = overlay_unmapped_address (load_addr, section);
1258 printf_filtered (",\n -- loaded at ");
1259 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1260 printf_filtered (" in overlay section %s",
1261 section->the_bfd_section->name);
1266 /* FIXME: cagney/2004-01-26: It should be possible to
1267 unconditionally call the SYMBOL_COMPUTED_OPS method when available.
1268 Unfortunately DWARF 2 stores the frame-base (instead of the
1269 function) location in a function's symbol. Oops! For the
1270 moment enable this when/where applicable. */
1271 SYMBOL_COMPUTED_OPS (sym)->describe_location (sym, context_pc,
1276 /* GDBARCH is the architecture associated with the objfile the symbol
1277 is defined in; the target architecture may be different, and may
1278 provide additional registers. However, we do not know the target
1279 architecture at this point. We assume the objfile architecture
1280 will contain all the standard registers that occur in debug info
1282 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1284 if (SYMBOL_IS_ARGUMENT (sym))
1285 printf_filtered (_("an argument in register %s"),
1286 gdbarch_register_name (gdbarch, regno));
1288 printf_filtered (_("a variable in register %s"),
1289 gdbarch_register_name (gdbarch, regno));
1293 printf_filtered (_("static storage at address "));
1294 load_addr = SYMBOL_VALUE_ADDRESS (sym);
1295 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1296 if (section_is_overlay (section))
1298 load_addr = overlay_unmapped_address (load_addr, section);
1299 printf_filtered (_(",\n -- loaded at "));
1300 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1301 printf_filtered (_(" in overlay section %s"),
1302 section->the_bfd_section->name);
1306 case LOC_REGPARM_ADDR:
1307 /* Note comment at LOC_REGISTER. */
1308 regno = SYMBOL_REGISTER_OPS (sym)->register_number (sym, gdbarch);
1309 printf_filtered (_("address of an argument in register %s"),
1310 gdbarch_register_name (gdbarch, regno));
1314 printf_filtered (_("an argument at offset %ld"), val);
1318 printf_filtered (_("a local variable at frame offset %ld"), val);
1322 printf_filtered (_("a reference argument at offset %ld"), val);
1326 printf_filtered (_("a typedef"));
1330 printf_filtered (_("a function at address "));
1331 load_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1332 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1333 if (section_is_overlay (section))
1335 load_addr = overlay_unmapped_address (load_addr, section);
1336 printf_filtered (_(",\n -- loaded at "));
1337 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1338 printf_filtered (_(" in overlay section %s"),
1339 section->the_bfd_section->name);
1343 case LOC_UNRESOLVED:
1345 struct minimal_symbol *msym;
1347 msym = lookup_minimal_symbol (SYMBOL_LINKAGE_NAME (sym), NULL, NULL);
1349 printf_filtered ("unresolved");
1352 section = SYMBOL_OBJ_SECTION (msym);
1353 load_addr = SYMBOL_VALUE_ADDRESS (msym);
1356 && (section->the_bfd_section->flags & SEC_THREAD_LOCAL) != 0)
1357 printf_filtered (_("a thread-local variable at offset %s "
1358 "in the thread-local storage for `%s'"),
1359 paddress (gdbarch, load_addr),
1360 section->objfile->name);
1363 printf_filtered (_("static storage at address "));
1364 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1365 if (section_is_overlay (section))
1367 load_addr = overlay_unmapped_address (load_addr, section);
1368 printf_filtered (_(",\n -- loaded at "));
1369 fputs_filtered (paddress (gdbarch, load_addr), gdb_stdout);
1370 printf_filtered (_(" in overlay section %s"),
1371 section->the_bfd_section->name);
1378 case LOC_OPTIMIZED_OUT:
1379 printf_filtered (_("optimized out"));
1383 printf_filtered (_("of unknown (botched) type"));
1386 printf_filtered (".\n");
1391 x_command (char *exp, int from_tty)
1393 struct expression *expr;
1394 struct format_data fmt;
1395 struct cleanup *old_chain;
1398 fmt.format = last_format ? last_format : 'x';
1399 fmt.size = last_size;
1403 if (exp && *exp == '/')
1406 fmt = decode_format (&exp, last_format, last_size);
1409 /* If we have an expression, evaluate it and use it as the address. */
1411 if (exp != 0 && *exp != 0)
1413 expr = parse_expression (exp);
1414 /* Cause expression not to be there any more if this command is
1415 repeated with Newline. But don't clobber a user-defined
1416 command's definition. */
1419 old_chain = make_cleanup (free_current_contents, &expr);
1420 val = evaluate_expression (expr);
1421 if (TYPE_CODE (value_type (val)) == TYPE_CODE_REF)
1422 val = coerce_ref (val);
1423 /* In rvalue contexts, such as this, functions are coerced into
1424 pointers to functions. This makes "x/i main" work. */
1425 if (/* last_format == 'i' && */
1426 TYPE_CODE (value_type (val)) == TYPE_CODE_FUNC
1427 && VALUE_LVAL (val) == lval_memory)
1428 next_address = value_address (val);
1430 next_address = value_as_address (val);
1432 next_gdbarch = expr->gdbarch;
1433 do_cleanups (old_chain);
1437 error_no_arg (_("starting display address"));
1439 do_examine (fmt, next_gdbarch, next_address);
1441 /* If the examine succeeds, we remember its size and format for next
1442 time. Set last_size to 'b' for strings. */
1443 if (fmt.format == 's')
1446 last_size = fmt.size;
1447 last_format = fmt.format;
1449 /* Set a couple of internal variables if appropriate. */
1450 if (last_examine_value)
1452 /* Make last address examined available to the user as $_. Use
1453 the correct pointer type. */
1454 struct type *pointer_type
1455 = lookup_pointer_type (value_type (last_examine_value));
1456 set_internalvar (lookup_internalvar ("_"),
1457 value_from_pointer (pointer_type,
1458 last_examine_address));
1460 /* Make contents of last address examined available to the user
1461 as $__. If the last value has not been fetched from memory
1462 then don't fetch it now; instead mark it by voiding the $__
1464 if (value_lazy (last_examine_value))
1465 clear_internalvar (lookup_internalvar ("__"));
1467 set_internalvar (lookup_internalvar ("__"), last_examine_value);
1472 /* Add an expression to the auto-display chain.
1473 Specify the expression. */
1476 display_command (char *exp, int from_tty)
1478 struct format_data fmt;
1479 struct expression *expr;
1480 struct display *new;
1484 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1486 if (tui_active && exp != NULL && *exp == '$')
1487 display_it = (tui_set_layout_for_display_command (exp) == TUI_FAILURE);
1501 fmt = decode_format (&exp, 0, 0);
1502 if (fmt.size && fmt.format == 0)
1504 if (fmt.format == 'i' || fmt.format == 's')
1515 innermost_block = NULL;
1516 expr = parse_expression (exp);
1518 new = (struct display *) xmalloc (sizeof (struct display));
1520 new->exp_string = xstrdup (exp);
1522 new->block = innermost_block;
1523 new->pspace = current_program_space;
1524 new->next = display_chain;
1525 new->number = ++display_number;
1528 display_chain = new;
1530 if (from_tty && target_has_execution)
1531 do_one_display (new);
1538 free_display (struct display *d)
1540 xfree (d->exp_string);
1545 /* Clear out the display_chain. Done when new symtabs are loaded,
1546 since this invalidates the types stored in many expressions. */
1549 clear_displays (void)
1553 while ((d = display_chain) != NULL)
1555 display_chain = d->next;
1560 /* Delete the auto-display DISPLAY. */
1563 delete_display (struct display *display)
1567 gdb_assert (display != NULL);
1569 if (display_chain == display)
1570 display_chain = display->next;
1573 if (d->next == display)
1575 d->next = display->next;
1579 free_display (display);
1582 /* Call FUNCTION on each of the displays whose numbers are given in
1583 ARGS. DATA is passed unmodified to FUNCTION. */
1586 map_display_numbers (char *args,
1587 void (*function) (struct display *,
1591 struct get_number_or_range_state state;
1595 error_no_arg (_("one or more display numbers"));
1597 init_number_or_range (&state, args);
1599 while (!state.finished)
1601 char *p = state.string;
1603 num = get_number_or_range (&state);
1605 warning (_("bad display number at or near '%s'"), p);
1608 struct display *d, *tmp;
1610 ALL_DISPLAYS_SAFE (d, tmp)
1611 if (d->number == num)
1614 printf_unfiltered (_("No display number %d.\n"), num);
1621 /* Callback for map_display_numbers, that deletes a display. */
1624 do_delete_display (struct display *d, void *data)
1629 /* "undisplay" command. */
1632 undisplay_command (char *args, int from_tty)
1636 if (query (_("Delete all auto-display expressions? ")))
1642 map_display_numbers (args, do_delete_display, NULL);
1646 /* Display a single auto-display.
1647 Do nothing if the display cannot be printed in the current context,
1648 or if the display is disabled. */
1651 do_one_display (struct display *d)
1653 struct cleanup *old_chain;
1654 int within_current_scope;
1656 if (d->enabled_p == 0)
1659 /* The expression carries the architecture that was used at parse time.
1660 This is a problem if the expression depends on architecture features
1661 (e.g. register numbers), and the current architecture is now different.
1662 For example, a display statement like "display/i $pc" is expected to
1663 display the PC register of the current architecture, not the arch at
1664 the time the display command was given. Therefore, we re-parse the
1665 expression if the current architecture has changed. */
1666 if (d->exp != NULL && d->exp->gdbarch != get_current_arch ())
1675 volatile struct gdb_exception ex;
1677 TRY_CATCH (ex, RETURN_MASK_ALL)
1679 innermost_block = NULL;
1680 d->exp = parse_expression (d->exp_string);
1681 d->block = innermost_block;
1685 /* Can't re-parse the expression. Disable this display item. */
1687 warning (_("Unable to display \"%s\": %s"),
1688 d->exp_string, ex.message);
1695 if (d->pspace == current_program_space)
1696 within_current_scope = contained_in (get_selected_block (0), d->block);
1698 within_current_scope = 0;
1701 within_current_scope = 1;
1702 if (!within_current_scope)
1705 old_chain = make_cleanup_restore_integer (¤t_display_number);
1706 current_display_number = d->number;
1708 annotate_display_begin ();
1709 printf_filtered ("%d", d->number);
1710 annotate_display_number_end ();
1711 printf_filtered (": ");
1714 volatile struct gdb_exception ex;
1716 annotate_display_format ();
1718 printf_filtered ("x/");
1719 if (d->format.count != 1)
1720 printf_filtered ("%d", d->format.count);
1721 printf_filtered ("%c", d->format.format);
1722 if (d->format.format != 'i' && d->format.format != 's')
1723 printf_filtered ("%c", d->format.size);
1724 printf_filtered (" ");
1726 annotate_display_expression ();
1728 puts_filtered (d->exp_string);
1729 annotate_display_expression_end ();
1731 if (d->format.count != 1 || d->format.format == 'i')
1732 printf_filtered ("\n");
1734 printf_filtered (" ");
1736 annotate_display_value ();
1738 TRY_CATCH (ex, RETURN_MASK_ERROR)
1743 val = evaluate_expression (d->exp);
1744 addr = value_as_address (val);
1745 if (d->format.format == 'i')
1746 addr = gdbarch_addr_bits_remove (d->exp->gdbarch, addr);
1747 do_examine (d->format, d->exp->gdbarch, addr);
1750 fprintf_filtered (gdb_stdout, _("<error: %s>\n"), ex.message);
1754 struct value_print_options opts;
1755 volatile struct gdb_exception ex;
1757 annotate_display_format ();
1759 if (d->format.format)
1760 printf_filtered ("/%c ", d->format.format);
1762 annotate_display_expression ();
1764 puts_filtered (d->exp_string);
1765 annotate_display_expression_end ();
1767 printf_filtered (" = ");
1769 annotate_display_expression ();
1771 get_formatted_print_options (&opts, d->format.format);
1772 opts.raw = d->format.raw;
1774 TRY_CATCH (ex, RETURN_MASK_ERROR)
1778 val = evaluate_expression (d->exp);
1779 print_formatted (val, d->format.size, &opts, gdb_stdout);
1782 fprintf_filtered (gdb_stdout, _("<error: %s>"), ex.message);
1783 printf_filtered ("\n");
1786 annotate_display_end ();
1788 gdb_flush (gdb_stdout);
1789 do_cleanups (old_chain);
1792 /* Display all of the values on the auto-display chain which can be
1793 evaluated in the current scope. */
1800 for (d = display_chain; d; d = d->next)
1804 /* Delete the auto-display which we were in the process of displaying.
1805 This is done when there is an error or a signal. */
1808 disable_display (int num)
1812 for (d = display_chain; d; d = d->next)
1813 if (d->number == num)
1818 printf_unfiltered (_("No display number %d.\n"), num);
1822 disable_current_display (void)
1824 if (current_display_number >= 0)
1826 disable_display (current_display_number);
1827 fprintf_unfiltered (gdb_stderr,
1828 _("Disabling display %d to "
1829 "avoid infinite recursion.\n"),
1830 current_display_number);
1832 current_display_number = -1;
1836 display_info (char *ignore, int from_tty)
1841 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1843 printf_filtered (_("Auto-display expressions now in effect:\n\
1844 Num Enb Expression\n"));
1846 for (d = display_chain; d; d = d->next)
1848 printf_filtered ("%d: %c ", d->number, "ny"[(int) d->enabled_p]);
1850 printf_filtered ("/%d%c%c ", d->format.count, d->format.size,
1852 else if (d->format.format)
1853 printf_filtered ("/%c ", d->format.format);
1854 puts_filtered (d->exp_string);
1855 if (d->block && !contained_in (get_selected_block (0), d->block))
1856 printf_filtered (_(" (cannot be evaluated in the current context)"));
1857 printf_filtered ("\n");
1858 gdb_flush (gdb_stdout);
1862 /* Callback fo map_display_numbers, that enables or disables the
1863 passed in display D. */
1866 do_enable_disable_display (struct display *d, void *data)
1868 d->enabled_p = *(int *) data;
1871 /* Implamentation of both the "disable display" and "enable display"
1872 commands. ENABLE decides what to do. */
1875 enable_disable_display_command (char *args, int from_tty, int enable)
1882 d->enabled_p = enable;
1886 map_display_numbers (args, do_enable_disable_display, &enable);
1889 /* The "enable display" command. */
1892 enable_display_command (char *args, int from_tty)
1894 enable_disable_display_command (args, from_tty, 1);
1897 /* The "disable display" command. */
1900 disable_display_command (char *args, int from_tty)
1902 enable_disable_display_command (args, from_tty, 0);
1905 /* display_chain items point to blocks and expressions. Some expressions in
1906 turn may point to symbols.
1907 Both symbols and blocks are obstack_alloc'd on objfile_stack, and are
1908 obstack_free'd when a shared library is unloaded.
1909 Clear pointers that are about to become dangling.
1910 Both .exp and .block fields will be restored next time we need to display
1911 an item by re-parsing .exp_string field in the new execution context. */
1914 clear_dangling_display_expressions (struct so_list *solib)
1916 struct objfile *objfile = solib->objfile;
1919 /* With no symbol file we cannot have a block or expression from it. */
1920 if (objfile == NULL)
1922 if (objfile->separate_debug_objfile_backlink)
1923 objfile = objfile->separate_debug_objfile_backlink;
1924 gdb_assert (objfile->pspace == solib->pspace);
1926 for (d = display_chain; d != NULL; d = d->next)
1928 if (d->pspace != solib->pspace)
1931 if (lookup_objfile_from_block (d->block) == objfile
1932 || (d->exp && exp_uses_objfile (d->exp, objfile)))
1942 /* Print the value in stack frame FRAME of a variable specified by a
1943 struct symbol. NAME is the name to print; if NULL then VAR's print
1944 name will be used. STREAM is the ui_file on which to print the
1945 value. INDENT specifies the number of indent levels to print
1946 before printing the variable name.
1948 This function invalidates FRAME. */
1951 print_variable_and_value (const char *name, struct symbol *var,
1952 struct frame_info *frame,
1953 struct ui_file *stream, int indent)
1955 volatile struct gdb_exception except;
1958 name = SYMBOL_PRINT_NAME (var);
1960 fprintf_filtered (stream, "%s%s = ", n_spaces (2 * indent), name);
1961 TRY_CATCH (except, RETURN_MASK_ERROR)
1964 struct value_print_options opts;
1966 val = read_var_value (var, frame);
1967 get_user_print_options (&opts);
1969 common_val_print (val, stream, indent, &opts, current_language);
1971 /* common_val_print invalidates FRAME when a pretty printer calls inferior
1975 if (except.reason < 0)
1976 fprintf_filtered(stream, "<error reading variable %s (%s)>", name,
1978 fprintf_filtered (stream, "\n");
1981 /* printf "printf format string" ARG to STREAM. */
1984 ui_printf (char *arg, struct ui_file *stream)
1986 struct format_piece *fpieces;
1988 struct value **val_args;
1989 int allocated_args = 20;
1990 struct cleanup *old_cleanups;
1992 val_args = xmalloc (allocated_args * sizeof (struct value *));
1993 old_cleanups = make_cleanup (free_current_contents, &val_args);
1996 error_no_arg (_("format-control string and values to print"));
1998 s = skip_spaces (s);
2000 /* A format string should follow, enveloped in double quotes. */
2002 error (_("Bad format string, missing '\"'."));
2004 fpieces = parse_format_string (&s);
2006 make_cleanup (free_format_pieces_cleanup, &fpieces);
2009 error (_("Bad format string, non-terminated '\"'."));
2011 s = skip_spaces (s);
2013 if (*s != ',' && *s != 0)
2014 error (_("Invalid argument syntax"));
2018 s = skip_spaces (s);
2024 char *current_substring;
2027 for (fr = 0; fpieces[fr].string != NULL; fr++)
2028 if (fpieces[fr].argclass != literal_piece)
2031 /* Now, parse all arguments and evaluate them.
2032 Store the VALUEs in VAL_ARGS. */
2038 if (nargs == allocated_args)
2039 val_args = (struct value **) xrealloc ((char *) val_args,
2040 (allocated_args *= 2)
2041 * sizeof (struct value *));
2043 val_args[nargs] = parse_to_comma_and_eval (&s1);
2051 if (nargs != nargs_wanted)
2052 error (_("Wrong number of arguments for specified format-string"));
2054 /* Now actually print them. */
2056 for (fr = 0; fpieces[fr].string != NULL; fr++)
2058 current_substring = fpieces[fr].string;
2059 switch (fpieces[fr].argclass)
2067 tem = value_as_address (val_args[i]);
2069 /* This is a %s argument. Find the length of the string. */
2075 read_memory (tem + j, &c, 1);
2080 /* Copy the string contents into a string inside GDB. */
2081 str = (gdb_byte *) alloca (j + 1);
2083 read_memory (tem, str, j);
2086 fprintf_filtered (stream, current_substring, (char *) str);
2089 case wide_string_arg:
2094 struct gdbarch *gdbarch
2095 = get_type_arch (value_type (val_args[i]));
2096 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2097 struct type *wctype = lookup_typename (current_language, gdbarch,
2098 "wchar_t", NULL, 0);
2099 int wcwidth = TYPE_LENGTH (wctype);
2100 gdb_byte *buf = alloca (wcwidth);
2101 struct obstack output;
2102 struct cleanup *inner_cleanup;
2104 tem = value_as_address (val_args[i]);
2106 /* This is a %s argument. Find the length of the string. */
2107 for (j = 0;; j += wcwidth)
2110 read_memory (tem + j, buf, wcwidth);
2111 if (extract_unsigned_integer (buf, wcwidth, byte_order) == 0)
2115 /* Copy the string contents into a string inside GDB. */
2116 str = (gdb_byte *) alloca (j + wcwidth);
2118 read_memory (tem, str, j);
2119 memset (&str[j], 0, wcwidth);
2121 obstack_init (&output);
2122 inner_cleanup = make_cleanup_obstack_free (&output);
2124 convert_between_encodings (target_wide_charset (gdbarch),
2127 &output, translit_char);
2128 obstack_grow_str0 (&output, "");
2130 fprintf_filtered (stream, current_substring,
2131 obstack_base (&output));
2132 do_cleanups (inner_cleanup);
2137 struct gdbarch *gdbarch
2138 = get_type_arch (value_type (val_args[i]));
2139 struct type *wctype = lookup_typename (current_language, gdbarch,
2140 "wchar_t", NULL, 0);
2141 struct type *valtype;
2142 struct obstack output;
2143 struct cleanup *inner_cleanup;
2144 const gdb_byte *bytes;
2146 valtype = value_type (val_args[i]);
2147 if (TYPE_LENGTH (valtype) != TYPE_LENGTH (wctype)
2148 || TYPE_CODE (valtype) != TYPE_CODE_INT)
2149 error (_("expected wchar_t argument for %%lc"));
2151 bytes = value_contents (val_args[i]);
2153 obstack_init (&output);
2154 inner_cleanup = make_cleanup_obstack_free (&output);
2156 convert_between_encodings (target_wide_charset (gdbarch),
2158 bytes, TYPE_LENGTH (valtype),
2159 TYPE_LENGTH (valtype),
2160 &output, translit_char);
2161 obstack_grow_str0 (&output, "");
2163 fprintf_filtered (stream, current_substring,
2164 obstack_base (&output));
2165 do_cleanups (inner_cleanup);
2170 struct type *type = value_type (val_args[i]);
2174 /* If format string wants a float, unchecked-convert the value
2175 to floating point of the same size. */
2176 type = float_type_from_length (type);
2177 val = unpack_double (type, value_contents (val_args[i]), &inv);
2179 error (_("Invalid floating value found in program."));
2181 fprintf_filtered (stream, current_substring, (double) val);
2184 case long_double_arg:
2185 #ifdef HAVE_LONG_DOUBLE
2187 struct type *type = value_type (val_args[i]);
2191 /* If format string wants a float, unchecked-convert the value
2192 to floating point of the same size. */
2193 type = float_type_from_length (type);
2194 val = unpack_double (type, value_contents (val_args[i]), &inv);
2196 error (_("Invalid floating value found in program."));
2198 fprintf_filtered (stream, current_substring,
2203 error (_("long double not supported in printf"));
2206 #ifdef PRINTF_HAS_LONG_LONG
2208 long long val = value_as_long (val_args[i]);
2210 fprintf_filtered (stream, current_substring, val);
2214 error (_("long long not supported in printf"));
2218 int val = value_as_long (val_args[i]);
2220 fprintf_filtered (stream, current_substring, val);
2225 long val = value_as_long (val_args[i]);
2227 fprintf_filtered (stream, current_substring, val);
2231 /* Handles decimal floating values. */
2234 const gdb_byte *param_ptr = value_contents (val_args[i]);
2236 #if defined (PRINTF_HAS_DECFLOAT)
2237 /* If we have native support for Decimal floating
2238 printing, handle it here. */
2239 fprintf_filtered (stream, current_substring, param_ptr);
2242 /* As a workaround until vasprintf has native support for DFP
2243 we convert the DFP values to string and print them using
2244 the %s format specifier. */
2247 int nnull_chars = 0;
2249 /* Parameter data. */
2250 struct type *param_type = value_type (val_args[i]);
2251 struct gdbarch *gdbarch = get_type_arch (param_type);
2252 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
2254 /* DFP output data. */
2255 struct value *dfp_value = NULL;
2259 struct type *dfp_type = NULL;
2260 char decstr[MAX_DECIMAL_STRING];
2262 /* Points to the end of the string so that we can go back
2263 and check for DFP length modifiers. */
2264 eos = current_substring + strlen (current_substring);
2266 /* Look for the float/double format specifier. */
2267 while (*eos != 'f' && *eos != 'e' && *eos != 'E'
2268 && *eos != 'g' && *eos != 'G')
2273 /* Search for the '%' char and extract the size and type of
2274 the output decimal value based on its modifiers
2275 (%Hf, %Df, %DDf). */
2276 while (*--sos != '%')
2281 dfp_type = builtin_type (gdbarch)->builtin_decfloat;
2283 else if (*sos == 'D' && *(sos - 1) == 'D')
2286 dfp_type = builtin_type (gdbarch)->builtin_declong;
2292 dfp_type = builtin_type (gdbarch)->builtin_decdouble;
2296 /* Replace %Hf, %Df and %DDf with %s's. */
2299 /* Go through the whole format string and pull the correct
2300 number of chars back to compensate for the change in the
2301 format specifier. */
2302 while (nnull_chars < nargs - i)
2310 /* Conversion between different DFP types. */
2311 if (TYPE_CODE (param_type) == TYPE_CODE_DECFLOAT)
2312 decimal_convert (param_ptr, TYPE_LENGTH (param_type),
2313 byte_order, dec, dfp_len, byte_order);
2315 /* If this is a non-trivial conversion, just output 0.
2316 A correct converted value can be displayed by explicitly
2317 casting to a DFP type. */
2318 decimal_from_string (dec, dfp_len, byte_order, "0");
2320 dfp_value = value_from_decfloat (dfp_type, dec);
2322 dfp_ptr = (gdb_byte *) value_contents (dfp_value);
2324 decimal_to_string (dfp_ptr, dfp_len, byte_order, decstr);
2326 /* Print the DFP value. */
2327 fprintf_filtered (stream, current_substring, decstr);
2335 /* We avoid the host's %p because pointers are too
2336 likely to be the wrong size. The only interesting
2337 modifier for %p is a width; extract that, and then
2338 handle %p as glibc would: %#x or a literal "(nil)". */
2340 char *p, *fmt, *fmt_p;
2341 #ifdef PRINTF_HAS_LONG_LONG
2342 long long val = value_as_long (val_args[i]);
2344 long val = value_as_long (val_args[i]);
2347 fmt = alloca (strlen (current_substring) + 5);
2349 /* Copy up to the leading %. */
2350 p = current_substring;
2354 int is_percent = (*p == '%');
2369 /* Copy any width. */
2370 while (*p >= '0' && *p < '9')
2373 gdb_assert (*p == 'p' && *(p + 1) == '\0');
2376 #ifdef PRINTF_HAS_LONG_LONG
2382 fprintf_filtered (stream, fmt, val);
2388 fprintf_filtered (stream, fmt, "(nil)");
2394 /* Print a portion of the format string that has no
2395 directives. Note that this will not include any
2396 ordinary %-specs, but it might include "%%". That is
2397 why we use printf_filtered and not puts_filtered here.
2398 Also, we pass a dummy argument because some platforms
2399 have modified GCC to include -Wformat-security by
2400 default, which will warn here if there is no
2402 fprintf_filtered (stream, current_substring, 0);
2405 internal_error (__FILE__, __LINE__,
2406 _("failed internal consistency check"));
2408 /* Maybe advance to the next argument. */
2409 if (fpieces[fr].argclass != literal_piece)
2413 do_cleanups (old_cleanups);
2416 /* Implement the "printf" command. */
2419 printf_command (char *arg, int from_tty)
2421 ui_printf (arg, gdb_stdout);
2424 /* Implement the "eval" command. */
2427 eval_command (char *arg, int from_tty)
2429 struct ui_file *ui_out = mem_fileopen ();
2430 struct cleanup *cleanups = make_cleanup_ui_file_delete (ui_out);
2433 ui_printf (arg, ui_out);
2435 expanded = ui_file_xstrdup (ui_out, NULL);
2436 make_cleanup (xfree, expanded);
2438 execute_command (expanded, from_tty);
2440 do_cleanups (cleanups);
2444 _initialize_printcmd (void)
2446 struct cmd_list_element *c;
2448 current_display_number = -1;
2450 observer_attach_solib_unloaded (clear_dangling_display_expressions);
2452 add_info ("address", address_info,
2453 _("Describe where symbol SYM is stored."));
2455 add_info ("symbol", sym_info, _("\
2456 Describe what symbol is at location ADDR.\n\
2457 Only for symbols with fixed locations (global or static scope)."));
2459 add_com ("x", class_vars, x_command, _("\
2460 Examine memory: x/FMT ADDRESS.\n\
2461 ADDRESS is an expression for the memory address to examine.\n\
2462 FMT is a repeat count followed by a format letter and a size letter.\n\
2463 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2464 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
2465 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2466 The specified number of objects of the specified size are printed\n\
2467 according to the format.\n\n\
2468 Defaults for format and size letters are those previously used.\n\
2469 Default count is 1. Default address is following last thing printed\n\
2470 with this command or \"print\"."));
2473 add_com ("whereis", class_vars, whereis_command,
2474 _("Print line number and file of definition of variable."));
2477 add_info ("display", display_info, _("\
2478 Expressions to display when program stops, with code numbers."));
2480 add_cmd ("undisplay", class_vars, undisplay_command, _("\
2481 Cancel some expressions to be displayed when program stops.\n\
2482 Arguments are the code numbers of the expressions to stop displaying.\n\
2483 No argument means cancel all automatic-display expressions.\n\
2484 \"delete display\" has the same effect as this command.\n\
2485 Do \"info display\" to see current list of code numbers."),
2488 add_com ("display", class_vars, display_command, _("\
2489 Print value of expression EXP each time the program stops.\n\
2490 /FMT may be used before EXP as in the \"print\" command.\n\
2491 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2492 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2493 and examining is done as in the \"x\" command.\n\n\
2494 With no argument, display all currently requested auto-display expressions.\n\
2495 Use \"undisplay\" to cancel display requests previously made."));
2497 add_cmd ("display", class_vars, enable_display_command, _("\
2498 Enable some expressions to be displayed when program stops.\n\
2499 Arguments are the code numbers of the expressions to resume displaying.\n\
2500 No argument means enable all automatic-display expressions.\n\
2501 Do \"info display\" to see current list of code numbers."), &enablelist);
2503 add_cmd ("display", class_vars, disable_display_command, _("\
2504 Disable some expressions to be displayed when program stops.\n\
2505 Arguments are the code numbers of the expressions to stop displaying.\n\
2506 No argument means disable all automatic-display expressions.\n\
2507 Do \"info display\" to see current list of code numbers."), &disablelist);
2509 add_cmd ("display", class_vars, undisplay_command, _("\
2510 Cancel some expressions to be displayed when program stops.\n\
2511 Arguments are the code numbers of the expressions to stop displaying.\n\
2512 No argument means cancel all automatic-display expressions.\n\
2513 Do \"info display\" to see current list of code numbers."), &deletelist);
2515 add_com ("printf", class_vars, printf_command, _("\
2516 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2517 This is useful for formatted output in user-defined commands."));
2519 add_com ("output", class_vars, output_command, _("\
2520 Like \"print\" but don't put in value history and don't print newline.\n\
2521 This is useful in user-defined commands."));
2523 add_prefix_cmd ("set", class_vars, set_command, _("\
2524 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2525 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2526 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2527 with $), a register (a few standard names starting with $), or an actual\n\
2528 variable in the program being debugged. EXP is any valid expression.\n\
2529 Use \"set variable\" for variables with names identical to set subcommands.\n\
2531 With a subcommand, this command modifies parts of the gdb environment.\n\
2532 You can see these environment settings with the \"show\" command."),
2533 &setlist, "set ", 1, &cmdlist);
2535 add_com ("assign", class_vars, set_command, _("\
2536 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2537 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2538 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2539 with $), a register (a few standard names starting with $), or an actual\n\
2540 variable in the program being debugged. EXP is any valid expression.\n\
2541 Use \"set variable\" for variables with names identical to set subcommands.\n\
2542 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2543 You can see these environment settings with the \"show\" command."));
2545 /* "call" is the same as "set", but handy for dbx users to call fns. */
2546 c = add_com ("call", class_vars, call_command, _("\
2547 Call a function in the program.\n\
2548 The argument is the function name and arguments, in the notation of the\n\
2549 current working language. The result is printed and saved in the value\n\
2550 history, if it is not void."));
2551 set_cmd_completer (c, expression_completer);
2553 add_cmd ("variable", class_vars, set_command, _("\
2554 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2555 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2556 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2557 with $), a register (a few standard names starting with $), or an actual\n\
2558 variable in the program being debugged. EXP is any valid expression.\n\
2559 This may usually be abbreviated to simply \"set\"."),
2562 c = add_com ("print", class_vars, print_command, _("\
2563 Print value of expression EXP.\n\
2564 Variables accessible are those of the lexical environment of the selected\n\
2565 stack frame, plus all those whose scope is global or an entire file.\n\
2567 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2568 $$NUM refers to NUM'th value back from the last one.\n\
2569 Names starting with $ refer to registers (with the values they would have\n\
2570 if the program were to return to the stack frame now selected, restoring\n\
2571 all registers saved by frames farther in) or else to debugger\n\
2572 \"convenience\" variables (any such name not a known register).\n\
2573 Use assignment expressions to give values to convenience variables.\n\
2575 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2576 @ is a binary operator for treating consecutive data objects\n\
2577 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2578 element is FOO, whose second element is stored in the space following\n\
2579 where FOO is stored, etc. FOO must be an expression whose value\n\
2580 resides in memory.\n\
2582 EXP may be preceded with /FMT, where FMT is a format letter\n\
2583 but no count or size letter (see \"x\" command)."));
2584 set_cmd_completer (c, expression_completer);
2585 add_com_alias ("p", "print", class_vars, 1);
2586 add_com_alias ("inspect", "print", class_vars, 1);
2588 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class,
2589 &max_symbolic_offset, _("\
2590 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2591 Show the largest offset that will be printed in <symbol+1234> form."), NULL,
2593 show_max_symbolic_offset,
2594 &setprintlist, &showprintlist);
2595 add_setshow_boolean_cmd ("symbol-filename", no_class,
2596 &print_symbol_filename, _("\
2597 Set printing of source filename and line number with <symbol>."), _("\
2598 Show printing of source filename and line number with <symbol>."), NULL,
2600 show_print_symbol_filename,
2601 &setprintlist, &showprintlist);
2603 add_com ("eval", no_class, eval_command, _("\
2604 Convert \"printf format string\", arg1, arg2, arg3, ..., argn to\n\
2605 a command line, and call it."));