1 /* Print and select stack frames for GDB, the GNU debugger.
3 Copyright (C) 1986-2014 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 #include "expression.h"
31 #include "breakpoint.h"
38 #include "dictionary.h"
39 #include "exceptions.h"
40 #include "reggroups.h"
44 #include "gdbthread.h"
45 #include "cp-support.h"
47 #include "inline-frame.h"
49 #include "cli/cli-utils.h"
51 #include "gdb_assert.h"
56 #include "python/python.h"
58 void (*deprecated_selected_frame_level_changed_hook) (int);
60 /* The possible choices of "set print frame-arguments", and the value
63 static const char *const print_frame_arguments_choices[] =
64 {"all", "scalars", "none", NULL};
65 static const char *print_frame_arguments = "scalars";
67 /* If non-zero, don't invoke pretty-printers for frame arguments. */
68 static int print_raw_frame_arguments;
70 /* The possible choices of "set print entry-values", and the value
73 const char print_entry_values_no[] = "no";
74 const char print_entry_values_only[] = "only";
75 const char print_entry_values_preferred[] = "preferred";
76 const char print_entry_values_if_needed[] = "if-needed";
77 const char print_entry_values_both[] = "both";
78 const char print_entry_values_compact[] = "compact";
79 const char print_entry_values_default[] = "default";
80 static const char *const print_entry_values_choices[] =
82 print_entry_values_no,
83 print_entry_values_only,
84 print_entry_values_preferred,
85 print_entry_values_if_needed,
86 print_entry_values_both,
87 print_entry_values_compact,
88 print_entry_values_default,
91 const char *print_entry_values = print_entry_values_default;
93 /* Prototypes for local functions. */
95 static void print_frame_local_vars (struct frame_info *, int,
98 static void print_frame (struct frame_info *frame, int print_level,
99 enum print_what print_what, int print_args,
100 struct symtab_and_line sal);
102 static void set_last_displayed_sal (int valid,
103 struct program_space *pspace,
105 struct symtab *symtab,
108 /* Zero means do things normally; we are interacting directly with the
109 user. One means print the full filename and linenumber when a
110 frame is printed, and do so in a format emacs18/emacs19.22 can
111 parse. Two means print similar annotations, but in many more
112 cases and in a slightly different syntax. */
114 int annotation_level = 0;
116 /* These variables hold the last symtab and line we displayed to the user.
117 * This is where we insert a breakpoint or a skiplist entry by default. */
118 static int last_displayed_sal_valid = 0;
119 static struct program_space *last_displayed_pspace = 0;
120 static CORE_ADDR last_displayed_addr = 0;
121 static struct symtab *last_displayed_symtab = 0;
122 static int last_displayed_line = 0;
125 /* Return 1 if we should display the address in addition to the location,
126 because we are in the middle of a statement. */
129 frame_show_address (struct frame_info *frame,
130 struct symtab_and_line sal)
132 /* If there is a line number, but no PC, then there is no location
133 information associated with this sal. The only way that should
134 happen is for the call sites of inlined functions (SAL comes from
135 find_frame_sal). Otherwise, we would have some PC range if the
136 SAL came from a line table. */
137 if (sal.line != 0 && sal.pc == 0 && sal.end == 0)
139 if (get_next_frame (frame) == NULL)
140 gdb_assert (inline_skipped_frames (inferior_ptid) > 0);
142 gdb_assert (get_frame_type (get_next_frame (frame)) == INLINE_FRAME);
146 return get_frame_pc (frame) != sal.pc;
149 /* Show or print a stack frame FRAME briefly. The output is format
150 according to PRINT_LEVEL and PRINT_WHAT printing the frame's
151 relative level, function name, argument list, and file name and
152 line number. If the frame's PC is not at the beginning of the
153 source line, the actual PC is printed at the beginning. */
156 print_stack_frame (struct frame_info *frame, int print_level,
157 enum print_what print_what,
160 volatile struct gdb_exception e;
162 /* For mi, alway print location and address. */
163 if (ui_out_is_mi_like_p (current_uiout))
164 print_what = LOC_AND_ADDRESS;
166 TRY_CATCH (e, RETURN_MASK_ERROR)
168 int center = (print_what == SRC_LINE || print_what == SRC_AND_LOC);
170 print_frame_info (frame, print_level, print_what, 1 /* print_args */,
173 set_current_sal_from_frame (frame, center);
177 /* Print nameless arguments of frame FRAME on STREAM, where START is
178 the offset of the first nameless argument, and NUM is the number of
179 nameless arguments to print. FIRST is nonzero if this is the first
180 argument (not just the first nameless argument). */
183 print_frame_nameless_args (struct frame_info *frame, long start, int num,
184 int first, struct ui_file *stream)
186 struct gdbarch *gdbarch = get_frame_arch (frame);
187 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
192 for (i = 0; i < num; i++)
195 argsaddr = get_frame_args_address (frame);
198 arg_value = read_memory_integer (argsaddr + start,
199 sizeof (int), byte_order);
201 fprintf_filtered (stream, ", ");
202 fprintf_filtered (stream, "%ld", arg_value);
204 start += sizeof (int);
208 /* Print single argument of inferior function. ARG must be already
211 Errors are printed as if they would be the parameter value. Use zeroed ARG
212 iff it should not be printed accoring to user settings. */
215 print_frame_arg (const struct frame_arg *arg)
217 struct ui_out *uiout = current_uiout;
218 volatile struct gdb_exception except;
219 struct cleanup *old_chain;
222 stb = mem_fileopen ();
223 old_chain = make_cleanup_ui_file_delete (stb);
225 gdb_assert (!arg->val || !arg->error);
226 gdb_assert (arg->entry_kind == print_entry_values_no
227 || arg->entry_kind == print_entry_values_only
228 || (!ui_out_is_mi_like_p (uiout)
229 && arg->entry_kind == print_entry_values_compact));
231 annotate_arg_begin ();
233 make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
234 fprintf_symbol_filtered (stb, SYMBOL_PRINT_NAME (arg->sym),
235 SYMBOL_LANGUAGE (arg->sym), DMGL_PARAMS | DMGL_ANSI);
236 if (arg->entry_kind == print_entry_values_compact)
238 /* It is OK to provide invalid MI-like stream as with
239 PRINT_ENTRY_VALUE_COMPACT we never use MI. */
240 fputs_filtered ("=", stb);
242 fprintf_symbol_filtered (stb, SYMBOL_PRINT_NAME (arg->sym),
243 SYMBOL_LANGUAGE (arg->sym),
244 DMGL_PARAMS | DMGL_ANSI);
246 if (arg->entry_kind == print_entry_values_only
247 || arg->entry_kind == print_entry_values_compact)
248 fputs_filtered ("@entry", stb);
249 ui_out_field_stream (uiout, "name", stb);
250 annotate_arg_name_end ();
251 ui_out_text (uiout, "=");
253 if (!arg->val && !arg->error)
254 ui_out_text (uiout, "...");
258 except.message = arg->error;
261 /* TRY_CATCH has two statements, wrap it in a block. */
263 TRY_CATCH (except, RETURN_MASK_ERROR)
265 const struct language_defn *language;
266 struct value_print_options opts;
268 /* Avoid value_print because it will deref ref parameters. We
269 just want to print their addresses. Print ??? for args whose
270 address we do not know. We pass 2 as "recurse" to val_print
271 because our standard indentation here is 4 spaces, and
272 val_print indents 2 for each recurse. */
274 annotate_arg_value (value_type (arg->val));
276 /* Use the appropriate language to display our symbol, unless the
277 user forced the language to a specific language. */
278 if (language_mode == language_mode_auto)
279 language = language_def (SYMBOL_LANGUAGE (arg->sym));
281 language = current_language;
283 get_no_prettyformat_print_options (&opts);
285 opts.raw = print_raw_frame_arguments;
287 /* True in "summary" mode, false otherwise. */
288 opts.summary = !strcmp (print_frame_arguments, "scalars");
290 common_val_print (arg->val, stb, 2, &opts, language);
294 fprintf_filtered (stb, _("<error reading variable: %s>"),
298 ui_out_field_stream (uiout, "value", stb);
300 /* Also invoke ui_out_tuple_end. */
301 do_cleanups (old_chain);
306 /* Read in inferior function local SYM at FRAME into ARGP. Caller is
307 responsible for xfree of ARGP->ERROR. This function never throws an
311 read_frame_local (struct symbol *sym, struct frame_info *frame,
312 struct frame_arg *argp)
314 volatile struct gdb_exception except;
315 struct value *val = NULL;
317 TRY_CATCH (except, RETURN_MASK_ERROR)
319 val = read_var_value (sym, frame);
322 argp->error = (val == NULL) ? xstrdup (except.message) : NULL;
327 /* Read in inferior function parameter SYM at FRAME into ARGP. Caller is
328 responsible for xfree of ARGP->ERROR. This function never throws an
332 read_frame_arg (struct symbol *sym, struct frame_info *frame,
333 struct frame_arg *argp, struct frame_arg *entryargp)
335 struct value *val = NULL, *entryval = NULL;
336 char *val_error = NULL, *entryval_error = NULL;
338 volatile struct gdb_exception except;
340 if (print_entry_values != print_entry_values_only
341 && print_entry_values != print_entry_values_preferred)
343 TRY_CATCH (except, RETURN_MASK_ERROR)
345 val = read_var_value (sym, frame);
349 val_error = alloca (strlen (except.message) + 1);
350 strcpy (val_error, except.message);
354 if (SYMBOL_COMPUTED_OPS (sym) != NULL
355 && SYMBOL_COMPUTED_OPS (sym)->read_variable_at_entry != NULL
356 && print_entry_values != print_entry_values_no
357 && (print_entry_values != print_entry_values_if_needed
358 || !val || value_optimized_out (val)))
360 TRY_CATCH (except, RETURN_MASK_ERROR)
362 const struct symbol_computed_ops *ops;
364 ops = SYMBOL_COMPUTED_OPS (sym);
365 entryval = ops->read_variable_at_entry (sym, frame);
369 entryval_error = alloca (strlen (except.message) + 1);
370 strcpy (entryval_error, except.message);
373 if (except.error == NO_ENTRY_VALUE_ERROR
374 || (entryval && value_optimized_out (entryval)))
377 entryval_error = NULL;
380 if (print_entry_values == print_entry_values_compact
381 || print_entry_values == print_entry_values_default)
383 /* For MI do not try to use print_entry_values_compact for ARGP. */
385 if (val && entryval && !ui_out_is_mi_like_p (current_uiout))
387 struct type *type = value_type (val);
389 if (!value_optimized_out (val)
390 && value_available_contents_eq (val, 0, entryval, 0,
393 /* Initialize it just to avoid a GCC false warning. */
394 struct value *val_deref = NULL, *entryval_deref;
396 /* DW_AT_GNU_call_site_value does match with the current
397 value. If it is a reference still try to verify if
398 dereferenced DW_AT_GNU_call_site_data_value does not
401 TRY_CATCH (except, RETURN_MASK_ERROR)
403 struct type *type_deref;
405 val_deref = coerce_ref (val);
406 if (value_lazy (val_deref))
407 value_fetch_lazy (val_deref);
408 type_deref = value_type (val_deref);
410 entryval_deref = coerce_ref (entryval);
411 if (value_lazy (entryval_deref))
412 value_fetch_lazy (entryval_deref);
414 /* If the reference addresses match but dereferenced
415 content does not match print them. */
417 && value_available_contents_eq (val_deref, 0,
419 TYPE_LENGTH (type_deref)))
423 /* Value was not a reference; and its content matches. */
424 if (val == val_deref)
426 /* If the dereferenced content could not be fetched do not
428 else if (except.error == NO_ENTRY_VALUE_ERROR)
430 else if (except.message)
432 entryval_error = alloca (strlen (except.message) + 1);
433 strcpy (entryval_error, except.message);
441 /* Try to remove possibly duplicate error message for ENTRYARGP even
444 if (val_error && entryval_error
445 && strcmp (val_error, entryval_error) == 0)
447 entryval_error = NULL;
449 /* Do not se VAL_EQUAL as the same error message may be shown for
450 the entry value even if no entry values are present in the
456 if (entryval == NULL)
458 if (print_entry_values == print_entry_values_preferred)
460 TRY_CATCH (except, RETURN_MASK_ERROR)
462 val = read_var_value (sym, frame);
466 val_error = alloca (strlen (except.message) + 1);
467 strcpy (val_error, except.message);
470 if (print_entry_values == print_entry_values_only
471 || print_entry_values == print_entry_values_both
472 || (print_entry_values == print_entry_values_preferred
473 && (!val || value_optimized_out (val))))
475 entryval = allocate_optimized_out_value (SYMBOL_TYPE (sym));
476 entryval_error = NULL;
479 if ((print_entry_values == print_entry_values_compact
480 || print_entry_values == print_entry_values_if_needed
481 || print_entry_values == print_entry_values_preferred)
482 && (!val || value_optimized_out (val)) && entryval != NULL)
490 argp->error = val_error ? xstrdup (val_error) : NULL;
491 if (!val && !val_error)
492 argp->entry_kind = print_entry_values_only;
493 else if ((print_entry_values == print_entry_values_compact
494 || print_entry_values == print_entry_values_default) && val_equal)
496 argp->entry_kind = print_entry_values_compact;
497 gdb_assert (!ui_out_is_mi_like_p (current_uiout));
500 argp->entry_kind = print_entry_values_no;
502 entryargp->sym = sym;
503 entryargp->val = entryval;
504 entryargp->error = entryval_error ? xstrdup (entryval_error) : NULL;
505 if (!entryval && !entryval_error)
506 entryargp->entry_kind = print_entry_values_no;
508 entryargp->entry_kind = print_entry_values_only;
511 /* Print the arguments of frame FRAME on STREAM, given the function
512 FUNC running in that frame (as a symbol), where NUM is the number
513 of arguments according to the stack frame (or -1 if the number of
514 arguments is unknown). */
516 /* Note that currently the "number of arguments according to the
517 stack frame" is only known on VAX where i refers to the "number of
518 ints of arguments according to the stack frame". */
521 print_frame_args (struct symbol *func, struct frame_info *frame,
522 int num, struct ui_file *stream)
524 struct ui_out *uiout = current_uiout;
526 /* Offset of next stack argument beyond the one we have seen that is
527 at the highest offset, or -1 if we haven't come to a stack
529 long highest_offset = -1;
530 /* Number of ints of arguments that we have printed so far. */
531 int args_printed = 0;
532 struct cleanup *old_chain;
534 /* True if we should print arguments, false otherwise. */
535 int print_args = strcmp (print_frame_arguments, "none");
537 stb = mem_fileopen ();
538 old_chain = make_cleanup_ui_file_delete (stb);
542 struct block *b = SYMBOL_BLOCK_VALUE (func);
543 struct block_iterator iter;
546 ALL_BLOCK_SYMBOLS (b, iter, sym)
548 struct frame_arg arg, entryarg;
552 /* Keep track of the highest stack argument offset seen, and
553 skip over any kinds of symbols we don't care about. */
555 if (!SYMBOL_IS_ARGUMENT (sym))
558 switch (SYMBOL_CLASS (sym))
563 long current_offset = SYMBOL_VALUE (sym);
564 int arg_size = TYPE_LENGTH (SYMBOL_TYPE (sym));
566 /* Compute address of next argument by adding the size of
567 this argument and rounding to an int boundary. */
569 ((current_offset + arg_size + sizeof (int) - 1)
570 & ~(sizeof (int) - 1));
572 /* If this is the highest offset seen yet, set
574 if (highest_offset == -1
575 || (current_offset > highest_offset))
576 highest_offset = current_offset;
578 /* Add the number of ints we're about to print to
580 args_printed += (arg_size + sizeof (int) - 1) / sizeof (int);
583 /* We care about types of symbols, but don't need to
584 keep track of stack offsets in them. */
586 case LOC_REGPARM_ADDR:
588 case LOC_OPTIMIZED_OUT:
593 /* We have to look up the symbol because arguments can have
594 two entries (one a parameter, one a local) and the one we
595 want is the local, which lookup_symbol will find for us.
596 This includes gcc1 (not gcc2) on SPARC when passing a
597 small structure and gcc2 when the argument type is float
598 and it is passed as a double and converted to float by
599 the prologue (in the latter case the type of the LOC_ARG
600 symbol is double and the type of the LOC_LOCAL symbol is
602 /* But if the parameter name is null, don't try it. Null
603 parameter names occur on the RS/6000, for traceback
604 tables. FIXME, should we even print them? */
606 if (*SYMBOL_LINKAGE_NAME (sym))
610 nsym = lookup_symbol (SYMBOL_LINKAGE_NAME (sym),
611 b, VAR_DOMAIN, NULL);
612 gdb_assert (nsym != NULL);
613 if (SYMBOL_CLASS (nsym) == LOC_REGISTER
614 && !SYMBOL_IS_ARGUMENT (nsym))
616 /* There is a LOC_ARG/LOC_REGISTER pair. This means
617 that it was passed on the stack and loaded into a
618 register, or passed in a register and stored in a
619 stack slot. GDB 3.x used the LOC_ARG; GDB
620 4.0-4.11 used the LOC_REGISTER.
622 Reasons for using the LOC_ARG:
624 (1) Because find_saved_registers may be slow for
627 (2) Because registers are often re-used and stack
628 slots rarely (never?) are. Therefore using
629 the stack slot is much less likely to print
632 Reasons why we might want to use the LOC_REGISTER:
634 (1) So that the backtrace prints the same value
635 as "print foo". I see no compelling reason
636 why this needs to be the case; having the
637 backtrace print the value which was passed
638 in, and "print foo" print the value as
639 modified within the called function, makes
642 Additional note: It might be nice if "info args"
643 displayed both values.
645 One more note: There is a case with SPARC
646 structure passing where we need to use the
647 LOC_REGISTER, but this is dealt with by creating
648 a single LOC_REGPARM in symbol reading. */
650 /* Leave sym (the LOC_ARG) alone. */
657 /* Print the current arg. */
659 ui_out_text (uiout, ", ");
660 ui_out_wrap_hint (uiout, " ");
664 memset (&arg, 0, sizeof (arg));
666 arg.entry_kind = print_entry_values_no;
667 memset (&entryarg, 0, sizeof (entryarg));
669 entryarg.entry_kind = print_entry_values_no;
672 read_frame_arg (sym, frame, &arg, &entryarg);
674 if (arg.entry_kind != print_entry_values_only)
675 print_frame_arg (&arg);
677 if (entryarg.entry_kind != print_entry_values_no)
679 if (arg.entry_kind != print_entry_values_only)
681 ui_out_text (uiout, ", ");
682 ui_out_wrap_hint (uiout, " ");
685 print_frame_arg (&entryarg);
689 xfree (entryarg.error);
695 /* Don't print nameless args in situations where we don't know
696 enough about the stack to find them. */
701 if (highest_offset == -1)
702 start = gdbarch_frame_args_skip (get_frame_arch (frame));
704 start = highest_offset;
706 print_frame_nameless_args (frame, start, num - args_printed,
710 do_cleanups (old_chain);
713 /* Set the current source and line to the location given by frame
714 FRAME, if possible. When CENTER is true, adjust so the relevant
715 line is in the center of the next 'list'. */
718 set_current_sal_from_frame (struct frame_info *frame, int center)
720 struct symtab_and_line sal;
722 find_frame_sal (frame, &sal);
726 sal.line = max (sal.line - get_lines_to_list () / 2, 1);
727 set_current_source_symtab_and_line (&sal);
731 /* If ON, GDB will display disassembly of the next source line when
732 execution of the program being debugged stops.
733 If AUTO (which is the default), or there's no line info to determine
734 the source line of the next instruction, display disassembly of next
735 instruction instead. */
737 static enum auto_boolean disassemble_next_line;
740 show_disassemble_next_line (struct ui_file *file, int from_tty,
741 struct cmd_list_element *c,
744 fprintf_filtered (file,
745 _("Debugger's willingness to use "
746 "disassemble-next-line is %s.\n"),
750 /* Use TRY_CATCH to catch the exception from the gdb_disassembly
751 because it will be broken by filter sometime. */
754 do_gdb_disassembly (struct gdbarch *gdbarch,
755 int how_many, CORE_ADDR low, CORE_ADDR high)
757 volatile struct gdb_exception exception;
759 TRY_CATCH (exception, RETURN_MASK_ERROR)
761 gdb_disassembly (gdbarch, current_uiout, 0,
762 DISASSEMBLY_RAW_INSN, how_many,
765 if (exception.reason < 0)
767 /* If an exception was thrown while doing the disassembly, print
768 the error message, to give the user a clue of what happened. */
769 exception_print (gdb_stderr, exception);
773 /* Print information about frame FRAME. The output is format according
774 to PRINT_LEVEL and PRINT_WHAT and PRINT_ARGS. The meaning of
777 SRC_LINE: Print only source line.
778 LOCATION: Print only location.
779 LOC_AND_SRC: Print location and source line.
781 Used in "where" output, and to emit breakpoint or step
785 print_frame_info (struct frame_info *frame, int print_level,
786 enum print_what print_what, int print_args,
789 struct gdbarch *gdbarch = get_frame_arch (frame);
790 struct symtab_and_line sal;
793 struct ui_out *uiout = current_uiout;
795 if (get_frame_type (frame) == DUMMY_FRAME
796 || get_frame_type (frame) == SIGTRAMP_FRAME
797 || get_frame_type (frame) == ARCH_FRAME)
799 struct cleanup *uiout_cleanup
800 = make_cleanup_ui_out_tuple_begin_end (uiout, "frame");
802 annotate_frame_begin (print_level ? frame_relative_level (frame) : 0,
803 gdbarch, get_frame_pc (frame));
805 /* Do this regardless of SOURCE because we don't have any source
806 to list for this frame. */
809 ui_out_text (uiout, "#");
810 ui_out_field_fmt_int (uiout, 2, ui_left, "level",
811 frame_relative_level (frame));
813 if (ui_out_is_mi_like_p (uiout))
815 annotate_frame_address ();
816 ui_out_field_core_addr (uiout, "addr",
817 gdbarch, get_frame_pc (frame));
818 annotate_frame_address_end ();
821 if (get_frame_type (frame) == DUMMY_FRAME)
823 annotate_function_call ();
824 ui_out_field_string (uiout, "func", "<function called from gdb>");
826 else if (get_frame_type (frame) == SIGTRAMP_FRAME)
828 annotate_signal_handler_caller ();
829 ui_out_field_string (uiout, "func", "<signal handler called>");
831 else if (get_frame_type (frame) == ARCH_FRAME)
833 ui_out_field_string (uiout, "func", "<cross-architecture call>");
835 ui_out_text (uiout, "\n");
836 annotate_frame_end ();
838 do_cleanups (uiout_cleanup);
842 /* If FRAME is not the innermost frame, that normally means that
843 FRAME->pc points to *after* the call instruction, and we want to
844 get the line containing the call, never the next line. But if
845 the next frame is a SIGTRAMP_FRAME or a DUMMY_FRAME, then the
846 next frame was not entered as the result of a call, and we want
847 to get the line containing FRAME->pc. */
848 find_frame_sal (frame, &sal);
850 location_print = (print_what == LOCATION
851 || print_what == LOC_AND_ADDRESS
852 || print_what == SRC_AND_LOC);
854 if (location_print || !sal.symtab)
855 print_frame (frame, print_level, print_what, print_args, sal);
857 source_print = (print_what == SRC_LINE || print_what == SRC_AND_LOC);
859 /* If disassemble-next-line is set to auto or on and doesn't have
860 the line debug messages for $pc, output the next instruction. */
861 if ((disassemble_next_line == AUTO_BOOLEAN_AUTO
862 || disassemble_next_line == AUTO_BOOLEAN_TRUE)
863 && source_print && !sal.symtab)
864 do_gdb_disassembly (get_frame_arch (frame), 1,
865 get_frame_pc (frame), get_frame_pc (frame) + 1);
867 if (source_print && sal.symtab)
870 int mid_statement = ((print_what == SRC_LINE)
871 && frame_show_address (frame, sal));
873 if (annotation_level)
874 done = identify_source_line (sal.symtab, sal.line, mid_statement,
875 get_frame_pc (frame));
878 if (deprecated_print_frame_info_listing_hook)
879 deprecated_print_frame_info_listing_hook (sal.symtab,
884 struct value_print_options opts;
886 get_user_print_options (&opts);
887 /* We used to do this earlier, but that is clearly
888 wrong. This function is used by many different
889 parts of gdb, including normal_stop in infrun.c,
890 which uses this to print out the current PC
891 when we stepi/nexti into the middle of a source
892 line. Only the command line really wants this
893 behavior. Other UIs probably would like the
894 ability to decide for themselves if it is desired. */
895 if (opts.addressprint && mid_statement)
897 ui_out_field_core_addr (uiout, "addr",
898 gdbarch, get_frame_pc (frame));
899 ui_out_text (uiout, "\t");
902 print_source_lines (sal.symtab, sal.line, sal.line + 1, 0);
906 /* If disassemble-next-line is set to on and there is line debug
907 messages, output assembly codes for next line. */
908 if (disassemble_next_line == AUTO_BOOLEAN_TRUE)
909 do_gdb_disassembly (get_frame_arch (frame), -1, sal.pc, sal.end);
916 if (get_frame_pc_if_available (frame, &pc))
917 set_last_displayed_sal (1, sal.pspace, pc, sal.symtab, sal.line);
919 set_last_displayed_sal (0, 0, 0, 0, 0);
922 annotate_frame_end ();
924 gdb_flush (gdb_stdout);
927 /* Remember the last symtab and line we displayed, which we use e.g.
928 * as the place to put a breakpoint when the `break' command is
929 * invoked with no arguments. */
932 set_last_displayed_sal (int valid, struct program_space *pspace,
933 CORE_ADDR addr, struct symtab *symtab,
936 last_displayed_sal_valid = valid;
937 last_displayed_pspace = pspace;
938 last_displayed_addr = addr;
939 last_displayed_symtab = symtab;
940 last_displayed_line = line;
941 if (valid && pspace == NULL)
943 clear_last_displayed_sal ();
944 internal_error (__FILE__, __LINE__,
945 _("Trying to set NULL pspace."));
949 /* Forget the last sal we displayed. */
952 clear_last_displayed_sal (void)
954 last_displayed_sal_valid = 0;
955 last_displayed_pspace = 0;
956 last_displayed_addr = 0;
957 last_displayed_symtab = 0;
958 last_displayed_line = 0;
961 /* Is our record of the last sal we displayed valid? If not,
962 * the get_last_displayed_* functions will return NULL or 0, as
966 last_displayed_sal_is_valid (void)
968 return last_displayed_sal_valid;
971 /* Get the pspace of the last sal we displayed, if it's valid. */
973 struct program_space *
974 get_last_displayed_pspace (void)
976 if (last_displayed_sal_valid)
977 return last_displayed_pspace;
981 /* Get the address of the last sal we displayed, if it's valid. */
984 get_last_displayed_addr (void)
986 if (last_displayed_sal_valid)
987 return last_displayed_addr;
991 /* Get the symtab of the last sal we displayed, if it's valid. */
994 get_last_displayed_symtab (void)
996 if (last_displayed_sal_valid)
997 return last_displayed_symtab;
1001 /* Get the line of the last sal we displayed, if it's valid. */
1004 get_last_displayed_line (void)
1006 if (last_displayed_sal_valid)
1007 return last_displayed_line;
1011 /* Get the last sal we displayed, if it's valid. */
1014 get_last_displayed_sal (struct symtab_and_line *sal)
1016 if (last_displayed_sal_valid)
1018 sal->pspace = last_displayed_pspace;
1019 sal->pc = last_displayed_addr;
1020 sal->symtab = last_displayed_symtab;
1021 sal->line = last_displayed_line;
1033 /* Attempt to obtain the FUNNAME, FUNLANG and optionally FUNCP of the function
1034 corresponding to FRAME. FUNNAME needs to be freed by the caller. */
1037 find_frame_funname (struct frame_info *frame, char **funname,
1038 enum language *funlang, struct symbol **funcp)
1040 struct symbol *func;
1043 *funlang = language_unknown;
1047 func = get_frame_function (frame);
1050 /* In certain pathological cases, the symtabs give the wrong
1051 function (when we are in the first function in a file which
1052 is compiled without debugging symbols, the previous function
1053 is compiled with debugging symbols, and the "foo.o" symbol
1054 that is supposed to tell us where the file with debugging
1055 symbols ends has been truncated by ar because it is longer
1056 than 15 characters). This also occurs if the user uses asm()
1057 to create a function but not stabs for it (in a file compiled
1060 So look in the minimal symbol tables as well, and if it comes
1061 up with a larger address for the function use that instead.
1062 I don't think this can ever cause any problems; there
1063 shouldn't be any minimal symbols in the middle of a function;
1064 if this is ever changed many parts of GDB will need to be
1065 changed (and we'll create a find_pc_minimal_function or some
1068 struct bound_minimal_symbol msymbol;
1070 /* Don't attempt to do this for inlined functions, which do not
1071 have a corresponding minimal symbol. */
1072 if (!block_inlined_p (SYMBOL_BLOCK_VALUE (func)))
1074 = lookup_minimal_symbol_by_pc (get_frame_address_in_block (frame));
1076 memset (&msymbol, 0, sizeof (msymbol));
1078 if (msymbol.minsym != NULL
1079 && (SYMBOL_VALUE_ADDRESS (msymbol.minsym)
1080 > BLOCK_START (SYMBOL_BLOCK_VALUE (func))))
1082 /* We also don't know anything about the function besides
1083 its address and name. */
1085 *funname = xstrdup (SYMBOL_PRINT_NAME (msymbol.minsym));
1086 *funlang = SYMBOL_LANGUAGE (msymbol.minsym);
1090 *funname = xstrdup (SYMBOL_PRINT_NAME (func));
1091 *funlang = SYMBOL_LANGUAGE (func);
1094 if (*funlang == language_cplus)
1096 /* It seems appropriate to use SYMBOL_PRINT_NAME() here,
1097 to display the demangled name that we already have
1098 stored in the symbol table, but we stored a version
1099 with DMGL_PARAMS turned on, and here we don't want to
1100 display parameters. So remove the parameters. */
1101 char *func_only = cp_remove_params (*funname);
1106 *funname = func_only;
1113 struct bound_minimal_symbol msymbol;
1116 if (!get_frame_address_in_block_if_available (frame, &pc))
1119 msymbol = lookup_minimal_symbol_by_pc (pc);
1120 if (msymbol.minsym != NULL)
1122 *funname = xstrdup (SYMBOL_PRINT_NAME (msymbol.minsym));
1123 *funlang = SYMBOL_LANGUAGE (msymbol.minsym);
1129 print_frame (struct frame_info *frame, int print_level,
1130 enum print_what print_what, int print_args,
1131 struct symtab_and_line sal)
1133 struct gdbarch *gdbarch = get_frame_arch (frame);
1134 struct ui_out *uiout = current_uiout;
1135 char *funname = NULL;
1136 enum language funlang = language_unknown;
1137 struct ui_file *stb;
1138 struct cleanup *old_chain, *list_chain;
1139 struct value_print_options opts;
1140 struct symbol *func;
1144 pc_p = get_frame_pc_if_available (frame, &pc);
1146 stb = mem_fileopen ();
1147 old_chain = make_cleanup_ui_file_delete (stb);
1149 find_frame_funname (frame, &funname, &funlang, &func);
1150 make_cleanup (xfree, funname);
1152 annotate_frame_begin (print_level ? frame_relative_level (frame) : 0,
1155 list_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "frame");
1159 ui_out_text (uiout, "#");
1160 ui_out_field_fmt_int (uiout, 2, ui_left, "level",
1161 frame_relative_level (frame));
1163 get_user_print_options (&opts);
1164 if (opts.addressprint)
1166 || frame_show_address (frame, sal)
1167 || print_what == LOC_AND_ADDRESS)
1169 annotate_frame_address ();
1171 ui_out_field_core_addr (uiout, "addr", gdbarch, pc);
1173 ui_out_field_string (uiout, "addr", "<unavailable>");
1174 annotate_frame_address_end ();
1175 ui_out_text (uiout, " in ");
1177 annotate_frame_function_name ();
1178 fprintf_symbol_filtered (stb, funname ? funname : "??",
1179 funlang, DMGL_ANSI);
1180 ui_out_field_stream (uiout, "func", stb);
1181 ui_out_wrap_hint (uiout, " ");
1182 annotate_frame_args ();
1184 ui_out_text (uiout, " (");
1187 struct gdbarch *gdbarch = get_frame_arch (frame);
1189 struct cleanup *args_list_chain;
1190 volatile struct gdb_exception e;
1192 if (gdbarch_frame_num_args_p (gdbarch))
1194 numargs = gdbarch_frame_num_args (gdbarch, frame);
1195 gdb_assert (numargs >= 0);
1200 args_list_chain = make_cleanup_ui_out_list_begin_end (uiout, "args");
1201 TRY_CATCH (e, RETURN_MASK_ERROR)
1203 print_frame_args (func, frame, numargs, gdb_stdout);
1205 /* FIXME: ARGS must be a list. If one argument is a string it
1206 will have " that will not be properly escaped. */
1207 /* Invoke ui_out_tuple_end. */
1208 do_cleanups (args_list_chain);
1211 ui_out_text (uiout, ")");
1214 const char *filename_display;
1216 filename_display = symtab_to_filename_for_display (sal.symtab);
1217 annotate_frame_source_begin ();
1218 ui_out_wrap_hint (uiout, " ");
1219 ui_out_text (uiout, " at ");
1220 annotate_frame_source_file ();
1221 ui_out_field_string (uiout, "file", filename_display);
1222 if (ui_out_is_mi_like_p (uiout))
1224 const char *fullname = symtab_to_fullname (sal.symtab);
1226 ui_out_field_string (uiout, "fullname", fullname);
1228 annotate_frame_source_file_end ();
1229 ui_out_text (uiout, ":");
1230 annotate_frame_source_line ();
1231 ui_out_field_int (uiout, "line", sal.line);
1232 annotate_frame_source_end ();
1235 if (pc_p && (funname == NULL || sal.symtab == NULL))
1237 char *lib = solib_name_from_address (get_frame_program_space (frame),
1238 get_frame_pc (frame));
1242 annotate_frame_where ();
1243 ui_out_wrap_hint (uiout, " ");
1244 ui_out_text (uiout, " from ");
1245 ui_out_field_string (uiout, "from", lib);
1249 /* do_cleanups will call ui_out_tuple_end() for us. */
1250 do_cleanups (list_chain);
1251 ui_out_text (uiout, "\n");
1252 do_cleanups (old_chain);
1256 /* Read a frame specification in whatever the appropriate format is
1257 from FRAME_EXP. Call error(), printing MESSAGE, if the
1258 specification is in any way invalid (so this function never returns
1259 NULL). When SEPECTED_P is non-NULL set its target to indicate that
1260 the default selected frame was used. */
1262 static struct frame_info *
1263 parse_frame_specification_1 (const char *frame_exp, const char *message,
1264 int *selected_frame_p)
1267 struct value *args[4];
1268 CORE_ADDR addrs[ARRAY_SIZE (args)];
1270 if (frame_exp == NULL)
1278 struct cleanup *cleanup;
1281 /* Skip leading white space, bail of EOL. */
1282 frame_exp = skip_spaces_const (frame_exp);
1286 /* Parse the argument, extract it, save it. */
1288 *p && !isspace (*p);
1290 addr_string = savestring (frame_exp, p - frame_exp);
1292 cleanup = make_cleanup (xfree, addr_string);
1294 /* NOTE: Parse and evaluate expression, but do not use
1295 functions such as parse_and_eval_long or
1296 parse_and_eval_address to also extract the value.
1297 Instead value_as_long and value_as_address are used.
1298 This avoids problems with expressions that contain
1300 if (numargs >= ARRAY_SIZE (args))
1301 error (_("Too many args in frame specification"));
1302 args[numargs++] = parse_and_eval (addr_string);
1304 do_cleanups (cleanup);
1308 /* If no args, default to the selected frame. */
1311 if (selected_frame_p != NULL)
1312 (*selected_frame_p) = 1;
1313 return get_selected_frame (message);
1316 /* None of the remaining use the selected frame. */
1317 if (selected_frame_p != NULL)
1318 (*selected_frame_p) = 0;
1320 /* Assume the single arg[0] is an integer, and try using that to
1321 select a frame relative to current. */
1324 struct frame_info *fid;
1325 int level = value_as_long (args[0]);
1327 fid = find_relative_frame (get_current_frame (), &level);
1329 /* find_relative_frame was successful. */
1333 /* Convert each value into a corresponding address. */
1337 for (i = 0; i < numargs; i++)
1338 addrs[i] = value_as_address (args[i]);
1341 /* Assume that the single arg[0] is an address, use that to identify
1342 a frame with a matching ID. Should this also accept stack/pc or
1343 stack/pc/special. */
1346 struct frame_id id = frame_id_build_wild (addrs[0]);
1347 struct frame_info *fid;
1349 /* If (s)he specifies the frame with an address, he deserves
1350 what (s)he gets. Still, give the highest one that matches.
1351 (NOTE: cagney/2004-10-29: Why highest, or outer-most, I don't
1353 for (fid = get_current_frame ();
1355 fid = get_prev_frame (fid))
1357 if (frame_id_eq (id, get_frame_id (fid)))
1359 struct frame_info *prev_frame;
1363 prev_frame = get_prev_frame (fid);
1365 || !frame_id_eq (id, get_frame_id (prev_frame)))
1374 /* We couldn't identify the frame as an existing frame, but
1375 perhaps we can create one with a single argument. */
1377 return create_new_frame (addrs[0], 0);
1378 else if (numargs == 2)
1379 return create_new_frame (addrs[0], addrs[1]);
1381 error (_("Too many args in frame specification"));
1384 static struct frame_info *
1385 parse_frame_specification (char *frame_exp)
1387 return parse_frame_specification_1 (frame_exp, NULL, NULL);
1390 /* Print verbosely the selected frame or the frame at address
1391 ADDR_EXP. Absolutely all information in the frame is printed. */
1394 frame_info (char *addr_exp, int from_tty)
1396 struct frame_info *fi;
1397 struct symtab_and_line sal;
1398 struct symbol *func;
1400 struct frame_info *calling_frame_info;
1402 const char *funname = 0;
1403 enum language funlang = language_unknown;
1404 const char *pc_regname;
1405 int selected_frame_p;
1406 struct gdbarch *gdbarch;
1407 struct cleanup *back_to = make_cleanup (null_cleanup, NULL);
1410 /* Initialize it to avoid "may be used uninitialized" warning. */
1411 CORE_ADDR caller_pc = 0;
1412 volatile struct gdb_exception ex;
1414 fi = parse_frame_specification_1 (addr_exp, "No stack.", &selected_frame_p);
1415 gdbarch = get_frame_arch (fi);
1417 /* Name of the value returned by get_frame_pc(). Per comments, "pc"
1418 is not a good name. */
1419 if (gdbarch_pc_regnum (gdbarch) >= 0)
1420 /* OK, this is weird. The gdbarch_pc_regnum hardware register's value can
1421 easily not match that of the internal value returned by
1423 pc_regname = gdbarch_register_name (gdbarch, gdbarch_pc_regnum (gdbarch));
1425 /* But then, this is weird to. Even without gdbarch_pc_regnum, an
1426 architectures will often have a hardware register called "pc",
1427 and that register's value, again, can easily not match
1431 frame_pc_p = get_frame_pc_if_available (fi, &frame_pc);
1432 find_frame_sal (fi, &sal);
1433 func = get_frame_function (fi);
1437 funname = SYMBOL_PRINT_NAME (func);
1438 funlang = SYMBOL_LANGUAGE (func);
1439 if (funlang == language_cplus)
1441 /* It seems appropriate to use SYMBOL_PRINT_NAME() here,
1442 to display the demangled name that we already have
1443 stored in the symbol table, but we stored a version
1444 with DMGL_PARAMS turned on, and here we don't want to
1445 display parameters. So remove the parameters. */
1446 char *func_only = cp_remove_params (funname);
1450 funname = func_only;
1451 make_cleanup (xfree, func_only);
1455 else if (frame_pc_p)
1457 struct bound_minimal_symbol msymbol;
1459 msymbol = lookup_minimal_symbol_by_pc (frame_pc);
1460 if (msymbol.minsym != NULL)
1462 funname = SYMBOL_PRINT_NAME (msymbol.minsym);
1463 funlang = SYMBOL_LANGUAGE (msymbol.minsym);
1466 calling_frame_info = get_prev_frame (fi);
1468 if (selected_frame_p && frame_relative_level (fi) >= 0)
1470 printf_filtered (_("Stack level %d, frame at "),
1471 frame_relative_level (fi));
1475 printf_filtered (_("Stack frame at "));
1477 fputs_filtered (paddress (gdbarch, get_frame_base (fi)), gdb_stdout);
1478 printf_filtered (":\n");
1479 printf_filtered (" %s = ", pc_regname);
1481 fputs_filtered (paddress (gdbarch, get_frame_pc (fi)), gdb_stdout);
1483 fputs_filtered ("<unavailable>", gdb_stdout);
1488 printf_filtered (" in ");
1489 fprintf_symbol_filtered (gdb_stdout, funname, funlang,
1490 DMGL_ANSI | DMGL_PARAMS);
1494 printf_filtered (" (%s:%d)", symtab_to_filename_for_display (sal.symtab),
1496 puts_filtered ("; ");
1498 printf_filtered ("saved %s = ", pc_regname);
1500 TRY_CATCH (ex, RETURN_MASK_ERROR)
1502 caller_pc = frame_unwind_caller_pc (fi);
1508 case NOT_AVAILABLE_ERROR:
1509 val_print_unavailable (gdb_stdout);
1511 case OPTIMIZED_OUT_ERROR:
1512 val_print_not_saved (gdb_stdout);
1515 fprintf_filtered (gdb_stdout, _("<error: %s>"), ex.message);
1520 fputs_filtered (paddress (gdbarch, caller_pc), gdb_stdout);
1521 printf_filtered ("\n");
1523 if (calling_frame_info == NULL)
1525 enum unwind_stop_reason reason;
1527 reason = get_frame_unwind_stop_reason (fi);
1528 if (reason != UNWIND_NO_REASON)
1529 printf_filtered (_(" Outermost frame: %s\n"),
1530 frame_stop_reason_string (reason));
1532 else if (get_frame_type (fi) == TAILCALL_FRAME)
1533 puts_filtered (" tail call frame");
1534 else if (get_frame_type (fi) == INLINE_FRAME)
1535 printf_filtered (" inlined into frame %d",
1536 frame_relative_level (get_prev_frame (fi)));
1539 printf_filtered (" called by frame at ");
1540 fputs_filtered (paddress (gdbarch, get_frame_base (calling_frame_info)),
1543 if (get_next_frame (fi) && calling_frame_info)
1544 puts_filtered (",");
1546 if (get_next_frame (fi))
1548 printf_filtered (" caller of frame at ");
1549 fputs_filtered (paddress (gdbarch, get_frame_base (get_next_frame (fi))),
1552 if (get_next_frame (fi) || calling_frame_info)
1553 puts_filtered ("\n");
1556 printf_filtered (" source language %s.\n",
1557 language_str (s->language));
1560 /* Address of the argument list for this frame, or 0. */
1561 CORE_ADDR arg_list = get_frame_args_address (fi);
1562 /* Number of args for this frame, or -1 if unknown. */
1566 printf_filtered (" Arglist at unknown address.\n");
1569 printf_filtered (" Arglist at ");
1570 fputs_filtered (paddress (gdbarch, arg_list), gdb_stdout);
1571 printf_filtered (",");
1573 if (!gdbarch_frame_num_args_p (gdbarch))
1576 puts_filtered (" args: ");
1580 numargs = gdbarch_frame_num_args (gdbarch, fi);
1581 gdb_assert (numargs >= 0);
1583 puts_filtered (" no args.");
1584 else if (numargs == 1)
1585 puts_filtered (" 1 arg: ");
1587 printf_filtered (" %d args: ", numargs);
1589 print_frame_args (func, fi, numargs, gdb_stdout);
1590 puts_filtered ("\n");
1594 /* Address of the local variables for this frame, or 0. */
1595 CORE_ADDR arg_list = get_frame_locals_address (fi);
1598 printf_filtered (" Locals at unknown address,");
1601 printf_filtered (" Locals at ");
1602 fputs_filtered (paddress (gdbarch, arg_list), gdb_stdout);
1603 printf_filtered (",");
1607 /* Print as much information as possible on the location of all the
1610 enum lval_type lval;
1619 /* The sp is special; what's displayed isn't the save address, but
1620 the value of the previous frame's sp. This is a legacy thing,
1621 at one stage the frame cached the previous frame's SP instead
1622 of its address, hence it was easiest to just display the cached
1624 if (gdbarch_sp_regnum (gdbarch) >= 0)
1626 /* Find out the location of the saved stack pointer with out
1627 actually evaluating it. */
1628 frame_register_unwind (fi, gdbarch_sp_regnum (gdbarch),
1629 &optimized, &unavailable, &lval, &addr,
1631 if (!optimized && !unavailable && lval == not_lval)
1633 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
1634 int sp_size = register_size (gdbarch, gdbarch_sp_regnum (gdbarch));
1635 gdb_byte value[MAX_REGISTER_SIZE];
1638 frame_register_unwind (fi, gdbarch_sp_regnum (gdbarch),
1639 &optimized, &unavailable, &lval, &addr,
1641 /* NOTE: cagney/2003-05-22: This is assuming that the
1642 stack pointer was packed as an unsigned integer. That
1643 may or may not be valid. */
1644 sp = extract_unsigned_integer (value, sp_size, byte_order);
1645 printf_filtered (" Previous frame's sp is ");
1646 fputs_filtered (paddress (gdbarch, sp), gdb_stdout);
1647 printf_filtered ("\n");
1650 else if (!optimized && !unavailable && lval == lval_memory)
1652 printf_filtered (" Previous frame's sp at ");
1653 fputs_filtered (paddress (gdbarch, addr), gdb_stdout);
1654 printf_filtered ("\n");
1657 else if (!optimized && !unavailable && lval == lval_register)
1659 printf_filtered (" Previous frame's sp in %s\n",
1660 gdbarch_register_name (gdbarch, realnum));
1663 /* else keep quiet. */
1667 numregs = gdbarch_num_regs (gdbarch)
1668 + gdbarch_num_pseudo_regs (gdbarch);
1669 for (i = 0; i < numregs; i++)
1670 if (i != gdbarch_sp_regnum (gdbarch)
1671 && gdbarch_register_reggroup_p (gdbarch, i, all_reggroup))
1673 /* Find out the location of the saved register without
1674 fetching the corresponding value. */
1675 frame_register_unwind (fi, i, &optimized, &unavailable,
1676 &lval, &addr, &realnum, NULL);
1677 /* For moment, only display registers that were saved on the
1679 if (!optimized && !unavailable && lval == lval_memory)
1682 puts_filtered (" Saved registers:\n ");
1684 puts_filtered (",");
1686 printf_filtered (" %s at ",
1687 gdbarch_register_name (gdbarch, i));
1688 fputs_filtered (paddress (gdbarch, addr), gdb_stdout);
1692 if (count || need_nl)
1693 puts_filtered ("\n");
1696 do_cleanups (back_to);
1699 /* Print briefly all stack frames or just the innermost COUNT_EXP
1703 backtrace_command_1 (char *count_exp, int show_locals, int no_filters,
1706 struct frame_info *fi;
1709 struct frame_info *trailing;
1710 int trailing_level, py_start = 0, py_end = 0;
1711 enum py_bt_status result = PY_BT_ERROR;
1713 if (!target_has_stack)
1714 error (_("No stack."));
1716 /* The following code must do two things. First, it must set the
1717 variable TRAILING to the frame from which we should start
1718 printing. Second, it must set the variable count to the number
1719 of frames which we should print, or -1 if all of them. */
1720 trailing = get_current_frame ();
1725 count = parse_and_eval_long (count_exp);
1728 struct frame_info *current;
1734 while (current && count--)
1737 current = get_prev_frame (current);
1740 /* Will stop when CURRENT reaches the top of the stack.
1741 TRAILING will be COUNT below it. */
1745 trailing = get_prev_frame (trailing);
1746 current = get_prev_frame (current);
1766 /* Read in symbols for all of the frames. Need to do this in a
1767 separate pass so that "Reading in symbols for xxx" messages
1768 don't screw up the appearance of the backtrace. Also if
1769 people have strong opinions against reading symbols for
1770 backtrace this may have to be an option. */
1772 for (fi = trailing; fi != NULL && i--; fi = get_prev_frame (fi))
1777 pc = get_frame_address_in_block (fi);
1778 find_pc_sect_symtab_via_partial (pc, find_pc_mapped_section (pc));
1784 int flags = PRINT_LEVEL | PRINT_FRAME_INFO | PRINT_ARGS;
1785 enum py_frame_args arg_type;
1788 flags |= PRINT_LOCALS;
1790 if (!strcmp (print_frame_arguments, "scalars"))
1791 arg_type = CLI_SCALAR_VALUES;
1792 else if (!strcmp (print_frame_arguments, "all"))
1793 arg_type = CLI_ALL_VALUES;
1795 arg_type = NO_VALUES;
1797 result = apply_frame_filter (get_current_frame (), flags, arg_type,
1798 current_uiout, py_start, py_end);
1801 /* Run the inbuilt backtrace if there are no filters registered, or
1802 "no-filters" has been specified from the command. */
1803 if (no_filters || result == PY_BT_NO_FILTERS)
1805 for (i = 0, fi = trailing; fi && count--; i++, fi = get_prev_frame (fi))
1809 /* Don't use print_stack_frame; if an error() occurs it probably
1810 means further attempts to backtrace would fail (on the other
1811 hand, perhaps the code does or could be fixed to make sure
1812 the frame->prev field gets set to NULL in that case). */
1814 print_frame_info (fi, 1, LOCATION, 1, 0);
1817 struct frame_id frame_id = get_frame_id (fi);
1819 print_frame_local_vars (fi, 1, gdb_stdout);
1821 /* print_frame_local_vars invalidates FI. */
1822 fi = frame_find_by_id (frame_id);
1826 warning (_("Unable to restore previously selected frame."));
1831 /* Save the last frame to check for error conditions. */
1835 /* If we've stopped before the end, mention that. */
1837 printf_filtered (_("(More stack frames follow...)\n"));
1839 /* If we've run out of frames, and the reason appears to be an error
1840 condition, print it. */
1841 if (fi == NULL && trailing != NULL)
1843 enum unwind_stop_reason reason;
1845 reason = get_frame_unwind_stop_reason (trailing);
1846 if (reason >= UNWIND_FIRST_ERROR)
1847 printf_filtered (_("Backtrace stopped: %s\n"),
1848 frame_stop_reason_string (reason));
1854 backtrace_command (char *arg, int from_tty)
1856 struct cleanup *old_chain = make_cleanup (null_cleanup, NULL);
1857 int fulltrace_arg = -1, arglen = 0, argc = 0, no_filters = -1;
1865 argv = gdb_buildargv (arg);
1866 make_cleanup_freeargv (argv);
1868 for (i = 0; argv[i]; i++)
1872 for (j = 0; j < strlen (argv[i]); j++)
1873 argv[i][j] = tolower (argv[i][j]);
1875 if (no_filters < 0 && subset_compare (argv[i], "no-filters"))
1879 if (fulltrace_arg < 0 && subset_compare (argv[i], "full"))
1880 fulltrace_arg = argc;
1884 arglen += strlen (argv[i]);
1890 if (fulltrace_arg >= 0 || no_filters >= 0)
1894 arg = xmalloc (arglen + 1);
1895 make_cleanup (xfree, arg);
1897 for (i = 0; i < argc; i++)
1899 if (i != fulltrace_arg && i != no_filters)
1901 strcat (arg, argv[i]);
1911 backtrace_command_1 (arg, fulltrace_arg >= 0 /* show_locals */,
1912 no_filters >= 0 /* no frame-filters */, from_tty);
1914 do_cleanups (old_chain);
1918 backtrace_full_command (char *arg, int from_tty)
1920 backtrace_command_1 (arg, 1 /* show_locals */, 0, from_tty);
1924 /* Iterate over the local variables of a block B, calling CB with
1928 iterate_over_block_locals (struct block *b,
1929 iterate_over_block_arg_local_vars_cb cb,
1932 struct block_iterator iter;
1935 ALL_BLOCK_SYMBOLS (b, iter, sym)
1937 switch (SYMBOL_CLASS (sym))
1943 if (SYMBOL_IS_ARGUMENT (sym))
1945 if (SYMBOL_DOMAIN (sym) == COMMON_BLOCK_DOMAIN)
1947 (*cb) (SYMBOL_PRINT_NAME (sym), sym, cb_data);
1951 /* Ignore symbols which are not locals. */
1958 /* Same, but print labels. */
1961 /* Commented out, as the code using this function has also been
1962 commented out. FIXME:brobecker/2009-01-13: Find out why the code
1963 was commented out in the first place. The discussion introducing
1964 this change (2007-12-04: Support lexical blocks and function bodies
1965 that occupy non-contiguous address ranges) did not explain why
1966 this change was made. */
1968 print_block_frame_labels (struct gdbarch *gdbarch, struct block *b,
1969 int *have_default, struct ui_file *stream)
1971 struct block_iterator iter;
1973 int values_printed = 0;
1975 ALL_BLOCK_SYMBOLS (b, iter, sym)
1977 if (strcmp (SYMBOL_LINKAGE_NAME (sym), "default") == 0)
1983 if (SYMBOL_CLASS (sym) == LOC_LABEL)
1985 struct symtab_and_line sal;
1986 struct value_print_options opts;
1988 sal = find_pc_line (SYMBOL_VALUE_ADDRESS (sym), 0);
1990 fputs_filtered (SYMBOL_PRINT_NAME (sym), stream);
1991 get_user_print_options (&opts);
1992 if (opts.addressprint)
1994 fprintf_filtered (stream, " ");
1995 fputs_filtered (paddress (gdbarch, SYMBOL_VALUE_ADDRESS (sym)),
1998 fprintf_filtered (stream, " in file %s, line %d\n",
1999 sal.symtab->filename, sal.line);
2003 return values_printed;
2007 /* Iterate over all the local variables in block B, including all its
2008 superblocks, stopping when the top-level block is reached. */
2011 iterate_over_block_local_vars (struct block *block,
2012 iterate_over_block_arg_local_vars_cb cb,
2017 iterate_over_block_locals (block, cb, cb_data);
2018 /* After handling the function's top-level block, stop. Don't
2019 continue to its superblock, the block of per-file
2021 if (BLOCK_FUNCTION (block))
2023 block = BLOCK_SUPERBLOCK (block);
2027 /* Data to be passed around in the calls to the locals and args
2030 struct print_variable_and_value_data
2032 struct frame_id frame_id;
2034 struct ui_file *stream;
2038 /* The callback for the locals and args iterators. */
2041 do_print_variable_and_value (const char *print_name,
2045 struct print_variable_and_value_data *p = cb_data;
2046 struct frame_info *frame;
2048 frame = frame_find_by_id (p->frame_id);
2051 warning (_("Unable to restore previously selected frame."));
2055 print_variable_and_value (print_name, sym, frame, p->stream, p->num_tabs);
2057 /* print_variable_and_value invalidates FRAME. */
2060 p->values_printed = 1;
2063 /* Print all variables from the innermost up to the function block of FRAME.
2064 Print them with values to STREAM indented by NUM_TABS.
2066 This function will invalidate FRAME. */
2069 print_frame_local_vars (struct frame_info *frame, int num_tabs,
2070 struct ui_file *stream)
2072 struct print_variable_and_value_data cb_data;
2073 struct block *block;
2076 if (!get_frame_pc_if_available (frame, &pc))
2078 fprintf_filtered (stream,
2079 _("PC unavailable, cannot determine locals.\n"));
2083 block = get_frame_block (frame, 0);
2086 fprintf_filtered (stream, "No symbol table info available.\n");
2090 cb_data.frame_id = get_frame_id (frame);
2091 cb_data.num_tabs = 4 * num_tabs;
2092 cb_data.stream = stream;
2093 cb_data.values_printed = 0;
2095 iterate_over_block_local_vars (block,
2096 do_print_variable_and_value,
2099 /* do_print_variable_and_value invalidates FRAME. */
2102 if (!cb_data.values_printed)
2103 fprintf_filtered (stream, _("No locals.\n"));
2107 locals_info (char *args, int from_tty)
2109 print_frame_local_vars (get_selected_frame (_("No frame selected.")),
2113 /* Iterate over all the argument variables in block B.
2115 Returns 1 if any argument was walked; 0 otherwise. */
2118 iterate_over_block_arg_vars (struct block *b,
2119 iterate_over_block_arg_local_vars_cb cb,
2122 struct block_iterator iter;
2123 struct symbol *sym, *sym2;
2125 ALL_BLOCK_SYMBOLS (b, iter, sym)
2127 /* Don't worry about things which aren't arguments. */
2128 if (SYMBOL_IS_ARGUMENT (sym))
2130 /* We have to look up the symbol because arguments can have
2131 two entries (one a parameter, one a local) and the one we
2132 want is the local, which lookup_symbol will find for us.
2133 This includes gcc1 (not gcc2) on the sparc when passing a
2134 small structure and gcc2 when the argument type is float
2135 and it is passed as a double and converted to float by
2136 the prologue (in the latter case the type of the LOC_ARG
2137 symbol is double and the type of the LOC_LOCAL symbol is
2138 float). There are also LOC_ARG/LOC_REGISTER pairs which
2139 are not combined in symbol-reading. */
2141 sym2 = lookup_symbol (SYMBOL_LINKAGE_NAME (sym),
2142 b, VAR_DOMAIN, NULL);
2143 (*cb) (SYMBOL_PRINT_NAME (sym), sym2, cb_data);
2148 /* Print all argument variables of the function of FRAME.
2149 Print them with values to STREAM.
2151 This function will invalidate FRAME. */
2154 print_frame_arg_vars (struct frame_info *frame, struct ui_file *stream)
2156 struct print_variable_and_value_data cb_data;
2157 struct symbol *func;
2160 if (!get_frame_pc_if_available (frame, &pc))
2162 fprintf_filtered (stream, _("PC unavailable, cannot determine args.\n"));
2166 func = get_frame_function (frame);
2169 fprintf_filtered (stream, _("No symbol table info available.\n"));
2173 cb_data.frame_id = get_frame_id (frame);
2174 cb_data.num_tabs = 0;
2175 cb_data.stream = gdb_stdout;
2176 cb_data.values_printed = 0;
2178 iterate_over_block_arg_vars (SYMBOL_BLOCK_VALUE (func),
2179 do_print_variable_and_value, &cb_data);
2181 /* do_print_variable_and_value invalidates FRAME. */
2184 if (!cb_data.values_printed)
2185 fprintf_filtered (stream, _("No arguments.\n"));
2189 args_info (char *ignore, int from_tty)
2191 print_frame_arg_vars (get_selected_frame (_("No frame selected.")),
2197 args_plus_locals_info (char *ignore, int from_tty)
2199 args_info (ignore, from_tty);
2200 locals_info (ignore, from_tty);
2204 /* Select frame FRAME. Also print the stack frame and show the source
2205 if this is the tui version. */
2207 select_and_print_frame (struct frame_info *frame)
2209 select_frame (frame);
2211 print_stack_frame (frame, 1, SRC_AND_LOC, 1);
2214 /* Return the symbol-block in which the selected frame is executing.
2215 Can return zero under various legitimate circumstances.
2217 If ADDR_IN_BLOCK is non-zero, set *ADDR_IN_BLOCK to the relevant
2218 code address within the block returned. We use this to decide
2219 which macros are in scope. */
2222 get_selected_block (CORE_ADDR *addr_in_block)
2224 if (!has_stack_frames ())
2227 return get_frame_block (get_selected_frame (NULL), addr_in_block);
2230 /* Find a frame a certain number of levels away from FRAME.
2231 LEVEL_OFFSET_PTR points to an int containing the number of levels.
2232 Positive means go to earlier frames (up); negative, the reverse.
2233 The int that contains the number of levels is counted toward
2234 zero as the frames for those levels are found.
2235 If the top or bottom frame is reached, that frame is returned,
2236 but the final value of *LEVEL_OFFSET_PTR is nonzero and indicates
2237 how much farther the original request asked to go. */
2240 find_relative_frame (struct frame_info *frame, int *level_offset_ptr)
2242 /* Going up is simple: just call get_prev_frame enough times or
2243 until the initial frame is reached. */
2244 while (*level_offset_ptr > 0)
2246 struct frame_info *prev = get_prev_frame (frame);
2250 (*level_offset_ptr)--;
2254 /* Going down is just as simple. */
2255 while (*level_offset_ptr < 0)
2257 struct frame_info *next = get_next_frame (frame);
2261 (*level_offset_ptr)++;
2268 /* The "select_frame" command. With no argument this is a NOP.
2269 Select the frame at level LEVEL_EXP if it is a valid level.
2270 Otherwise, treat LEVEL_EXP as an address expression and select it.
2272 See parse_frame_specification for more info on proper frame
2276 select_frame_command (char *level_exp, int from_tty)
2278 select_frame (parse_frame_specification_1 (level_exp, "No stack.", NULL));
2281 /* The "frame" command. With no argument, print the selected frame
2282 briefly. With an argument, behave like select_frame and then print
2283 the selected frame. */
2286 frame_command (char *level_exp, int from_tty)
2288 select_frame_command (level_exp, from_tty);
2289 print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
2292 /* The XDB Compatibility command to print the current frame. */
2295 current_frame_command (char *level_exp, int from_tty)
2297 print_stack_frame (get_selected_frame (_("No stack.")), 1, SRC_AND_LOC, 1);
2300 /* Select the frame up one or COUNT_EXP stack levels from the
2301 previously selected frame, and print it briefly. */
2304 up_silently_base (char *count_exp)
2306 struct frame_info *frame;
2310 count = parse_and_eval_long (count_exp);
2312 frame = find_relative_frame (get_selected_frame ("No stack."), &count);
2313 if (count != 0 && count_exp == NULL)
2314 error (_("Initial frame selected; you cannot go up."));
2315 select_frame (frame);
2319 up_silently_command (char *count_exp, int from_tty)
2321 up_silently_base (count_exp);
2325 up_command (char *count_exp, int from_tty)
2327 up_silently_base (count_exp);
2328 print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
2331 /* Select the frame down one or COUNT_EXP stack levels from the previously
2332 selected frame, and print it briefly. */
2335 down_silently_base (char *count_exp)
2337 struct frame_info *frame;
2341 count = -parse_and_eval_long (count_exp);
2343 frame = find_relative_frame (get_selected_frame ("No stack."), &count);
2344 if (count != 0 && count_exp == NULL)
2346 /* We only do this if COUNT_EXP is not specified. That way
2347 "down" means to really go down (and let me know if that is
2348 impossible), but "down 9999" can be used to mean go all the
2349 way down without getting an error. */
2351 error (_("Bottom (innermost) frame selected; you cannot go down."));
2354 select_frame (frame);
2358 down_silently_command (char *count_exp, int from_tty)
2360 down_silently_base (count_exp);
2364 down_command (char *count_exp, int from_tty)
2366 down_silently_base (count_exp);
2367 print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
2372 return_command (char *retval_exp, int from_tty)
2374 /* Initialize it just to avoid a GCC false warning. */
2375 enum return_value_convention rv_conv = RETURN_VALUE_STRUCT_CONVENTION;
2376 struct frame_info *thisframe;
2377 struct gdbarch *gdbarch;
2378 struct symbol *thisfun;
2379 struct value *return_value = NULL;
2380 struct value *function = NULL;
2381 const char *query_prefix = "";
2383 thisframe = get_selected_frame ("No selected frame.");
2384 thisfun = get_frame_function (thisframe);
2385 gdbarch = get_frame_arch (thisframe);
2387 if (get_frame_type (get_current_frame ()) == INLINE_FRAME)
2388 error (_("Can not force return from an inlined function."));
2390 /* Compute the return value. If the computation triggers an error,
2391 let it bail. If the return type can't be handled, set
2392 RETURN_VALUE to NULL, and QUERY_PREFIX to an informational
2396 struct expression *retval_expr = parse_expression (retval_exp);
2397 struct cleanup *old_chain = make_cleanup (xfree, retval_expr);
2398 struct type *return_type = NULL;
2400 /* Compute the return value. Should the computation fail, this
2401 call throws an error. */
2402 return_value = evaluate_expression (retval_expr);
2404 /* Cast return value to the return type of the function. Should
2405 the cast fail, this call throws an error. */
2406 if (thisfun != NULL)
2407 return_type = TYPE_TARGET_TYPE (SYMBOL_TYPE (thisfun));
2408 if (return_type == NULL)
2410 if (retval_expr->elts[0].opcode != UNOP_CAST
2411 && retval_expr->elts[0].opcode != UNOP_CAST_TYPE)
2412 error (_("Return value type not available for selected "
2414 "Please use an explicit cast of the value to return."));
2415 return_type = value_type (return_value);
2417 do_cleanups (old_chain);
2418 CHECK_TYPEDEF (return_type);
2419 return_value = value_cast (return_type, return_value);
2421 /* Make sure the value is fully evaluated. It may live in the
2422 stack frame we're about to pop. */
2423 if (value_lazy (return_value))
2424 value_fetch_lazy (return_value);
2426 if (thisfun != NULL)
2427 function = read_var_value (thisfun, thisframe);
2429 rv_conv = RETURN_VALUE_REGISTER_CONVENTION;
2430 if (TYPE_CODE (return_type) == TYPE_CODE_VOID)
2431 /* If the return-type is "void", don't try to find the
2432 return-value's location. However, do still evaluate the
2433 return expression so that, even when the expression result
2434 is discarded, side effects such as "return i++" still
2436 return_value = NULL;
2437 else if (thisfun != NULL)
2439 rv_conv = struct_return_convention (gdbarch, function, return_type);
2440 if (rv_conv == RETURN_VALUE_STRUCT_CONVENTION
2441 || rv_conv == RETURN_VALUE_ABI_RETURNS_ADDRESS)
2443 query_prefix = "The location at which to store the "
2444 "function's return value is unknown.\n"
2445 "If you continue, the return value "
2446 "that you specified will be ignored.\n";
2447 return_value = NULL;
2452 /* Does an interactive user really want to do this? Include
2453 information, such as how well GDB can handle the return value, in
2454 the query message. */
2459 if (thisfun == NULL)
2460 confirmed = query (_("%sMake selected stack frame return now? "),
2463 confirmed = query (_("%sMake %s return now? "), query_prefix,
2464 SYMBOL_PRINT_NAME (thisfun));
2466 error (_("Not confirmed"));
2469 /* Discard the selected frame and all frames inner-to it. */
2470 frame_pop (get_selected_frame (NULL));
2472 /* Store RETURN_VALUE in the just-returned register set. */
2473 if (return_value != NULL)
2475 struct type *return_type = value_type (return_value);
2476 struct gdbarch *gdbarch = get_regcache_arch (get_current_regcache ());
2478 gdb_assert (rv_conv != RETURN_VALUE_STRUCT_CONVENTION
2479 && rv_conv != RETURN_VALUE_ABI_RETURNS_ADDRESS);
2480 gdbarch_return_value (gdbarch, function, return_type,
2481 get_current_regcache (), NULL /*read*/,
2482 value_contents (return_value) /*write*/);
2485 /* If we are at the end of a call dummy now, pop the dummy frame
2487 if (get_frame_type (get_current_frame ()) == DUMMY_FRAME)
2488 frame_pop (get_current_frame ());
2490 /* If interactive, print the frame that is now current. */
2492 frame_command ("0", 1);
2494 select_frame_command ("0", 0);
2497 /* Sets the scope to input function name, provided that the function
2498 is within the current stack frame. */
2500 struct function_bounds
2502 CORE_ADDR low, high;
2506 func_command (char *arg, int from_tty)
2508 struct frame_info *frame;
2510 struct symtabs_and_lines sals;
2513 struct function_bounds *func_bounds = NULL;
2514 struct cleanup *cleanups;
2519 frame = parse_frame_specification ("0");
2520 sals = decode_line_with_current_source (arg, DECODE_LINE_FUNFIRSTLINE);
2521 cleanups = make_cleanup (xfree, sals.sals);
2522 func_bounds = (struct function_bounds *) xmalloc (
2523 sizeof (struct function_bounds) * sals.nelts);
2524 make_cleanup (xfree, func_bounds);
2525 for (i = 0; (i < sals.nelts && !found); i++)
2527 if (sals.sals[i].pspace != current_program_space)
2528 func_bounds[i].low = func_bounds[i].high = 0;
2529 else if (sals.sals[i].pc == 0
2530 || find_pc_partial_function (sals.sals[i].pc, NULL,
2531 &func_bounds[i].low,
2532 &func_bounds[i].high) == 0)
2534 func_bounds[i].low = func_bounds[i].high = 0;
2540 for (i = 0; (i < sals.nelts && !found); i++)
2541 found = (get_frame_pc (frame) >= func_bounds[i].low
2542 && get_frame_pc (frame) < func_bounds[i].high);
2546 frame = find_relative_frame (frame, &level);
2549 while (!found && level == 0);
2551 do_cleanups (cleanups);
2554 printf_filtered (_("'%s' not within current stack frame.\n"), arg);
2555 else if (frame != get_selected_frame (NULL))
2556 select_and_print_frame (frame);
2559 /* Gets the language of the current frame. */
2562 get_frame_language (void)
2564 struct frame_info *frame = deprecated_safe_get_selected_frame ();
2568 volatile struct gdb_exception ex;
2572 /* We determine the current frame language by looking up its
2573 associated symtab. To retrieve this symtab, we use the frame
2574 PC. However we cannot use the frame PC as is, because it
2575 usually points to the instruction following the "call", which
2576 is sometimes the first instruction of another function. So
2577 we rely on get_frame_address_in_block(), it provides us with
2578 a PC that is guaranteed to be inside the frame's code
2581 TRY_CATCH (ex, RETURN_MASK_ERROR)
2583 pc = get_frame_address_in_block (frame);
2587 if (ex.error != NOT_AVAILABLE_ERROR)
2588 throw_exception (ex);
2592 s = find_pc_symtab (pc);
2598 return language_unknown;
2602 /* Provide a prototype to silence -Wmissing-prototypes. */
2603 void _initialize_stack (void);
2606 _initialize_stack (void)
2608 add_com ("return", class_stack, return_command, _("\
2609 Make selected stack frame return to its caller.\n\
2610 Control remains in the debugger, but when you continue\n\
2611 execution will resume in the frame above the one now selected.\n\
2612 If an argument is given, it is an expression for the value to return."));
2614 add_com ("up", class_stack, up_command, _("\
2615 Select and print stack frame that called this one.\n\
2616 An argument says how many frames up to go."));
2617 add_com ("up-silently", class_support, up_silently_command, _("\
2618 Same as the `up' command, but does not print anything.\n\
2619 This is useful in command scripts."));
2621 add_com ("down", class_stack, down_command, _("\
2622 Select and print stack frame called by this one.\n\
2623 An argument says how many frames down to go."));
2624 add_com_alias ("do", "down", class_stack, 1);
2625 add_com_alias ("dow", "down", class_stack, 1);
2626 add_com ("down-silently", class_support, down_silently_command, _("\
2627 Same as the `down' command, but does not print anything.\n\
2628 This is useful in command scripts."));
2630 add_com ("frame", class_stack, frame_command, _("\
2631 Select and print a stack frame.\nWith no argument, \
2632 print the selected stack frame. (See also \"info frame\").\n\
2633 An argument specifies the frame to select.\n\
2634 It can be a stack frame number or the address of the frame.\n\
2635 With argument, nothing is printed if input is coming from\n\
2636 a command file or a user-defined command."));
2638 add_com_alias ("f", "frame", class_stack, 1);
2642 add_com ("L", class_stack, current_frame_command,
2643 _("Print the current stack frame.\n"));
2644 add_com_alias ("V", "frame", class_stack, 1);
2646 add_com ("select-frame", class_stack, select_frame_command, _("\
2647 Select a stack frame without printing anything.\n\
2648 An argument specifies the frame to select.\n\
2649 It can be a stack frame number or the address of the frame.\n"));
2651 add_com ("backtrace", class_stack, backtrace_command, _("\
2652 Print backtrace of all stack frames, or innermost COUNT frames.\n\
2653 With a negative argument, print outermost -COUNT frames.\nUse of the \
2654 'full' qualifier also prints the values of the local variables.\n\
2655 Use of the 'no-filters' qualifier prohibits frame filters from executing\n\
2656 on this backtrace.\n"));
2657 add_com_alias ("bt", "backtrace", class_stack, 0);
2660 add_com_alias ("t", "backtrace", class_stack, 0);
2661 add_com ("T", class_stack, backtrace_full_command, _("\
2662 Print backtrace of all stack frames, or innermost COUNT frames\n\
2663 and the values of the local variables.\n\
2664 With a negative argument, print outermost -COUNT frames.\n\
2665 Usage: T <count>\n"));
2668 add_com_alias ("where", "backtrace", class_alias, 0);
2669 add_info ("stack", backtrace_command,
2670 _("Backtrace of the stack, or innermost COUNT frames."));
2671 add_info_alias ("s", "stack", 1);
2672 add_info ("frame", frame_info,
2673 _("All about selected stack frame, or frame at ADDR."));
2674 add_info_alias ("f", "frame", 1);
2675 add_info ("locals", locals_info,
2676 _("Local variables of current stack frame."));
2677 add_info ("args", args_info,
2678 _("Argument variables of current stack frame."));
2680 add_com ("l", class_info, args_plus_locals_info,
2681 _("Argument and local variables of current stack frame."));
2684 add_com ("func", class_stack, func_command, _("\
2685 Select the stack frame that contains <func>.\n\
2686 Usage: func <name>\n"));
2688 add_setshow_enum_cmd ("frame-arguments", class_stack,
2689 print_frame_arguments_choices, &print_frame_arguments,
2690 _("Set printing of non-scalar frame arguments"),
2691 _("Show printing of non-scalar frame arguments"),
2692 NULL, NULL, NULL, &setprintlist, &showprintlist);
2694 add_setshow_boolean_cmd ("frame-arguments", no_class,
2695 &print_raw_frame_arguments, _("\
2696 Set whether to print frame arguments in raw form."), _("\
2697 Show whether to print frame arguments in raw form."), _("\
2698 If set, frame arguments are printed in raw form, bypassing any\n\
2699 pretty-printers for that value."),
2701 &setprintrawlist, &showprintrawlist);
2703 add_setshow_auto_boolean_cmd ("disassemble-next-line", class_stack,
2704 &disassemble_next_line, _("\
2705 Set whether to disassemble next source line or insn when execution stops."),
2707 Show whether to disassemble next source line or insn when execution stops."),
2709 If ON, GDB will display disassembly of the next source line, in addition\n\
2710 to displaying the source line itself. If the next source line cannot\n\
2711 be displayed (e.g., source is unavailable or there's no line info), GDB\n\
2712 will display disassembly of next instruction instead of showing the\n\
2714 If AUTO, display disassembly of next instruction only if the source line\n\
2715 cannot be displayed.\n\
2716 If OFF (which is the default), never display the disassembly of the next\n\
2719 show_disassemble_next_line,
2720 &setlist, &showlist);
2721 disassemble_next_line = AUTO_BOOLEAN_FALSE;
2723 add_setshow_enum_cmd ("entry-values", class_stack,
2724 print_entry_values_choices, &print_entry_values,
2725 _("Set printing of function arguments at function "
2727 _("Show printing of function arguments at function "
2730 GDB can sometimes determine the values of function arguments at entry,\n\
2731 in addition to their current values. This option tells GDB whether\n\
2732 to print the current value, the value at entry (marked as val@entry),\n\
2733 or both. Note that one or both of these values may be <optimized out>."),
2734 NULL, NULL, &setprintlist, &showprintlist);