1 /* Print values for GNU debugger GDB.
3 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
4 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Free Software
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 2 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, write to the Free Software
21 Foundation, Inc., 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
25 #include "gdb_string.h"
31 #include "expression.h"
35 #include "breakpoint.h"
39 #include "symfile.h" /* for overlay functions */
40 #include "objfiles.h" /* ditto */
41 #include "completer.h" /* for completion functions */
44 extern int asm_demangle
; /* Whether to demangle syms in asm printouts */
45 extern int addressprint
; /* Whether to print hex addresses in HLL " */
54 /* Last specified output format. */
56 static char last_format
= 'x';
58 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
60 static char last_size
= 'w';
62 /* Default address to examine next. */
64 static CORE_ADDR next_address
;
66 /* Default section to examine next. */
68 static asection
*next_section
;
70 /* Last address examined. */
72 static CORE_ADDR last_examine_address
;
74 /* Contents of last address examined.
75 This is not valid past the end of the `x' command! */
77 static struct value
*last_examine_value
;
79 /* Largest offset between a symbolic value and an address, that will be
80 printed as `0x1234 <symbol+offset>'. */
82 static unsigned int max_symbolic_offset
= UINT_MAX
;
84 /* Append the source filename and linenumber of the symbol when
85 printing a symbolic value as `<symbol at filename:linenum>' if set. */
86 static int print_symbol_filename
= 0;
88 /* Number of auto-display expression currently being displayed.
89 So that we can disable it if we get an error or a signal within it.
90 -1 when not doing one. */
92 int current_display_number
;
94 /* Flag to low-level print routines that this value is being printed
95 in an epoch window. We'd like to pass this as a parameter, but
96 every routine would need to take it. Perhaps we can encapsulate
97 this in the I/O stream once we have GNU stdio. */
103 /* Chain link to next auto-display item. */
104 struct display
*next
;
105 /* Expression to be evaluated and displayed. */
106 struct expression
*exp
;
107 /* Item number of this auto-display item. */
109 /* Display format specified. */
110 struct format_data format
;
111 /* Innermost block required by this expression when evaluated */
113 /* Status of this display (enabled or disabled) */
117 /* Chain of expressions whose values should be displayed
118 automatically each time the program stops. */
120 static struct display
*display_chain
;
122 static int display_number
;
124 /* Prototypes for exported functions. */
126 void output_command (char *, int);
128 void _initialize_printcmd (void);
130 /* Prototypes for local functions. */
132 static void delete_display (int);
134 static void enable_display (char *, int);
136 static void disable_display_command (char *, int);
138 static void disassemble_command (char *, int);
140 static void printf_command (char *, int);
142 static void print_frame_nameless_args (struct frame_info
*, long,
143 int, int, struct ui_file
*);
145 static void display_info (char *, int);
147 static void do_one_display (struct display
*);
149 static void undisplay_command (char *, int);
151 static void free_display (struct display
*);
153 static void display_command (char *, int);
155 void x_command (char *, int);
157 static void address_info (char *, int);
159 static void set_command (char *, int);
161 static void call_command (char *, int);
163 static void inspect_command (char *, int);
165 static void print_command (char *, int);
167 static void print_command_1 (char *, int, int);
169 static void validate_format (struct format_data
, char *);
171 static void do_examine (struct format_data
, CORE_ADDR addr
,
174 static void print_formatted (struct value
*, int, int, struct ui_file
*);
176 static struct format_data
decode_format (char **, int, int);
178 static int print_insn (CORE_ADDR
, struct ui_file
*);
180 static void sym_info (char *, int);
183 /* Decode a format specification. *STRING_PTR should point to it.
184 OFORMAT and OSIZE are used as defaults for the format and size
185 if none are given in the format specification.
186 If OSIZE is zero, then the size field of the returned value
187 should be set only if a size is explicitly specified by the
189 The structure returned describes all the data
190 found in the specification. In addition, *STRING_PTR is advanced
191 past the specification and past all whitespace following it. */
193 static struct format_data
194 decode_format (char **string_ptr
, int oformat
, int osize
)
196 struct format_data val
;
197 register char *p
= *string_ptr
;
203 if (*p
>= '0' && *p
<= '9')
204 val
.count
= atoi (p
);
205 while (*p
>= '0' && *p
<= '9')
208 /* Now process size or format letters that follow. */
212 if (*p
== 'b' || *p
== 'h' || *p
== 'w' || *p
== 'g')
214 else if (*p
>= 'a' && *p
<= 'z')
220 while (*p
== ' ' || *p
== '\t')
224 /* Set defaults for format and size if not specified. */
225 if (val
.format
== '?')
229 /* Neither has been specified. */
230 val
.format
= oformat
;
234 /* If a size is specified, any format makes a reasonable
235 default except 'i'. */
236 val
.format
= oformat
== 'i' ? 'x' : oformat
;
238 else if (val
.size
== '?')
243 /* Pick the appropriate size for an address. */
244 if (TARGET_PTR_BIT
== 64)
245 val
.size
= osize
? 'g' : osize
;
246 else if (TARGET_PTR_BIT
== 32)
247 val
.size
= osize
? 'w' : osize
;
248 else if (TARGET_PTR_BIT
== 16)
249 val
.size
= osize
? 'h' : osize
;
251 /* Bad value for TARGET_PTR_BIT */
252 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
255 /* Floating point has to be word or giantword. */
256 if (osize
== 'w' || osize
== 'g')
259 /* Default it to giantword if the last used size is not
261 val
.size
= osize
? 'g' : osize
;
264 /* Characters default to one byte. */
265 val
.size
= osize
? 'b' : osize
;
268 /* The default is the size most recently specified. */
275 /* Print value VAL on stream according to FORMAT, a letter or 0.
276 Do not end with a newline.
277 0 means print VAL according to its own type.
278 SIZE is the letter for the size of datum being printed.
279 This is used to pad hex numbers so they line up. */
282 print_formatted (struct value
*val
, register int format
, int size
,
283 struct ui_file
*stream
)
285 struct type
*type
= check_typedef (VALUE_TYPE (val
));
286 int len
= TYPE_LENGTH (type
);
288 if (VALUE_LVAL (val
) == lval_memory
)
290 next_address
= VALUE_ADDRESS (val
) + len
;
291 next_section
= VALUE_BFD_SECTION (val
);
297 /* FIXME: Need to handle wchar_t's here... */
298 next_address
= VALUE_ADDRESS (val
)
299 + val_print_string (VALUE_ADDRESS (val
), -1, 1, stream
);
300 next_section
= VALUE_BFD_SECTION (val
);
304 /* The old comment says
305 "Force output out, print_insn not using _filtered".
306 I'm not completely sure what that means, I suspect most print_insn
307 now do use _filtered, so I guess it's obsolete.
308 --Yes, it does filter now, and so this is obsolete. -JB */
310 /* We often wrap here if there are long symbolic names. */
312 next_address
= VALUE_ADDRESS (val
)
313 + print_insn (VALUE_ADDRESS (val
), stream
);
314 next_section
= VALUE_BFD_SECTION (val
);
319 || TYPE_CODE (type
) == TYPE_CODE_ARRAY
320 || TYPE_CODE (type
) == TYPE_CODE_STRING
321 || TYPE_CODE (type
) == TYPE_CODE_STRUCT
322 || TYPE_CODE (type
) == TYPE_CODE_UNION
)
323 /* If format is 0, use the 'natural' format for
324 * that type of value. If the type is non-scalar,
325 * we have to use language rules to print it as
326 * a series of scalars.
328 value_print (val
, stream
, format
, Val_pretty_default
);
330 /* User specified format, so don't look to the
331 * the type to tell us what to do.
333 print_scalar_formatted (VALUE_CONTENTS (val
), type
,
334 format
, size
, stream
);
338 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
339 according to letters FORMAT and SIZE on STREAM.
340 FORMAT may not be zero. Formats s and i are not supported at this level.
342 This is how the elements of an array or structure are printed
346 print_scalar_formatted (char *valaddr
, struct type
*type
, int format
, int size
,
347 struct ui_file
*stream
)
350 unsigned int len
= TYPE_LENGTH (type
);
352 if (len
> sizeof (LONGEST
)
360 if (!TYPE_UNSIGNED (type
)
361 || !extract_long_unsigned_integer (valaddr
, len
, &val_long
))
363 /* We can't print it normally, but we can print it in hex.
364 Printing it in the wrong radix is more useful than saying
365 "use /x, you dummy". */
366 /* FIXME: we could also do octal or binary if that was the
368 /* FIXME: we should be using the size field to give us a
369 minimum field width to print. */
372 print_octal_chars (stream
, valaddr
, len
);
373 else if (format
== 'd')
374 print_decimal_chars (stream
, valaddr
, len
);
375 else if (format
== 't')
376 print_binary_chars (stream
, valaddr
, len
);
378 /* replace with call to print_hex_chars? Looks
379 like val_print_type_code_int is redoing
382 val_print_type_code_int (type
, valaddr
, stream
);
387 /* If we get here, extract_long_unsigned_integer set val_long. */
389 else if (format
!= 'f')
390 val_long
= unpack_long (type
, valaddr
);
392 /* If the value is a pointer, and pointers and addresses are not the
393 same, then at this point, the value's length is TARGET_ADDR_BIT, not
394 TYPE_LENGTH (type). */
395 if (TYPE_CODE (type
) == TYPE_CODE_PTR
)
396 len
= TARGET_ADDR_BIT
;
398 /* If we are printing it as unsigned, truncate it in case it is actually
399 a negative signed value (e.g. "print/u (short)-1" should print 65535
400 (if shorts are 16 bits) instead of 4294967295). */
403 if (len
< sizeof (LONGEST
))
404 val_long
&= ((LONGEST
) 1 << HOST_CHAR_BIT
* len
) - 1;
412 /* no size specified, like in print. Print varying # of digits. */
413 print_longest (stream
, 'x', 1, val_long
);
422 print_longest (stream
, size
, 1, val_long
);
425 error ("Undefined output size \"%c\".", size
);
430 print_longest (stream
, 'd', 1, val_long
);
434 print_longest (stream
, 'u', 0, val_long
);
439 print_longest (stream
, 'o', 1, val_long
);
441 fprintf_filtered (stream
, "0");
446 CORE_ADDR addr
= unpack_pointer (type
, valaddr
);
447 print_address (addr
, stream
);
452 value_print (value_from_longest (builtin_type_true_char
, val_long
),
453 stream
, 0, Val_pretty_default
);
457 if (len
== TYPE_LENGTH (builtin_type_float
))
458 type
= builtin_type_float
;
459 else if (len
== TYPE_LENGTH (builtin_type_double
))
460 type
= builtin_type_double
;
461 else if (len
== TYPE_LENGTH (builtin_type_long_double
))
462 type
= builtin_type_long_double
;
463 print_floating (valaddr
, type
, stream
);
467 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
470 /* Binary; 't' stands for "two". */
472 char bits
[8 * (sizeof val_long
) + 1];
473 char buf
[8 * (sizeof val_long
) + 32];
478 width
= 8 * (sizeof val_long
);
495 error ("Undefined output size \"%c\".", size
);
501 bits
[width
] = (val_long
& 1) ? '1' : '0';
506 while (*cp
&& *cp
== '0')
511 strcpy (buf
, local_binary_format_prefix ());
513 strcat (buf
, local_binary_format_suffix ());
514 fprintf_filtered (stream
, buf
);
519 error ("Undefined output format \"%c\".", format
);
523 /* Specify default address for `x' command.
524 `info lines' uses this. */
527 set_next_address (CORE_ADDR addr
)
531 /* Make address available to the user as $_. */
532 set_internalvar (lookup_internalvar ("_"),
533 value_from_pointer (lookup_pointer_type (builtin_type_void
),
537 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
538 after LEADIN. Print nothing if no symbolic name is found nearby.
539 Optionally also print source file and line number, if available.
540 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
541 or to interpret it as a possible C++ name and convert it back to source
542 form. However note that DO_DEMANGLE can be overridden by the specific
543 settings of the demangle and asm_demangle variables. */
546 print_address_symbolic (CORE_ADDR addr
, struct ui_file
*stream
, int do_demangle
,
550 char *filename
= NULL
;
555 /* throw away both name and filename */
556 struct cleanup
*cleanup_chain
= make_cleanup (free_current_contents
, &name
);
557 make_cleanup (free_current_contents
, &filename
);
559 if (build_address_symbolic (addr
, do_demangle
, &name
, &offset
, &filename
, &line
, &unmapped
))
561 do_cleanups (cleanup_chain
);
565 fputs_filtered (leadin
, stream
);
567 fputs_filtered ("<*", stream
);
569 fputs_filtered ("<", stream
);
570 fputs_filtered (name
, stream
);
572 fprintf_filtered (stream
, "+%u", (unsigned int) offset
);
574 /* Append source filename and line number if desired. Give specific
575 line # of this addr, if we have it; else line # of the nearest symbol. */
576 if (print_symbol_filename
&& filename
!= NULL
)
579 fprintf_filtered (stream
, " at %s:%d", filename
, line
);
581 fprintf_filtered (stream
, " in %s", filename
);
584 fputs_filtered ("*>", stream
);
586 fputs_filtered (">", stream
);
588 do_cleanups (cleanup_chain
);
591 /* Given an address ADDR return all the elements needed to print the
592 address in a symbolic form. NAME can be mangled or not depending
593 on DO_DEMANGLE (and also on the asm_demangle global variable,
594 manipulated via ''set print asm-demangle''). Return 0 in case of
595 success, when all the info in the OUT paramters is valid. Return 1
598 build_address_symbolic (CORE_ADDR addr
, /* IN */
599 int do_demangle
, /* IN */
600 char **name
, /* OUT */
601 int *offset
, /* OUT */
602 char **filename
, /* OUT */
604 int *unmapped
) /* OUT */
606 struct minimal_symbol
*msymbol
;
607 struct symbol
*symbol
;
608 struct symtab
*symtab
= 0;
609 CORE_ADDR name_location
= 0;
610 asection
*section
= 0;
611 char *name_temp
= "";
613 /* Let's say it is unmapped. */
616 /* Determine if the address is in an overlay, and whether it is
618 if (overlay_debugging
)
620 section
= find_pc_overlay (addr
);
621 if (pc_in_unmapped_range (addr
, section
))
624 addr
= overlay_mapped_address (addr
, section
);
628 /* On some targets, add in extra "flag" bits to PC for
629 disassembly. This should ensure that "rounding errors" in
630 symbol addresses that are masked for disassembly favour the
631 the correct symbol. */
633 #ifdef GDB_TARGET_UNMASK_DISAS_PC
634 addr
= GDB_TARGET_UNMASK_DISAS_PC (addr
);
637 /* First try to find the address in the symbol table, then
638 in the minsyms. Take the closest one. */
640 /* This is defective in the sense that it only finds text symbols. So
641 really this is kind of pointless--we should make sure that the
642 minimal symbols have everything we need (by changing that we could
643 save some memory, but for many debug format--ELF/DWARF or
644 anything/stabs--it would be inconvenient to eliminate those minimal
646 msymbol
= lookup_minimal_symbol_by_pc_section (addr
, section
);
647 symbol
= find_pc_sect_function (addr
, section
);
651 name_location
= BLOCK_START (SYMBOL_BLOCK_VALUE (symbol
));
653 name_temp
= SYMBOL_SOURCE_NAME (symbol
);
655 name_temp
= SYMBOL_LINKAGE_NAME (symbol
);
660 if (SYMBOL_VALUE_ADDRESS (msymbol
) > name_location
|| symbol
== NULL
)
662 /* The msymbol is closer to the address than the symbol;
663 use the msymbol instead. */
666 name_location
= SYMBOL_VALUE_ADDRESS (msymbol
);
668 name_temp
= SYMBOL_SOURCE_NAME (msymbol
);
670 name_temp
= SYMBOL_LINKAGE_NAME (msymbol
);
673 if (symbol
== NULL
&& msymbol
== NULL
)
676 /* On some targets, mask out extra "flag" bits from PC for handsome
679 #ifdef GDB_TARGET_MASK_DISAS_PC
680 name_location
= GDB_TARGET_MASK_DISAS_PC (name_location
);
681 addr
= GDB_TARGET_MASK_DISAS_PC (addr
);
684 /* If the nearest symbol is too far away, don't print anything symbolic. */
686 /* For when CORE_ADDR is larger than unsigned int, we do math in
687 CORE_ADDR. But when we detect unsigned wraparound in the
688 CORE_ADDR math, we ignore this test and print the offset,
689 because addr+max_symbolic_offset has wrapped through the end
690 of the address space back to the beginning, giving bogus comparison. */
691 if (addr
> name_location
+ max_symbolic_offset
692 && name_location
+ max_symbolic_offset
> name_location
)
695 *offset
= addr
- name_location
;
697 *name
= xstrdup (name_temp
);
699 if (print_symbol_filename
)
701 struct symtab_and_line sal
;
703 sal
= find_pc_sect_line (addr
, section
, 0);
707 *filename
= xstrdup (sal
.symtab
->filename
);
710 else if (symtab
&& symbol
&& symbol
->line
)
712 *filename
= xstrdup (symtab
->filename
);
713 *line
= symbol
->line
;
717 *filename
= xstrdup (symtab
->filename
);
724 /* Print address ADDR on STREAM. USE_LOCAL means the same thing as for
727 print_address_numeric (CORE_ADDR addr
, int use_local
, struct ui_file
*stream
)
729 /* Truncate address to the size of a target address, avoiding shifts
730 larger or equal than the width of a CORE_ADDR. The local
731 variable ADDR_BIT stops the compiler reporting a shift overflow
732 when it won't occur. */
733 /* NOTE: This assumes that the significant address information is
734 kept in the least significant bits of ADDR - the upper bits were
735 either zero or sign extended. Should ADDRESS_TO_POINTER() or
736 some ADDRESS_TO_PRINTABLE() be used to do the conversion? */
738 int addr_bit
= TARGET_ADDR_BIT
;
740 if (addr_bit
< (sizeof (CORE_ADDR
) * HOST_CHAR_BIT
))
741 addr
&= ((CORE_ADDR
) 1 << addr_bit
) - 1;
742 print_longest (stream
, 'x', use_local
, (ULONGEST
) addr
);
745 /* Print address ADDR symbolically on STREAM.
746 First print it as a number. Then perhaps print
747 <SYMBOL + OFFSET> after the number. */
750 print_address (CORE_ADDR addr
, struct ui_file
*stream
)
752 print_address_numeric (addr
, 1, stream
);
753 print_address_symbolic (addr
, stream
, asm_demangle
, " ");
756 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
757 controls whether to print the symbolic name "raw" or demangled.
758 Global setting "addressprint" controls whether to print hex address
762 print_address_demangle (CORE_ADDR addr
, struct ui_file
*stream
, int do_demangle
)
766 fprintf_filtered (stream
, "0");
768 else if (addressprint
)
770 print_address_numeric (addr
, 1, stream
);
771 print_address_symbolic (addr
, stream
, do_demangle
, " ");
775 print_address_symbolic (addr
, stream
, do_demangle
, "");
780 /* These are the types that $__ will get after an examine command of one
783 static struct type
*examine_i_type
;
785 static struct type
*examine_b_type
;
786 static struct type
*examine_h_type
;
787 static struct type
*examine_w_type
;
788 static struct type
*examine_g_type
;
790 /* Examine data at address ADDR in format FMT.
791 Fetch it from memory and print on gdb_stdout. */
794 do_examine (struct format_data fmt
, CORE_ADDR addr
, asection
*sect
)
796 register char format
= 0;
798 register int count
= 1;
799 struct type
*val_type
= NULL
;
801 register int maxelts
;
809 /* String or instruction format implies fetch single bytes
810 regardless of the specified size. */
811 if (format
== 's' || format
== 'i')
815 val_type
= examine_i_type
;
816 else if (size
== 'b')
817 val_type
= examine_b_type
;
818 else if (size
== 'h')
819 val_type
= examine_h_type
;
820 else if (size
== 'w')
821 val_type
= examine_w_type
;
822 else if (size
== 'g')
823 val_type
= examine_g_type
;
830 if (format
== 's' || format
== 'i')
833 /* Print as many objects as specified in COUNT, at most maxelts per line,
834 with the address of the next one at the start of each line. */
839 print_address (next_address
, gdb_stdout
);
840 printf_filtered (":");
845 printf_filtered ("\t");
846 /* Note that print_formatted sets next_address for the next
848 last_examine_address
= next_address
;
850 if (last_examine_value
)
851 value_free (last_examine_value
);
853 /* The value to be displayed is not fetched greedily.
854 Instead, to avoid the posibility of a fetched value not
855 being used, its retreval is delayed until the print code
856 uses it. When examining an instruction stream, the
857 disassembler will perform its own memory fetch using just
858 the address stored in LAST_EXAMINE_VALUE. FIXME: Should
859 the disassembler be modified so that LAST_EXAMINE_VALUE
860 is left with the byte sequence from the last complete
861 instruction fetched from memory? */
862 last_examine_value
= value_at_lazy (val_type
, next_address
, sect
);
864 if (last_examine_value
)
865 release_value (last_examine_value
);
867 print_formatted (last_examine_value
, format
, size
, gdb_stdout
);
869 printf_filtered ("\n");
870 gdb_flush (gdb_stdout
);
875 validate_format (struct format_data fmt
, char *cmdname
)
878 error ("Size letters are meaningless in \"%s\" command.", cmdname
);
880 error ("Item count other than 1 is meaningless in \"%s\" command.",
882 if (fmt
.format
== 'i' || fmt
.format
== 's')
883 error ("Format letter \"%c\" is meaningless in \"%s\" command.",
884 fmt
.format
, cmdname
);
887 /* Evaluate string EXP as an expression in the current language and
888 print the resulting value. EXP may contain a format specifier as the
889 first argument ("/x myvar" for example, to print myvar in hex).
893 print_command_1 (char *exp
, int inspect
, int voidprint
)
895 struct expression
*expr
;
896 register struct cleanup
*old_chain
= 0;
897 register char format
= 0;
899 struct format_data fmt
;
902 /* Pass inspect flag to the rest of the print routines in a global (sigh). */
903 inspect_it
= inspect
;
905 if (exp
&& *exp
== '/')
908 fmt
= decode_format (&exp
, last_format
, 0);
909 validate_format (fmt
, "print");
910 last_format
= format
= fmt
.format
;
922 expr
= parse_expression (exp
);
923 old_chain
= make_cleanup (free_current_contents
, &expr
);
925 val
= evaluate_expression (expr
);
928 val
= access_value_history (0);
930 if (voidprint
|| (val
&& VALUE_TYPE (val
) &&
931 TYPE_CODE (VALUE_TYPE (val
)) != TYPE_CODE_VOID
))
933 int histindex
= record_latest_value (val
);
936 annotate_value_history_begin (histindex
, VALUE_TYPE (val
));
938 annotate_value_begin (VALUE_TYPE (val
));
941 printf_unfiltered ("\031(gdb-makebuffer \"%s\" %d '(\"", exp
, histindex
);
942 else if (histindex
>= 0)
943 printf_filtered ("$%d = ", histindex
);
946 annotate_value_history_value ();
948 print_formatted (val
, format
, fmt
.size
, gdb_stdout
);
949 printf_filtered ("\n");
952 annotate_value_history_end ();
954 annotate_value_end ();
957 printf_unfiltered ("\") )\030");
961 do_cleanups (old_chain
);
962 inspect_it
= 0; /* Reset print routines to normal */
967 print_command (char *exp
, int from_tty
)
969 print_command_1 (exp
, 0, 1);
972 /* Same as print, except in epoch, it gets its own window */
975 inspect_command (char *exp
, int from_tty
)
977 extern int epoch_interface
;
979 print_command_1 (exp
, epoch_interface
, 1);
982 /* Same as print, except it doesn't print void results. */
985 call_command (char *exp
, int from_tty
)
987 print_command_1 (exp
, 0, 0);
992 output_command (char *exp
, int from_tty
)
994 struct expression
*expr
;
995 register struct cleanup
*old_chain
;
996 register char format
= 0;
998 struct format_data fmt
;
1000 if (exp
&& *exp
== '/')
1003 fmt
= decode_format (&exp
, 0, 0);
1004 validate_format (fmt
, "output");
1005 format
= fmt
.format
;
1008 expr
= parse_expression (exp
);
1009 old_chain
= make_cleanup (free_current_contents
, &expr
);
1011 val
= evaluate_expression (expr
);
1013 annotate_value_begin (VALUE_TYPE (val
));
1015 print_formatted (val
, format
, fmt
.size
, gdb_stdout
);
1017 annotate_value_end ();
1020 gdb_flush (gdb_stdout
);
1022 do_cleanups (old_chain
);
1027 set_command (char *exp
, int from_tty
)
1029 struct expression
*expr
= parse_expression (exp
);
1030 register struct cleanup
*old_chain
=
1031 make_cleanup (free_current_contents
, &expr
);
1032 evaluate_expression (expr
);
1033 do_cleanups (old_chain
);
1038 sym_info (char *arg
, int from_tty
)
1040 struct minimal_symbol
*msymbol
;
1041 struct objfile
*objfile
;
1042 struct obj_section
*osect
;
1044 CORE_ADDR addr
, sect_addr
;
1046 unsigned int offset
;
1049 error_no_arg ("address");
1051 addr
= parse_and_eval_address (arg
);
1052 ALL_OBJSECTIONS (objfile
, osect
)
1054 sect
= osect
->the_bfd_section
;
1055 sect_addr
= overlay_mapped_address (addr
, sect
);
1057 if (osect
->addr
<= sect_addr
&& sect_addr
< osect
->endaddr
&&
1058 (msymbol
= lookup_minimal_symbol_by_pc_section (sect_addr
, sect
)))
1061 offset
= sect_addr
- SYMBOL_VALUE_ADDRESS (msymbol
);
1063 printf_filtered ("%s + %u in ",
1064 SYMBOL_SOURCE_NAME (msymbol
), offset
);
1066 printf_filtered ("%s in ",
1067 SYMBOL_SOURCE_NAME (msymbol
));
1068 if (pc_in_unmapped_range (addr
, sect
))
1069 printf_filtered ("load address range of ");
1070 if (section_is_overlay (sect
))
1071 printf_filtered ("%s overlay ",
1072 section_is_mapped (sect
) ? "mapped" : "unmapped");
1073 printf_filtered ("section %s", sect
->name
);
1074 printf_filtered ("\n");
1078 printf_filtered ("No symbol matches %s.\n", arg
);
1083 address_info (char *exp
, int from_tty
)
1085 register struct symbol
*sym
;
1086 register struct minimal_symbol
*msymbol
;
1088 register long basereg
;
1090 CORE_ADDR load_addr
;
1091 int is_a_field_of_this
; /* C++: lookup_symbol sets this to nonzero
1092 if exp is a field of `this'. */
1095 error ("Argument required.");
1097 sym
= lookup_symbol (exp
, get_selected_block (0), VAR_NAMESPACE
,
1098 &is_a_field_of_this
, (struct symtab
**) NULL
);
1101 if (is_a_field_of_this
)
1103 printf_filtered ("Symbol \"");
1104 fprintf_symbol_filtered (gdb_stdout
, exp
,
1105 current_language
->la_language
, DMGL_ANSI
);
1106 printf_filtered ("\" is a field of the local class variable `this'\n");
1110 msymbol
= lookup_minimal_symbol (exp
, NULL
, NULL
);
1112 if (msymbol
!= NULL
)
1114 load_addr
= SYMBOL_VALUE_ADDRESS (msymbol
);
1116 printf_filtered ("Symbol \"");
1117 fprintf_symbol_filtered (gdb_stdout
, exp
,
1118 current_language
->la_language
, DMGL_ANSI
);
1119 printf_filtered ("\" is at ");
1120 print_address_numeric (load_addr
, 1, gdb_stdout
);
1121 printf_filtered (" in a file compiled without debugging");
1122 section
= SYMBOL_BFD_SECTION (msymbol
);
1123 if (section_is_overlay (section
))
1125 load_addr
= overlay_unmapped_address (load_addr
, section
);
1126 printf_filtered (",\n -- loaded at ");
1127 print_address_numeric (load_addr
, 1, gdb_stdout
);
1128 printf_filtered (" in overlay section %s", section
->name
);
1130 printf_filtered (".\n");
1133 error ("No symbol \"%s\" in current context.", exp
);
1137 printf_filtered ("Symbol \"");
1138 fprintf_symbol_filtered (gdb_stdout
, SYMBOL_NAME (sym
),
1139 current_language
->la_language
, DMGL_ANSI
);
1140 printf_filtered ("\" is ");
1141 val
= SYMBOL_VALUE (sym
);
1142 basereg
= SYMBOL_BASEREG (sym
);
1143 section
= SYMBOL_BFD_SECTION (sym
);
1145 switch (SYMBOL_CLASS (sym
))
1148 case LOC_CONST_BYTES
:
1149 printf_filtered ("constant");
1153 printf_filtered ("a label at address ");
1154 print_address_numeric (load_addr
= SYMBOL_VALUE_ADDRESS (sym
),
1156 if (section_is_overlay (section
))
1158 load_addr
= overlay_unmapped_address (load_addr
, section
);
1159 printf_filtered (",\n -- loaded at ");
1160 print_address_numeric (load_addr
, 1, gdb_stdout
);
1161 printf_filtered (" in overlay section %s", section
->name
);
1166 printf_filtered ("a variable in register %s", REGISTER_NAME (val
));
1170 printf_filtered ("static storage at address ");
1171 print_address_numeric (load_addr
= SYMBOL_VALUE_ADDRESS (sym
),
1173 if (section_is_overlay (section
))
1175 load_addr
= overlay_unmapped_address (load_addr
, section
);
1176 printf_filtered (",\n -- loaded at ");
1177 print_address_numeric (load_addr
, 1, gdb_stdout
);
1178 printf_filtered (" in overlay section %s", section
->name
);
1183 printf_filtered ("external global (indirect addressing), at address *(");
1184 print_address_numeric (load_addr
= SYMBOL_VALUE_ADDRESS (sym
),
1186 printf_filtered (")");
1187 if (section_is_overlay (section
))
1189 load_addr
= overlay_unmapped_address (load_addr
, section
);
1190 printf_filtered (",\n -- loaded at ");
1191 print_address_numeric (load_addr
, 1, gdb_stdout
);
1192 printf_filtered (" in overlay section %s", section
->name
);
1197 printf_filtered ("an argument in register %s", REGISTER_NAME (val
));
1200 case LOC_REGPARM_ADDR
:
1201 printf_filtered ("address of an argument in register %s", REGISTER_NAME (val
));
1205 printf_filtered ("an argument at offset %ld", val
);
1209 printf_filtered ("an argument at frame offset %ld", val
);
1213 printf_filtered ("a local variable at frame offset %ld", val
);
1217 printf_filtered ("a reference argument at offset %ld", val
);
1221 printf_filtered ("a variable at offset %ld from register %s",
1222 val
, REGISTER_NAME (basereg
));
1225 case LOC_BASEREG_ARG
:
1226 printf_filtered ("an argument at offset %ld from register %s",
1227 val
, REGISTER_NAME (basereg
));
1231 printf_filtered ("a typedef");
1235 printf_filtered ("a function at address ");
1236 #ifdef GDB_TARGET_MASK_DISAS_PC
1237 print_address_numeric
1238 (load_addr
= GDB_TARGET_MASK_DISAS_PC (BLOCK_START (SYMBOL_BLOCK_VALUE (sym
))),
1241 print_address_numeric (load_addr
= BLOCK_START (SYMBOL_BLOCK_VALUE (sym
)),
1244 if (section_is_overlay (section
))
1246 load_addr
= overlay_unmapped_address (load_addr
, section
);
1247 printf_filtered (",\n -- loaded at ");
1248 print_address_numeric (load_addr
, 1, gdb_stdout
);
1249 printf_filtered (" in overlay section %s", section
->name
);
1253 case LOC_UNRESOLVED
:
1255 struct minimal_symbol
*msym
;
1257 msym
= lookup_minimal_symbol (SYMBOL_NAME (sym
), NULL
, NULL
);
1259 printf_filtered ("unresolved");
1262 section
= SYMBOL_BFD_SECTION (msym
);
1263 printf_filtered ("static storage at address ");
1264 print_address_numeric (load_addr
= SYMBOL_VALUE_ADDRESS (msym
),
1266 if (section_is_overlay (section
))
1268 load_addr
= overlay_unmapped_address (load_addr
, section
);
1269 printf_filtered (",\n -- loaded at ");
1270 print_address_numeric (load_addr
, 1, gdb_stdout
);
1271 printf_filtered (" in overlay section %s", section
->name
);
1277 case LOC_THREAD_LOCAL_STATIC
:
1279 "a thread-local variable at offset %ld from the thread base register %s",
1280 val
, REGISTER_NAME (basereg
));
1283 case LOC_OPTIMIZED_OUT
:
1284 printf_filtered ("optimized out");
1288 printf_filtered ("of unknown (botched) type");
1291 printf_filtered (".\n");
1295 x_command (char *exp
, int from_tty
)
1297 struct expression
*expr
;
1298 struct format_data fmt
;
1299 struct cleanup
*old_chain
;
1302 fmt
.format
= last_format
;
1303 fmt
.size
= last_size
;
1306 if (exp
&& *exp
== '/')
1309 fmt
= decode_format (&exp
, last_format
, last_size
);
1312 /* If we have an expression, evaluate it and use it as the address. */
1314 if (exp
!= 0 && *exp
!= 0)
1316 expr
= parse_expression (exp
);
1317 /* Cause expression not to be there any more
1318 if this command is repeated with Newline.
1319 But don't clobber a user-defined command's definition. */
1322 old_chain
= make_cleanup (free_current_contents
, &expr
);
1323 val
= evaluate_expression (expr
);
1324 if (TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_REF
)
1325 val
= value_ind (val
);
1326 /* In rvalue contexts, such as this, functions are coerced into
1327 pointers to functions. This makes "x/i main" work. */
1328 if (/* last_format == 'i' && */
1329 TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_FUNC
1330 && VALUE_LVAL (val
) == lval_memory
)
1331 next_address
= VALUE_ADDRESS (val
);
1333 next_address
= value_as_address (val
);
1334 if (VALUE_BFD_SECTION (val
))
1335 next_section
= VALUE_BFD_SECTION (val
);
1336 do_cleanups (old_chain
);
1339 do_examine (fmt
, next_address
, next_section
);
1341 /* If the examine succeeds, we remember its size and format for next time. */
1342 last_size
= fmt
.size
;
1343 last_format
= fmt
.format
;
1345 /* Set a couple of internal variables if appropriate. */
1346 if (last_examine_value
)
1348 /* Make last address examined available to the user as $_. Use
1349 the correct pointer type. */
1350 struct type
*pointer_type
1351 = lookup_pointer_type (VALUE_TYPE (last_examine_value
));
1352 set_internalvar (lookup_internalvar ("_"),
1353 value_from_pointer (pointer_type
,
1354 last_examine_address
));
1356 /* Make contents of last address examined available to the user as $__. */
1357 /* If the last value has not been fetched from memory then don't
1358 fetch it now - instead mark it by voiding the $__ variable. */
1359 if (VALUE_LAZY (last_examine_value
))
1360 set_internalvar (lookup_internalvar ("__"),
1361 allocate_value (builtin_type_void
));
1363 set_internalvar (lookup_internalvar ("__"), last_examine_value
);
1368 /* Add an expression to the auto-display chain.
1369 Specify the expression. */
1372 display_command (char *exp
, int from_tty
)
1374 struct format_data fmt
;
1375 register struct expression
*expr
;
1376 register struct display
*new;
1380 if (tui_version
&& *exp
== '$')
1381 display_it
= (tui_set_layout (exp
) == TUI_FAILURE
);
1395 fmt
= decode_format (&exp
, 0, 0);
1396 if (fmt
.size
&& fmt
.format
== 0)
1398 if (fmt
.format
== 'i' || fmt
.format
== 's')
1408 innermost_block
= 0;
1409 expr
= parse_expression (exp
);
1411 new = (struct display
*) xmalloc (sizeof (struct display
));
1414 new->block
= innermost_block
;
1415 new->next
= display_chain
;
1416 new->number
= ++display_number
;
1419 display_chain
= new;
1421 if (from_tty
&& target_has_execution
)
1422 do_one_display (new);
1429 free_display (struct display
*d
)
1435 /* Clear out the display_chain.
1436 Done when new symtabs are loaded, since this invalidates
1437 the types stored in many expressions. */
1440 clear_displays (void)
1442 register struct display
*d
;
1444 while ((d
= display_chain
) != NULL
)
1447 display_chain
= d
->next
;
1452 /* Delete the auto-display number NUM. */
1455 delete_display (int num
)
1457 register struct display
*d1
, *d
;
1460 error ("No display number %d.", num
);
1462 if (display_chain
->number
== num
)
1465 display_chain
= d1
->next
;
1469 for (d
= display_chain
;; d
= d
->next
)
1472 error ("No display number %d.", num
);
1473 if (d
->next
->number
== num
)
1483 /* Delete some values from the auto-display chain.
1484 Specify the element numbers. */
1487 undisplay_command (char *args
, int from_tty
)
1489 register char *p
= args
;
1495 if (query ("Delete all auto-display expressions? "))
1504 while (*p1
>= '0' && *p1
<= '9')
1506 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1507 error ("Arguments must be display numbers.");
1511 delete_display (num
);
1514 while (*p
== ' ' || *p
== '\t')
1520 /* Display a single auto-display.
1521 Do nothing if the display cannot be printed in the current context,
1522 or if the display is disabled. */
1525 do_one_display (struct display
*d
)
1527 int within_current_scope
;
1529 if (d
->enabled_p
== 0)
1533 within_current_scope
= contained_in (get_selected_block (0), d
->block
);
1535 within_current_scope
= 1;
1536 if (!within_current_scope
)
1539 current_display_number
= d
->number
;
1541 annotate_display_begin ();
1542 printf_filtered ("%d", d
->number
);
1543 annotate_display_number_end ();
1544 printf_filtered (": ");
1550 annotate_display_format ();
1552 printf_filtered ("x/");
1553 if (d
->format
.count
!= 1)
1554 printf_filtered ("%d", d
->format
.count
);
1555 printf_filtered ("%c", d
->format
.format
);
1556 if (d
->format
.format
!= 'i' && d
->format
.format
!= 's')
1557 printf_filtered ("%c", d
->format
.size
);
1558 printf_filtered (" ");
1560 annotate_display_expression ();
1562 print_expression (d
->exp
, gdb_stdout
);
1563 annotate_display_expression_end ();
1565 if (d
->format
.count
!= 1)
1566 printf_filtered ("\n");
1568 printf_filtered (" ");
1570 val
= evaluate_expression (d
->exp
);
1571 addr
= value_as_address (val
);
1572 if (d
->format
.format
== 'i')
1573 addr
= ADDR_BITS_REMOVE (addr
);
1575 annotate_display_value ();
1577 do_examine (d
->format
, addr
, VALUE_BFD_SECTION (val
));
1581 annotate_display_format ();
1583 if (d
->format
.format
)
1584 printf_filtered ("/%c ", d
->format
.format
);
1586 annotate_display_expression ();
1588 print_expression (d
->exp
, gdb_stdout
);
1589 annotate_display_expression_end ();
1591 printf_filtered (" = ");
1593 annotate_display_expression ();
1595 print_formatted (evaluate_expression (d
->exp
),
1596 d
->format
.format
, d
->format
.size
, gdb_stdout
);
1597 printf_filtered ("\n");
1600 annotate_display_end ();
1602 gdb_flush (gdb_stdout
);
1603 current_display_number
= -1;
1606 /* Display all of the values on the auto-display chain which can be
1607 evaluated in the current scope. */
1612 register struct display
*d
;
1614 for (d
= display_chain
; d
; d
= d
->next
)
1618 /* Delete the auto-display which we were in the process of displaying.
1619 This is done when there is an error or a signal. */
1622 disable_display (int num
)
1624 register struct display
*d
;
1626 for (d
= display_chain
; d
; d
= d
->next
)
1627 if (d
->number
== num
)
1632 printf_unfiltered ("No display number %d.\n", num
);
1636 disable_current_display (void)
1638 if (current_display_number
>= 0)
1640 disable_display (current_display_number
);
1641 fprintf_unfiltered (gdb_stderr
, "Disabling display %d to avoid infinite recursion.\n",
1642 current_display_number
);
1644 current_display_number
= -1;
1648 display_info (char *ignore
, int from_tty
)
1650 register struct display
*d
;
1653 printf_unfiltered ("There are no auto-display expressions now.\n");
1655 printf_filtered ("Auto-display expressions now in effect:\n\
1656 Num Enb Expression\n");
1658 for (d
= display_chain
; d
; d
= d
->next
)
1660 printf_filtered ("%d: %c ", d
->number
, "ny"[(int) d
->enabled_p
]);
1662 printf_filtered ("/%d%c%c ", d
->format
.count
, d
->format
.size
,
1664 else if (d
->format
.format
)
1665 printf_filtered ("/%c ", d
->format
.format
);
1666 print_expression (d
->exp
, gdb_stdout
);
1667 if (d
->block
&& !contained_in (get_selected_block (0), d
->block
))
1668 printf_filtered (" (cannot be evaluated in the current context)");
1669 printf_filtered ("\n");
1670 gdb_flush (gdb_stdout
);
1675 enable_display (char *args
, int from_tty
)
1677 register char *p
= args
;
1680 register struct display
*d
;
1684 for (d
= display_chain
; d
; d
= d
->next
)
1691 while (*p1
>= '0' && *p1
<= '9')
1693 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1694 error ("Arguments must be display numbers.");
1698 for (d
= display_chain
; d
; d
= d
->next
)
1699 if (d
->number
== num
)
1704 printf_unfiltered ("No display number %d.\n", num
);
1707 while (*p
== ' ' || *p
== '\t')
1714 disable_display_command (char *args
, int from_tty
)
1716 register char *p
= args
;
1718 register struct display
*d
;
1722 for (d
= display_chain
; d
; d
= d
->next
)
1729 while (*p1
>= '0' && *p1
<= '9')
1731 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1732 error ("Arguments must be display numbers.");
1734 disable_display (atoi (p
));
1737 while (*p
== ' ' || *p
== '\t')
1743 /* Print the value in stack frame FRAME of a variable
1744 specified by a struct symbol. */
1747 print_variable_value (struct symbol
*var
, struct frame_info
*frame
,
1748 struct ui_file
*stream
)
1750 struct value
*val
= read_var_value (var
, frame
);
1752 value_print (val
, stream
, 0, Val_pretty_default
);
1755 /* Print the arguments of a stack frame, given the function FUNC
1756 running in that frame (as a symbol), the info on the frame,
1757 and the number of args according to the stack frame (or -1 if unknown). */
1759 /* References here and elsewhere to "number of args according to the
1760 stack frame" appear in all cases to refer to "number of ints of args
1761 according to the stack frame". At least for VAX, i386, isi. */
1764 print_frame_args (struct symbol
*func
, struct frame_info
*fi
, int num
,
1765 struct ui_file
*stream
)
1767 struct block
*b
= NULL
;
1770 register struct symbol
*sym
;
1772 /* Offset of next stack argument beyond the one we have seen that is
1773 at the highest offset.
1774 -1 if we haven't come to a stack argument yet. */
1775 long highest_offset
= -1;
1777 /* Number of ints of arguments that we have printed so far. */
1778 int args_printed
= 0;
1779 struct cleanup
*old_chain
, *list_chain
;
1780 struct ui_stream
*stb
;
1782 stb
= ui_out_stream_new (uiout
);
1783 old_chain
= make_cleanup_ui_out_stream_delete (stb
);
1787 b
= SYMBOL_BLOCK_VALUE (func
);
1788 ALL_BLOCK_SYMBOLS (b
, i
, sym
)
1792 /* Keep track of the highest stack argument offset seen, and
1793 skip over any kinds of symbols we don't care about. */
1795 switch (SYMBOL_CLASS (sym
))
1800 long current_offset
= SYMBOL_VALUE (sym
);
1801 arg_size
= TYPE_LENGTH (SYMBOL_TYPE (sym
));
1803 /* Compute address of next argument by adding the size of
1804 this argument and rounding to an int boundary. */
1806 ((current_offset
+ arg_size
+ sizeof (int) - 1)
1807 & ~(sizeof (int) - 1));
1809 /* If this is the highest offset seen yet, set highest_offset. */
1810 if (highest_offset
== -1
1811 || (current_offset
> highest_offset
))
1812 highest_offset
= current_offset
;
1814 /* Add the number of ints we're about to print to args_printed. */
1815 args_printed
+= (arg_size
+ sizeof (int) - 1) / sizeof (int);
1818 /* We care about types of symbols, but don't need to keep track of
1819 stack offsets in them. */
1821 case LOC_REGPARM_ADDR
:
1823 case LOC_BASEREG_ARG
:
1826 /* Other types of symbols we just skip over. */
1831 /* We have to look up the symbol because arguments can have
1832 two entries (one a parameter, one a local) and the one we
1833 want is the local, which lookup_symbol will find for us.
1834 This includes gcc1 (not gcc2) on the sparc when passing a
1835 small structure and gcc2 when the argument type is float
1836 and it is passed as a double and converted to float by
1837 the prologue (in the latter case the type of the LOC_ARG
1838 symbol is double and the type of the LOC_LOCAL symbol is
1840 /* But if the parameter name is null, don't try it.
1841 Null parameter names occur on the RS/6000, for traceback tables.
1842 FIXME, should we even print them? */
1844 if (*SYMBOL_NAME (sym
))
1846 struct symbol
*nsym
;
1847 nsym
= lookup_symbol
1849 b
, VAR_NAMESPACE
, (int *) NULL
, (struct symtab
**) NULL
);
1850 if (SYMBOL_CLASS (nsym
) == LOC_REGISTER
)
1852 /* There is a LOC_ARG/LOC_REGISTER pair. This means that
1853 it was passed on the stack and loaded into a register,
1854 or passed in a register and stored in a stack slot.
1855 GDB 3.x used the LOC_ARG; GDB 4.0-4.11 used the LOC_REGISTER.
1857 Reasons for using the LOC_ARG:
1858 (1) because find_saved_registers may be slow for remote
1860 (2) because registers are often re-used and stack slots
1861 rarely (never?) are. Therefore using the stack slot is
1862 much less likely to print garbage.
1864 Reasons why we might want to use the LOC_REGISTER:
1865 (1) So that the backtrace prints the same value as
1866 "print foo". I see no compelling reason why this needs
1867 to be the case; having the backtrace print the value which
1868 was passed in, and "print foo" print the value as modified
1869 within the called function, makes perfect sense to me.
1871 Additional note: It might be nice if "info args" displayed
1873 One more note: There is a case with sparc structure passing
1874 where we need to use the LOC_REGISTER, but this is dealt with
1875 by creating a single LOC_REGPARM in symbol reading. */
1877 /* Leave sym (the LOC_ARG) alone. */
1884 /* Print the current arg. */
1886 ui_out_text (uiout
, ", ");
1887 ui_out_wrap_hint (uiout
, " ");
1889 annotate_arg_begin ();
1891 list_chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, NULL
);
1892 fprintf_symbol_filtered (stb
->stream
, SYMBOL_SOURCE_NAME (sym
),
1893 SYMBOL_LANGUAGE (sym
), DMGL_PARAMS
| DMGL_ANSI
);
1894 ui_out_field_stream (uiout
, "name", stb
);
1895 annotate_arg_name_end ();
1896 ui_out_text (uiout
, "=");
1898 /* Avoid value_print because it will deref ref parameters. We just
1899 want to print their addresses. Print ??? for args whose address
1900 we do not know. We pass 2 as "recurse" to val_print because our
1901 standard indentation here is 4 spaces, and val_print indents
1902 2 for each recurse. */
1903 val
= read_var_value (sym
, fi
);
1905 annotate_arg_value (val
== NULL
? NULL
: VALUE_TYPE (val
));
1909 val_print (VALUE_TYPE (val
), VALUE_CONTENTS (val
), 0,
1910 VALUE_ADDRESS (val
),
1911 stb
->stream
, 0, 0, 2, Val_no_prettyprint
);
1912 ui_out_field_stream (uiout
, "value", stb
);
1915 ui_out_text (uiout
, "???");
1917 /* Invoke ui_out_tuple_end. */
1918 do_cleanups (list_chain
);
1920 annotate_arg_end ();
1926 /* Don't print nameless args in situations where we don't know
1927 enough about the stack to find them. */
1932 if (highest_offset
== -1)
1933 start
= FRAME_ARGS_SKIP
;
1935 start
= highest_offset
;
1937 print_frame_nameless_args (fi
, start
, num
- args_printed
,
1940 do_cleanups (old_chain
);
1943 /* Print nameless args on STREAM.
1944 FI is the frameinfo for this frame, START is the offset
1945 of the first nameless arg, and NUM is the number of nameless args to
1946 print. FIRST is nonzero if this is the first argument (not just
1947 the first nameless arg). */
1950 print_frame_nameless_args (struct frame_info
*fi
, long start
, int num
,
1951 int first
, struct ui_file
*stream
)
1957 for (i
= 0; i
< num
; i
++)
1960 #ifdef NAMELESS_ARG_VALUE
1961 NAMELESS_ARG_VALUE (fi
, start
, &arg_value
);
1963 argsaddr
= FRAME_ARGS_ADDRESS (fi
);
1967 arg_value
= read_memory_integer (argsaddr
+ start
, sizeof (int));
1971 fprintf_filtered (stream
, ", ");
1973 #ifdef PRINT_NAMELESS_INTEGER
1974 PRINT_NAMELESS_INTEGER (stream
, arg_value
);
1976 #ifdef PRINT_TYPELESS_INTEGER
1977 PRINT_TYPELESS_INTEGER (stream
, builtin_type_int
, (LONGEST
) arg_value
);
1979 fprintf_filtered (stream
, "%ld", arg_value
);
1980 #endif /* PRINT_TYPELESS_INTEGER */
1981 #endif /* PRINT_NAMELESS_INTEGER */
1983 start
+= sizeof (int);
1989 printf_command (char *arg
, int from_tty
)
1991 register char *f
= NULL
;
1992 register char *s
= arg
;
1993 char *string
= NULL
;
1994 struct value
**val_args
;
1996 char *current_substring
;
1998 int allocated_args
= 20;
1999 struct cleanup
*old_cleanups
;
2001 val_args
= (struct value
**) xmalloc (allocated_args
2002 * sizeof (struct value
*));
2003 old_cleanups
= make_cleanup (free_current_contents
, &val_args
);
2006 error_no_arg ("format-control string and values to print");
2008 /* Skip white space before format string */
2009 while (*s
== ' ' || *s
== '\t')
2012 /* A format string should follow, enveloped in double quotes */
2014 error ("Bad format string, missing '\"'.");
2016 /* Parse the format-control string and copy it into the string STRING,
2017 processing some kinds of escape sequence. */
2019 f
= string
= (char *) alloca (strlen (s
) + 1);
2027 error ("Bad format string, non-terminated '\"'.");
2060 /* ??? TODO: handle other escape sequences */
2061 error ("Unrecognized escape character \\%c in format string.",
2071 /* Skip over " and following space and comma. */
2074 while (*s
== ' ' || *s
== '\t')
2077 if (*s
!= ',' && *s
!= 0)
2078 error ("Invalid argument syntax");
2082 while (*s
== ' ' || *s
== '\t')
2085 /* Need extra space for the '\0's. Doubling the size is sufficient. */
2086 substrings
= alloca (strlen (string
) * 2);
2087 current_substring
= substrings
;
2090 /* Now scan the string for %-specs and see what kinds of args they want.
2091 argclass[I] classifies the %-specs so we can give printf_filtered
2092 something of the right size. */
2096 no_arg
, int_arg
, string_arg
, double_arg
, long_long_arg
2098 enum argclass
*argclass
;
2099 enum argclass this_argclass
;
2105 argclass
= (enum argclass
*) alloca (strlen (s
) * sizeof *argclass
);
2113 while (strchr ("0123456789.hlL-+ #", *f
))
2115 if (*f
== 'l' || *f
== 'L')
2122 this_argclass
= string_arg
;
2128 this_argclass
= double_arg
;
2132 error ("`*' not supported for precision or width in printf");
2135 error ("Format specifier `n' not supported in printf");
2138 this_argclass
= no_arg
;
2143 this_argclass
= long_long_arg
;
2145 this_argclass
= int_arg
;
2149 if (this_argclass
!= no_arg
)
2151 strncpy (current_substring
, last_arg
, f
- last_arg
);
2152 current_substring
+= f
- last_arg
;
2153 *current_substring
++ = '\0';
2155 argclass
[nargs_wanted
++] = this_argclass
;
2159 /* Now, parse all arguments and evaluate them.
2160 Store the VALUEs in VAL_ARGS. */
2165 if (nargs
== allocated_args
)
2166 val_args
= (struct value
**) xrealloc ((char *) val_args
,
2167 (allocated_args
*= 2)
2168 * sizeof (struct value
*));
2170 val_args
[nargs
] = parse_to_comma_and_eval (&s1
);
2172 /* If format string wants a float, unchecked-convert the value to
2173 floating point of the same size */
2175 if (argclass
[nargs
] == double_arg
)
2177 struct type
*type
= VALUE_TYPE (val_args
[nargs
]);
2178 if (TYPE_LENGTH (type
) == sizeof (float))
2179 VALUE_TYPE (val_args
[nargs
]) = builtin_type_float
;
2180 if (TYPE_LENGTH (type
) == sizeof (double))
2181 VALUE_TYPE (val_args
[nargs
]) = builtin_type_double
;
2189 if (nargs
!= nargs_wanted
)
2190 error ("Wrong number of arguments for specified format-string");
2192 /* Now actually print them. */
2193 current_substring
= substrings
;
2194 for (i
= 0; i
< nargs
; i
++)
2196 switch (argclass
[i
])
2203 tem
= value_as_address (val_args
[i
]);
2205 /* This is a %s argument. Find the length of the string. */
2210 read_memory (tem
+ j
, &c
, 1);
2215 /* Copy the string contents into a string inside GDB. */
2216 str
= (char *) alloca (j
+ 1);
2218 read_memory (tem
, str
, j
);
2221 printf_filtered (current_substring
, str
);
2226 double val
= value_as_double (val_args
[i
]);
2227 printf_filtered (current_substring
, val
);
2231 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
2233 long long val
= value_as_long (val_args
[i
]);
2234 printf_filtered (current_substring
, val
);
2238 error ("long long not supported in printf");
2242 /* FIXME: there should be separate int_arg and long_arg. */
2243 long val
= value_as_long (val_args
[i
]);
2244 printf_filtered (current_substring
, val
);
2247 default: /* purecov: deadcode */
2248 error ("internal error in printf_command"); /* purecov: deadcode */
2250 /* Skip to the next substring. */
2251 current_substring
+= strlen (current_substring
) + 1;
2253 /* Print the portion of the format string after the last argument. */
2254 printf_filtered (last_arg
);
2256 do_cleanups (old_cleanups
);
2259 /* Dump a specified section of assembly code. With no command line
2260 arguments, this command will dump the assembly code for the
2261 function surrounding the pc value in the selected frame. With one
2262 argument, it will dump the assembly code surrounding that pc value.
2263 Two arguments are interpeted as bounds within which to dump
2268 disassemble_command (char *arg
, int from_tty
)
2270 CORE_ADDR low
, high
;
2272 CORE_ADDR pc
, pc_masked
;
2281 if (!selected_frame
)
2282 error ("No frame selected.\n");
2284 pc
= get_frame_pc (selected_frame
);
2285 if (find_pc_partial_function (pc
, &name
, &low
, &high
) == 0)
2286 error ("No function contains program counter for selected frame.\n");
2288 else if (tui_version
)
2289 low
= tuiGetLowDisassemblyAddress (low
, pc
);
2291 low
+= FUNCTION_START_OFFSET
;
2293 else if (!(space_index
= (char *) strchr (arg
, ' ')))
2296 pc
= parse_and_eval_address (arg
);
2297 if (find_pc_partial_function (pc
, &name
, &low
, &high
) == 0)
2298 error ("No function contains specified address.\n");
2300 else if (tui_version
)
2301 low
= tuiGetLowDisassemblyAddress (low
, pc
);
2303 low
+= FUNCTION_START_OFFSET
;
2307 /* Two arguments. */
2308 *space_index
= '\0';
2309 low
= parse_and_eval_address (arg
);
2310 high
= parse_and_eval_address (space_index
+ 1);
2314 if (!tui_is_window_visible (DISASSEM_WIN
))
2317 printf_filtered ("Dump of assembler code ");
2320 printf_filtered ("for function %s:\n", name
);
2324 printf_filtered ("from ");
2325 print_address_numeric (low
, 1, gdb_stdout
);
2326 printf_filtered (" to ");
2327 print_address_numeric (high
, 1, gdb_stdout
);
2328 printf_filtered (":\n");
2331 /* Dump the specified range. */
2334 #ifdef GDB_TARGET_MASK_DISAS_PC
2335 pc_masked
= GDB_TARGET_MASK_DISAS_PC (pc
);
2340 while (pc_masked
< high
)
2343 print_address (pc_masked
, gdb_stdout
);
2344 printf_filtered (":\t");
2345 /* We often wrap here if there are long symbolic names. */
2347 pc
+= print_insn (pc
, gdb_stdout
);
2348 printf_filtered ("\n");
2350 #ifdef GDB_TARGET_MASK_DISAS_PC
2351 pc_masked
= GDB_TARGET_MASK_DISAS_PC (pc
);
2356 printf_filtered ("End of assembler dump.\n");
2357 gdb_flush (gdb_stdout
);
2362 tui_show_assembly (low
);
2367 /* Print the instruction at address MEMADDR in debugged memory,
2368 on STREAM. Returns length of the instruction, in bytes. */
2371 print_insn (CORE_ADDR memaddr
, struct ui_file
*stream
)
2373 if (TARGET_BYTE_ORDER
== BFD_ENDIAN_BIG
)
2374 TARGET_PRINT_INSN_INFO
->endian
= BFD_ENDIAN_BIG
;
2376 TARGET_PRINT_INSN_INFO
->endian
= BFD_ENDIAN_LITTLE
;
2378 if (TARGET_ARCHITECTURE
!= NULL
)
2379 TARGET_PRINT_INSN_INFO
->mach
= TARGET_ARCHITECTURE
->mach
;
2380 /* else: should set .mach=0 but some disassemblers don't grok this */
2382 TARGET_PRINT_INSN_INFO
->stream
= stream
;
2384 return TARGET_PRINT_INSN (memaddr
, TARGET_PRINT_INSN_INFO
);
2389 _initialize_printcmd (void)
2391 struct cmd_list_element
*c
;
2393 current_display_number
= -1;
2395 add_info ("address", address_info
,
2396 "Describe where symbol SYM is stored.");
2398 add_info ("symbol", sym_info
,
2399 "Describe what symbol is at location ADDR.\n\
2400 Only for symbols with fixed locations (global or static scope).");
2402 add_com ("x", class_vars
, x_command
,
2403 concat ("Examine memory: x/FMT ADDRESS.\n\
2404 ADDRESS is an expression for the memory address to examine.\n\
2405 FMT is a repeat count followed by a format letter and a size letter.\n\
2406 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
2407 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n",
2408 "Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
2409 The specified number of objects of the specified size are printed\n\
2410 according to the format.\n\n\
2411 Defaults for format and size letters are those previously used.\n\
2412 Default count is 1. Default address is following last thing printed\n\
2413 with this command or \"print\".", NULL
));
2415 c
= add_com ("disassemble", class_vars
, disassemble_command
,
2416 "Disassemble a specified section of memory.\n\
2417 Default is the function surrounding the pc of the selected frame.\n\
2418 With a single argument, the function surrounding that address is dumped.\n\
2419 Two arguments are taken as a range of memory to dump.");
2420 set_cmd_completer (c
, location_completer
);
2422 add_com_alias ("va", "disassemble", class_xdb
, 0);
2425 add_com ("whereis", class_vars
, whereis_command
,
2426 "Print line number and file of definition of variable.");
2429 add_info ("display", display_info
,
2430 "Expressions to display when program stops, with code numbers.");
2432 add_cmd ("undisplay", class_vars
, undisplay_command
,
2433 "Cancel some expressions to be displayed when program stops.\n\
2434 Arguments are the code numbers of the expressions to stop displaying.\n\
2435 No argument means cancel all automatic-display expressions.\n\
2436 \"delete display\" has the same effect as this command.\n\
2437 Do \"info display\" to see current list of code numbers.",
2440 add_com ("display", class_vars
, display_command
,
2441 "Print value of expression EXP each time the program stops.\n\
2442 /FMT may be used before EXP as in the \"print\" command.\n\
2443 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2444 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2445 and examining is done as in the \"x\" command.\n\n\
2446 With no argument, display all currently requested auto-display expressions.\n\
2447 Use \"undisplay\" to cancel display requests previously made."
2450 add_cmd ("display", class_vars
, enable_display
,
2451 "Enable some expressions to be displayed when program stops.\n\
2452 Arguments are the code numbers of the expressions to resume displaying.\n\
2453 No argument means enable all automatic-display expressions.\n\
2454 Do \"info display\" to see current list of code numbers.", &enablelist
);
2456 add_cmd ("display", class_vars
, disable_display_command
,
2457 "Disable some expressions to be displayed when program stops.\n\
2458 Arguments are the code numbers of the expressions to stop displaying.\n\
2459 No argument means disable all automatic-display expressions.\n\
2460 Do \"info display\" to see current list of code numbers.", &disablelist
);
2462 add_cmd ("display", class_vars
, undisplay_command
,
2463 "Cancel some expressions to be displayed when program stops.\n\
2464 Arguments are the code numbers of the expressions to stop displaying.\n\
2465 No argument means cancel all automatic-display expressions.\n\
2466 Do \"info display\" to see current list of code numbers.", &deletelist
);
2468 add_com ("printf", class_vars
, printf_command
,
2469 "printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2470 This is useful for formatted output in user-defined commands.");
2472 add_com ("output", class_vars
, output_command
,
2473 "Like \"print\" but don't put in value history and don't print newline.\n\
2474 This is useful in user-defined commands.");
2476 add_prefix_cmd ("set", class_vars
, set_command
,
2477 concat ("Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2478 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2479 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2480 with $), a register (a few standard names starting with $), or an actual\n\
2481 variable in the program being debugged. EXP is any valid expression.\n",
2482 "Use \"set variable\" for variables with names identical to set subcommands.\n\
2483 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2484 You can see these environment settings with the \"show\" command.", NULL
),
2485 &setlist
, "set ", 1, &cmdlist
);
2487 add_com ("assign", class_vars
, set_command
, concat ("Evaluate expression \
2488 EXP and assign result to variable VAR, using assignment\n\
2489 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2490 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2491 with $), a register (a few standard names starting with $), or an actual\n\
2492 variable in the program being debugged. EXP is any valid expression.\n",
2493 "Use \"set variable\" for variables with names identical to set subcommands.\n\
2494 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2495 You can see these environment settings with the \"show\" command.", NULL
));
2497 /* "call" is the same as "set", but handy for dbx users to call fns. */
2498 c
= add_com ("call", class_vars
, call_command
,
2499 "Call a function in the program.\n\
2500 The argument is the function name and arguments, in the notation of the\n\
2501 current working language. The result is printed and saved in the value\n\
2502 history, if it is not void.");
2503 set_cmd_completer (c
, location_completer
);
2505 add_cmd ("variable", class_vars
, set_command
,
2506 "Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2507 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2508 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2509 with $), a register (a few standard names starting with $), or an actual\n\
2510 variable in the program being debugged. EXP is any valid expression.\n\
2511 This may usually be abbreviated to simply \"set\".",
2514 c
= add_com ("print", class_vars
, print_command
,
2515 concat ("Print value of expression EXP.\n\
2516 Variables accessible are those of the lexical environment of the selected\n\
2517 stack frame, plus all those whose scope is global or an entire file.\n\
2519 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2520 $$NUM refers to NUM'th value back from the last one.\n\
2521 Names starting with $ refer to registers (with the values they would have\n",
2522 "if the program were to return to the stack frame now selected, restoring\n\
2523 all registers saved by frames farther in) or else to debugger\n\
2524 \"convenience\" variables (any such name not a known register).\n\
2525 Use assignment expressions to give values to convenience variables.\n",
2527 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2528 @ is a binary operator for treating consecutive data objects\n\
2529 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2530 element is FOO, whose second element is stored in the space following\n\
2531 where FOO is stored, etc. FOO must be an expression whose value\n\
2532 resides in memory.\n",
2534 EXP may be preceded with /FMT, where FMT is a format letter\n\
2535 but no count or size letter (see \"x\" command).", NULL
));
2536 set_cmd_completer (c
, location_completer
);
2537 add_com_alias ("p", "print", class_vars
, 1);
2539 c
= add_com ("inspect", class_vars
, inspect_command
,
2540 "Same as \"print\" command, except that if you are running in the epoch\n\
2541 environment, the value is printed in its own window.");
2542 set_cmd_completer (c
, location_completer
);
2545 add_set_cmd ("max-symbolic-offset", no_class
, var_uinteger
,
2546 (char *) &max_symbolic_offset
,
2547 "Set the largest offset that will be printed in <symbol+1234> form.",
2551 add_set_cmd ("symbol-filename", no_class
, var_boolean
,
2552 (char *) &print_symbol_filename
,
2553 "Set printing of source filename and line number with <symbol>.",
2557 /* For examine/instruction a single byte quantity is specified as
2558 the data. This avoids problems with value_at_lazy() requiring a
2559 valid data type (and rejecting VOID). */
2560 examine_i_type
= init_type (TYPE_CODE_INT
, 1, 0, "examine_i_type", NULL
);
2562 examine_b_type
= init_type (TYPE_CODE_INT
, 1, 0, "examine_b_type", NULL
);
2563 examine_h_type
= init_type (TYPE_CODE_INT
, 2, 0, "examine_h_type", NULL
);
2564 examine_w_type
= init_type (TYPE_CODE_INT
, 4, 0, "examine_w_type", NULL
);
2565 examine_g_type
= init_type (TYPE_CODE_INT
, 8, 0, "examine_g_type", NULL
);