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);
326 /* If we get here with a string format, try again without it. Go
327 all the way back to the language printers, which may call us
331 val_print (type, valaddr, 0, 0, stream, 0, 0, 0, Val_pretty_default,
336 if (len > sizeof(LONGEST) &&
337 (TYPE_CODE (type) == TYPE_CODE_INT
338 || TYPE_CODE (type) == TYPE_CODE_ENUM))
343 print_octal_chars (stream, valaddr, len);
347 print_decimal_chars (stream, valaddr, len);
350 print_binary_chars (stream, valaddr, len);
353 print_hex_chars (stream, valaddr, len);
356 print_char_chars (stream, valaddr, len);
364 val_long = unpack_long (type, valaddr);
366 /* If the value is a pointer, and pointers and addresses are not the
367 same, then at this point, the value's length (in target bytes) is
368 gdbarch_addr_bit/TARGET_CHAR_BIT, not TYPE_LENGTH (type). */
369 if (TYPE_CODE (type) == TYPE_CODE_PTR)
370 len = gdbarch_addr_bit (current_gdbarch) / TARGET_CHAR_BIT;
372 /* If we are printing it as unsigned, truncate it in case it is actually
373 a negative signed value (e.g. "print/u (short)-1" should print 65535
374 (if shorts are 16 bits) instead of 4294967295). */
377 if (len < sizeof (LONGEST))
378 val_long &= ((LONGEST) 1 << HOST_CHAR_BIT * len) - 1;
386 /* No size specified, like in print. Print varying # of digits. */
387 print_longest (stream, 'x', 1, val_long);
396 print_longest (stream, size, 1, val_long);
399 error (_("Undefined output size \"%c\"."), size);
404 print_longest (stream, 'd', 1, val_long);
408 print_longest (stream, 'u', 0, val_long);
413 print_longest (stream, 'o', 1, val_long);
415 fprintf_filtered (stream, "0");
420 CORE_ADDR addr = unpack_pointer (type, valaddr);
421 print_address (addr, stream);
426 if (TYPE_UNSIGNED (type))
430 utype = builtin_type (current_gdbarch)->builtin_true_unsigned_char;
431 value_print (value_from_longest (utype, val_long),
432 stream, 0, Val_pretty_default);
435 value_print (value_from_longest (builtin_type_true_char, val_long),
436 stream, 0, Val_pretty_default);
440 if (len == TYPE_LENGTH (builtin_type_float))
441 type = builtin_type_float;
442 else if (len == TYPE_LENGTH (builtin_type_double))
443 type = builtin_type_double;
444 else if (len == TYPE_LENGTH (builtin_type_long_double))
445 type = builtin_type_long_double;
446 print_floating (valaddr, type, stream);
450 internal_error (__FILE__, __LINE__,
451 _("failed internal consistency check"));
454 /* Binary; 't' stands for "two". */
456 char bits[8 * (sizeof val_long) + 1];
457 char buf[8 * (sizeof val_long) + 32];
462 width = 8 * (sizeof val_long);
479 error (_("Undefined output size \"%c\"."), size);
485 bits[width] = (val_long & 1) ? '1' : '0';
490 while (*cp && *cp == '0')
496 fputs_filtered (buf, stream);
501 error (_("Undefined output format \"%c\"."), format);
505 /* Specify default address for `x' command.
506 The `info lines' command uses this. */
509 set_next_address (CORE_ADDR addr)
513 /* Make address available to the user as $_. */
514 set_internalvar (lookup_internalvar ("_"),
515 value_from_pointer (lookup_pointer_type (builtin_type_void),
519 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
520 after LEADIN. Print nothing if no symbolic name is found nearby.
521 Optionally also print source file and line number, if available.
522 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
523 or to interpret it as a possible C++ name and convert it back to source
524 form. However note that DO_DEMANGLE can be overridden by the specific
525 settings of the demangle and asm_demangle variables. */
528 print_address_symbolic (CORE_ADDR addr, struct ui_file *stream,
529 int do_demangle, char *leadin)
532 char *filename = NULL;
537 /* Throw away both name and filename. */
538 struct cleanup *cleanup_chain = make_cleanup (free_current_contents, &name);
539 make_cleanup (free_current_contents, &filename);
541 if (build_address_symbolic (addr, do_demangle, &name, &offset,
542 &filename, &line, &unmapped))
544 do_cleanups (cleanup_chain);
548 fputs_filtered (leadin, stream);
550 fputs_filtered ("<*", stream);
552 fputs_filtered ("<", stream);
553 fputs_filtered (name, stream);
555 fprintf_filtered (stream, "+%u", (unsigned int) offset);
557 /* Append source filename and line number if desired. Give specific
558 line # of this addr, if we have it; else line # of the nearest symbol. */
559 if (print_symbol_filename && filename != NULL)
562 fprintf_filtered (stream, " at %s:%d", filename, line);
564 fprintf_filtered (stream, " in %s", filename);
567 fputs_filtered ("*>", stream);
569 fputs_filtered (">", stream);
571 do_cleanups (cleanup_chain);
574 /* Given an address ADDR return all the elements needed to print the
575 address in a symbolic form. NAME can be mangled or not depending
576 on DO_DEMANGLE (and also on the asm_demangle global variable,
577 manipulated via ''set print asm-demangle''). Return 0 in case of
578 success, when all the info in the OUT paramters is valid. Return 1
581 build_address_symbolic (CORE_ADDR addr, /* IN */
582 int do_demangle, /* IN */
583 char **name, /* OUT */
584 int *offset, /* OUT */
585 char **filename, /* OUT */
587 int *unmapped) /* OUT */
589 struct minimal_symbol *msymbol;
590 struct symbol *symbol;
591 CORE_ADDR name_location = 0;
592 asection *section = 0;
593 char *name_temp = "";
595 /* Let's say it is unmapped. */
598 /* Determine if the address is in an overlay, and whether it is
600 if (overlay_debugging)
602 section = find_pc_overlay (addr);
603 if (pc_in_unmapped_range (addr, section))
606 addr = overlay_mapped_address (addr, section);
610 /* First try to find the address in the symbol table, then
611 in the minsyms. Take the closest one. */
613 /* This is defective in the sense that it only finds text symbols. So
614 really this is kind of pointless--we should make sure that the
615 minimal symbols have everything we need (by changing that we could
616 save some memory, but for many debug format--ELF/DWARF or
617 anything/stabs--it would be inconvenient to eliminate those minimal
619 msymbol = lookup_minimal_symbol_by_pc_section (addr, section);
620 symbol = find_pc_sect_function (addr, section);
624 name_location = BLOCK_START (SYMBOL_BLOCK_VALUE (symbol));
625 if (do_demangle || asm_demangle)
626 name_temp = SYMBOL_PRINT_NAME (symbol);
628 name_temp = DEPRECATED_SYMBOL_NAME (symbol);
633 if (SYMBOL_VALUE_ADDRESS (msymbol) > name_location || symbol == NULL)
635 /* The msymbol is closer to the address than the symbol;
636 use the msymbol instead. */
638 name_location = SYMBOL_VALUE_ADDRESS (msymbol);
639 if (do_demangle || asm_demangle)
640 name_temp = SYMBOL_PRINT_NAME (msymbol);
642 name_temp = DEPRECATED_SYMBOL_NAME (msymbol);
645 if (symbol == NULL && msymbol == NULL)
648 /* If the nearest symbol is too far away, don't print anything symbolic. */
650 /* For when CORE_ADDR is larger than unsigned int, we do math in
651 CORE_ADDR. But when we detect unsigned wraparound in the
652 CORE_ADDR math, we ignore this test and print the offset,
653 because addr+max_symbolic_offset has wrapped through the end
654 of the address space back to the beginning, giving bogus comparison. */
655 if (addr > name_location + max_symbolic_offset
656 && name_location + max_symbolic_offset > name_location)
659 *offset = addr - name_location;
661 *name = xstrdup (name_temp);
663 if (print_symbol_filename)
665 struct symtab_and_line sal;
667 sal = find_pc_sect_line (addr, section, 0);
671 *filename = xstrdup (sal.symtab->filename);
678 /* Print address ADDR on STREAM. USE_LOCAL means the same thing as for
681 deprecated_print_address_numeric (CORE_ADDR addr, int use_local,
682 struct ui_file *stream)
685 fputs_filtered (paddress (addr), stream);
688 int addr_bit = gdbarch_addr_bit (current_gdbarch);
690 if (addr_bit < (sizeof (CORE_ADDR) * HOST_CHAR_BIT))
691 addr &= ((CORE_ADDR) 1 << addr_bit) - 1;
692 print_longest (stream, 'x', 0, (ULONGEST) addr);
696 /* Print address ADDR symbolically on STREAM.
697 First print it as a number. Then perhaps print
698 <SYMBOL + OFFSET> after the number. */
701 print_address (CORE_ADDR addr, struct ui_file *stream)
703 fputs_filtered (paddress (addr), stream);
704 print_address_symbolic (addr, stream, asm_demangle, " ");
707 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
708 controls whether to print the symbolic name "raw" or demangled.
709 Global setting "addressprint" controls whether to print hex address
713 print_address_demangle (CORE_ADDR addr, struct ui_file *stream,
718 fprintf_filtered (stream, "0");
720 else if (addressprint)
722 fputs_filtered (paddress (addr), stream);
723 print_address_symbolic (addr, stream, do_demangle, " ");
727 print_address_symbolic (addr, stream, do_demangle, "");
732 /* These are the types that $__ will get after an examine command of one
735 static struct type *examine_i_type;
737 static struct type *examine_b_type;
738 static struct type *examine_h_type;
739 static struct type *examine_w_type;
740 static struct type *examine_g_type;
742 /* Examine data at address ADDR in format FMT.
743 Fetch it from memory and print on gdb_stdout. */
746 do_examine (struct format_data fmt, CORE_ADDR addr)
751 struct type *val_type = NULL;
760 /* String or instruction format implies fetch single bytes
761 regardless of the specified size. */
762 if (format == 's' || format == 'i')
766 val_type = examine_i_type;
767 else if (size == 'b')
768 val_type = examine_b_type;
769 else if (size == 'h')
770 val_type = examine_h_type;
771 else if (size == 'w')
772 val_type = examine_w_type;
773 else if (size == 'g')
774 val_type = examine_g_type;
781 if (format == 's' || format == 'i')
784 /* Print as many objects as specified in COUNT, at most maxelts per line,
785 with the address of the next one at the start of each line. */
790 print_address (next_address, gdb_stdout);
791 printf_filtered (":");
796 printf_filtered ("\t");
797 /* Note that print_formatted sets next_address for the next
799 last_examine_address = next_address;
801 if (last_examine_value)
802 value_free (last_examine_value);
804 /* The value to be displayed is not fetched greedily.
805 Instead, to avoid the possibility of a fetched value not
806 being used, its retrieval is delayed until the print code
807 uses it. When examining an instruction stream, the
808 disassembler will perform its own memory fetch using just
809 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
810 the disassembler be modified so that LAST_EXAMINE_VALUE
811 is left with the byte sequence from the last complete
812 instruction fetched from memory? */
813 last_examine_value = value_at_lazy (val_type, next_address);
815 if (last_examine_value)
816 release_value (last_examine_value);
818 print_formatted (last_examine_value, format, size, gdb_stdout);
820 /* Display any branch delay slots following the final insn. */
821 if (format == 'i' && count == 1)
822 count += branch_delay_insns;
824 printf_filtered ("\n");
825 gdb_flush (gdb_stdout);
830 validate_format (struct format_data fmt, char *cmdname)
833 error (_("Size letters are meaningless in \"%s\" command."), cmdname);
835 error (_("Item count other than 1 is meaningless in \"%s\" command."),
837 if (fmt.format == 'i')
838 error (_("Format letter \"%c\" is meaningless in \"%s\" command."),
839 fmt.format, cmdname);
842 /* Evaluate string EXP as an expression in the current language and
843 print the resulting value. EXP may contain a format specifier as the
844 first argument ("/x myvar" for example, to print myvar in hex). */
847 print_command_1 (char *exp, int inspect, int voidprint)
849 struct expression *expr;
850 struct cleanup *old_chain = 0;
853 struct format_data fmt;
856 /* Pass inspect flag to the rest of the print routines in a global
858 inspect_it = inspect;
860 if (exp && *exp == '/')
863 fmt = decode_format (&exp, last_format, 0);
864 validate_format (fmt, "print");
865 last_format = format = fmt.format;
877 expr = parse_expression (exp);
878 old_chain = make_cleanup (free_current_contents, &expr);
880 val = evaluate_expression (expr);
883 val = access_value_history (0);
885 if (voidprint || (val && value_type (val) &&
886 TYPE_CODE (value_type (val)) != TYPE_CODE_VOID))
888 int histindex = record_latest_value (val);
891 annotate_value_history_begin (histindex, value_type (val));
893 annotate_value_begin (value_type (val));
896 printf_unfiltered ("\031(gdb-makebuffer \"%s\" %d '(\"",
898 else if (histindex >= 0)
899 printf_filtered ("$%d = ", histindex);
902 annotate_value_history_value ();
904 print_formatted (val, format, fmt.size, gdb_stdout);
905 printf_filtered ("\n");
908 annotate_value_history_end ();
910 annotate_value_end ();
913 printf_unfiltered ("\") )\030");
917 do_cleanups (old_chain);
918 inspect_it = 0; /* Reset print routines to normal. */
922 print_command (char *exp, int from_tty)
924 print_command_1 (exp, 0, 1);
927 /* Same as print, except in epoch, it gets its own window. */
929 inspect_command (char *exp, int from_tty)
931 extern int epoch_interface;
933 print_command_1 (exp, epoch_interface, 1);
936 /* Same as print, except it doesn't print void results. */
938 call_command (char *exp, int from_tty)
940 print_command_1 (exp, 0, 0);
944 output_command (char *exp, int from_tty)
946 struct expression *expr;
947 struct cleanup *old_chain;
950 struct format_data fmt;
954 if (exp && *exp == '/')
957 fmt = decode_format (&exp, 0, 0);
958 validate_format (fmt, "output");
962 expr = parse_expression (exp);
963 old_chain = make_cleanup (free_current_contents, &expr);
965 val = evaluate_expression (expr);
967 annotate_value_begin (value_type (val));
969 print_formatted (val, format, fmt.size, gdb_stdout);
971 annotate_value_end ();
974 gdb_flush (gdb_stdout);
976 do_cleanups (old_chain);
980 set_command (char *exp, int from_tty)
982 struct expression *expr = parse_expression (exp);
983 struct cleanup *old_chain =
984 make_cleanup (free_current_contents, &expr);
985 evaluate_expression (expr);
986 do_cleanups (old_chain);
990 sym_info (char *arg, int from_tty)
992 struct minimal_symbol *msymbol;
993 struct objfile *objfile;
994 struct obj_section *osect;
996 CORE_ADDR addr, sect_addr;
1001 error_no_arg (_("address"));
1003 addr = parse_and_eval_address (arg);
1004 ALL_OBJSECTIONS (objfile, osect)
1006 /* Only process each object file once, even if there's a separate
1008 if (objfile->separate_debug_objfile_backlink)
1011 sect = osect->the_bfd_section;
1012 sect_addr = overlay_mapped_address (addr, sect);
1014 if (osect->addr <= sect_addr && sect_addr < osect->endaddr &&
1015 (msymbol = lookup_minimal_symbol_by_pc_section (sect_addr, sect)))
1018 offset = sect_addr - SYMBOL_VALUE_ADDRESS (msymbol);
1020 printf_filtered ("%s + %u in ",
1021 SYMBOL_PRINT_NAME (msymbol), offset);
1023 printf_filtered ("%s in ",
1024 SYMBOL_PRINT_NAME (msymbol));
1025 if (pc_in_unmapped_range (addr, sect))
1026 printf_filtered (_("load address range of "));
1027 if (section_is_overlay (sect))
1028 printf_filtered (_("%s overlay "),
1029 section_is_mapped (sect) ? "mapped" : "unmapped");
1030 printf_filtered (_("section %s"), sect->name);
1031 printf_filtered ("\n");
1035 printf_filtered (_("No symbol matches %s.\n"), arg);
1039 address_info (char *exp, int from_tty)
1042 struct minimal_symbol *msymbol;
1046 CORE_ADDR load_addr;
1047 int is_a_field_of_this; /* C++: lookup_symbol sets this to nonzero
1048 if exp is a field of `this'. */
1051 error (_("Argument required."));
1053 sym = lookup_symbol (exp, get_selected_block (0), VAR_DOMAIN,
1054 &is_a_field_of_this, (struct symtab **) NULL);
1057 if (is_a_field_of_this)
1059 printf_filtered ("Symbol \"");
1060 fprintf_symbol_filtered (gdb_stdout, exp,
1061 current_language->la_language, DMGL_ANSI);
1062 printf_filtered ("\" is a field of the local class variable ");
1063 if (current_language->la_language == language_objc)
1064 printf_filtered ("`self'\n"); /* ObjC equivalent of "this" */
1066 printf_filtered ("`this'\n");
1070 msymbol = lookup_minimal_symbol (exp, NULL, NULL);
1072 if (msymbol != NULL)
1074 load_addr = SYMBOL_VALUE_ADDRESS (msymbol);
1076 printf_filtered ("Symbol \"");
1077 fprintf_symbol_filtered (gdb_stdout, exp,
1078 current_language->la_language, DMGL_ANSI);
1079 printf_filtered ("\" is at ");
1080 fputs_filtered (paddress (load_addr), gdb_stdout);
1081 printf_filtered (" in a file compiled without debugging");
1082 section = SYMBOL_BFD_SECTION (msymbol);
1083 if (section_is_overlay (section))
1085 load_addr = overlay_unmapped_address (load_addr, section);
1086 printf_filtered (",\n -- loaded at ");
1087 fputs_filtered (paddress (load_addr), gdb_stdout);
1088 printf_filtered (" in overlay section %s", section->name);
1090 printf_filtered (".\n");
1093 error (_("No symbol \"%s\" in current context."), exp);
1097 printf_filtered ("Symbol \"");
1098 fprintf_symbol_filtered (gdb_stdout, DEPRECATED_SYMBOL_NAME (sym),
1099 current_language->la_language, DMGL_ANSI);
1100 printf_filtered ("\" is ");
1101 val = SYMBOL_VALUE (sym);
1102 basereg = SYMBOL_BASEREG (sym);
1103 section = SYMBOL_BFD_SECTION (sym);
1105 switch (SYMBOL_CLASS (sym))
1108 case LOC_CONST_BYTES:
1109 printf_filtered ("constant");
1113 printf_filtered ("a label at address ");
1114 fputs_filtered (paddress (load_addr = SYMBOL_VALUE_ADDRESS (sym)),
1116 if (section_is_overlay (section))
1118 load_addr = overlay_unmapped_address (load_addr, section);
1119 printf_filtered (",\n -- loaded at ");
1120 fputs_filtered (paddress (load_addr), gdb_stdout);
1121 printf_filtered (" in overlay section %s", section->name);
1126 case LOC_COMPUTED_ARG:
1127 /* FIXME: cagney/2004-01-26: It should be possible to
1128 unconditionally call the SYMBOL_OPS method when available.
1129 Unfortunately DWARF 2 stores the frame-base (instead of the
1130 function) location in a function's symbol. Oops! For the
1131 moment enable this when/where applicable. */
1132 SYMBOL_OPS (sym)->describe_location (sym, gdb_stdout);
1136 printf_filtered (_("a variable in register %s"),
1137 gdbarch_register_name (current_gdbarch, val));
1141 printf_filtered (_("static storage at address "));
1142 fputs_filtered (paddress (load_addr = SYMBOL_VALUE_ADDRESS (sym)),
1144 if (section_is_overlay (section))
1146 load_addr = overlay_unmapped_address (load_addr, section);
1147 printf_filtered (_(",\n -- loaded at "));
1148 fputs_filtered (paddress (load_addr), gdb_stdout);
1149 printf_filtered (_(" in overlay section %s"), section->name);
1154 printf_filtered (_("external global (indirect addressing), at address *("));
1155 fputs_filtered (paddress (load_addr = SYMBOL_VALUE_ADDRESS (sym)),
1157 printf_filtered (")");
1158 if (section_is_overlay (section))
1160 load_addr = overlay_unmapped_address (load_addr, section);
1161 printf_filtered (_(",\n -- loaded at "));
1162 fputs_filtered (paddress (load_addr), gdb_stdout);
1163 printf_filtered (_(" in overlay section %s"), section->name);
1168 printf_filtered (_("an argument in register %s"),
1169 gdbarch_register_name (current_gdbarch, val));
1172 case LOC_REGPARM_ADDR:
1173 printf_filtered (_("address of an argument in register %s"),
1174 gdbarch_register_name (current_gdbarch, val));
1178 printf_filtered (_("an argument at offset %ld"), val);
1182 printf_filtered (_("an argument at frame offset %ld"), val);
1186 printf_filtered (_("a local variable at frame offset %ld"), val);
1190 printf_filtered (_("a reference argument at offset %ld"), val);
1194 printf_filtered (_("a variable at offset %ld from register %s"),
1195 val, gdbarch_register_name (current_gdbarch, basereg));
1198 case LOC_BASEREG_ARG:
1199 printf_filtered (_("an argument at offset %ld from register %s"),
1200 val, gdbarch_register_name (current_gdbarch, basereg));
1204 printf_filtered (_("a typedef"));
1208 printf_filtered (_("a function at address "));
1209 load_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1210 fputs_filtered (paddress (load_addr), gdb_stdout);
1211 if (section_is_overlay (section))
1213 load_addr = overlay_unmapped_address (load_addr, section);
1214 printf_filtered (_(",\n -- loaded at "));
1215 fputs_filtered (paddress (load_addr), gdb_stdout);
1216 printf_filtered (_(" in overlay section %s"), section->name);
1220 case LOC_UNRESOLVED:
1222 struct minimal_symbol *msym;
1224 msym = lookup_minimal_symbol (DEPRECATED_SYMBOL_NAME (sym), NULL, NULL);
1226 printf_filtered ("unresolved");
1229 section = SYMBOL_BFD_SECTION (msym);
1230 printf_filtered (_("static storage at address "));
1231 load_addr = SYMBOL_VALUE_ADDRESS (msym);
1232 fputs_filtered (paddress (load_addr), gdb_stdout);
1233 if (section_is_overlay (section))
1235 load_addr = overlay_unmapped_address (load_addr, section);
1236 printf_filtered (_(",\n -- loaded at "));
1237 fputs_filtered (paddress (load_addr), gdb_stdout);
1238 printf_filtered (_(" in overlay section %s"), section->name);
1244 case LOC_HP_THREAD_LOCAL_STATIC:
1245 printf_filtered (_("\
1246 a thread-local variable at offset %ld from the thread base register %s"),
1247 val, gdbarch_register_name (current_gdbarch, basereg));
1250 case LOC_OPTIMIZED_OUT:
1251 printf_filtered (_("optimized out"));
1255 printf_filtered (_("of unknown (botched) type"));
1258 printf_filtered (".\n");
1263 x_command (char *exp, int from_tty)
1265 struct expression *expr;
1266 struct format_data fmt;
1267 struct cleanup *old_chain;
1270 fmt.format = last_format;
1271 fmt.size = last_size;
1274 if (exp && *exp == '/')
1277 fmt = decode_format (&exp, last_format, last_size);
1280 /* If we have an expression, evaluate it and use it as the address. */
1282 if (exp != 0 && *exp != 0)
1284 expr = parse_expression (exp);
1285 /* Cause expression not to be there any more if this command is
1286 repeated with Newline. But don't clobber a user-defined
1287 command's definition. */
1290 old_chain = make_cleanup (free_current_contents, &expr);
1291 val = evaluate_expression (expr);
1292 if (TYPE_CODE (value_type (val)) == TYPE_CODE_REF)
1293 val = value_ind (val);
1294 /* In rvalue contexts, such as this, functions are coerced into
1295 pointers to functions. This makes "x/i main" work. */
1296 if (/* last_format == 'i' && */
1297 TYPE_CODE (value_type (val)) == TYPE_CODE_FUNC
1298 && VALUE_LVAL (val) == lval_memory)
1299 next_address = VALUE_ADDRESS (val);
1301 next_address = value_as_address (val);
1302 do_cleanups (old_chain);
1305 do_examine (fmt, next_address);
1307 /* If the examine succeeds, we remember its size and format for next
1309 last_size = fmt.size;
1310 last_format = fmt.format;
1312 /* Set a couple of internal variables if appropriate. */
1313 if (last_examine_value)
1315 /* Make last address examined available to the user as $_. Use
1316 the correct pointer type. */
1317 struct type *pointer_type
1318 = lookup_pointer_type (value_type (last_examine_value));
1319 set_internalvar (lookup_internalvar ("_"),
1320 value_from_pointer (pointer_type,
1321 last_examine_address));
1323 /* Make contents of last address examined available to the user
1324 as $__. If the last value has not been fetched from memory
1325 then don't fetch it now; instead mark it by voiding the $__
1327 if (value_lazy (last_examine_value))
1328 set_internalvar (lookup_internalvar ("__"),
1329 allocate_value (builtin_type_void));
1331 set_internalvar (lookup_internalvar ("__"), last_examine_value);
1336 /* Add an expression to the auto-display chain.
1337 Specify the expression. */
1340 display_command (char *exp, int from_tty)
1342 struct format_data fmt;
1343 struct expression *expr;
1344 struct display *new;
1348 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1350 if (tui_active && exp != NULL && *exp == '$')
1351 display_it = (tui_set_layout_for_display_command (exp) == TUI_FAILURE);
1365 fmt = decode_format (&exp, 0, 0);
1366 if (fmt.size && fmt.format == 0)
1368 if (fmt.format == 'i' || fmt.format == 's')
1378 innermost_block = 0;
1379 expr = parse_expression (exp);
1381 new = (struct display *) xmalloc (sizeof (struct display));
1384 new->block = innermost_block;
1385 new->next = display_chain;
1386 new->number = ++display_number;
1389 display_chain = new;
1391 if (from_tty && target_has_execution)
1392 do_one_display (new);
1399 free_display (struct display *d)
1405 /* Clear out the display_chain. Done when new symtabs are loaded,
1406 since this invalidates the types stored in many expressions. */
1409 clear_displays (void)
1413 while ((d = display_chain) != NULL)
1416 display_chain = d->next;
1421 /* Delete the auto-display number NUM. */
1424 delete_display (int num)
1426 struct display *d1, *d;
1429 error (_("No display number %d."), num);
1431 if (display_chain->number == num)
1434 display_chain = d1->next;
1438 for (d = display_chain;; d = d->next)
1441 error (_("No display number %d."), num);
1442 if (d->next->number == num)
1452 /* Delete some values from the auto-display chain.
1453 Specify the element numbers. */
1456 undisplay_command (char *args, int from_tty)
1464 if (query ("Delete all auto-display expressions? "))
1473 while (*p1 >= '0' && *p1 <= '9')
1475 if (*p1 && *p1 != ' ' && *p1 != '\t')
1476 error (_("Arguments must be display numbers."));
1480 delete_display (num);
1483 while (*p == ' ' || *p == '\t')
1489 /* Display a single auto-display.
1490 Do nothing if the display cannot be printed in the current context,
1491 or if the display is disabled. */
1494 do_one_display (struct display *d)
1496 int within_current_scope;
1498 if (d->enabled_p == 0)
1502 within_current_scope = contained_in (get_selected_block (0), d->block);
1504 within_current_scope = 1;
1505 if (!within_current_scope)
1508 current_display_number = d->number;
1510 annotate_display_begin ();
1511 printf_filtered ("%d", d->number);
1512 annotate_display_number_end ();
1513 printf_filtered (": ");
1519 annotate_display_format ();
1521 printf_filtered ("x/");
1522 if (d->format.count != 1)
1523 printf_filtered ("%d", d->format.count);
1524 printf_filtered ("%c", d->format.format);
1525 if (d->format.format != 'i' && d->format.format != 's')
1526 printf_filtered ("%c", d->format.size);
1527 printf_filtered (" ");
1529 annotate_display_expression ();
1531 print_expression (d->exp, gdb_stdout);
1532 annotate_display_expression_end ();
1534 if (d->format.count != 1 || d->format.format == 'i')
1535 printf_filtered ("\n");
1537 printf_filtered (" ");
1539 val = evaluate_expression (d->exp);
1540 addr = value_as_address (val);
1541 if (d->format.format == 'i')
1542 addr = gdbarch_addr_bits_remove (current_gdbarch, addr);
1544 annotate_display_value ();
1546 do_examine (d->format, addr);
1550 annotate_display_format ();
1552 if (d->format.format)
1553 printf_filtered ("/%c ", d->format.format);
1555 annotate_display_expression ();
1557 print_expression (d->exp, gdb_stdout);
1558 annotate_display_expression_end ();
1560 printf_filtered (" = ");
1562 annotate_display_expression ();
1564 print_formatted (evaluate_expression (d->exp),
1565 d->format.format, d->format.size, gdb_stdout);
1566 printf_filtered ("\n");
1569 annotate_display_end ();
1571 gdb_flush (gdb_stdout);
1572 current_display_number = -1;
1575 /* Display all of the values on the auto-display chain which can be
1576 evaluated in the current scope. */
1583 for (d = display_chain; d; d = d->next)
1587 /* Delete the auto-display which we were in the process of displaying.
1588 This is done when there is an error or a signal. */
1591 disable_display (int num)
1595 for (d = display_chain; d; d = d->next)
1596 if (d->number == num)
1601 printf_unfiltered (_("No display number %d.\n"), num);
1605 disable_current_display (void)
1607 if (current_display_number >= 0)
1609 disable_display (current_display_number);
1610 fprintf_unfiltered (gdb_stderr, _("\
1611 Disabling display %d to avoid infinite recursion.\n"),
1612 current_display_number);
1614 current_display_number = -1;
1618 display_info (char *ignore, int from_tty)
1623 printf_unfiltered (_("There are no auto-display expressions now.\n"));
1625 printf_filtered (_("Auto-display expressions now in effect:\n\
1626 Num Enb Expression\n"));
1628 for (d = display_chain; d; d = d->next)
1630 printf_filtered ("%d: %c ", d->number, "ny"[(int) d->enabled_p]);
1632 printf_filtered ("/%d%c%c ", d->format.count, d->format.size,
1634 else if (d->format.format)
1635 printf_filtered ("/%c ", d->format.format);
1636 print_expression (d->exp, gdb_stdout);
1637 if (d->block && !contained_in (get_selected_block (0), d->block))
1638 printf_filtered (_(" (cannot be evaluated in the current context)"));
1639 printf_filtered ("\n");
1640 gdb_flush (gdb_stdout);
1645 enable_display (char *args, int from_tty)
1654 for (d = display_chain; d; d = d->next)
1661 while (*p1 >= '0' && *p1 <= '9')
1663 if (*p1 && *p1 != ' ' && *p1 != '\t')
1664 error (_("Arguments must be display numbers."));
1668 for (d = display_chain; d; d = d->next)
1669 if (d->number == num)
1674 printf_unfiltered (_("No display number %d.\n"), num);
1677 while (*p == ' ' || *p == '\t')
1683 disable_display_command (char *args, int from_tty)
1691 for (d = display_chain; d; d = d->next)
1698 while (*p1 >= '0' && *p1 <= '9')
1700 if (*p1 && *p1 != ' ' && *p1 != '\t')
1701 error (_("Arguments must be display numbers."));
1703 disable_display (atoi (p));
1706 while (*p == ' ' || *p == '\t')
1712 /* Print the value in stack frame FRAME of a variable specified by a
1716 print_variable_value (struct symbol *var, struct frame_info *frame,
1717 struct ui_file *stream)
1719 struct value *val = read_var_value (var, frame);
1721 value_print (val, stream, 0, Val_pretty_default);
1725 printf_command (char *arg, int from_tty)
1729 char *string = NULL;
1730 struct value **val_args;
1732 char *current_substring;
1734 int allocated_args = 20;
1735 struct cleanup *old_cleanups;
1737 val_args = xmalloc (allocated_args * sizeof (struct value *));
1738 old_cleanups = make_cleanup (free_current_contents, &val_args);
1741 error_no_arg (_("format-control string and values to print"));
1743 /* Skip white space before format string */
1744 while (*s == ' ' || *s == '\t')
1747 /* A format string should follow, enveloped in double quotes. */
1749 error (_("Bad format string, missing '\"'."));
1751 /* Parse the format-control string and copy it into the string STRING,
1752 processing some kinds of escape sequence. */
1754 f = string = (char *) alloca (strlen (s) + 1);
1762 error (_("Bad format string, non-terminated '\"'."));
1795 /* ??? TODO: handle other escape sequences */
1796 error (_("Unrecognized escape character \\%c in format string."),
1806 /* Skip over " and following space and comma. */
1809 while (*s == ' ' || *s == '\t')
1812 if (*s != ',' && *s != 0)
1813 error (_("Invalid argument syntax"));
1817 while (*s == ' ' || *s == '\t')
1820 /* Need extra space for the '\0's. Doubling the size is sufficient. */
1821 substrings = alloca (strlen (string) * 2);
1822 current_substring = substrings;
1825 /* Now scan the string for %-specs and see what kinds of args they want.
1826 argclass[I] classifies the %-specs so we can give printf_filtered
1827 something of the right size. */
1831 int_arg, long_arg, long_long_arg, ptr_arg, string_arg,
1832 double_arg, long_double_arg, decfloat_arg
1834 enum argclass *argclass;
1835 enum argclass this_argclass;
1840 argclass = (enum argclass *) alloca (strlen (s) * sizeof *argclass);
1847 int seen_hash = 0, seen_zero = 0, lcount = 0, seen_prec = 0;
1848 int seen_space = 0, seen_plus = 0;
1849 int seen_big_l = 0, seen_h = 0, seen_big_h = 0;
1850 int seen_big_d = 0, seen_double_big_d = 0;
1853 /* Check the validity of the format specifier, and work
1854 out what argument it expects. We only accept C89
1855 format strings, with the exception of long long (which
1856 we autoconf for). */
1858 /* Skip over "%%". */
1865 /* The first part of a format specifier is a set of flag
1867 while (strchr ("0-+ #", *f))
1880 /* The next part of a format specifier is a width. */
1881 while (strchr ("0123456789", *f))
1884 /* The next part of a format specifier is a precision. */
1889 while (strchr ("0123456789", *f))
1893 /* The next part of a format specifier is a length modifier. */
1914 /* Decimal32 modifier. */
1920 /* Decimal64 and Decimal128 modifiers. */
1925 /* Check for a Decimal128. */
1929 seen_double_big_d = 1;
1945 if (seen_space || seen_plus)
1952 this_argclass = int_arg;
1953 else if (lcount == 1)
1954 this_argclass = long_arg;
1956 this_argclass = long_long_arg;
1963 this_argclass = int_arg;
1964 if (lcount || seen_h || seen_big_l)
1966 if (seen_prec || seen_zero || seen_space || seen_plus)
1971 this_argclass = ptr_arg;
1972 if (lcount || seen_h || seen_big_l)
1974 if (seen_prec || seen_zero || seen_space || seen_plus)
1979 this_argclass = string_arg;
1980 if (lcount || seen_h || seen_big_l)
1982 if (seen_zero || seen_space || seen_plus)
1991 if (seen_big_h || seen_big_d || seen_double_big_d)
1992 this_argclass = decfloat_arg;
1993 else if (seen_big_l)
1994 this_argclass = long_double_arg;
1996 this_argclass = double_arg;
1998 if (lcount || seen_h)
2003 error (_("`*' not supported for precision or width in printf"));
2006 error (_("Format specifier `n' not supported in printf"));
2009 error (_("Incomplete format specifier at end of format string"));
2012 error (_("Unrecognized format specifier '%c' in printf"), *f);
2016 error (_("Inappropriate modifiers to format specifier '%c' in printf"),
2021 if (lcount > 1 && USE_PRINTF_I64)
2023 /* Windows' printf does support long long, but not the usual way.
2024 Convert %lld to %I64d. */
2025 int length_before_ll = f - last_arg - 1 - lcount;
2026 strncpy (current_substring, last_arg, length_before_ll);
2027 strcpy (current_substring + length_before_ll, "I64");
2028 current_substring[length_before_ll + 3] =
2029 last_arg[length_before_ll + lcount];
2030 current_substring += length_before_ll + 4;
2034 strncpy (current_substring, last_arg, f - last_arg);
2035 current_substring += f - last_arg;
2037 *current_substring++ = '\0';
2039 argclass[nargs_wanted++] = this_argclass;
2042 /* Now, parse all arguments and evaluate them.
2043 Store the VALUEs in VAL_ARGS. */
2048 if (nargs == allocated_args)
2049 val_args = (struct value **) xrealloc ((char *) val_args,
2050 (allocated_args *= 2)
2051 * sizeof (struct value *));
2053 val_args[nargs] = parse_to_comma_and_eval (&s1);
2055 /* If format string wants a float, unchecked-convert the value to
2056 floating point of the same size */
2058 if (argclass[nargs] == double_arg)
2060 struct type *type = value_type (val_args[nargs]);
2061 if (TYPE_LENGTH (type) == sizeof (float))
2062 deprecated_set_value_type (val_args[nargs], builtin_type_float);
2063 if (TYPE_LENGTH (type) == sizeof (double))
2064 deprecated_set_value_type (val_args[nargs], builtin_type_double);
2072 if (nargs != nargs_wanted)
2073 error (_("Wrong number of arguments for specified format-string"));
2075 /* Now actually print them. */
2076 current_substring = substrings;
2077 for (i = 0; i < nargs; i++)
2079 switch (argclass[i])
2086 tem = value_as_address (val_args[i]);
2088 /* This is a %s argument. Find the length of the string. */
2093 read_memory (tem + j, &c, 1);
2098 /* Copy the string contents into a string inside GDB. */
2099 str = (gdb_byte *) alloca (j + 1);
2101 read_memory (tem, str, j);
2104 printf_filtered (current_substring, (char *) str);
2109 double val = value_as_double (val_args[i]);
2110 printf_filtered (current_substring, val);
2113 case long_double_arg:
2114 #ifdef HAVE_LONG_DOUBLE
2116 long double val = value_as_double (val_args[i]);
2117 printf_filtered (current_substring, val);
2121 error (_("long double not supported in printf"));
2124 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2126 long long val = value_as_long (val_args[i]);
2127 printf_filtered (current_substring, val);
2131 error (_("long long not supported in printf"));
2135 int val = value_as_long (val_args[i]);
2136 printf_filtered (current_substring, val);
2141 long val = value_as_long (val_args[i]);
2142 printf_filtered (current_substring, val);
2146 /* Handles decimal floating values. */
2149 const gdb_byte *param_ptr = value_contents (val_args[i]);
2150 #if defined (PRINTF_HAS_DECFLOAT)
2151 /* If we have native support for Decimal floating
2152 printing, handle it here. */
2153 printf_filtered (current_substring, param_ptr);
2156 /* As a workaround until vasprintf has native support for DFP
2157 we convert the DFP values to string and print them using
2158 the %s format specifier. */
2161 int nnull_chars = 0;
2163 /* Parameter data. */
2164 struct type *param_type = value_type (val_args[i]);
2165 unsigned int param_len = TYPE_LENGTH (param_type);
2167 /* DFP output data. */
2168 struct value *dfp_value = NULL;
2172 struct type *dfp_type = NULL;
2173 char decstr[MAX_DECIMAL_STRING];
2175 /* Points to the end of the string so that we can go back
2176 and check for DFP length modifiers. */
2177 eos = current_substring + strlen (current_substring);
2179 /* Look for the float/double format specifier. */
2180 while (*eos != 'f' && *eos != 'e' && *eos != 'E'
2181 && *eos != 'g' && *eos != 'G')
2186 /* Search for the '%' char and extract the size and type of
2187 the output decimal value based on its modifiers
2188 (%Hf, %Df, %DDf). */
2189 while (*--sos != '%')
2194 dfp_type = builtin_type (current_gdbarch)->builtin_decfloat;
2196 else if (*sos == 'D' && *(sos - 1) == 'D')
2199 dfp_type = builtin_type (current_gdbarch)->builtin_declong;
2205 dfp_type = builtin_type (current_gdbarch)->builtin_decdouble;
2209 /* Replace %Hf, %Df and %DDf with %s's. */
2212 /* Go through the whole format string and pull the correct
2213 number of chars back to compensate for the change in the
2214 format specifier. */
2215 while (nnull_chars < nargs - i)
2223 /* Conversion between different DFP types. */
2224 if (TYPE_CODE (param_type) == TYPE_CODE_DECFLOAT)
2225 decimal_convert (param_ptr, param_len, dec, dfp_len);
2227 /* If this is a non-trivial conversion, just output 0.
2228 A correct converted value can be displayed by explicitly
2229 casting to a DFP type. */
2230 decimal_from_string (dec, dfp_len, "0");
2232 dfp_value = value_from_decfloat (dfp_type, dec);
2234 dfp_ptr = (gdb_byte *) value_contents (dfp_value);
2236 decimal_to_string (dfp_ptr, dfp_len, decstr);
2238 /* Print the DFP value. */
2239 printf_filtered (current_substring, decstr);
2247 /* We avoid the host's %p because pointers are too
2248 likely to be the wrong size. The only interesting
2249 modifier for %p is a width; extract that, and then
2250 handle %p as glibc would: %#x or a literal "(nil)". */
2252 char *p, *fmt, *fmt_p;
2253 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2254 long long val = value_as_long (val_args[i]);
2256 long val = value_as_long (val_args[i]);
2259 fmt = alloca (strlen (current_substring) + 5);
2261 /* Copy up to the leading %. */
2262 p = current_substring;
2266 int is_percent = (*p == '%');
2280 /* Copy any width. */
2281 while (*p >= '0' && *p < '9')
2284 gdb_assert (*p == 'p' && *(p + 1) == '\0');
2287 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2293 printf_filtered (fmt, val);
2299 printf_filtered (fmt, "(nil)");
2305 internal_error (__FILE__, __LINE__,
2306 _("failed internal consistency check"));
2308 /* Skip to the next substring. */
2309 current_substring += strlen (current_substring) + 1;
2311 /* Print the portion of the format string after the last argument. */
2312 puts_filtered (last_arg);
2314 do_cleanups (old_cleanups);
2318 _initialize_printcmd (void)
2320 struct cmd_list_element *c;
2322 current_display_number = -1;
2324 add_info ("address", address_info,
2325 _("Describe where symbol SYM is stored."));
2327 add_info ("symbol", sym_info, _("\
2328 Describe what symbol is at location ADDR.\n\
2329 Only for symbols with fixed locations (global or static scope)."));
2331 add_com ("x", class_vars, x_command, _("\
2332 Examine memory: x/FMT ADDRESS.\n\
2333 ADDRESS is an expression for the memory address to examine.\n\
2334 FMT is a repeat count followed by a format letter and a size letter.\n\
2335 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2336 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
2337 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2338 The specified number of objects of the specified size are printed\n\
2339 according to the format.\n\n\
2340 Defaults for format and size letters are those previously used.\n\
2341 Default count is 1. Default address is following last thing printed\n\
2342 with this command or \"print\"."));
2345 add_com ("whereis", class_vars, whereis_command,
2346 _("Print line number and file of definition of variable."));
2349 add_info ("display", display_info, _("\
2350 Expressions to display when program stops, with code numbers."));
2352 add_cmd ("undisplay", class_vars, undisplay_command, _("\
2353 Cancel some expressions to be displayed when program stops.\n\
2354 Arguments are the code numbers of the expressions to stop displaying.\n\
2355 No argument means cancel all automatic-display expressions.\n\
2356 \"delete display\" has the same effect as this command.\n\
2357 Do \"info display\" to see current list of code numbers."),
2360 add_com ("display", class_vars, display_command, _("\
2361 Print value of expression EXP each time the program stops.\n\
2362 /FMT may be used before EXP as in the \"print\" command.\n\
2363 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2364 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2365 and examining is done as in the \"x\" command.\n\n\
2366 With no argument, display all currently requested auto-display expressions.\n\
2367 Use \"undisplay\" to cancel display requests previously made."));
2369 add_cmd ("display", class_vars, enable_display, _("\
2370 Enable some expressions to be displayed when program stops.\n\
2371 Arguments are the code numbers of the expressions to resume displaying.\n\
2372 No argument means enable all automatic-display expressions.\n\
2373 Do \"info display\" to see current list of code numbers."), &enablelist);
2375 add_cmd ("display", class_vars, disable_display_command, _("\
2376 Disable some expressions to be displayed when program stops.\n\
2377 Arguments are the code numbers of the expressions to stop displaying.\n\
2378 No argument means disable all automatic-display expressions.\n\
2379 Do \"info display\" to see current list of code numbers."), &disablelist);
2381 add_cmd ("display", class_vars, undisplay_command, _("\
2382 Cancel some expressions to be displayed when program stops.\n\
2383 Arguments are the code numbers of the expressions to stop displaying.\n\
2384 No argument means cancel all automatic-display expressions.\n\
2385 Do \"info display\" to see current list of code numbers."), &deletelist);
2387 add_com ("printf", class_vars, printf_command, _("\
2388 printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2389 This is useful for formatted output in user-defined commands."));
2391 add_com ("output", class_vars, output_command, _("\
2392 Like \"print\" but don't put in value history and don't print newline.\n\
2393 This is useful in user-defined commands."));
2395 add_prefix_cmd ("set", class_vars, set_command, _("\
2396 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2397 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2398 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2399 with $), a register (a few standard names starting with $), or an actual\n\
2400 variable in the program being debugged. EXP is any valid expression.\n\
2401 Use \"set variable\" for variables with names identical to set subcommands.\n\
2403 With a subcommand, this command modifies parts of the gdb environment.\n\
2404 You can see these environment settings with the \"show\" command."),
2405 &setlist, "set ", 1, &cmdlist);
2407 add_com ("assign", class_vars, set_command, _("\
2408 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2409 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2410 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2411 with $), a register (a few standard names starting with $), or an actual\n\
2412 variable in the program being debugged. EXP is any valid expression.\n\
2413 Use \"set variable\" for variables with names identical to set subcommands.\n\
2414 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2415 You can see these environment settings with the \"show\" command."));
2417 /* "call" is the same as "set", but handy for dbx users to call fns. */
2418 c = add_com ("call", class_vars, call_command, _("\
2419 Call a function in the program.\n\
2420 The argument is the function name and arguments, in the notation of the\n\
2421 current working language. The result is printed and saved in the value\n\
2422 history, if it is not void."));
2423 set_cmd_completer (c, location_completer);
2425 add_cmd ("variable", class_vars, set_command, _("\
2426 Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2427 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2428 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2429 with $), a register (a few standard names starting with $), or an actual\n\
2430 variable in the program being debugged. EXP is any valid expression.\n\
2431 This may usually be abbreviated to simply \"set\"."),
2434 c = add_com ("print", class_vars, print_command, _("\
2435 Print value of expression EXP.\n\
2436 Variables accessible are those of the lexical environment of the selected\n\
2437 stack frame, plus all those whose scope is global or an entire file.\n\
2439 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2440 $$NUM refers to NUM'th value back from the last one.\n\
2441 Names starting with $ refer to registers (with the values they would have\n\
2442 if the program were to return to the stack frame now selected, restoring\n\
2443 all registers saved by frames farther in) or else to debugger\n\
2444 \"convenience\" variables (any such name not a known register).\n\
2445 Use assignment expressions to give values to convenience variables.\n\
2447 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2448 @ is a binary operator for treating consecutive data objects\n\
2449 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2450 element is FOO, whose second element is stored in the space following\n\
2451 where FOO is stored, etc. FOO must be an expression whose value\n\
2452 resides in memory.\n\
2454 EXP may be preceded with /FMT, where FMT is a format letter\n\
2455 but no count or size letter (see \"x\" command)."));
2456 set_cmd_completer (c, location_completer);
2457 add_com_alias ("p", "print", class_vars, 1);
2459 c = add_com ("inspect", class_vars, inspect_command, _("\
2460 Same as \"print\" command, except that if you are running in the epoch\n\
2461 environment, the value is printed in its own window."));
2462 set_cmd_completer (c, location_completer);
2464 add_setshow_uinteger_cmd ("max-symbolic-offset", no_class,
2465 &max_symbolic_offset, _("\
2466 Set the largest offset that will be printed in <symbol+1234> form."), _("\
2467 Show the largest offset that will be printed in <symbol+1234> form."), NULL,
2469 show_max_symbolic_offset,
2470 &setprintlist, &showprintlist);
2471 add_setshow_boolean_cmd ("symbol-filename", no_class,
2472 &print_symbol_filename, _("\
2473 Set printing of source filename and line number with <symbol>."), _("\
2474 Show printing of source filename and line number with <symbol>."), NULL,
2476 show_print_symbol_filename,
2477 &setprintlist, &showprintlist);
2479 /* For examine/instruction a single byte quantity is specified as
2480 the data. This avoids problems with value_at_lazy() requiring a
2481 valid data type (and rejecting VOID). */
2482 examine_i_type = init_type (TYPE_CODE_INT, 1, 0, "examine_i_type", NULL);
2484 examine_b_type = init_type (TYPE_CODE_INT, 1, 0, "examine_b_type", NULL);
2485 examine_h_type = init_type (TYPE_CODE_INT, 2, 0, "examine_h_type", NULL);
2486 examine_w_type = init_type (TYPE_CODE_INT, 4, 0, "examine_w_type", NULL);
2487 examine_g_type = init_type (TYPE_CODE_INT, 8, 0, "examine_g_type", NULL);