gdb/stack.h

   1 /* Stack manipulation commands, for GDB the GNU Debugger.
   2
   3    Copyright (C) 2003-2021 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   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.
  11
  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.
  16
  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/>.  */
  19
  20 #ifndef STACK_H
  21 #define STACK_H
  22
  23 /* Access method used by the MI -stack-select-frame command to switch to
  24    frame FI.  This differs from SELECT_FRAME in that the observers for a
  25    user selected context change will be triggered.  */
  26
  27 void select_frame_for_mi (struct frame_info *fi);
  28
  29 gdb::unique_xmalloc_ptr<char> find_frame_funname (struct frame_info *frame,
  30                                                   enum language *funlang,
  31                                                   struct symbol **funcp);
  32
  33 typedef void (*iterate_over_block_arg_local_vars_cb) (const char *print_name,
  34                                                       struct symbol *sym,
  35                                                       void *cb_data);
  36
  37 void iterate_over_block_arg_vars (const struct block *block,
  38                                   iterate_over_block_arg_local_vars_cb cb,
  39                                   void *cb_data);
  40
  41 void iterate_over_block_local_vars (const struct block *block,
  42                                     iterate_over_block_arg_local_vars_cb cb,
  43                                     void *cb_data);
  44
  45 /* Initialize *WHAT to be a copy of the user desired print what frame info.
  46    If !WHAT.has_value (), the printing function chooses a default set of
  47    information to print, otherwise the printing function should print
  48    the relevant information.  */
  49
  50 void get_user_print_what_frame_info (gdb::optional<enum print_what> *what);
  51
  52 /* Return true if we should display the address in addition to the location,
  53    because we are in the middle of a statement.  */
  54
  55 bool frame_show_address (struct frame_info *frame, struct symtab_and_line sal);
  56
  57 /* Forget the last sal we displayed.  */
  58
  59 void clear_last_displayed_sal (void);
  60
  61 /* Is our record of the last sal we displayed valid?  If not, the
  62    get_last_displayed_* functions will return NULL or 0, as appropriate.  */
  63
  64 bool last_displayed_sal_is_valid (void);
  65
  66 /* Get the pspace of the last sal we displayed, if it's valid, otherwise
  67    return nullptr.  */
  68
  69 struct program_space* get_last_displayed_pspace (void);
  70
  71 /* Get the address of the last sal we displayed, if it's valid, otherwise
  72    return an address of 0.  */
  73
  74 CORE_ADDR get_last_displayed_addr (void);
  75
  76 /* Get the symtab of the last sal we displayed, if it's valid, otherwise
  77    return nullptr.  */
  78
  79 struct symtab* get_last_displayed_symtab (void);
  80
  81 /* Get the line of the last sal we displayed, if it's valid, otherwise
  82    return 0.  */
  83
  84 int get_last_displayed_line (void);
  85
  86 /* Get the last sal we displayed, if it's valid, otherwise return a
  87    symtab_and_line constructed in its default state.  */
  88
  89 symtab_and_line get_last_displayed_sal ();
  90
  91 /* Completer for the "frame apply all" command.  */
  92 void frame_apply_all_cmd_completer (struct cmd_list_element *ignore,
  93                                     completion_tracker &tracker,
  94                                     const char *text, const char */*word*/);
  95
  96 #endif /* #ifndef STACK_H */