1 /* Print values for GNU debugger GDB.
3 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
5 2008 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 #include "gdb_string.h"
29 #include "expression.h"
33 #include "breakpoint.h"
37 #include "symfile.h" /* for overlay functions */
38 #include "objfiles.h" /* ditto */
39 #include "completer.h" /* for completion functions */
41 #include "gdb_assert.h"
47 #include "tui/tui.h" /* For tui_active et.al. */
50 #if defined(__MINGW32__)
51 # define USE_PRINTF_I64 1
52 # define PRINTF_HAS_LONG_LONG
54 # define USE_PRINTF_I64 0
57 extern int asm_demangle
; /* Whether to demangle syms in asm printouts */
58 extern int addressprint
; /* Whether to print hex addresses in HLL " */
67 /* Last specified output format. */
69 static char last_format
= 'x';
71 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
73 static char last_size
= 'w';
75 /* Default address to examine next. */
77 static CORE_ADDR next_address
;
79 /* Number of delay instructions following current disassembled insn. */
81 static int branch_delay_insns
;
83 /* Last address examined. */
85 static CORE_ADDR last_examine_address
;
87 /* Contents of last address examined.
88 This is not valid past the end of the `x' command! */
90 static struct value
*last_examine_value
;
92 /* Largest offset between a symbolic value and an address, that will be
93 printed as `0x1234 <symbol+offset>'. */
95 static unsigned int max_symbolic_offset
= UINT_MAX
;
97 show_max_symbolic_offset (struct ui_file
*file
, int from_tty
,
98 struct cmd_list_element
*c
, const char *value
)
100 fprintf_filtered (file
, _("\
101 The largest offset that will be printed in <symbol+1234> form is %s.\n"),
105 /* Append the source filename and linenumber of the symbol when
106 printing a symbolic value as `<symbol at filename:linenum>' if set. */
107 static int print_symbol_filename
= 0;
109 show_print_symbol_filename (struct ui_file
*file
, int from_tty
,
110 struct cmd_list_element
*c
, const char *value
)
112 fprintf_filtered (file
, _("\
113 Printing of source filename and line number with <symbol> is %s.\n"),
117 /* Number of auto-display expression currently being displayed.
118 So that we can disable it if we get an error or a signal within it.
119 -1 when not doing one. */
121 int current_display_number
;
123 /* Flag to low-level print routines that this value is being printed
124 in an epoch window. We'd like to pass this as a parameter, but
125 every routine would need to take it. Perhaps we can encapsulate
126 this in the I/O stream once we have GNU stdio. */
132 /* Chain link to next auto-display item. */
133 struct display
*next
;
134 /* Expression to be evaluated and displayed. */
135 struct expression
*exp
;
136 /* Item number of this auto-display item. */
138 /* Display format specified. */
139 struct format_data format
;
140 /* Innermost block required by this expression when evaluated */
142 /* Status of this display (enabled or disabled) */
146 /* Chain of expressions whose values should be displayed
147 automatically each time the program stops. */
149 static struct display
*display_chain
;
151 static int display_number
;
153 /* Prototypes for exported functions. */
155 void output_command (char *, int);
157 void _initialize_printcmd (void);
159 /* Prototypes for local functions. */
161 static void do_one_display (struct display
*);
164 /* Decode a format specification. *STRING_PTR should point to it.
165 OFORMAT and OSIZE are used as defaults for the format and size
166 if none are given in the format specification.
167 If OSIZE is zero, then the size field of the returned value
168 should be set only if a size is explicitly specified by the
170 The structure returned describes all the data
171 found in the specification. In addition, *STRING_PTR is advanced
172 past the specification and past all whitespace following it. */
174 static struct format_data
175 decode_format (char **string_ptr
, int oformat
, int osize
)
177 struct format_data val
;
178 char *p
= *string_ptr
;
184 if (*p
>= '0' && *p
<= '9')
185 val
.count
= atoi (p
);
186 while (*p
>= '0' && *p
<= '9')
189 /* Now process size or format letters that follow. */
193 if (*p
== 'b' || *p
== 'h' || *p
== 'w' || *p
== 'g')
195 else if (*p
>= 'a' && *p
<= 'z')
201 while (*p
== ' ' || *p
== '\t')
205 /* Set defaults for format and size if not specified. */
206 if (val
.format
== '?')
210 /* Neither has been specified. */
211 val
.format
= oformat
;
215 /* If a size is specified, any format makes a reasonable
216 default except 'i'. */
217 val
.format
= oformat
== 'i' ? 'x' : oformat
;
219 else if (val
.size
== '?')
224 /* Pick the appropriate size for an address. */
225 if (gdbarch_ptr_bit (current_gdbarch
) == 64)
226 val
.size
= osize
? 'g' : osize
;
227 else if (gdbarch_ptr_bit (current_gdbarch
) == 32)
228 val
.size
= osize
? 'w' : osize
;
229 else if (gdbarch_ptr_bit (current_gdbarch
) == 16)
230 val
.size
= osize
? 'h' : osize
;
232 /* Bad value for gdbarch_ptr_bit. */
233 internal_error (__FILE__
, __LINE__
,
234 _("failed internal consistency check"));
237 /* Floating point has to be word or giantword. */
238 if (osize
== 'w' || osize
== 'g')
241 /* Default it to giantword if the last used size is not
243 val
.size
= osize
? 'g' : osize
;
246 /* Characters default to one byte. */
247 val
.size
= osize
? 'b' : osize
;
250 /* The default is the size most recently specified. */
257 /* Print value VAL on stream according to FORMAT, a letter or 0.
258 Do not end with a newline.
259 0 means print VAL according to its own type.
260 SIZE is the letter for the size of datum being printed.
261 This is used to pad hex numbers so they line up. SIZE is 0
262 for print / output and set for examine. */
265 print_formatted (struct value
*val
, int format
, int size
,
266 struct ui_file
*stream
)
268 struct type
*type
= check_typedef (value_type (val
));
269 int len
= TYPE_LENGTH (type
);
271 if (VALUE_LVAL (val
) == lval_memory
)
272 next_address
= VALUE_ADDRESS (val
) + len
;
279 /* FIXME: Need to handle wchar_t's here... */
280 next_address
= VALUE_ADDRESS (val
)
281 + val_print_string (VALUE_ADDRESS (val
), -1, 1, stream
);
285 /* We often wrap here if there are long symbolic names. */
287 next_address
= (VALUE_ADDRESS (val
)
288 + gdb_print_insn (VALUE_ADDRESS (val
), stream
,
289 &branch_delay_insns
));
294 if (format
== 0 || format
== 's'
295 || TYPE_CODE (type
) == TYPE_CODE_REF
296 || TYPE_CODE (type
) == TYPE_CODE_ARRAY
297 || TYPE_CODE (type
) == TYPE_CODE_STRING
298 || TYPE_CODE (type
) == TYPE_CODE_STRUCT
299 || TYPE_CODE (type
) == TYPE_CODE_UNION
300 || TYPE_CODE (type
) == TYPE_CODE_NAMESPACE
)
301 /* If format is 0, use the 'natural' format for that type of
302 value. If the type is non-scalar, we have to use language
303 rules to print it as a series of scalars. */
304 value_print (val
, stream
, format
, Val_pretty_default
);
306 /* User specified format, so don't look to the the type to
307 tell us what to do. */
308 print_scalar_formatted (value_contents (val
), type
,
309 format
, size
, stream
);
312 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
313 according to letters FORMAT and SIZE on STREAM.
314 FORMAT may not be zero. Formats s and i are not supported at this level.
316 This is how the elements of an array or structure are printed
320 print_scalar_formatted (const void *valaddr
, struct type
*type
,
321 int format
, int size
, struct ui_file
*stream
)
323 LONGEST val_long
= 0;
324 unsigned int len
= TYPE_LENGTH (type
);
325 enum bfd_endian byte_order
= gdbarch_byte_order (current_gdbarch
);
327 /* If we get here with a string format, try again without it. Go
328 all the way back to the language printers, which may call us
332 val_print (type
, valaddr
, 0, 0, stream
, 0, 0, 0, Val_pretty_default
,
337 if (len
> sizeof(LONGEST
) &&
338 (TYPE_CODE (type
) == TYPE_CODE_INT
339 || TYPE_CODE (type
) == TYPE_CODE_ENUM
))
344 print_octal_chars (stream
, valaddr
, len
, byte_order
);
348 print_decimal_chars (stream
, valaddr
, len
, byte_order
);
351 print_binary_chars (stream
, valaddr
, len
, byte_order
);
354 print_hex_chars (stream
, valaddr
, len
, byte_order
);
357 print_char_chars (stream
, valaddr
, len
, byte_order
);
365 val_long
= unpack_long (type
, valaddr
);
367 /* If the value is a pointer, and pointers and addresses are not the
368 same, then at this point, the value's length (in target bytes) is
369 gdbarch_addr_bit/TARGET_CHAR_BIT, not TYPE_LENGTH (type). */
370 if (TYPE_CODE (type
) == TYPE_CODE_PTR
)
371 len
= gdbarch_addr_bit (current_gdbarch
) / TARGET_CHAR_BIT
;
373 /* If we are printing it as unsigned, truncate it in case it is actually
374 a negative signed value (e.g. "print/u (short)-1" should print 65535
375 (if shorts are 16 bits) instead of 4294967295). */
378 if (len
< sizeof (LONGEST
))
379 val_long
&= ((LONGEST
) 1 << HOST_CHAR_BIT
* len
) - 1;
387 /* No size specified, like in print. Print varying # of digits. */
388 print_longest (stream
, 'x', 1, val_long
);
397 print_longest (stream
, size
, 1, val_long
);
400 error (_("Undefined output size \"%c\"."), size
);
405 print_longest (stream
, 'd', 1, val_long
);
409 print_longest (stream
, 'u', 0, val_long
);
414 print_longest (stream
, 'o', 1, val_long
);
416 fprintf_filtered (stream
, "0");
421 CORE_ADDR addr
= unpack_pointer (type
, valaddr
);
422 print_address (addr
, stream
);
427 if (TYPE_UNSIGNED (type
))
431 utype
= builtin_type (current_gdbarch
)->builtin_true_unsigned_char
;
432 value_print (value_from_longest (utype
, val_long
),
433 stream
, 0, Val_pretty_default
);
436 value_print (value_from_longest (builtin_type_true_char
, val_long
),
437 stream
, 0, Val_pretty_default
);
441 if (len
== TYPE_LENGTH (builtin_type_float
))
442 type
= builtin_type_float
;
443 else if (len
== TYPE_LENGTH (builtin_type_double
))
444 type
= builtin_type_double
;
445 else if (len
== TYPE_LENGTH (builtin_type_long_double
))
446 type
= builtin_type_long_double
;
447 print_floating (valaddr
, type
, stream
);
451 internal_error (__FILE__
, __LINE__
,
452 _("failed internal consistency check"));
455 /* Binary; 't' stands for "two". */
457 char bits
[8 * (sizeof val_long
) + 1];
458 char buf
[8 * (sizeof val_long
) + 32];
463 width
= 8 * (sizeof val_long
);
480 error (_("Undefined output size \"%c\"."), size
);
486 bits
[width
] = (val_long
& 1) ? '1' : '0';
491 while (*cp
&& *cp
== '0')
497 fputs_filtered (buf
, stream
);
502 error (_("Undefined output format \"%c\"."), format
);
506 /* Specify default address for `x' command.
507 The `info lines' command uses this. */
510 set_next_address (CORE_ADDR addr
)
514 /* Make address available to the user as $_. */
515 set_internalvar (lookup_internalvar ("_"),
516 value_from_pointer (lookup_pointer_type (builtin_type_void
),
520 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
521 after LEADIN. Print nothing if no symbolic name is found nearby.
522 Optionally also print source file and line number, if available.
523 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
524 or to interpret it as a possible C++ name and convert it back to source
525 form. However note that DO_DEMANGLE can be overridden by the specific
526 settings of the demangle and asm_demangle variables. */
529 print_address_symbolic (CORE_ADDR addr
, struct ui_file
*stream
,
530 int do_demangle
, char *leadin
)
533 char *filename
= NULL
;
538 /* Throw away both name and filename. */
539 struct cleanup
*cleanup_chain
= make_cleanup (free_current_contents
, &name
);
540 make_cleanup (free_current_contents
, &filename
);
542 if (build_address_symbolic (addr
, do_demangle
, &name
, &offset
,
543 &filename
, &line
, &unmapped
))
545 do_cleanups (cleanup_chain
);
549 fputs_filtered (leadin
, stream
);
551 fputs_filtered ("<*", stream
);
553 fputs_filtered ("<", stream
);
554 fputs_filtered (name
, stream
);
556 fprintf_filtered (stream
, "+%u", (unsigned int) offset
);
558 /* Append source filename and line number if desired. Give specific
559 line # of this addr, if we have it; else line # of the nearest symbol. */
560 if (print_symbol_filename
&& filename
!= NULL
)
563 fprintf_filtered (stream
, " at %s:%d", filename
, line
);
565 fprintf_filtered (stream
, " in %s", filename
);
568 fputs_filtered ("*>", stream
);
570 fputs_filtered (">", stream
);
572 do_cleanups (cleanup_chain
);
575 /* Given an address ADDR return all the elements needed to print the
576 address in a symbolic form. NAME can be mangled or not depending
577 on DO_DEMANGLE (and also on the asm_demangle global variable,
578 manipulated via ''set print asm-demangle''). Return 0 in case of
579 success, when all the info in the OUT paramters is valid. Return 1
582 build_address_symbolic (CORE_ADDR addr
, /* IN */
583 int do_demangle
, /* IN */
584 char **name
, /* OUT */
585 int *offset
, /* OUT */
586 char **filename
, /* OUT */
588 int *unmapped
) /* OUT */
590 struct minimal_symbol
*msymbol
;
591 struct symbol
*symbol
;
592 CORE_ADDR name_location
= 0;
593 asection
*section
= 0;
594 char *name_temp
= "";
596 /* Let's say it is unmapped. */
599 /* Determine if the address is in an overlay, and whether it is
601 if (overlay_debugging
)
603 section
= find_pc_overlay (addr
);
604 if (pc_in_unmapped_range (addr
, section
))
607 addr
= overlay_mapped_address (addr
, section
);
611 /* First try to find the address in the symbol table, then
612 in the minsyms. Take the closest one. */
614 /* This is defective in the sense that it only finds text symbols. So
615 really this is kind of pointless--we should make sure that the
616 minimal symbols have everything we need (by changing that we could
617 save some memory, but for many debug format--ELF/DWARF or
618 anything/stabs--it would be inconvenient to eliminate those minimal
620 msymbol
= lookup_minimal_symbol_by_pc_section (addr
, section
);
621 symbol
= find_pc_sect_function (addr
, section
);
625 name_location
= BLOCK_START (SYMBOL_BLOCK_VALUE (symbol
));
626 if (do_demangle
|| asm_demangle
)
627 name_temp
= SYMBOL_PRINT_NAME (symbol
);
629 name_temp
= DEPRECATED_SYMBOL_NAME (symbol
);
634 if (SYMBOL_VALUE_ADDRESS (msymbol
) > name_location
|| symbol
== NULL
)
636 /* The msymbol is closer to the address than the symbol;
637 use the msymbol instead. */
639 name_location
= SYMBOL_VALUE_ADDRESS (msymbol
);
640 if (do_demangle
|| asm_demangle
)
641 name_temp
= SYMBOL_PRINT_NAME (msymbol
);
643 name_temp
= DEPRECATED_SYMBOL_NAME (msymbol
);
646 if (symbol
== NULL
&& msymbol
== NULL
)
649 /* If the nearest symbol is too far away, don't print anything symbolic. */
651 /* For when CORE_ADDR is larger than unsigned int, we do math in
652 CORE_ADDR. But when we detect unsigned wraparound in the
653 CORE_ADDR math, we ignore this test and print the offset,
654 because addr+max_symbolic_offset has wrapped through the end
655 of the address space back to the beginning, giving bogus comparison. */
656 if (addr
> name_location
+ max_symbolic_offset
657 && name_location
+ max_symbolic_offset
> name_location
)
660 *offset
= addr
- name_location
;
662 *name
= xstrdup (name_temp
);
664 if (print_symbol_filename
)
666 struct symtab_and_line sal
;
668 sal
= find_pc_sect_line (addr
, section
, 0);
672 *filename
= xstrdup (sal
.symtab
->filename
);
680 /* Print address ADDR symbolically on STREAM.
681 First print it as a number. Then perhaps print
682 <SYMBOL + OFFSET> after the number. */
685 print_address (CORE_ADDR addr
, struct ui_file
*stream
)
687 fputs_filtered (paddress (addr
), stream
);
688 print_address_symbolic (addr
, stream
, asm_demangle
, " ");
691 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
692 controls whether to print the symbolic name "raw" or demangled.
693 Global setting "addressprint" controls whether to print hex address
697 print_address_demangle (CORE_ADDR addr
, struct ui_file
*stream
,
702 fprintf_filtered (stream
, "0");
704 else if (addressprint
)
706 fputs_filtered (paddress (addr
), stream
);
707 print_address_symbolic (addr
, stream
, do_demangle
, " ");
711 print_address_symbolic (addr
, stream
, do_demangle
, "");
716 /* These are the types that $__ will get after an examine command of one
719 static struct type
*examine_i_type
;
721 static struct type
*examine_b_type
;
722 static struct type
*examine_h_type
;
723 static struct type
*examine_w_type
;
724 static struct type
*examine_g_type
;
726 /* Examine data at address ADDR in format FMT.
727 Fetch it from memory and print on gdb_stdout. */
730 do_examine (struct format_data fmt
, CORE_ADDR addr
)
735 struct type
*val_type
= NULL
;
744 /* String or instruction format implies fetch single bytes
745 regardless of the specified size. */
746 if (format
== 's' || format
== 'i')
750 val_type
= examine_i_type
;
751 else if (size
== 'b')
752 val_type
= examine_b_type
;
753 else if (size
== 'h')
754 val_type
= examine_h_type
;
755 else if (size
== 'w')
756 val_type
= examine_w_type
;
757 else if (size
== 'g')
758 val_type
= examine_g_type
;
765 if (format
== 's' || format
== 'i')
768 /* Print as many objects as specified in COUNT, at most maxelts per line,
769 with the address of the next one at the start of each line. */
774 print_address (next_address
, gdb_stdout
);
775 printf_filtered (":");
780 printf_filtered ("\t");
781 /* Note that print_formatted sets next_address for the next
783 last_examine_address
= next_address
;
785 if (last_examine_value
)
786 value_free (last_examine_value
);
788 /* The value to be displayed is not fetched greedily.
789 Instead, to avoid the possibility of a fetched value not
790 being used, its retrieval is delayed until the print code
791 uses it. When examining an instruction stream, the
792 disassembler will perform its own memory fetch using just
793 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
794 the disassembler be modified so that LAST_EXAMINE_VALUE
795 is left with the byte sequence from the last complete
796 instruction fetched from memory? */
797 last_examine_value
= value_at_lazy (val_type
, next_address
);
799 if (last_examine_value
)
800 release_value (last_examine_value
);
802 print_formatted (last_examine_value
, format
, size
, gdb_stdout
);
804 /* Display any branch delay slots following the final insn. */
805 if (format
== 'i' && count
== 1)
806 count
+= branch_delay_insns
;
808 printf_filtered ("\n");
809 gdb_flush (gdb_stdout
);
814 validate_format (struct format_data fmt
, char *cmdname
)
817 error (_("Size letters are meaningless in \"%s\" command."), cmdname
);
819 error (_("Item count other than 1 is meaningless in \"%s\" command."),
821 if (fmt
.format
== 'i')
822 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
823 fmt
.format
, cmdname
);
826 /* Evaluate string EXP as an expression in the current language and
827 print the resulting value. EXP may contain a format specifier as the
828 first argument ("/x myvar" for example, to print myvar in hex). */
831 print_command_1 (char *exp
, int inspect
, int voidprint
)
833 struct expression
*expr
;
834 struct cleanup
*old_chain
= 0;
837 struct format_data fmt
;
840 /* Pass inspect flag to the rest of the print routines in a global
842 inspect_it
= inspect
;
844 if (exp
&& *exp
== '/')
847 fmt
= decode_format (&exp
, last_format
, 0);
848 validate_format (fmt
, "print");
849 last_format
= format
= fmt
.format
;
861 expr
= parse_expression (exp
);
862 old_chain
= make_cleanup (free_current_contents
, &expr
);
864 val
= evaluate_expression (expr
);
867 val
= access_value_history (0);
869 if (voidprint
|| (val
&& value_type (val
) &&
870 TYPE_CODE (value_type (val
)) != TYPE_CODE_VOID
))
872 int histindex
= record_latest_value (val
);
875 annotate_value_history_begin (histindex
, value_type (val
));
877 annotate_value_begin (value_type (val
));
880 printf_unfiltered ("\031(gdb-makebuffer \"%s\" %d '(\"",
882 else if (histindex
>= 0)
883 printf_filtered ("$%d = ", histindex
);
886 annotate_value_history_value ();
888 print_formatted (val
, format
, fmt
.size
, gdb_stdout
);
889 printf_filtered ("\n");
892 annotate_value_history_end ();
894 annotate_value_end ();
897 printf_unfiltered ("\") )\030");
901 do_cleanups (old_chain
);
902 inspect_it
= 0; /* Reset print routines to normal. */
906 print_command (char *exp
, int from_tty
)
908 print_command_1 (exp
, 0, 1);
911 /* Same as print, except in epoch, it gets its own window. */
913 inspect_command (char *exp
, int from_tty
)
915 extern int epoch_interface
;
917 print_command_1 (exp
, epoch_interface
, 1);
920 /* Same as print, except it doesn't print void results. */
922 call_command (char *exp
, int from_tty
)
924 print_command_1 (exp
, 0, 0);
928 output_command (char *exp
, int from_tty
)
930 struct expression
*expr
;
931 struct cleanup
*old_chain
;
934 struct format_data fmt
;
938 if (exp
&& *exp
== '/')
941 fmt
= decode_format (&exp
, 0, 0);
942 validate_format (fmt
, "output");
946 expr
= parse_expression (exp
);
947 old_chain
= make_cleanup (free_current_contents
, &expr
);
949 val
= evaluate_expression (expr
);
951 annotate_value_begin (value_type (val
));
953 print_formatted (val
, format
, fmt
.size
, gdb_stdout
);
955 annotate_value_end ();
958 gdb_flush (gdb_stdout
);
960 do_cleanups (old_chain
);
964 set_command (char *exp
, int from_tty
)
966 struct expression
*expr
= parse_expression (exp
);
967 struct cleanup
*old_chain
=
968 make_cleanup (free_current_contents
, &expr
);
969 evaluate_expression (expr
);
970 do_cleanups (old_chain
);
974 sym_info (char *arg
, int from_tty
)
976 struct minimal_symbol
*msymbol
;
977 struct objfile
*objfile
;
978 struct obj_section
*osect
;
980 CORE_ADDR addr
, sect_addr
;
985 error_no_arg (_("address"));
987 addr
= parse_and_eval_address (arg
);
988 ALL_OBJSECTIONS (objfile
, osect
)
990 /* Only process each object file once, even if there's a separate
992 if (objfile
->separate_debug_objfile_backlink
)
995 sect
= osect
->the_bfd_section
;
996 sect_addr
= overlay_mapped_address (addr
, sect
);
998 if (osect
->addr
<= sect_addr
&& sect_addr
< osect
->endaddr
&&
999 (msymbol
= lookup_minimal_symbol_by_pc_section (sect_addr
, sect
)))
1002 offset
= sect_addr
- SYMBOL_VALUE_ADDRESS (msymbol
);
1004 printf_filtered ("%s + %u in ",
1005 SYMBOL_PRINT_NAME (msymbol
), offset
);
1007 printf_filtered ("%s in ",
1008 SYMBOL_PRINT_NAME (msymbol
));
1009 if (pc_in_unmapped_range (addr
, sect
))
1010 printf_filtered (_("load address range of "));
1011 if (section_is_overlay (sect
))
1012 printf_filtered (_("%s overlay "),
1013 section_is_mapped (sect
) ? "mapped" : "unmapped");
1014 printf_filtered (_("section %s"), sect
->name
);
1015 printf_filtered ("\n");
1019 printf_filtered (_("No symbol matches %s.\n"), arg
);
1023 address_info (char *exp
, int from_tty
)
1026 struct minimal_symbol
*msymbol
;
1029 CORE_ADDR load_addr
;
1030 int is_a_field_of_this
; /* C++: lookup_symbol sets this to nonzero
1031 if exp is a field of `this'. */
1034 error (_("Argument required."));
1036 sym
= lookup_symbol (exp
, get_selected_block (0), VAR_DOMAIN
,
1037 &is_a_field_of_this
);
1040 if (is_a_field_of_this
)
1042 printf_filtered ("Symbol \"");
1043 fprintf_symbol_filtered (gdb_stdout
, exp
,
1044 current_language
->la_language
, DMGL_ANSI
);
1045 printf_filtered ("\" is a field of the local class variable ");
1046 if (current_language
->la_language
== language_objc
)
1047 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1049 printf_filtered ("`this'\n");
1053 msymbol
= lookup_minimal_symbol (exp
, NULL
, NULL
);
1055 if (msymbol
!= NULL
)
1057 load_addr
= SYMBOL_VALUE_ADDRESS (msymbol
);
1059 printf_filtered ("Symbol \"");
1060 fprintf_symbol_filtered (gdb_stdout
, exp
,
1061 current_language
->la_language
, DMGL_ANSI
);
1062 printf_filtered ("\" is at ");
1063 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1064 printf_filtered (" in a file compiled without debugging");
1065 section
= SYMBOL_BFD_SECTION (msymbol
);
1066 if (section_is_overlay (section
))
1068 load_addr
= overlay_unmapped_address (load_addr
, section
);
1069 printf_filtered (",\n -- loaded at ");
1070 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1071 printf_filtered (" in overlay section %s", section
->name
);
1073 printf_filtered (".\n");
1076 error (_("No symbol \"%s\" in current context."), exp
);
1080 printf_filtered ("Symbol \"");
1081 fprintf_symbol_filtered (gdb_stdout
, DEPRECATED_SYMBOL_NAME (sym
),
1082 current_language
->la_language
, DMGL_ANSI
);
1083 printf_filtered ("\" is ");
1084 val
= SYMBOL_VALUE (sym
);
1085 section
= SYMBOL_BFD_SECTION (sym
);
1087 switch (SYMBOL_CLASS (sym
))
1090 case LOC_CONST_BYTES
:
1091 printf_filtered ("constant");
1095 printf_filtered ("a label at address ");
1096 fputs_filtered (paddress (load_addr
= SYMBOL_VALUE_ADDRESS (sym
)),
1098 if (section_is_overlay (section
))
1100 load_addr
= overlay_unmapped_address (load_addr
, section
);
1101 printf_filtered (",\n -- loaded at ");
1102 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1103 printf_filtered (" in overlay section %s", section
->name
);
1108 /* FIXME: cagney/2004-01-26: It should be possible to
1109 unconditionally call the SYMBOL_OPS method when available.
1110 Unfortunately DWARF 2 stores the frame-base (instead of the
1111 function) location in a function's symbol. Oops! For the
1112 moment enable this when/where applicable. */
1113 SYMBOL_OPS (sym
)->describe_location (sym
, gdb_stdout
);
1117 if (SYMBOL_IS_ARGUMENT (sym
))
1118 printf_filtered (_("an argument in register %s"),
1119 gdbarch_register_name (current_gdbarch
, val
));
1121 printf_filtered (_("a variable in register %s"),
1122 gdbarch_register_name (current_gdbarch
, val
));
1126 printf_filtered (_("static storage at address "));
1127 fputs_filtered (paddress (load_addr
= SYMBOL_VALUE_ADDRESS (sym
)),
1129 if (section_is_overlay (section
))
1131 load_addr
= overlay_unmapped_address (load_addr
, section
);
1132 printf_filtered (_(",\n -- loaded at "));
1133 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1134 printf_filtered (_(" in overlay section %s"), section
->name
);
1138 case LOC_REGPARM_ADDR
:
1139 printf_filtered (_("address of an argument in register %s"),
1140 gdbarch_register_name (current_gdbarch
, val
));
1144 printf_filtered (_("an argument at offset %ld"), val
);
1148 printf_filtered (_("a local variable at frame offset %ld"), val
);
1152 printf_filtered (_("a reference argument at offset %ld"), val
);
1156 printf_filtered (_("a typedef"));
1160 printf_filtered (_("a function at address "));
1161 load_addr
= BLOCK_START (SYMBOL_BLOCK_VALUE (sym
));
1162 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1163 if (section_is_overlay (section
))
1165 load_addr
= overlay_unmapped_address (load_addr
, section
);
1166 printf_filtered (_(",\n -- loaded at "));
1167 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1168 printf_filtered (_(" in overlay section %s"), section
->name
);
1172 case LOC_UNRESOLVED
:
1174 struct minimal_symbol
*msym
;
1176 msym
= lookup_minimal_symbol (DEPRECATED_SYMBOL_NAME (sym
), NULL
, NULL
);
1178 printf_filtered ("unresolved");
1181 section
= SYMBOL_BFD_SECTION (msym
);
1182 printf_filtered (_("static storage at address "));
1183 load_addr
= SYMBOL_VALUE_ADDRESS (msym
);
1184 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1185 if (section_is_overlay (section
))
1187 load_addr
= overlay_unmapped_address (load_addr
, section
);
1188 printf_filtered (_(",\n -- loaded at "));
1189 fputs_filtered (paddress (load_addr
), gdb_stdout
);
1190 printf_filtered (_(" in overlay section %s"), section
->name
);
1196 case LOC_OPTIMIZED_OUT
:
1197 printf_filtered (_("optimized out"));
1201 printf_filtered (_("of unknown (botched) type"));
1204 printf_filtered (".\n");
1209 x_command (char *exp
, int from_tty
)
1211 struct expression
*expr
;
1212 struct format_data fmt
;
1213 struct cleanup
*old_chain
;
1216 fmt
.format
= last_format
;
1217 fmt
.size
= last_size
;
1220 if (exp
&& *exp
== '/')
1223 fmt
= decode_format (&exp
, last_format
, last_size
);
1226 /* If we have an expression, evaluate it and use it as the address. */
1228 if (exp
!= 0 && *exp
!= 0)
1230 expr
= parse_expression (exp
);
1231 /* Cause expression not to be there any more if this command is
1232 repeated with Newline. But don't clobber a user-defined
1233 command's definition. */
1236 old_chain
= make_cleanup (free_current_contents
, &expr
);
1237 val
= evaluate_expression (expr
);
1238 if (TYPE_CODE (value_type (val
)) == TYPE_CODE_REF
)
1239 val
= value_ind (val
);
1240 /* In rvalue contexts, such as this, functions are coerced into
1241 pointers to functions. This makes "x/i main" work. */
1242 if (/* last_format == 'i' && */
1243 TYPE_CODE (value_type (val
)) == TYPE_CODE_FUNC
1244 && VALUE_LVAL (val
) == lval_memory
)
1245 next_address
= VALUE_ADDRESS (val
);
1247 next_address
= value_as_address (val
);
1248 do_cleanups (old_chain
);
1251 do_examine (fmt
, next_address
);
1253 /* If the examine succeeds, we remember its size and format for next
1255 last_size
= fmt
.size
;
1256 last_format
= fmt
.format
;
1258 /* Set a couple of internal variables if appropriate. */
1259 if (last_examine_value
)
1261 /* Make last address examined available to the user as $_. Use
1262 the correct pointer type. */
1263 struct type
*pointer_type
1264 = lookup_pointer_type (value_type (last_examine_value
));
1265 set_internalvar (lookup_internalvar ("_"),
1266 value_from_pointer (pointer_type
,
1267 last_examine_address
));
1269 /* Make contents of last address examined available to the user
1270 as $__. If the last value has not been fetched from memory
1271 then don't fetch it now; instead mark it by voiding the $__
1273 if (value_lazy (last_examine_value
))
1274 set_internalvar (lookup_internalvar ("__"),
1275 allocate_value (builtin_type_void
));
1277 set_internalvar (lookup_internalvar ("__"), last_examine_value
);
1282 /* Add an expression to the auto-display chain.
1283 Specify the expression. */
1286 display_command (char *exp
, int from_tty
)
1288 struct format_data fmt
;
1289 struct expression
*expr
;
1290 struct display
*new;
1294 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1296 if (tui_active
&& exp
!= NULL
&& *exp
== '$')
1297 display_it
= (tui_set_layout_for_display_command (exp
) == TUI_FAILURE
);
1311 fmt
= decode_format (&exp
, 0, 0);
1312 if (fmt
.size
&& fmt
.format
== 0)
1314 if (fmt
.format
== 'i' || fmt
.format
== 's')
1324 innermost_block
= 0;
1325 expr
= parse_expression (exp
);
1327 new = (struct display
*) xmalloc (sizeof (struct display
));
1330 new->block
= innermost_block
;
1331 new->next
= display_chain
;
1332 new->number
= ++display_number
;
1335 display_chain
= new;
1337 if (from_tty
&& target_has_execution
)
1338 do_one_display (new);
1345 free_display (struct display
*d
)
1351 /* Clear out the display_chain. Done when new symtabs are loaded,
1352 since this invalidates the types stored in many expressions. */
1355 clear_displays (void)
1359 while ((d
= display_chain
) != NULL
)
1362 display_chain
= d
->next
;
1367 /* Delete the auto-display number NUM. */
1370 delete_display (int num
)
1372 struct display
*d1
, *d
;
1375 error (_("No display number %d."), num
);
1377 if (display_chain
->number
== num
)
1380 display_chain
= d1
->next
;
1384 for (d
= display_chain
;; d
= d
->next
)
1387 error (_("No display number %d."), num
);
1388 if (d
->next
->number
== num
)
1398 /* Delete some values from the auto-display chain.
1399 Specify the element numbers. */
1402 undisplay_command (char *args
, int from_tty
)
1410 if (query ("Delete all auto-display expressions? "))
1419 while (*p1
>= '0' && *p1
<= '9')
1421 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1422 error (_("Arguments must be display numbers."));
1426 delete_display (num
);
1429 while (*p
== ' ' || *p
== '\t')
1435 /* Display a single auto-display.
1436 Do nothing if the display cannot be printed in the current context,
1437 or if the display is disabled. */
1440 do_one_display (struct display
*d
)
1442 int within_current_scope
;
1444 if (d
->enabled_p
== 0)
1448 within_current_scope
= contained_in (get_selected_block (0), d
->block
);
1450 within_current_scope
= 1;
1451 if (!within_current_scope
)
1454 current_display_number
= d
->number
;
1456 annotate_display_begin ();
1457 printf_filtered ("%d", d
->number
);
1458 annotate_display_number_end ();
1459 printf_filtered (": ");
1465 annotate_display_format ();
1467 printf_filtered ("x/");
1468 if (d
->format
.count
!= 1)
1469 printf_filtered ("%d", d
->format
.count
);
1470 printf_filtered ("%c", d
->format
.format
);
1471 if (d
->format
.format
!= 'i' && d
->format
.format
!= 's')
1472 printf_filtered ("%c", d
->format
.size
);
1473 printf_filtered (" ");
1475 annotate_display_expression ();
1477 print_expression (d
->exp
, gdb_stdout
);
1478 annotate_display_expression_end ();
1480 if (d
->format
.count
!= 1 || d
->format
.format
== 'i')
1481 printf_filtered ("\n");
1483 printf_filtered (" ");
1485 val
= evaluate_expression (d
->exp
);
1486 addr
= value_as_address (val
);
1487 if (d
->format
.format
== 'i')
1488 addr
= gdbarch_addr_bits_remove (current_gdbarch
, addr
);
1490 annotate_display_value ();
1492 do_examine (d
->format
, addr
);
1496 annotate_display_format ();
1498 if (d
->format
.format
)
1499 printf_filtered ("/%c ", d
->format
.format
);
1501 annotate_display_expression ();
1503 print_expression (d
->exp
, gdb_stdout
);
1504 annotate_display_expression_end ();
1506 printf_filtered (" = ");
1508 annotate_display_expression ();
1510 print_formatted (evaluate_expression (d
->exp
),
1511 d
->format
.format
, d
->format
.size
, gdb_stdout
);
1512 printf_filtered ("\n");
1515 annotate_display_end ();
1517 gdb_flush (gdb_stdout
);
1518 current_display_number
= -1;
1521 /* Display all of the values on the auto-display chain which can be
1522 evaluated in the current scope. */
1529 for (d
= display_chain
; d
; d
= d
->next
)
1533 /* Delete the auto-display which we were in the process of displaying.
1534 This is done when there is an error or a signal. */
1537 disable_display (int num
)
1541 for (d
= display_chain
; d
; d
= d
->next
)
1542 if (d
->number
== num
)
1547 printf_unfiltered (_("No display number %d.\n"), num
);
1551 disable_current_display (void)
1553 if (current_display_number
>= 0)
1555 disable_display (current_display_number
);
1556 fprintf_unfiltered (gdb_stderr
, _("\
1557 Disabling display %d to avoid infinite recursion.\n"),
1558 current_display_number
);
1560 current_display_number
= -1;
1564 display_info (char *ignore
, int from_tty
)
1569 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1571 printf_filtered (_("Auto-display expressions now in effect:\n\
1572 Num Enb Expression\n"));
1574 for (d
= display_chain
; d
; d
= d
->next
)
1576 printf_filtered ("%d: %c ", d
->number
, "ny"[(int) d
->enabled_p
]);
1578 printf_filtered ("/%d%c%c ", d
->format
.count
, d
->format
.size
,
1580 else if (d
->format
.format
)
1581 printf_filtered ("/%c ", d
->format
.format
);
1582 print_expression (d
->exp
, gdb_stdout
);
1583 if (d
->block
&& !contained_in (get_selected_block (0), d
->block
))
1584 printf_filtered (_(" (cannot be evaluated in the current context)"));
1585 printf_filtered ("\n");
1586 gdb_flush (gdb_stdout
);
1591 enable_display (char *args
, int from_tty
)
1600 for (d
= display_chain
; d
; d
= d
->next
)
1607 while (*p1
>= '0' && *p1
<= '9')
1609 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1610 error (_("Arguments must be display numbers."));
1614 for (d
= display_chain
; d
; d
= d
->next
)
1615 if (d
->number
== num
)
1620 printf_unfiltered (_("No display number %d.\n"), num
);
1623 while (*p
== ' ' || *p
== '\t')
1629 disable_display_command (char *args
, int from_tty
)
1637 for (d
= display_chain
; d
; d
= d
->next
)
1644 while (*p1
>= '0' && *p1
<= '9')
1646 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1647 error (_("Arguments must be display numbers."));
1649 disable_display (atoi (p
));
1652 while (*p
== ' ' || *p
== '\t')
1658 /* Print the value in stack frame FRAME of a variable specified by a
1662 print_variable_value (struct symbol
*var
, struct frame_info
*frame
,
1663 struct ui_file
*stream
)
1665 struct value
*val
= read_var_value (var
, frame
);
1667 value_print (val
, stream
, 0, Val_pretty_default
);
1671 printf_command (char *arg
, int from_tty
)
1675 char *string
= NULL
;
1676 struct value
**val_args
;
1678 char *current_substring
;
1680 int allocated_args
= 20;
1681 struct cleanup
*old_cleanups
;
1683 val_args
= xmalloc (allocated_args
* sizeof (struct value
*));
1684 old_cleanups
= make_cleanup (free_current_contents
, &val_args
);
1687 error_no_arg (_("format-control string and values to print"));
1689 /* Skip white space before format string */
1690 while (*s
== ' ' || *s
== '\t')
1693 /* A format string should follow, enveloped in double quotes. */
1695 error (_("Bad format string, missing '\"'."));
1697 /* Parse the format-control string and copy it into the string STRING,
1698 processing some kinds of escape sequence. */
1700 f
= string
= (char *) alloca (strlen (s
) + 1);
1708 error (_("Bad format string, non-terminated '\"'."));
1741 /* ??? TODO: handle other escape sequences */
1742 error (_("Unrecognized escape character \\%c in format string."),
1752 /* Skip over " and following space and comma. */
1755 while (*s
== ' ' || *s
== '\t')
1758 if (*s
!= ',' && *s
!= 0)
1759 error (_("Invalid argument syntax"));
1763 while (*s
== ' ' || *s
== '\t')
1766 /* Need extra space for the '\0's. Doubling the size is sufficient. */
1767 substrings
= alloca (strlen (string
) * 2);
1768 current_substring
= substrings
;
1771 /* Now scan the string for %-specs and see what kinds of args they want.
1772 argclass[I] classifies the %-specs so we can give printf_filtered
1773 something of the right size. */
1777 int_arg
, long_arg
, long_long_arg
, ptr_arg
, string_arg
,
1778 double_arg
, long_double_arg
, decfloat_arg
1780 enum argclass
*argclass
;
1781 enum argclass this_argclass
;
1786 argclass
= (enum argclass
*) alloca (strlen (s
) * sizeof *argclass
);
1793 int seen_hash
= 0, seen_zero
= 0, lcount
= 0, seen_prec
= 0;
1794 int seen_space
= 0, seen_plus
= 0;
1795 int seen_big_l
= 0, seen_h
= 0, seen_big_h
= 0;
1796 int seen_big_d
= 0, seen_double_big_d
= 0;
1799 /* Check the validity of the format specifier, and work
1800 out what argument it expects. We only accept C89
1801 format strings, with the exception of long long (which
1802 we autoconf for). */
1804 /* Skip over "%%". */
1811 /* The first part of a format specifier is a set of flag
1813 while (strchr ("0-+ #", *f
))
1826 /* The next part of a format specifier is a width. */
1827 while (strchr ("0123456789", *f
))
1830 /* The next part of a format specifier is a precision. */
1835 while (strchr ("0123456789", *f
))
1839 /* The next part of a format specifier is a length modifier. */
1860 /* Decimal32 modifier. */
1866 /* Decimal64 and Decimal128 modifiers. */
1871 /* Check for a Decimal128. */
1875 seen_double_big_d
= 1;
1891 if (seen_space
|| seen_plus
)
1898 this_argclass
= int_arg
;
1899 else if (lcount
== 1)
1900 this_argclass
= long_arg
;
1902 this_argclass
= long_long_arg
;
1909 this_argclass
= int_arg
;
1910 if (lcount
|| seen_h
|| seen_big_l
)
1912 if (seen_prec
|| seen_zero
|| seen_space
|| seen_plus
)
1917 this_argclass
= ptr_arg
;
1918 if (lcount
|| seen_h
|| seen_big_l
)
1920 if (seen_prec
|| seen_zero
|| seen_space
|| seen_plus
)
1925 this_argclass
= string_arg
;
1926 if (lcount
|| seen_h
|| seen_big_l
)
1928 if (seen_zero
|| seen_space
|| seen_plus
)
1937 if (seen_big_h
|| seen_big_d
|| seen_double_big_d
)
1938 this_argclass
= decfloat_arg
;
1939 else if (seen_big_l
)
1940 this_argclass
= long_double_arg
;
1942 this_argclass
= double_arg
;
1944 if (lcount
|| seen_h
)
1949 error (_("`*' not supported for precision or width in printf"));
1952 error (_("Format specifier `n' not supported in printf"));
1955 error (_("Incomplete format specifier at end of format string"));
1958 error (_("Unrecognized format specifier '%c' in printf"), *f
);
1962 error (_("Inappropriate modifiers to format specifier '%c' in printf"),
1967 if (lcount
> 1 && USE_PRINTF_I64
)
1969 /* Windows' printf does support long long, but not the usual way.
1970 Convert %lld to %I64d. */
1971 int length_before_ll
= f
- last_arg
- 1 - lcount
;
1972 strncpy (current_substring
, last_arg
, length_before_ll
);
1973 strcpy (current_substring
+ length_before_ll
, "I64");
1974 current_substring
[length_before_ll
+ 3] =
1975 last_arg
[length_before_ll
+ lcount
];
1976 current_substring
+= length_before_ll
+ 4;
1980 strncpy (current_substring
, last_arg
, f
- last_arg
);
1981 current_substring
+= f
- last_arg
;
1983 *current_substring
++ = '\0';
1985 argclass
[nargs_wanted
++] = this_argclass
;
1988 /* Now, parse all arguments and evaluate them.
1989 Store the VALUEs in VAL_ARGS. */
1994 if (nargs
== allocated_args
)
1995 val_args
= (struct value
**) xrealloc ((char *) val_args
,
1996 (allocated_args
*= 2)
1997 * sizeof (struct value
*));
1999 val_args
[nargs
] = parse_to_comma_and_eval (&s1
);
2001 /* If format string wants a float, unchecked-convert the value to
2002 floating point of the same size */
2004 if (argclass
[nargs
] == double_arg
)
2006 struct type
*type
= value_type (val_args
[nargs
]);
2007 if (TYPE_LENGTH (type
) == sizeof (float))
2008 deprecated_set_value_type (val_args
[nargs
], builtin_type_float
);
2009 if (TYPE_LENGTH (type
) == sizeof (double))
2010 deprecated_set_value_type (val_args
[nargs
], builtin_type_double
);
2018 if (nargs
!= nargs_wanted
)
2019 error (_("Wrong number of arguments for specified format-string"));
2021 /* Now actually print them. */
2022 current_substring
= substrings
;
2023 for (i
= 0; i
< nargs
; i
++)
2025 switch (argclass
[i
])
2032 tem
= value_as_address (val_args
[i
]);
2034 /* This is a %s argument. Find the length of the string. */
2039 read_memory (tem
+ j
, &c
, 1);
2044 /* Copy the string contents into a string inside GDB. */
2045 str
= (gdb_byte
*) alloca (j
+ 1);
2047 read_memory (tem
, str
, j
);
2050 printf_filtered (current_substring
, (char *) str
);
2055 double val
= value_as_double (val_args
[i
]);
2056 printf_filtered (current_substring
, val
);
2059 case long_double_arg
:
2060 #ifdef HAVE_LONG_DOUBLE
2062 long double val
= value_as_double (val_args
[i
]);
2063 printf_filtered (current_substring
, val
);
2067 error (_("long double not supported in printf"));
2070 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2072 long long val
= value_as_long (val_args
[i
]);
2073 printf_filtered (current_substring
, val
);
2077 error (_("long long not supported in printf"));
2081 int val
= value_as_long (val_args
[i
]);
2082 printf_filtered (current_substring
, val
);
2087 long val
= value_as_long (val_args
[i
]);
2088 printf_filtered (current_substring
, val
);
2092 /* Handles decimal floating values. */
2095 const gdb_byte
*param_ptr
= value_contents (val_args
[i
]);
2096 #if defined (PRINTF_HAS_DECFLOAT)
2097 /* If we have native support for Decimal floating
2098 printing, handle it here. */
2099 printf_filtered (current_substring
, param_ptr
);
2102 /* As a workaround until vasprintf has native support for DFP
2103 we convert the DFP values to string and print them using
2104 the %s format specifier. */
2107 int nnull_chars
= 0;
2109 /* Parameter data. */
2110 struct type
*param_type
= value_type (val_args
[i
]);
2111 unsigned int param_len
= TYPE_LENGTH (param_type
);
2113 /* DFP output data. */
2114 struct value
*dfp_value
= NULL
;
2118 struct type
*dfp_type
= NULL
;
2119 char decstr
[MAX_DECIMAL_STRING
];
2121 /* Points to the end of the string so that we can go back
2122 and check for DFP length modifiers. */
2123 eos
= current_substring
+ strlen (current_substring
);
2125 /* Look for the float/double format specifier. */
2126 while (*eos
!= 'f' && *eos
!= 'e' && *eos
!= 'E'
2127 && *eos
!= 'g' && *eos
!= 'G')
2132 /* Search for the '%' char and extract the size and type of
2133 the output decimal value based on its modifiers
2134 (%Hf, %Df, %DDf). */
2135 while (*--sos
!= '%')
2140 dfp_type
= builtin_type (current_gdbarch
)->builtin_decfloat
;
2142 else if (*sos
== 'D' && *(sos
- 1) == 'D')
2145 dfp_type
= builtin_type (current_gdbarch
)->builtin_declong
;
2151 dfp_type
= builtin_type (current_gdbarch
)->builtin_decdouble
;
2155 /* Replace %Hf, %Df and %DDf with %s's. */
2158 /* Go through the whole format string and pull the correct
2159 number of chars back to compensate for the change in the
2160 format specifier. */
2161 while (nnull_chars
< nargs
- i
)
2169 /* Conversion between different DFP types. */
2170 if (TYPE_CODE (param_type
) == TYPE_CODE_DECFLOAT
)
2171 decimal_convert (param_ptr
, param_len
, dec
, dfp_len
);
2173 /* If this is a non-trivial conversion, just output 0.
2174 A correct converted value can be displayed by explicitly
2175 casting to a DFP type. */
2176 decimal_from_string (dec
, dfp_len
, "0");
2178 dfp_value
= value_from_decfloat (dfp_type
, dec
);
2180 dfp_ptr
= (gdb_byte
*) value_contents (dfp_value
);
2182 decimal_to_string (dfp_ptr
, dfp_len
, decstr
);
2184 /* Print the DFP value. */
2185 printf_filtered (current_substring
, decstr
);
2193 /* We avoid the host's %p because pointers are too
2194 likely to be the wrong size. The only interesting
2195 modifier for %p is a width; extract that, and then
2196 handle %p as glibc would: %#x or a literal "(nil)". */
2198 char *p
, *fmt
, *fmt_p
;
2199 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2200 long long val
= value_as_long (val_args
[i
]);
2202 long val
= value_as_long (val_args
[i
]);
2205 fmt
= alloca (strlen (current_substring
) + 5);
2207 /* Copy up to the leading %. */
2208 p
= current_substring
;
2212 int is_percent
= (*p
== '%');
2226 /* Copy any width. */
2227 while (*p
>= '0' && *p
< '9')
2230 gdb_assert (*p
== 'p' && *(p
+ 1) == '\0');
2233 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2239 printf_filtered (fmt
, val
);
2245 printf_filtered (fmt
, "(nil)");
2251 internal_error (__FILE__
, __LINE__
,
2252 _("failed internal consistency check"));
2254 /* Skip to the next substring. */
2255 current_substring
+= strlen (current_substring
) + 1;
2257 /* Print the portion of the format string after the last argument. */
2258 puts_filtered (last_arg
);
2260 do_cleanups (old_cleanups
);
2264 _initialize_printcmd (void)
2266 struct cmd_list_element
*c
;
2268 current_display_number
= -1;
2270 add_info ("address", address_info
,
2271 _("Describe where symbol SYM is stored."));
2273 add_info ("symbol", sym_info
, _("\
2274 Describe what symbol is at location ADDR.\n\
2275 Only for symbols with fixed locations (global or static scope)."));
2277 add_com ("x", class_vars
, x_command
, _("\
2278 Examine memory: x/FMT ADDRESS.\n\
2279 ADDRESS is an expression for the memory address to examine.\n\
2280 FMT is a repeat count followed by a format letter and a size letter.\n\
2281 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2282 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
2283 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2284 The specified number of objects of the specified size are printed\n\
2285 according to the format.\n\n\
2286 Defaults for format and size letters are those previously used.\n\
2287 Default count is 1. Default address is following last thing printed\n\
2288 with this command or \"print\"."));
2291 add_com ("whereis", class_vars
, whereis_command
,
2292 _("Print line number and file of definition of variable."));
2295 add_info ("display", display_info
, _("\
2296 Expressions to display when program stops, with code numbers."));
2298 add_cmd ("undisplay", class_vars
, undisplay_command
, _("\
2299 Cancel some expressions to be displayed when program stops.\n\
2300 Arguments are the code numbers of the expressions to stop displaying.\n\
2301 No argument means cancel all automatic-display expressions.\n\
2302 \"delete display\" has the same effect as this command.\n\
2303 Do \"info display\" to see current list of code numbers."),
2306 add_com ("display", class_vars
, display_command
, _("\
2307 Print value of expression EXP each time the program stops.\n\
2308 /FMT may be used before EXP as in the \"print\" command.\n\
2309 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2310 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2311 and examining is done as in the \"x\" command.\n\n\
2312 With no argument, display all currently requested auto-display expressions.\n\
2313 Use \"undisplay\" to cancel display requests previously made."));
2315 add_cmd ("display", class_vars
, enable_display
, _("\
2316 Enable some expressions to be displayed when program stops.\n\
2317 Arguments are the code numbers of the expressions to resume displaying.\n\
2318 No argument means enable all automatic-display expressions.\n\
2319 Do \"info display\" to see current list of code numbers."), &enablelist
);
2321 add_cmd ("display", class_vars
, disable_display_command
, _("\
2322 Disable some expressions to be displayed when program stops.\n\
2323 Arguments are the code numbers of the expressions to stop displaying.\n\
2324 No argument means disable all automatic-display expressions.\n\
2325 Do \"info display\" to see current list of code numbers."), &disablelist
);
2327 add_cmd ("display", class_vars
, undisplay_command
, _("\
2328 Cancel some expressions to be displayed when program stops.\n\
2329 Arguments are the code numbers of the expressions to stop displaying.\n\
2330 No argument means cancel all automatic-display expressions.\n\
2331 Do \"info display\" to see current list of code numbers."), &deletelist
);
2333 add_com ("printf", class_vars
, printf_command
, _("\
2334 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2335 This is useful for formatted output in user-defined commands."));
2337 add_com ("output", class_vars
, output_command
, _("\
2338 Like \"print\" but don't put in value history and don't print newline.\n\
2339 This is useful in user-defined commands."));
2341 add_prefix_cmd ("set", class_vars
, set_command
, _("\
2342 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2343 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2344 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2345 with $), a register (a few standard names starting with $), or an actual\n\
2346 variable in the program being debugged. EXP is any valid expression.\n\
2347 Use \"set variable\" for variables with names identical to set subcommands.\n\
2349 With a subcommand, this command modifies parts of the gdb environment.\n\
2350 You can see these environment settings with the \"show\" command."),
2351 &setlist
, "set ", 1, &cmdlist
);
2353 add_com ("assign", class_vars
, set_command
, _("\
2354 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2355 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2356 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2357 with $), a register (a few standard names starting with $), or an actual\n\
2358 variable in the program being debugged. EXP is any valid expression.\n\
2359 Use \"set variable\" for variables with names identical to set subcommands.\n\
2360 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2361 You can see these environment settings with the \"show\" command."));
2363 /* "call" is the same as "set", but handy for dbx users to call fns. */
2364 c
= add_com ("call", class_vars
, call_command
, _("\
2365 Call a function in the program.\n\
2366 The argument is the function name and arguments, in the notation of the\n\
2367 current working language. The result is printed and saved in the value\n\
2368 history, if it is not void."));
2369 set_cmd_completer (c
, expression_completer
);
2371 add_cmd ("variable", class_vars
, set_command
, _("\
2372 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2373 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2374 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2375 with $), a register (a few standard names starting with $), or an actual\n\
2376 variable in the program being debugged. EXP is any valid expression.\n\
2377 This may usually be abbreviated to simply \"set\"."),
2380 c
= add_com ("print", class_vars
, print_command
, _("\
2381 Print value of expression EXP.\n\
2382 Variables accessible are those of the lexical environment of the selected\n\
2383 stack frame, plus all those whose scope is global or an entire file.\n\
2385 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2386 $$NUM refers to NUM'th value back from the last one.\n\
2387 Names starting with $ refer to registers (with the values they would have\n\
2388 if the program were to return to the stack frame now selected, restoring\n\
2389 all registers saved by frames farther in) or else to debugger\n\
2390 \"convenience\" variables (any such name not a known register).\n\
2391 Use assignment expressions to give values to convenience variables.\n\
2393 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2394 @ is a binary operator for treating consecutive data objects\n\
2395 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2396 element is FOO, whose second element is stored in the space following\n\
2397 where FOO is stored, etc. FOO must be an expression whose value\n\
2398 resides in memory.\n\
2400 EXP may be preceded with /FMT, where FMT is a format letter\n\
2401 but no count or size letter (see \"x\" command)."));
2402 set_cmd_completer (c
, expression_completer
);
2403 add_com_alias ("p", "print", class_vars
, 1);
2405 c
= add_com ("inspect", class_vars
, inspect_command
, _("\
2406 Same as \"print\" command, except that if you are running in the epoch\n\
2407 environment, the value is printed in its own window."));
2408 set_cmd_completer (c
, expression_completer
);
2410 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class
,
2411 &max_symbolic_offset
, _("\
2412 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2413 Show the largest offset that will be printed in <symbol+1234> form."), NULL
,
2415 show_max_symbolic_offset
,
2416 &setprintlist
, &showprintlist
);
2417 add_setshow_boolean_cmd ("symbol-filename", no_class
,
2418 &print_symbol_filename
, _("\
2419 Set printing of source filename and line number with <symbol>."), _("\
2420 Show printing of source filename and line number with <symbol>."), NULL
,
2422 show_print_symbol_filename
,
2423 &setprintlist
, &showprintlist
);
2425 /* For examine/instruction a single byte quantity is specified as
2426 the data. This avoids problems with value_at_lazy() requiring a
2427 valid data type (and rejecting VOID). */
2428 examine_i_type
= init_type (TYPE_CODE_INT
, 1, 0, "examine_i_type", NULL
);
2430 examine_b_type
= init_type (TYPE_CODE_INT
, 1, 0, "examine_b_type", NULL
);
2431 examine_h_type
= init_type (TYPE_CODE_INT
, 2, 0, "examine_h_type", NULL
);
2432 examine_w_type
= init_type (TYPE_CODE_INT
, 4, 0, "examine_w_type", NULL
);
2433 examine_g_type
= init_type (TYPE_CODE_INT
, 8, 0, "examine_g_type", NULL
);