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 /* Subroutine of ui_printf to simplify it.
1982 Print VALUE to STREAM using FORMAT.
1983 VALUE is a C-style string on the target. */
1986 printf_c_string (struct ui_file
*stream
, const char *format
,
1987 struct value
*value
)
1993 tem
= value_as_address (value
);
1995 /* This is a %s argument. Find the length of the string. */
2001 read_memory (tem
+ j
, &c
, 1);
2006 /* Copy the string contents into a string inside GDB. */
2007 str
= (gdb_byte
*) alloca (j
+ 1);
2009 read_memory (tem
, str
, j
);
2012 fprintf_filtered (stream
, format
, (char *) str
);
2015 /* Subroutine of ui_printf to simplify it.
2016 Print VALUE to STREAM using FORMAT.
2017 VALUE is a wide C-style string on the target. */
2020 printf_wide_c_string (struct ui_file
*stream
, const char *format
,
2021 struct value
*value
)
2026 struct gdbarch
*gdbarch
= get_type_arch (value_type (value
));
2027 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
2028 struct type
*wctype
= lookup_typename (current_language
, gdbarch
,
2029 "wchar_t", NULL
, 0);
2030 int wcwidth
= TYPE_LENGTH (wctype
);
2031 gdb_byte
*buf
= alloca (wcwidth
);
2032 struct obstack output
;
2033 struct cleanup
*inner_cleanup
;
2035 tem
= value_as_address (value
);
2037 /* This is a %s argument. Find the length of the string. */
2038 for (j
= 0;; j
+= wcwidth
)
2041 read_memory (tem
+ j
, buf
, wcwidth
);
2042 if (extract_unsigned_integer (buf
, wcwidth
, byte_order
) == 0)
2046 /* Copy the string contents into a string inside GDB. */
2047 str
= (gdb_byte
*) alloca (j
+ wcwidth
);
2049 read_memory (tem
, str
, j
);
2050 memset (&str
[j
], 0, wcwidth
);
2052 obstack_init (&output
);
2053 inner_cleanup
= make_cleanup_obstack_free (&output
);
2055 convert_between_encodings (target_wide_charset (gdbarch
),
2058 &output
, translit_char
);
2059 obstack_grow_str0 (&output
, "");
2061 fprintf_filtered (stream
, format
, obstack_base (&output
));
2062 do_cleanups (inner_cleanup
);
2065 /* Subroutine of ui_printf to simplify it.
2066 Print VALUE, a decimal floating point value, to STREAM using FORMAT. */
2069 printf_decfloat (struct ui_file
*stream
, const char *format
,
2070 struct value
*value
)
2072 const gdb_byte
*param_ptr
= value_contents (value
);
2074 #if defined (PRINTF_HAS_DECFLOAT)
2075 /* If we have native support for Decimal floating
2076 printing, handle it here. */
2077 fprintf_filtered (stream
, format
, param_ptr
);
2079 /* As a workaround until vasprintf has native support for DFP
2080 we convert the DFP values to string and print them using
2081 the %s format specifier. */
2084 /* Parameter data. */
2085 struct type
*param_type
= value_type (value
);
2086 struct gdbarch
*gdbarch
= get_type_arch (param_type
);
2087 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
2089 /* DFP output data. */
2090 struct value
*dfp_value
= NULL
;
2094 struct type
*dfp_type
= NULL
;
2095 char decstr
[MAX_DECIMAL_STRING
];
2097 /* Points to the end of the string so that we can go back
2098 and check for DFP length modifiers. */
2099 p
= format
+ strlen (format
);
2101 /* Look for the float/double format specifier. */
2102 while (*p
!= 'f' && *p
!= 'e' && *p
!= 'E'
2103 && *p
!= 'g' && *p
!= 'G')
2106 /* Search for the '%' char and extract the size and type of
2107 the output decimal value based on its modifiers
2108 (%Hf, %Df, %DDf). */
2114 dfp_type
= builtin_type (gdbarch
)->builtin_decfloat
;
2116 else if (*p
== 'D' && *(p
- 1) == 'D')
2119 dfp_type
= builtin_type (gdbarch
)->builtin_declong
;
2125 dfp_type
= builtin_type (gdbarch
)->builtin_decdouble
;
2129 /* Conversion between different DFP types. */
2130 if (TYPE_CODE (param_type
) == TYPE_CODE_DECFLOAT
)
2131 decimal_convert (param_ptr
, TYPE_LENGTH (param_type
),
2132 byte_order
, dec
, dfp_len
, byte_order
);
2134 /* If this is a non-trivial conversion, just output 0.
2135 A correct converted value can be displayed by explicitly
2136 casting to a DFP type. */
2137 decimal_from_string (dec
, dfp_len
, byte_order
, "0");
2139 dfp_value
= value_from_decfloat (dfp_type
, dec
);
2141 dfp_ptr
= (gdb_byte
*) value_contents (dfp_value
);
2143 decimal_to_string (dfp_ptr
, dfp_len
, byte_order
, decstr
);
2145 /* Print the DFP value. */
2146 fprintf_filtered (stream
, "%s", decstr
);
2150 /* Subroutine of ui_printf to simplify it.
2151 Print VALUE, a target pointer, to STREAM using FORMAT. */
2154 printf_pointer (struct ui_file
*stream
, const char *format
,
2155 struct value
*value
)
2157 /* We avoid the host's %p because pointers are too
2158 likely to be the wrong size. The only interesting
2159 modifier for %p is a width; extract that, and then
2160 handle %p as glibc would: %#x or a literal "(nil)". */
2164 #ifdef PRINTF_HAS_LONG_LONG
2165 long long val
= value_as_long (value
);
2167 long val
= value_as_long (value
);
2170 fmt
= alloca (strlen (format
) + 5);
2172 /* Copy up to the leading %. */
2177 int is_percent
= (*p
== '%');
2192 /* Copy any width. */
2193 while (*p
>= '0' && *p
< '9')
2196 gdb_assert (*p
== 'p' && *(p
+ 1) == '\0');
2199 #ifdef PRINTF_HAS_LONG_LONG
2205 fprintf_filtered (stream
, fmt
, val
);
2211 fprintf_filtered (stream
, fmt
, "(nil)");
2215 /* printf "printf format string" ARG to STREAM. */
2218 ui_printf (const char *arg
, struct ui_file
*stream
)
2220 struct format_piece
*fpieces
;
2221 const char *s
= arg
;
2222 struct value
**val_args
;
2223 int allocated_args
= 20;
2224 struct cleanup
*old_cleanups
;
2226 val_args
= xmalloc (allocated_args
* sizeof (struct value
*));
2227 old_cleanups
= make_cleanup (free_current_contents
, &val_args
);
2230 error_no_arg (_("format-control string and values to print"));
2232 s
= skip_spaces_const (s
);
2234 /* A format string should follow, enveloped in double quotes. */
2236 error (_("Bad format string, missing '\"'."));
2238 fpieces
= parse_format_string (&s
);
2240 make_cleanup (free_format_pieces_cleanup
, &fpieces
);
2243 error (_("Bad format string, non-terminated '\"'."));
2245 s
= skip_spaces_const (s
);
2247 if (*s
!= ',' && *s
!= 0)
2248 error (_("Invalid argument syntax"));
2252 s
= skip_spaces_const (s
);
2258 char *current_substring
;
2261 for (fr
= 0; fpieces
[fr
].string
!= NULL
; fr
++)
2262 if (fpieces
[fr
].argclass
!= literal_piece
)
2265 /* Now, parse all arguments and evaluate them.
2266 Store the VALUEs in VAL_ARGS. */
2272 if (nargs
== allocated_args
)
2273 val_args
= (struct value
**) xrealloc ((char *) val_args
,
2274 (allocated_args
*= 2)
2275 * sizeof (struct value
*));
2277 val_args
[nargs
] = parse_to_comma_and_eval (&s1
);
2285 if (nargs
!= nargs_wanted
)
2286 error (_("Wrong number of arguments for specified format-string"));
2288 /* Now actually print them. */
2290 for (fr
= 0; fpieces
[fr
].string
!= NULL
; fr
++)
2292 current_substring
= fpieces
[fr
].string
;
2293 switch (fpieces
[fr
].argclass
)
2296 printf_c_string (stream
, current_substring
, val_args
[i
]);
2298 case wide_string_arg
:
2299 printf_wide_c_string (stream
, current_substring
, val_args
[i
]);
2303 struct gdbarch
*gdbarch
2304 = get_type_arch (value_type (val_args
[i
]));
2305 struct type
*wctype
= lookup_typename (current_language
, gdbarch
,
2306 "wchar_t", NULL
, 0);
2307 struct type
*valtype
;
2308 struct obstack output
;
2309 struct cleanup
*inner_cleanup
;
2310 const gdb_byte
*bytes
;
2312 valtype
= value_type (val_args
[i
]);
2313 if (TYPE_LENGTH (valtype
) != TYPE_LENGTH (wctype
)
2314 || TYPE_CODE (valtype
) != TYPE_CODE_INT
)
2315 error (_("expected wchar_t argument for %%lc"));
2317 bytes
= value_contents (val_args
[i
]);
2319 obstack_init (&output
);
2320 inner_cleanup
= make_cleanup_obstack_free (&output
);
2322 convert_between_encodings (target_wide_charset (gdbarch
),
2324 bytes
, TYPE_LENGTH (valtype
),
2325 TYPE_LENGTH (valtype
),
2326 &output
, translit_char
);
2327 obstack_grow_str0 (&output
, "");
2329 fprintf_filtered (stream
, current_substring
,
2330 obstack_base (&output
));
2331 do_cleanups (inner_cleanup
);
2336 struct type
*type
= value_type (val_args
[i
]);
2340 /* If format string wants a float, unchecked-convert the value
2341 to floating point of the same size. */
2342 type
= float_type_from_length (type
);
2343 val
= unpack_double (type
, value_contents (val_args
[i
]), &inv
);
2345 error (_("Invalid floating value found in program."));
2347 fprintf_filtered (stream
, current_substring
, (double) val
);
2350 case long_double_arg
:
2351 #ifdef HAVE_LONG_DOUBLE
2353 struct type
*type
= value_type (val_args
[i
]);
2357 /* If format string wants a float, unchecked-convert the value
2358 to floating point of the same size. */
2359 type
= float_type_from_length (type
);
2360 val
= unpack_double (type
, value_contents (val_args
[i
]), &inv
);
2362 error (_("Invalid floating value found in program."));
2364 fprintf_filtered (stream
, current_substring
,
2369 error (_("long double not supported in printf"));
2372 #ifdef PRINTF_HAS_LONG_LONG
2374 long long val
= value_as_long (val_args
[i
]);
2376 fprintf_filtered (stream
, current_substring
, val
);
2380 error (_("long long not supported in printf"));
2384 int val
= value_as_long (val_args
[i
]);
2386 fprintf_filtered (stream
, current_substring
, val
);
2391 long val
= value_as_long (val_args
[i
]);
2393 fprintf_filtered (stream
, current_substring
, val
);
2396 /* Handles decimal floating values. */
2398 printf_decfloat (stream
, current_substring
, val_args
[i
]);
2401 printf_pointer (stream
, current_substring
, val_args
[i
]);
2404 /* Print a portion of the format string that has no
2405 directives. Note that this will not include any
2406 ordinary %-specs, but it might include "%%". That is
2407 why we use printf_filtered and not puts_filtered here.
2408 Also, we pass a dummy argument because some platforms
2409 have modified GCC to include -Wformat-security by
2410 default, which will warn here if there is no
2412 fprintf_filtered (stream
, current_substring
, 0);
2415 internal_error (__FILE__
, __LINE__
,
2416 _("failed internal consistency check"));
2418 /* Maybe advance to the next argument. */
2419 if (fpieces
[fr
].argclass
!= literal_piece
)
2423 do_cleanups (old_cleanups
);
2426 /* Implement the "printf" command. */
2429 printf_command (char *arg
, int from_tty
)
2431 ui_printf (arg
, gdb_stdout
);
2434 /* Implement the "eval" command. */
2437 eval_command (char *arg
, int from_tty
)
2439 struct ui_file
*ui_out
= mem_fileopen ();
2440 struct cleanup
*cleanups
= make_cleanup_ui_file_delete (ui_out
);
2443 ui_printf (arg
, ui_out
);
2445 expanded
= ui_file_xstrdup (ui_out
, NULL
);
2446 make_cleanup (xfree
, expanded
);
2448 execute_command (expanded
, from_tty
);
2450 do_cleanups (cleanups
);
2454 _initialize_printcmd (void)
2456 struct cmd_list_element
*c
;
2458 current_display_number
= -1;
2460 observer_attach_solib_unloaded (clear_dangling_display_expressions
);
2462 add_info ("address", address_info
,
2463 _("Describe where symbol SYM is stored."));
2465 add_info ("symbol", sym_info
, _("\
2466 Describe what symbol is at location ADDR.\n\
2467 Only for symbols with fixed locations (global or static scope)."));
2469 add_com ("x", class_vars
, x_command
, _("\
2470 Examine memory: x/FMT ADDRESS.\n\
2471 ADDRESS is an expression for the memory address to examine.\n\
2472 FMT is a repeat count followed by a format letter and a size letter.\n\
2473 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2474 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
2475 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2476 The specified number of objects of the specified size are printed\n\
2477 according to the format.\n\n\
2478 Defaults for format and size letters are those previously used.\n\
2479 Default count is 1. Default address is following last thing printed\n\
2480 with this command or \"print\"."));
2483 add_com ("whereis", class_vars
, whereis_command
,
2484 _("Print line number and file of definition of variable."));
2487 add_info ("display", display_info
, _("\
2488 Expressions to display when program stops, with code numbers."));
2490 add_cmd ("undisplay", class_vars
, undisplay_command
, _("\
2491 Cancel some expressions to be displayed when program stops.\n\
2492 Arguments are the code numbers of the expressions to stop displaying.\n\
2493 No argument means cancel all automatic-display expressions.\n\
2494 \"delete display\" has the same effect as this command.\n\
2495 Do \"info display\" to see current list of code numbers."),
2498 add_com ("display", class_vars
, display_command
, _("\
2499 Print value of expression EXP each time the program stops.\n\
2500 /FMT may be used before EXP as in the \"print\" command.\n\
2501 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2502 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2503 and examining is done as in the \"x\" command.\n\n\
2504 With no argument, display all currently requested auto-display expressions.\n\
2505 Use \"undisplay\" to cancel display requests previously made."));
2507 add_cmd ("display", class_vars
, enable_display_command
, _("\
2508 Enable some expressions to be displayed when program stops.\n\
2509 Arguments are the code numbers of the expressions to resume displaying.\n\
2510 No argument means enable all automatic-display expressions.\n\
2511 Do \"info display\" to see current list of code numbers."), &enablelist
);
2513 add_cmd ("display", class_vars
, disable_display_command
, _("\
2514 Disable some expressions to be displayed when program stops.\n\
2515 Arguments are the code numbers of the expressions to stop displaying.\n\
2516 No argument means disable all automatic-display expressions.\n\
2517 Do \"info display\" to see current list of code numbers."), &disablelist
);
2519 add_cmd ("display", class_vars
, undisplay_command
, _("\
2520 Cancel some expressions to be displayed when program stops.\n\
2521 Arguments are the code numbers of the expressions to stop displaying.\n\
2522 No argument means cancel all automatic-display expressions.\n\
2523 Do \"info display\" to see current list of code numbers."), &deletelist
);
2525 add_com ("printf", class_vars
, printf_command
, _("\
2526 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2527 This is useful for formatted output in user-defined commands."));
2529 add_com ("output", class_vars
, output_command
, _("\
2530 Like \"print\" but don't put in value history and don't print newline.\n\
2531 This is useful in user-defined commands."));
2533 add_prefix_cmd ("set", class_vars
, set_command
, _("\
2534 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2535 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2536 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2537 with $), a register (a few standard names starting with $), or an actual\n\
2538 variable in the program being debugged. EXP is any valid expression.\n\
2539 Use \"set variable\" for variables with names identical to set subcommands.\n\
2541 With a subcommand, this command modifies parts of the gdb environment.\n\
2542 You can see these environment settings with the \"show\" command."),
2543 &setlist
, "set ", 1, &cmdlist
);
2545 add_com ("assign", class_vars
, set_command
, _("\
2546 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2547 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2548 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2549 with $), a register (a few standard names starting with $), or an actual\n\
2550 variable in the program being debugged. EXP is any valid expression.\n\
2551 Use \"set variable\" for variables with names identical to set subcommands.\n\
2552 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2553 You can see these environment settings with the \"show\" command."));
2555 /* "call" is the same as "set", but handy for dbx users to call fns. */
2556 c
= add_com ("call", class_vars
, call_command
, _("\
2557 Call a function in the program.\n\
2558 The argument is the function name and arguments, in the notation of the\n\
2559 current working language. The result is printed and saved in the value\n\
2560 history, if it is not void."));
2561 set_cmd_completer (c
, expression_completer
);
2563 add_cmd ("variable", class_vars
, set_command
, _("\
2564 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2565 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2566 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2567 with $), a register (a few standard names starting with $), or an actual\n\
2568 variable in the program being debugged. EXP is any valid expression.\n\
2569 This may usually be abbreviated to simply \"set\"."),
2572 c
= add_com ("print", class_vars
, print_command
, _("\
2573 Print value of expression EXP.\n\
2574 Variables accessible are those of the lexical environment of the selected\n\
2575 stack frame, plus all those whose scope is global or an entire file.\n\
2577 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2578 $$NUM refers to NUM'th value back from the last one.\n\
2579 Names starting with $ refer to registers (with the values they would have\n\
2580 if the program were to return to the stack frame now selected, restoring\n\
2581 all registers saved by frames farther in) or else to debugger\n\
2582 \"convenience\" variables (any such name not a known register).\n\
2583 Use assignment expressions to give values to convenience variables.\n\
2585 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2586 @ is a binary operator for treating consecutive data objects\n\
2587 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2588 element is FOO, whose second element is stored in the space following\n\
2589 where FOO is stored, etc. FOO must be an expression whose value\n\
2590 resides in memory.\n\
2592 EXP may be preceded with /FMT, where FMT is a format letter\n\
2593 but no count or size letter (see \"x\" command)."));
2594 set_cmd_completer (c
, expression_completer
);
2595 add_com_alias ("p", "print", class_vars
, 1);
2596 add_com_alias ("inspect", "print", class_vars
, 1);
2598 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class
,
2599 &max_symbolic_offset
, _("\
2600 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2601 Show the largest offset that will be printed in <symbol+1234> form."), NULL
,
2603 show_max_symbolic_offset
,
2604 &setprintlist
, &showprintlist
);
2605 add_setshow_boolean_cmd ("symbol-filename", no_class
,
2606 &print_symbol_filename
, _("\
2607 Set printing of source filename and line number with <symbol>."), _("\
2608 Show printing of source filename and line number with <symbol>."), NULL
,
2610 show_print_symbol_filename
,
2611 &setprintlist
, &showprintlist
);
2613 add_com ("eval", no_class
, eval_command
, _("\
2614 Convert \"printf format string\", arg1, arg2, arg3, ..., argn to\n\
2615 a command line, and call it."));