1 /* Print values for GNU debugger GDB.
2 Copyright 1986, 1987, 1988, 1989, 1990, 1991 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
27 #include "expression.h"
31 #include "breakpoint.h"
34 /* These are just for containing_function_bounds. It might be better
35 to move containing_function_bounds to blockframe.c or thereabouts. */
40 extern int asm_demangle
; /* Whether to demangle syms in asm printouts */
41 extern int addressprint
; /* Whether to print hex addresses in HLL " */
50 /* Last specified output format. */
52 static char last_format
= 'x';
54 /* Last specified examination size. 'b', 'h', 'w' or `q'. */
56 static char last_size
= 'w';
58 /* Default address to examine next. */
60 static CORE_ADDR next_address
;
62 /* Last address examined. */
64 static CORE_ADDR last_examine_address
;
66 /* Contents of last address examined.
67 This is not valid past the end of the `x' command! */
69 static value last_examine_value
;
71 /* Largest offset between a symbolic value and an address, that will be
72 printed as `0x1234 <symbol+offset>'. */
74 static unsigned int max_symbolic_offset
= UINT_MAX
;
76 /* Number of auto-display expression currently being displayed.
77 So that we can disable it if we get an error or a signal within it.
78 -1 when not doing one. */
80 int current_display_number
;
82 /* Flag to low-level print routines that this value is being printed
83 in an epoch window. We'd like to pass this as a parameter, but
84 every routine would need to take it. Perhaps we can encapsulate
85 this in the I/O stream once we have GNU stdio. */
91 /* Chain link to next auto-display item. */
93 /* Expression to be evaluated and displayed. */
94 struct expression
*exp
;
95 /* Item number of this auto-display item. */
97 /* Display format specified. */
98 struct format_data format
;
99 /* Innermost block required by this expression when evaluated */
101 /* Status of this display (enabled or disabled) */
105 /* Chain of expressions whose values should be displayed
106 automatically each time the program stops. */
108 static struct display
*display_chain
;
110 static int display_number
;
112 /* Prototypes for local functions */
115 delete_display
PARAMS ((int));
118 enable_display
PARAMS ((char *, int));
121 disable_display_command
PARAMS ((char *, int));
124 disassemble_command
PARAMS ((char *, int));
127 containing_function_bounds
PARAMS ((CORE_ADDR
, CORE_ADDR
*, CORE_ADDR
*));
130 printf_command
PARAMS ((char *, int));
133 print_frame_nameless_args
PARAMS ((struct frame_info
*, long, int, int,
137 display_info
PARAMS ((char *, int));
140 do_one_display
PARAMS ((struct display
*));
143 undisplay_command
PARAMS ((char *, int));
146 free_display
PARAMS ((struct display
*));
149 display_command
PARAMS ((char *, int));
152 x_command
PARAMS ((char *, int));
155 address_info
PARAMS ((char *, int));
158 set_command
PARAMS ((char *, int));
161 output_command
PARAMS ((char *, int));
164 call_command
PARAMS ((char *, int));
167 inspect_command
PARAMS ((char *, int));
170 print_command
PARAMS ((char *, int));
173 print_command_1
PARAMS ((char *, int, int));
176 validate_format
PARAMS ((struct format_data
, char *));
179 do_examine
PARAMS ((struct format_data
, CORE_ADDR
));
182 print_formatted
PARAMS ((value
, int, int));
184 static struct format_data
185 decode_format
PARAMS ((char **, int, int));
188 /* Decode a format specification. *STRING_PTR should point to it.
189 OFORMAT and OSIZE are used as defaults for the format and size
190 if none are given in the format specification.
191 If OSIZE is zero, then the size field of the returned value
192 should be set only if a size is explicitly specified by the
194 The structure returned describes all the data
195 found in the specification. In addition, *STRING_PTR is advanced
196 past the specification and past all whitespace following it. */
198 static struct format_data
199 decode_format (string_ptr
, oformat
, osize
)
204 struct format_data val
;
205 register char *p
= *string_ptr
;
211 if (*p
>= '0' && *p
<= '9')
212 val
.count
= atoi (p
);
213 while (*p
>= '0' && *p
<= '9') p
++;
215 /* Now process size or format letters that follow. */
219 if (*p
== 'b' || *p
== 'h' || *p
== 'w' || *p
== 'g')
228 else if (*p
>= 'a' && *p
<= 'z')
235 /* Make sure 'g' size is not used on integer types.
236 Well, actually, we can handle hex. */
237 if (val
.size
== 'g' && val
.format
!= 'f' && val
.format
!= 'x')
241 while (*p
== ' ' || *p
== '\t') p
++;
244 /* Set defaults for format and size if not specified. */
245 if (val
.format
== '?')
249 /* Neither has been specified. */
250 val
.format
= oformat
;
254 /* If a size is specified, any format makes a reasonable
255 default except 'i'. */
256 val
.format
= oformat
== 'i' ? 'x' : oformat
;
258 else if (val
.size
== '?')
263 /* Addresses must be words. */
264 val
.size
= osize
? 'w' : osize
;
267 /* Floating point has to be word or giantword. */
268 if (osize
== 'w' || osize
== 'g')
271 /* Default it to giantword if the last used size is not
273 val
.size
= osize
? 'g' : osize
;
276 /* Characters default to one byte. */
277 val
.size
= osize
? 'b' : osize
;
280 /* The default is the size most recently specified. */
287 /* Print value VAL on stdout according to FORMAT, a letter or 0.
288 Do not end with a newline.
289 0 means print VAL according to its own type.
290 SIZE is the letter for the size of datum being printed.
291 This is used to pad hex numbers so they line up. */
294 print_formatted (val
, format
, size
)
299 int len
= TYPE_LENGTH (VALUE_TYPE (val
));
301 if (VALUE_LVAL (val
) == lval_memory
)
302 next_address
= VALUE_ADDRESS (val
) + len
;
307 next_address
= VALUE_ADDRESS (val
)
308 + value_print (value_addr (val
), stdout
, format
, Val_pretty_default
);
312 wrap_here (""); /* Force output out, print_insn not using _filtered */
313 next_address
= VALUE_ADDRESS (val
)
314 + print_insn (VALUE_ADDRESS (val
), stdout
);
319 || TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_ARRAY
320 || TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_STRING
321 || TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_STRUCT
322 || TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_UNION
323 || VALUE_REPEATED (val
))
324 value_print (val
, stdout
, format
, Val_pretty_default
);
326 print_scalar_formatted (VALUE_CONTENTS (val
), VALUE_TYPE (val
),
327 format
, size
, stdout
);
331 /* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
332 according to letters FORMAT and SIZE on STREAM.
333 FORMAT may not be zero. Formats s and i are not supported at this level.
335 This is how the elements of an array or structure are printed
339 print_scalar_formatted (valaddr
, type
, format
, size
, stream
)
347 int len
= TYPE_LENGTH (type
);
349 if (size
== 'g' && sizeof (LONGEST
) < 8
352 /* ok, we're going to have to get fancy here. Assumption: a
353 long is four bytes. FIXME. */
354 unsigned long v1
, v2
;
356 v1
= unpack_long (builtin_type_long
, valaddr
);
357 v2
= unpack_long (builtin_type_long
, valaddr
+ 4);
359 #if TARGET_BYTE_ORDER == LITTLE_ENDIAN
360 /* Swap the two for printing */
373 fprintf_filtered (stream
, local_hex_format_custom("08x%08"), v1
, v2
);
376 error ("Output size \"g\" unimplemented for format \"%c\".",
382 val_long
= unpack_long (type
, valaddr
);
384 /* If value is unsigned, truncate it in case negative. */
387 if (len
== sizeof (char))
388 val_long
&= (1 << 8 * sizeof(char)) - 1;
389 else if (len
== sizeof (short))
390 val_long
&= (1 << 8 * sizeof(short)) - 1;
391 else if (len
== sizeof (long))
392 val_long
&= (unsigned long) - 1;
400 /* no size specified, like in print. Print varying # of digits. */
401 #if defined (LONG_LONG)
402 fprintf_filtered (stream
, local_hex_format_custom("ll"), val_long
);
403 #else /* not LONG_LONG. */
404 fprintf_filtered (stream
, local_hex_format_custom("l"), val_long
);
405 #endif /* not LONG_LONG. */
408 #if defined (LONG_LONG)
412 fprintf_filtered (stream
, local_hex_format_custom("02ll"), val_long
);
415 fprintf_filtered (stream
, local_hex_format_custom("04ll"), val_long
);
418 fprintf_filtered (stream
, local_hex_format_custom("08ll"), val_long
);
421 fprintf_filtered (stream
, local_hex_format_custom("016ll"), val_long
);
424 error ("Undefined output size \"%c\".", size
);
426 #else /* not LONG_LONG. */
430 fprintf_filtered (stream
, local_hex_format_custom("02"), val_long
);
433 fprintf_filtered (stream
, local_hex_format_custom("04"), val_long
);
436 fprintf_filtered (stream
, local_hex_format_custom("08"), val_long
);
439 fprintf_filtered (stream
, local_hex_format_custom("016"), val_long
);
442 error ("Undefined output size \"%c\".", size
);
444 #endif /* not LONG_LONG */
449 fprintf_filtered (stream
, local_decimal_format_custom("ll"), val_long
);
451 fprintf_filtered (stream
, local_decimal_format(), val_long
);
457 fprintf_filtered (stream
, "%llu", val_long
);
459 fprintf_filtered (stream
, "%u", val_long
);
466 fprintf_filtered (stream
, local_octal_format_custom("ll"), val_long
);
468 fprintf_filtered (stream
, local_octal_format(), val_long
);
471 fprintf_filtered (stream
, "0");
475 print_address (unpack_pointer (type
, valaddr
), stream
);
479 value_print (value_from_longest (builtin_type_char
, val_long
), stream
, 0,
484 if (len
== sizeof (float))
485 type
= builtin_type_float
;
486 else if (len
== sizeof (double))
487 type
= builtin_type_double
;
488 print_floating (valaddr
, type
, stream
);
495 /* Binary; 't' stands for "two". */
497 char bits
[8*(sizeof val_long
) + 1];
502 width
= 8*(sizeof val_long
);
519 error ("Undefined output size \"%c\".", size
);
525 bits
[width
] = (val_long
& 1) ? '1' : '0';
530 while (*cp
&& *cp
== '0')
535 fprintf_filtered (stream
, local_binary_format_prefix());
536 fprintf_filtered (stream
, cp
);
537 fprintf_filtered (stream
, local_binary_format_suffix());
542 error ("Undefined output format \"%c\".", format
);
546 /* Specify default address for `x' command.
547 `info lines' uses this. */
550 set_next_address (addr
)
555 /* Make address available to the user as $_. */
556 set_internalvar (lookup_internalvar ("_"),
557 value_from_longest (lookup_pointer_type (builtin_type_void
),
561 /* Optionally print address ADDR symbolically as <SYMBOL+OFFSET> on STREAM,
562 after LEADIN. Print nothing if no symbolic name is found nearby.
563 DO_DEMANGLE controls whether to print a symbol in its native "raw" form,
564 or to interpret it as a possible C++ name and convert it back to source
565 form. However note that DO_DEMANGLE can be overridden by the specific
566 settings of the demangle and asm_demangle variables. */
569 print_address_symbolic (addr
, stream
, do_demangle
, leadin
)
575 CORE_ADDR name_location
;
576 register struct symbol
*symbol
;
579 /* First try to find the address in the symbol tables to find
580 static functions. If that doesn't succeed we try the minimal symbol
581 vector for symbols in non-text space.
582 FIXME: Should find a way to get at the static non-text symbols too. */
584 symbol
= find_pc_function (addr
);
587 name_location
= BLOCK_START (SYMBOL_BLOCK_VALUE (symbol
));
589 name
= SYMBOL_SOURCE_NAME (symbol
);
591 name
= SYMBOL_LINKAGE_NAME (symbol
);
595 register struct minimal_symbol
*msymbol
= lookup_minimal_symbol_by_pc (addr
);
597 /* If nothing comes out, don't print anything symbolic. */
600 name_location
= SYMBOL_VALUE_ADDRESS (msymbol
);
602 name
= SYMBOL_SOURCE_NAME (msymbol
);
604 name
= SYMBOL_LINKAGE_NAME (msymbol
);
607 /* If the nearest symbol is too far away, don't print anything symbolic. */
609 /* For when CORE_ADDR is larger than unsigned int, we do math in
610 CORE_ADDR. But when we detect unsigned wraparound in the
611 CORE_ADDR math, we ignore this test and print the offset,
612 because addr+max_symbolic_offset has wrapped through the end
613 of the address space back to the beginning, giving bogus comparison. */
614 if (addr
> name_location
+ max_symbolic_offset
615 && name_location
+ max_symbolic_offset
> name_location
)
618 fputs_filtered (leadin
, stream
);
619 fputs_filtered ("<", stream
);
620 fputs_filtered (name
, stream
);
621 if (addr
!= name_location
)
622 fprintf_filtered (stream
, "+%d>", (int)(addr
- name_location
));
624 fputs_filtered (">", stream
);
627 /* Print address ADDR symbolically on STREAM.
628 First print it as a number. Then perhaps print
629 <SYMBOL + OFFSET> after the number. */
632 print_address (addr
, stream
)
636 #ifdef ADDR_BITS_REMOVE
637 fprintf_filtered (stream
, local_hex_format(), ADDR_BITS_REMOVE(addr
));
639 fprintf_filtered (stream
, local_hex_format(), addr
);
641 print_address_symbolic (addr
, stream
, asm_demangle
, " ");
644 /* Print address ADDR symbolically on STREAM. Parameter DEMANGLE
645 controls whether to print the symbolic name "raw" or demangled.
646 Global setting "addressprint" controls whether to print hex address
650 print_address_demangle (addr
, stream
, do_demangle
)
656 fprintf_filtered (stream
, "0");
657 } else if (addressprint
) {
658 fprintf_filtered (stream
, local_hex_format(), addr
);
659 print_address_symbolic (addr
, stream
, do_demangle
, " ");
661 print_address_symbolic (addr
, stream
, do_demangle
, "");
666 /* Examine data at address ADDR in format FMT.
667 Fetch it from memory and print on stdout. */
670 do_examine (fmt
, addr
)
671 struct format_data fmt
;
674 register char format
= 0;
676 register int count
= 1;
677 struct type
*val_type
;
679 register int maxelts
;
686 /* String or instruction format implies fetch single bytes
687 regardless of the specified size. */
688 if (format
== 's' || format
== 'i')
692 val_type
= builtin_type_char
;
693 else if (size
== 'h')
694 val_type
= builtin_type_short
;
695 else if (size
== 'w')
696 val_type
= builtin_type_long
;
697 else if (size
== 'g')
699 val_type
= builtin_type_double
;
701 val_type
= builtin_type_long_long
;
709 if (format
== 's' || format
== 'i')
712 /* Print as many objects as specified in COUNT, at most maxelts per line,
713 with the address of the next one at the start of each line. */
717 print_address (next_address
, stdout
);
718 printf_filtered (":");
723 printf_filtered ("\t");
724 /* Note that print_formatted sets next_address for the next
726 last_examine_address
= next_address
;
727 last_examine_value
= value_at (val_type
, next_address
);
728 print_formatted (last_examine_value
, format
, size
);
730 printf_filtered ("\n");
736 validate_format (fmt
, cmdname
)
737 struct format_data fmt
;
741 error ("Size letters are meaningless in \"%s\" command.", cmdname
);
743 error ("Item count other than 1 is meaningless in \"%s\" command.",
745 if (fmt
.format
== 'i' || fmt
.format
== 's')
746 error ("Format letter \"%c\" is meaningless in \"%s\" command.",
747 fmt
.format
, cmdname
);
750 /* Evaluate string EXP as an expression in the current language and
751 print the resulting value. EXP may contain a format specifier as the
752 first argument ("/x myvar" for example, to print myvar in hex).
756 print_command_1 (exp
, inspect
, voidprint
)
761 struct expression
*expr
;
762 register struct cleanup
*old_chain
= 0;
763 register char format
= 0;
765 struct format_data fmt
;
768 /* Pass inspect flag to the rest of the print routines in a global (sigh). */
769 inspect_it
= inspect
;
771 if (exp
&& *exp
== '/')
774 fmt
= decode_format (&exp
, last_format
, 0);
775 validate_format (fmt
, "print");
776 last_format
= format
= fmt
.format
;
787 extern int objectprint
;
789 expr
= parse_expression (exp
);
790 old_chain
= make_cleanup (free_current_contents
, &expr
);
792 val
= evaluate_expression (expr
);
794 /* C++: figure out what type we actually want to print it as. */
795 type
= VALUE_TYPE (val
);
798 && ( TYPE_CODE (type
) == TYPE_CODE_PTR
799 || TYPE_CODE (type
) == TYPE_CODE_REF
)
800 && ( TYPE_CODE (TYPE_TARGET_TYPE (type
)) == TYPE_CODE_STRUCT
801 || TYPE_CODE (TYPE_TARGET_TYPE (type
)) == TYPE_CODE_UNION
))
805 v
= value_from_vtable_info (val
, TYPE_TARGET_TYPE (type
));
809 type
= VALUE_TYPE (val
);
814 val
= access_value_history (0);
816 if (voidprint
|| (val
&& VALUE_TYPE (val
) &&
817 TYPE_CODE (VALUE_TYPE (val
)) != TYPE_CODE_VOID
))
819 int histindex
= record_latest_value (val
);
822 printf ("\031(gdb-makebuffer \"%s\" %d '(\"", exp
, histindex
);
824 if (histindex
>= 0) printf_filtered ("$%d = ", histindex
);
826 print_formatted (val
, format
, fmt
.size
);
827 printf_filtered ("\n");
833 do_cleanups (old_chain
);
834 inspect_it
= 0; /* Reset print routines to normal */
839 print_command (exp
, from_tty
)
843 print_command_1 (exp
, 0, 1);
846 /* Same as print, except in epoch, it gets its own window */
849 inspect_command (exp
, from_tty
)
853 extern int epoch_interface
;
855 print_command_1 (exp
, epoch_interface
, 1);
858 /* Same as print, except it doesn't print void results. */
861 call_command (exp
, from_tty
)
865 print_command_1 (exp
, 0, 0);
870 output_command (exp
, from_tty
)
874 struct expression
*expr
;
875 register struct cleanup
*old_chain
;
876 register char format
= 0;
878 struct format_data fmt
;
880 if (exp
&& *exp
== '/')
883 fmt
= decode_format (&exp
, 0, 0);
884 validate_format (fmt
, "output");
888 expr
= parse_expression (exp
);
889 old_chain
= make_cleanup (free_current_contents
, &expr
);
891 val
= evaluate_expression (expr
);
893 print_formatted (val
, format
, fmt
.size
);
895 do_cleanups (old_chain
);
900 set_command (exp
, from_tty
)
904 struct expression
*expr
= parse_expression (exp
);
905 register struct cleanup
*old_chain
906 = make_cleanup (free_current_contents
, &expr
);
907 evaluate_expression (expr
);
908 do_cleanups (old_chain
);
913 address_info (exp
, from_tty
)
917 register struct symbol
*sym
;
918 register struct minimal_symbol
*msymbol
;
920 register long basereg
;
921 int is_a_field_of_this
; /* C++: lookup_symbol sets this to nonzero
922 if exp is a field of `this'. */
925 error ("Argument required.");
927 sym
= lookup_symbol (exp
, get_selected_block (), VAR_NAMESPACE
,
928 &is_a_field_of_this
, (struct symtab
**)NULL
);
931 if (is_a_field_of_this
)
933 printf ("Symbol \"%s\" is a field of the local class variable `this'\n", exp
);
937 msymbol
= lookup_minimal_symbol (exp
, (struct objfile
*) NULL
);
940 printf ("Symbol \"%s\" is at %s in a file compiled without debugging.\n",
941 exp
, local_hex_string(SYMBOL_VALUE_ADDRESS (msymbol
)));
943 error ("No symbol \"%s\" in current context.", exp
);
947 printf ("Symbol \"%s\" is ", SYMBOL_NAME (sym
));
948 val
= SYMBOL_VALUE (sym
);
949 basereg
= SYMBOL_BASEREG (sym
);
951 switch (SYMBOL_CLASS (sym
))
954 case LOC_CONST_BYTES
:
959 printf ("a label at address %s", local_hex_string(SYMBOL_VALUE_ADDRESS (sym
)));
963 printf ("a variable in register %s", reg_names
[val
]);
967 printf ("static storage at address %s", local_hex_string(SYMBOL_VALUE_ADDRESS (sym
)));
971 printf ("an argument in register %s", reg_names
[val
]);
974 case LOC_REGPARM_ADDR
:
975 printf ("address of an argument in register %s", reg_names
[val
]);
979 if (SYMBOL_BASEREG_VALID (sym
))
981 printf ("an argument at offset %ld from register %s",
982 val
, reg_names
[basereg
]);
986 printf ("an argument at offset %ld", val
);
991 if (SYMBOL_BASEREG_VALID (sym
))
993 printf ("an argument at offset %ld from register %s",
994 val
, reg_names
[basereg
]);
998 printf ("an argument at frame offset %ld", val
);
1003 if (SYMBOL_BASEREG_VALID (sym
))
1005 printf ("a local variable at offset %ld from register %s",
1006 val
, reg_names
[basereg
]);
1010 printf ("a local variable at frame offset %ld", val
);
1015 printf ("a reference argument at offset %ld", val
);
1019 printf ("a typedef");
1023 printf ("a function at address %s",
1024 local_hex_string(BLOCK_START (SYMBOL_BLOCK_VALUE (sym
))));
1027 case LOC_OPTIMIZED_OUT
:
1028 printf_filtered ("optimized out");
1032 printf ("of unknown (botched) type");
1039 x_command (exp
, from_tty
)
1043 struct expression
*expr
;
1044 struct format_data fmt
;
1045 struct cleanup
*old_chain
;
1048 fmt
.format
= last_format
;
1049 fmt
.size
= last_size
;
1052 if (exp
&& *exp
== '/')
1055 fmt
= decode_format (&exp
, last_format
, last_size
);
1058 /* If we have an expression, evaluate it and use it as the address. */
1060 if (exp
!= 0 && *exp
!= 0)
1062 expr
= parse_expression (exp
);
1063 /* Cause expression not to be there any more
1064 if this command is repeated with Newline.
1065 But don't clobber a user-defined command's definition. */
1068 old_chain
= make_cleanup (free_current_contents
, &expr
);
1069 val
= evaluate_expression (expr
);
1070 if (TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_REF
)
1071 val
= value_ind (val
);
1072 /* In rvalue contexts, such as this, functions are coerced into
1073 pointers to functions. This makes "x/i main" work. */
1074 if (/* last_format == 'i'
1075 && */ TYPE_CODE (VALUE_TYPE (val
)) == TYPE_CODE_FUNC
1076 && VALUE_LVAL (val
) == lval_memory
)
1077 next_address
= VALUE_ADDRESS (val
);
1079 next_address
= value_as_pointer (val
);
1080 do_cleanups (old_chain
);
1083 do_examine (fmt
, next_address
);
1085 /* If the examine succeeds, we remember its size and format for next time. */
1086 last_size
= fmt
.size
;
1087 last_format
= fmt
.format
;
1089 /* Set a couple of internal variables if appropriate. */
1090 if (last_examine_value
)
1092 /* Make last address examined available to the user as $_. Use
1093 the correct pointer type. */
1094 set_internalvar (lookup_internalvar ("_"),
1095 value_from_longest (
1096 lookup_pointer_type (VALUE_TYPE (last_examine_value
)),
1097 (LONGEST
) last_examine_address
));
1099 /* Make contents of last address examined available to the user as $__.*/
1100 set_internalvar (lookup_internalvar ("__"), last_examine_value
);
1105 /* Add an expression to the auto-display chain.
1106 Specify the expression. */
1109 display_command (exp
, from_tty
)
1113 struct format_data fmt
;
1114 register struct expression
*expr
;
1115 register struct display
*new;
1126 fmt
= decode_format (&exp
, 0, 0);
1127 if (fmt
.size
&& fmt
.format
== 0)
1129 if (fmt
.format
== 'i' || fmt
.format
== 's')
1139 innermost_block
= 0;
1140 expr
= parse_expression (exp
);
1142 new = (struct display
*) xmalloc (sizeof (struct display
));
1145 new->block
= innermost_block
;
1146 new->next
= display_chain
;
1147 new->number
= ++display_number
;
1149 new->status
= enabled
;
1150 display_chain
= new;
1152 if (from_tty
&& target_has_execution
)
1153 do_one_display (new);
1166 /* Clear out the display_chain.
1167 Done when new symtabs are loaded, since this invalidates
1168 the types stored in many expressions. */
1173 register struct display
*d
;
1175 while ((d
= display_chain
) != NULL
)
1178 display_chain
= d
->next
;
1183 /* Delete the auto-display number NUM. */
1186 delete_display (num
)
1189 register struct display
*d1
, *d
;
1192 error ("No display number %d.", num
);
1194 if (display_chain
->number
== num
)
1197 display_chain
= d1
->next
;
1201 for (d
= display_chain
; ; d
= d
->next
)
1204 error ("No display number %d.", num
);
1205 if (d
->next
->number
== num
)
1215 /* Delete some values from the auto-display chain.
1216 Specify the element numbers. */
1219 undisplay_command (args
, from_tty
)
1223 register char *p
= args
;
1229 if (query ("Delete all auto-display expressions? "))
1238 while (*p1
>= '0' && *p1
<= '9') p1
++;
1239 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1240 error ("Arguments must be display numbers.");
1244 delete_display (num
);
1247 while (*p
== ' ' || *p
== '\t') p
++;
1252 /* Display a single auto-display.
1253 Do nothing if the display cannot be printed in the current context,
1254 or if the display is disabled. */
1260 int within_current_scope
;
1262 if (d
->status
== disabled
)
1266 within_current_scope
= contained_in (get_selected_block (), d
->block
);
1268 within_current_scope
= 1;
1269 if (!within_current_scope
)
1272 current_display_number
= d
->number
;
1274 printf_filtered ("%d: ", d
->number
);
1279 printf_filtered ("x/");
1280 if (d
->format
.count
!= 1)
1281 printf_filtered ("%d", d
->format
.count
);
1282 printf_filtered ("%c", d
->format
.format
);
1283 if (d
->format
.format
!= 'i' && d
->format
.format
!= 's')
1284 printf_filtered ("%c", d
->format
.size
);
1285 printf_filtered (" ");
1286 print_expression (d
->exp
, stdout
);
1287 if (d
->format
.count
!= 1)
1288 printf_filtered ("\n");
1290 printf_filtered (" ");
1292 addr
= value_as_pointer (evaluate_expression (d
->exp
));
1293 if (d
->format
.format
== 'i')
1294 addr
= ADDR_BITS_REMOVE (addr
);
1296 do_examine (d
->format
, addr
);
1300 if (d
->format
.format
)
1301 printf_filtered ("/%c ", d
->format
.format
);
1302 print_expression (d
->exp
, stdout
);
1303 printf_filtered (" = ");
1304 print_formatted (evaluate_expression (d
->exp
),
1305 d
->format
.format
, d
->format
.size
);
1306 printf_filtered ("\n");
1310 current_display_number
= -1;
1313 /* Display all of the values on the auto-display chain which can be
1314 evaluated in the current scope. */
1319 register struct display
*d
;
1321 for (d
= display_chain
; d
; d
= d
->next
)
1325 /* Delete the auto-display which we were in the process of displaying.
1326 This is done when there is an error or a signal. */
1329 disable_display (num
)
1332 register struct display
*d
;
1334 for (d
= display_chain
; d
; d
= d
->next
)
1335 if (d
->number
== num
)
1337 d
->status
= disabled
;
1340 printf ("No display number %d.\n", num
);
1344 disable_current_display ()
1346 if (current_display_number
>= 0)
1348 disable_display (current_display_number
);
1349 fprintf (stderr
, "Disabling display %d to avoid infinite recursion.\n",
1350 current_display_number
);
1352 current_display_number
= -1;
1356 display_info (ignore
, from_tty
)
1360 register struct display
*d
;
1363 printf ("There are no auto-display expressions now.\n");
1365 printf_filtered ("Auto-display expressions now in effect:\n\
1366 Num Enb Expression\n");
1368 for (d
= display_chain
; d
; d
= d
->next
)
1370 printf_filtered ("%d: %c ", d
->number
, "ny"[(int)d
->status
]);
1372 printf_filtered ("/%d%c%c ", d
->format
.count
, d
->format
.size
,
1374 else if (d
->format
.format
)
1375 printf_filtered ("/%c ", d
->format
.format
);
1376 print_expression (d
->exp
, stdout
);
1377 if (d
->block
&& !contained_in (get_selected_block (), d
->block
))
1378 printf_filtered (" (cannot be evaluated in the current context)");
1379 printf_filtered ("\n");
1385 enable_display (args
, from_tty
)
1389 register char *p
= args
;
1392 register struct display
*d
;
1396 for (d
= display_chain
; d
; d
= d
->next
)
1397 d
->status
= enabled
;
1403 while (*p1
>= '0' && *p1
<= '9')
1405 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1406 error ("Arguments must be display numbers.");
1410 for (d
= display_chain
; d
; d
= d
->next
)
1411 if (d
->number
== num
)
1413 d
->status
= enabled
;
1416 printf ("No display number %d.\n", num
);
1419 while (*p
== ' ' || *p
== '\t')
1426 disable_display_command (args
, from_tty
)
1430 register char *p
= args
;
1432 register struct display
*d
;
1436 for (d
= display_chain
; d
; d
= d
->next
)
1437 d
->status
= disabled
;
1443 while (*p1
>= '0' && *p1
<= '9')
1445 if (*p1
&& *p1
!= ' ' && *p1
!= '\t')
1446 error ("Arguments must be display numbers.");
1448 disable_display (atoi (p
));
1451 while (*p
== ' ' || *p
== '\t')
1457 /* Print the value in stack frame FRAME of a variable
1458 specified by a struct symbol. */
1461 print_variable_value (var
, frame
, stream
)
1466 value val
= read_var_value (var
, frame
);
1467 value_print (val
, stream
, 0, Val_pretty_default
);
1470 /* Print the arguments of a stack frame, given the function FUNC
1471 running in that frame (as a symbol), the info on the frame,
1472 and the number of args according to the stack frame (or -1 if unknown). */
1474 /* References here and elsewhere to "number of args according to the
1475 stack frame" appear in all cases to refer to "number of ints of args
1476 according to the stack frame". At least for VAX, i386, isi. */
1479 print_frame_args (func
, fi
, num
, stream
)
1480 struct symbol
*func
;
1481 struct frame_info
*fi
;
1489 register struct symbol
*sym
;
1491 /* Offset of next stack argument beyond the one we have seen that is
1492 at the highest offset.
1493 -1 if we haven't come to a stack argument yet. */
1494 long highest_offset
= -1;
1496 /* Number of ints of arguments that we have printed so far. */
1497 int args_printed
= 0;
1501 b
= SYMBOL_BLOCK_VALUE (func
);
1502 nsyms
= BLOCK_NSYMS (b
);
1505 for (i
= 0; i
< nsyms
; i
++)
1508 sym
= BLOCK_SYM (b
, i
);
1510 /* Keep track of the highest stack argument offset seen, and
1511 skip over any kinds of symbols we don't care about. */
1513 switch (SYMBOL_CLASS (sym
)) {
1517 long current_offset
= SYMBOL_VALUE (sym
);
1519 arg_size
= TYPE_LENGTH (SYMBOL_TYPE (sym
));
1521 /* Compute address of next argument by adding the size of
1522 this argument and rounding to an int boundary. */
1524 = ((current_offset
+ arg_size
+ sizeof (int) - 1)
1525 & ~(sizeof (int) - 1));
1527 /* If this is the highest offset seen yet, set highest_offset. */
1528 if (highest_offset
== -1
1529 || (current_offset
> highest_offset
))
1530 highest_offset
= current_offset
;
1532 /* Add the number of ints we're about to print to args_printed. */
1533 args_printed
+= (arg_size
+ sizeof (int) - 1) / sizeof (int);
1536 /* We care about types of symbols, but don't need to keep track of
1537 stack offsets in them. */
1539 case LOC_REGPARM_ADDR
:
1543 /* Other types of symbols we just skip over. */
1548 /* We have to look up the symbol because arguments can have
1549 two entries (one a parameter, one a local) and the one we
1550 want is the local, which lookup_symbol will find for us.
1551 This includes gcc1 (not gcc2) on the sparc when passing a
1552 small structure and gcc2 when the argument type is float
1553 and it is passed as a double and converted to float by
1554 the prologue (in the latter case the type of the LOC_ARG
1555 symbol is double and the type of the LOC_LOCAL symbol is
1556 float). It's possible this should be dealt with in
1557 symbol reading the way it now is for LOC_REGPARM. */
1558 /* But if the parameter name is null, don't try it.
1559 Null parameter names occur on the RS/6000, for traceback tables.
1560 FIXME, should we even print them? */
1562 if (*SYMBOL_NAME (sym
))
1565 b
, VAR_NAMESPACE
, (int *)NULL
, (struct symtab
**)NULL
);
1567 /* Print the current arg. */
1569 fprintf_filtered (stream
, ", ");
1571 fprintf_symbol_filtered (stream
, SYMBOL_SOURCE_NAME (sym
),
1572 SYMBOL_LANGUAGE (sym
), DMGL_PARAMS
| DMGL_ANSI
);
1573 fputs_filtered ("=", stream
);
1575 /* Avoid value_print because it will deref ref parameters. We just
1576 want to print their addresses. Print ??? for args whose address
1577 we do not know. We pass 2 as "recurse" to val_print because our
1578 standard indentation here is 4 spaces, and val_print indents
1579 2 for each recurse. */
1580 val
= read_var_value (sym
, FRAME_INFO_ID (fi
));
1582 val_print (VALUE_TYPE (val
), VALUE_CONTENTS (val
), VALUE_ADDRESS (val
),
1583 stream
, 0, 0, 2, Val_no_prettyprint
);
1585 fputs_filtered ("???", stream
);
1589 /* Don't print nameless args in situations where we don't know
1590 enough about the stack to find them. */
1595 if (highest_offset
== -1)
1596 start
= FRAME_ARGS_SKIP
;
1598 start
= highest_offset
;
1600 print_frame_nameless_args (fi
, start
, num
- args_printed
,
1605 /* Print nameless args on STREAM.
1606 FI is the frameinfo for this frame, START is the offset
1607 of the first nameless arg, and NUM is the number of nameless args to
1608 print. FIRST is nonzero if this is the first argument (not just
1609 the first nameless arg). */
1611 print_frame_nameless_args (fi
, start
, num
, first
, stream
)
1612 struct frame_info
*fi
;
1622 for (i
= 0; i
< num
; i
++)
1625 #ifdef NAMELESS_ARG_VALUE
1626 NAMELESS_ARG_VALUE (fi
, start
, &arg_value
);
1628 argsaddr
= FRAME_ARGS_ADDRESS (fi
);
1632 arg_value
= read_memory_integer (argsaddr
+ start
, sizeof (int));
1636 fprintf_filtered (stream
, ", ");
1638 #ifdef PRINT_NAMELESS_INTEGER
1639 PRINT_NAMELESS_INTEGER (stream
, arg_value
);
1641 #ifdef PRINT_TYPELESS_INTEGER
1642 PRINT_TYPELESS_INTEGER (stream
, builtin_type_int
, (LONGEST
) arg_value
);
1644 fprintf_filtered (stream
, "%d", arg_value
);
1645 #endif /* PRINT_TYPELESS_INTEGER */
1646 #endif /* PRINT_NAMELESS_INTEGER */
1648 start
+= sizeof (int);
1654 printf_command (arg
, from_tty
)
1659 register char *s
= arg
;
1663 int allocated_args
= 20;
1666 val_args
= (value
*) xmalloc (allocated_args
* sizeof (value
));
1669 error_no_arg ("format-control string and values to print");
1671 /* Skip white space before format string */
1672 while (*s
== ' ' || *s
== '\t') s
++;
1674 /* A format string should follow, enveloped in double quotes */
1676 error ("Bad format string, missing '\"'.");
1678 /* Parse the format-control string and copy it into the string STRING,
1679 processing some kinds of escape sequence. */
1681 f
= string
= (char *) alloca (strlen (s
) + 1);
1688 error ("Bad format string, non-terminated '\"'.");
1689 /* doesn't return */
1710 /* ??? TODO: handle other escape sequences */
1711 error ("Unrecognized \\ escape character in format string.");
1720 /* Skip over " and following space and comma. */
1723 while (*s
== ' ' || *s
== '\t') s
++;
1725 if (*s
!= ',' && *s
!= 0)
1726 error ("Invalid argument syntax");
1729 while (*s
== ' ' || *s
== '\t') s
++;
1732 /* Now scan the string for %-specs and see what kinds of args they want.
1733 argclass[I] classifies the %-specs so we can give vprintf something
1734 of the right size. */
1736 enum argclass
{int_arg
, string_arg
, double_arg
, long_long_arg
};
1737 enum argclass
*argclass
;
1743 argclass
= (enum argclass
*) alloca (strlen (s
) * sizeof *argclass
);
1750 while (strchr ("0123456789.hlL-+ #", *f
))
1752 if (*f
== 'l' || *f
== 'L')
1757 argclass
[nargs_wanted
++] = string_arg
;
1758 else if (*f
== 'e' || *f
== 'f' || *f
== 'g')
1759 argclass
[nargs_wanted
++] = double_arg
;
1760 else if (lcount
> 1)
1761 argclass
[nargs_wanted
++] = long_long_arg
;
1763 argclass
[nargs_wanted
++] = int_arg
;
1767 /* Now, parse all arguments and evaluate them.
1768 Store the VALUEs in VAL_ARGS. */
1773 if (nargs
== allocated_args
)
1774 val_args
= (value
*) xrealloc ((char *) val_args
,
1775 (allocated_args
*= 2)
1778 val_args
[nargs
] = parse_to_comma_and_eval (&s1
);
1780 /* If format string wants a float, unchecked-convert the value to
1781 floating point of the same size */
1783 if (argclass
[nargs
] == double_arg
)
1785 if (TYPE_LENGTH (VALUE_TYPE (val_args
[nargs
])) == sizeof (float))
1786 VALUE_TYPE (val_args
[nargs
]) = builtin_type_float
;
1787 if (TYPE_LENGTH (VALUE_TYPE (val_args
[nargs
])) == sizeof (double))
1788 VALUE_TYPE (val_args
[nargs
]) = builtin_type_double
;
1796 if (nargs
!= nargs_wanted
)
1797 error ("Wrong number of arguments for specified format-string");
1799 /* Now lay out an argument-list containing the arguments
1800 as doubles, integers and C pointers. */
1802 arg_bytes
= (char *) alloca (sizeof (double) * nargs
);
1804 for (i
= 0; i
< nargs
; i
++)
1806 if (argclass
[i
] == string_arg
)
1811 tem
= value_as_pointer (val_args
[i
]);
1813 /* This is a %s argument. Find the length of the string. */
1818 read_memory (tem
+ j
, &c
, 1);
1823 /* Copy the string contents into a string inside GDB. */
1824 str
= (char *) alloca (j
+ 1);
1825 read_memory (tem
, str
, j
);
1828 /* Pass address of internal copy as the arg to vprintf. */
1829 *((int *) &arg_bytes
[argindex
]) = (int) str
;
1830 argindex
+= sizeof (int);
1832 else if (VALUE_TYPE (val_args
[i
])->code
== TYPE_CODE_FLT
)
1834 *((double *) &arg_bytes
[argindex
]) = value_as_double (val_args
[i
]);
1835 argindex
+= sizeof (double);
1839 if (argclass
[i
] == long_long_arg
)
1841 *(long long *) &arg_bytes
[argindex
] = value_as_long (val_args
[i
]);
1842 argindex
+= sizeof (long long);
1847 *((long *) &arg_bytes
[argindex
]) = value_as_long (val_args
[i
]);
1848 argindex
+= sizeof (long);
1853 /* There is not a standard way to make a va_list, so we need
1854 to do various things for different systems. */
1855 #if defined (__INT_VARARGS_H)
1860 list
.__va_stk
= (int *) arg_bytes
;
1861 list
.__va_reg
= (int *) arg_bytes
;
1862 vprintf (string
, list
);
1864 #else /* No __INT_VARARGS_H. */
1865 vprintf (string
, arg_bytes
);
1866 #endif /* No __INT_VARARGS_H. */
1869 /* Helper function for asdump_command. Finds the bounds of a function
1870 for a specified section of text. PC is an address within the
1871 function which you want bounds for; *LOW and *HIGH are set to the
1872 beginning (inclusive) and end (exclusive) of the function. This
1873 function returns 1 on success and 0 on failure. */
1876 containing_function_bounds (pc
, low
, high
)
1877 CORE_ADDR pc
, *low
, *high
;
1881 struct obj_section
*sec
;
1883 if (!find_pc_partial_function (pc
, 0, low
))
1886 sec
= find_pc_section (pc
);
1889 limit
= sec
->endaddr
;
1892 while (scan
< limit
)
1895 if (!find_pc_partial_function (scan
, 0, high
))
1904 /* Dump a specified section of assembly code. With no command line
1905 arguments, this command will dump the assembly code for the
1906 function surrounding the pc value in the selected frame. With one
1907 argument, it will dump the assembly code surrounding that pc value.
1908 Two arguments are interpeted as bounds within which to dump
1913 disassemble_command (arg
, from_tty
)
1917 CORE_ADDR low
, high
;
1923 if (!selected_frame
)
1924 error ("No frame selected.\n");
1926 pc
= get_frame_pc (selected_frame
);
1927 if (!containing_function_bounds (pc
, &low
, &high
))
1928 error ("No function contains pc specified by selected frame.\n");
1930 else if (!(space_index
= (char *) strchr (arg
, ' ')))
1933 pc
= parse_and_eval_address (arg
);
1934 if (!containing_function_bounds (pc
, &low
, &high
))
1935 error ("No function contains specified pc.\n");
1939 /* Two arguments. */
1940 *space_index
= '\0';
1941 low
= parse_and_eval_address (arg
);
1942 high
= parse_and_eval_address (space_index
+ 1);
1945 printf_filtered ("Dump of assembler code ");
1949 find_pc_partial_function (pc
, &name
, 0);
1950 printf_filtered ("for function %s:\n", name
);
1954 printf_filtered ("from %s ", local_hex_string(low
));
1955 printf_filtered ("to %s:\n", local_hex_string(high
));
1958 /* Dump the specified range. */
1959 for (pc
= low
; pc
< high
; )
1962 print_address (pc
, stdout
);
1963 printf_filtered (":\t");
1964 pc
+= print_insn (pc
, stdout
);
1965 printf_filtered ("\n");
1967 printf_filtered ("End of assembler dump.\n");
1973 _initialize_printcmd ()
1975 current_display_number
= -1;
1977 add_info ("address", address_info
,
1978 "Describe where variable VAR is stored.");
1980 add_com ("x", class_vars
, x_command
,
1981 "Examine memory: x/FMT ADDRESS.\n\
1982 ADDRESS is an expression for the memory address to examine.\n\
1983 FMT is a repeat count followed by a format letter and a size letter.\n\
1984 Format letters are o(octal), x(hex), d(decimal), u(unsigned decimal),\n\
1985 t(binary), f(float), a(address), i(instruction), c(char) and s(string).\n\
1986 Size letters are b(byte), h(halfword), w(word), g(giant, 8 bytes).\n\
1987 The specified number of objects of the specified size are printed\n\
1988 according to the format.\n\n\
1989 Defaults for format and size letters are those previously used.\n\
1990 Default count is 1. Default address is following last thing printed\n\
1991 with this command or \"print\".");
1993 add_com ("disassemble", class_vars
, disassemble_command
,
1994 "Disassemble a specified section of memory.\n\
1995 Default is the function surrounding the pc of the selected frame.\n\
1996 With a single argument, the function surrounding that address is dumped.\n\
1997 Two arguments are taken as a range of memory to dump.");
2000 add_com ("whereis", class_vars
, whereis_command
,
2001 "Print line number and file of definition of variable.");
2004 add_info ("display", display_info
,
2005 "Expressions to display when program stops, with code numbers.");
2007 add_cmd ("undisplay", class_vars
, undisplay_command
,
2008 "Cancel some expressions to be displayed when program stops.\n\
2009 Arguments are the code numbers of the expressions to stop displaying.\n\
2010 No argument means cancel all automatic-display expressions.\n\
2011 \"delete display\" has the same effect as this command.\n\
2012 Do \"info display\" to see current list of code numbers.",
2015 add_com ("display", class_vars
, display_command
,
2016 "Print value of expression EXP each time the program stops.\n\
2017 /FMT may be used before EXP as in the \"print\" command.\n\
2018 /FMT \"i\" or \"s\" or including a size-letter is allowed,\n\
2019 as in the \"x\" command, and then EXP is used to get the address to examine\n\
2020 and examining is done as in the \"x\" command.\n\n\
2021 With no argument, display all currently requested auto-display expressions.\n\
2022 Use \"undisplay\" to cancel display requests previously made.");
2024 add_cmd ("display", class_vars
, enable_display
,
2025 "Enable some expressions to be displayed when program stops.\n\
2026 Arguments are the code numbers of the expressions to resume displaying.\n\
2027 No argument means enable all automatic-display expressions.\n\
2028 Do \"info display\" to see current list of code numbers.", &enablelist
);
2030 add_cmd ("display", class_vars
, disable_display_command
,
2031 "Disable some expressions to be displayed when program stops.\n\
2032 Arguments are the code numbers of the expressions to stop displaying.\n\
2033 No argument means disable all automatic-display expressions.\n\
2034 Do \"info display\" to see current list of code numbers.", &disablelist
);
2036 add_cmd ("display", class_vars
, undisplay_command
,
2037 "Cancel some expressions to be displayed when program stops.\n\
2038 Arguments are the code numbers of the expressions to stop displaying.\n\
2039 No argument means cancel all automatic-display expressions.\n\
2040 Do \"info display\" to see current list of code numbers.", &deletelist
);
2042 add_com ("printf", class_vars
, printf_command
,
2043 "printf \"printf format string\", arg1, arg2, arg3, ..., argn\n\
2044 This is useful for formatted output in user-defined commands.");
2045 add_com ("output", class_vars
, output_command
,
2046 "Like \"print\" but don't put in value history and don't print newline.\n\
2047 This is useful in user-defined commands.");
2049 add_prefix_cmd ("set", class_vars
, set_command
,
2050 "Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2051 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2052 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2053 with $), a register (a few standard names starting with $), or an actual\n\
2054 variable in the program being debugged. EXP is any valid expression.\n\
2055 Use \"set variable\" for variables with names identical to set subcommands.\n\
2056 \nWith a subcommand, this command modifies parts of the gdb environment.\n\
2057 You can see these environment settings with the \"show\" command.",
2058 &setlist
, "set ", 1, &cmdlist
);
2060 /* "call" is the same as "set", but handy for dbx users to call fns. */
2061 add_com ("call", class_vars
, call_command
,
2062 "Call a function in the inferior process.\n\
2063 The argument is the function name and arguments, in the notation of the\n\
2064 current working language. The result is printed and saved in the value\n\
2065 history, if it is not void.");
2067 add_cmd ("variable", class_vars
, set_command
,
2068 "Evaluate expression EXP and assign result to variable VAR, using assignment\n\
2069 syntax appropriate for the current language (VAR = EXP or VAR := EXP for\n\
2070 example). VAR may be a debugger \"convenience\" variable (names starting\n\
2071 with $), a register (a few standard names starting with $), or an actual\n\
2072 variable in the program being debugged. EXP is any valid expression.\n\
2073 This may usually be abbreviated to simply \"set\".",
2076 add_com ("print", class_vars
, print_command
,
2077 concat ("Print value of expression EXP.\n\
2078 Variables accessible are those of the lexical environment of the selected\n\
2079 stack frame, plus all those whose scope is global or an entire file.\n\
2081 $NUM gets previous value number NUM. $ and $$ are the last two values.\n\
2082 $$NUM refers to NUM'th value back from the last one.\n\
2083 Names starting with $ refer to registers (with the values they would have\n\
2084 if the program were to return to the stack frame now selected, restoring\n\
2085 all registers saved by frames farther in) or else to debugger\n\
2086 \"convenience\" variables (any such name not a known register).\n\
2087 Use assignment expressions to give values to convenience variables.\n",
2089 {TYPE}ADREXP refers to a datum of data type TYPE, located at address ADREXP.\n\
2090 @ is a binary operator for treating consecutive data objects\n\
2091 anywhere in memory as an array. FOO@NUM gives an array whose first\n\
2092 element is FOO, whose second element is stored in the space following\n\
2093 where FOO is stored, etc. FOO must be an expression whose value\n\
2094 resides in memory.\n",
2096 EXP may be preceded with /FMT, where FMT is a format letter\n\
2097 but no count or size letter (see \"x\" command).", NULL
));
2098 add_com_alias ("p", "print", class_vars
, 1);
2100 add_com ("inspect", class_vars
, inspect_command
,
2101 "Same as \"print\" command, except that if you are running in the epoch\n\
2102 environment, the value is printed in its own window.");
2105 add_set_cmd ("max-symbolic-offset", no_class
, var_uinteger
,
2106 (char *)&max_symbolic_offset
,
2107 "Set the largest offset that will be printed in <symbol+1234> form.",