gdb/blockframe.c - gdb

Global variables defined

Functions defined

Source code

  1. /* Get info from stack frames; convert between frames, blocks,
  2.    functions and pc values.

  4.    Copyright (C) 1986-2015 Free Software Foundation, Inc.

  6.    This file is part of GDB.

  8.    This program is free software; you can redistribute it and/or modify
  9.    it under the terms of the GNU General Public License as published by
  10.    the Free Software Foundation; either version 3 of the License, or
  11.    (at your option) any later version.

  13.    This program is distributed in the hope that it will be useful,
  14.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.    GNU General Public License for more details.

  18.    You should have received a copy of the GNU General Public License
  19.    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */

  21. #include "defs.h"
  22. #include "symtab.h"
  23. #include "bfd.h"
  24. #include "objfiles.h"
  25. #include "frame.h"
  26. #include "gdbcore.h"
  27. #include "value.h"
  28. #include "target.h"
  29. #include "inferior.h"
  30. #include "annotate.h"
  31. #include "regcache.h"
  32. #include "dummy-frame.h"
  33. #include "command.h"
  34. #include "gdbcmd.h"
  35. #include "block.h"
  36. #include "inline-frame.h"

  38. /* Return the innermost lexical block in execution in a specified
  39.    stack frame.  The frame address is assumed valid.

  41.    If ADDR_IN_BLOCK is non-zero, set *ADDR_IN_BLOCK to the exact code
  42.    address we used to choose the block.  We use this to find a source
  43.    line, to decide which macro definitions are in scope.

  45.    The value returned in *ADDR_IN_BLOCK isn't necessarily the frame's
  46.    PC, and may not really be a valid PC at all.  For example, in the
  47.    caller of a function declared to never return, the code at the
  48.    return address will never be reached, so the call instruction may
  49.    be the very last instruction in the block.  So the address we use
  50.    to choose the block is actually one byte before the return address
  51.    --- hopefully pointing us at the call instruction, or its delay
  52.    slot instruction.  */

  54. const struct block *
  55. ‌get_frame_block (struct frame_info *frame, CORE_ADDR *addr_in_block)
  56. {
  57.   CORE_ADDR pc;
  58.   const struct block *bl;
  59.   int inline_count;

  61.   if (!get_frame_address_in_block_if_available (frame, &pc))
  62.     return NULL;

  64.   if (addr_in_block)
  65.     *addr_in_block = pc;

  67.   bl = block_for_pc (pc);
  68.   if (bl == NULL)
  69.     return NULL;

  71.   inline_count = frame_inlined_callees (frame);

  73.   while (inline_count > 0)
  74.     {
  75.       if (block_inlined_p (bl))
  76.         inline_count--;

  78.       bl = BLOCK_SUPERBLOCK (bl);
  79.       gdb_assert (bl != NULL);
  80.     }

  82.   return bl;
  83. }

  85. CORE_ADDR
  86. ‌get_pc_function_start (CORE_ADDR pc)
  87. {
  88.   const struct block *bl;
  89.   struct bound_minimal_symbol msymbol;

  91.   bl = block_for_pc (pc);
  92.   if (bl)
  93.     {
  94.       struct symbol *symbol = block_linkage_function (bl);

  96.       if (symbol)
  97.         {
  98.           bl = SYMBOL_BLOCK_VALUE (symbol);
  99.           return BLOCK_START (bl);
  100.         }
  101.     }

  103.   msymbol = lookup_minimal_symbol_by_pc (pc);
  104.   if (msymbol.minsym)
  105.     {
  106.       CORE_ADDR fstart = BMSYMBOL_VALUE_ADDRESS (msymbol);

  108.       if (find_pc_section (fstart))
  109.         return fstart;
  110.     }

  112.   return 0;
  113. }

  115. /* Return the symbol for the function executing in frame FRAME.  */

  117. struct symbol *
  118. ‌get_frame_function (struct frame_info *frame)
  119. {
  120.   const struct block *bl = get_frame_block (frame, 0);

  122.   if (bl == NULL)
  123.     return NULL;

  125.   while (BLOCK_FUNCTION (bl) == NULL && BLOCK_SUPERBLOCK (bl) != NULL)
  126.     bl = BLOCK_SUPERBLOCK (bl);

  128.   return BLOCK_FUNCTION (bl);
  129. }


  132. /* Return the function containing pc value PC in section SECTION.
  133.    Returns 0 if function is not known.  */

  135. struct symbol *
  136. ‌find_pc_sect_function (CORE_ADDR pc, struct obj_section *section)
  137. {
  138.   const struct block *b = block_for_pc_sect (pc, section);

  140.   if (b == 0)
  141.     return 0;
  142.   return block_linkage_function (b);
  143. }

  145. /* Return the function containing pc value PC.
  146.    Returns 0 if function is not known.
  147.    Backward compatibility, no section */

  149. struct symbol *
  150. ‌find_pc_function (CORE_ADDR pc)
  151. {
  152.   return find_pc_sect_function (pc, find_pc_mapped_section (pc));
  153. }

  155. /* These variables are used to cache the most recent result
  156.    of find_pc_partial_function.  */

  158. ‌static CORE_ADDR cache_pc_function_low = 0;
  159. ‌static CORE_ADDR cache_pc_function_high = 0;
  160. ‌static const char *cache_pc_function_name = 0;
  161. ‌static struct obj_section *cache_pc_function_section = NULL;
  162. ‌static int cache_pc_function_is_gnu_ifunc = 0;

  164. /* Clear cache, e.g. when symbol table is discarded.  */

  166. void
  167. ‌clear_pc_function_cache (void)
  168. {
  169.   cache_pc_function_low = 0;
  170.   cache_pc_function_high = 0;
  171.   cache_pc_function_name = (char *) 0;
  172.   cache_pc_function_section = NULL;
  173.   cache_pc_function_is_gnu_ifunc = 0;
  174. }

  176. /* Finds the "function" (text symbol) that is smaller than PC but
  177.    greatest of all of the potential text symbols in SECTION.  Sets
  178.    *NAME and/or *ADDRESS conditionally if that pointer is non-null.
  179.    If ENDADDR is non-null, then set *ENDADDR to be the end of the
  180.    function (exclusive), but passing ENDADDR as non-null means that
  181.    the function might cause symbols to be read.  If IS_GNU_IFUNC_P is provided
  182.    *IS_GNU_IFUNC_P is set to 1 on return if the function is STT_GNU_IFUNC.
  183.    This function either succeeds or fails (not halfway succeeds).  If it
  184.    succeeds, it sets *NAME, *ADDRESS, and *ENDADDR to real information and
  185.    returns 1.  If it fails, it sets *NAME, *ADDRESS, *ENDADDR and
  186.    *IS_GNU_IFUNC_P to zero and returns 0.  */

  188. /* Backward compatibility, no section argument.  */

  190. int
  191. ‌find_pc_partial_function_gnu_ifunc (CORE_ADDR pc, const char **name,
  192.                                     CORE_ADDR *address, CORE_ADDR *endaddr,
  193.                                     int *is_gnu_ifunc_p)
  194. {
  195.   struct obj_section *section;
  196.   struct symbol *f;
  197.   struct bound_minimal_symbol msymbol;
  198.   struct compunit_symtab *compunit_symtab = NULL;
  199.   struct objfile *objfile;
  200.   int i;
  201.   CORE_ADDR mapped_pc;

  203.   /* To ensure that the symbol returned belongs to the correct setion
  204.      (and that the last [random] symbol from the previous section
  205.      isn't returned) try to find the section containing PC.  First try
  206.      the overlay code (which by default returns NULL); and second try
  207.      the normal section code (which almost always succeeds).  */
  208.   section = find_pc_overlay (pc);
  209.   if (section == NULL)
  210.     section = find_pc_section (pc);

  212.   mapped_pc = overlay_mapped_address (pc, section);

  214.   if (mapped_pc >= cache_pc_function_low
  215.       && mapped_pc < cache_pc_function_high
  216.       && section == cache_pc_function_section)
  217.     goto return_cached_value;

  219.   msymbol = lookup_minimal_symbol_by_pc_section (mapped_pc, section);
  220.   ALL_OBJFILES (objfile)
  221.   {
  222.     if (objfile->sf)
  223.       {
  224.         compunit_symtab
  225.           = objfile->sf->qf->find_pc_sect_compunit_symtab (objfile, msymbol,
  226.                                                            mapped_pc, section,
  227.                                                            0);
  228.       }
  229.     if (compunit_symtab != NULL)
  230.       break;
  231.   }

  233.   if (compunit_symtab != NULL)
  234.     {
  235.       /* Checking whether the msymbol has a larger value is for the
  236.          "pathological" case mentioned in print_frame_info.  */
  237.       f = find_pc_sect_function (mapped_pc, section);
  238.       if (f != NULL
  239.           && (msymbol.minsym == NULL
  240.               || (BLOCK_START (SYMBOL_BLOCK_VALUE (f))
  241.                   >= BMSYMBOL_VALUE_ADDRESS (msymbol))))
  242.         {
  243.           cache_pc_function_low = BLOCK_START (SYMBOL_BLOCK_VALUE (f));
  244.           cache_pc_function_high = BLOCK_END (SYMBOL_BLOCK_VALUE (f));
  245.           cache_pc_function_name = SYMBOL_LINKAGE_NAME (f);
  246.           cache_pc_function_section = section;
  247.           cache_pc_function_is_gnu_ifunc = TYPE_GNU_IFUNC (SYMBOL_TYPE (f));
  248.           goto return_cached_value;
  249.         }
  250.     }

  252.   /* Not in the normal symbol tables, see if the pc is in a known
  253.      section.  If it's not, then give up.  This ensures that anything
  254.      beyond the end of the text seg doesn't appear to be part of the
  255.      last function in the text segment.  */

  257.   if (!section)
  258.     msymbol.minsym = NULL;

  260.   /* Must be in the minimal symbol table.  */
  261.   if (msymbol.minsym == NULL)
  262.     {
  263.       /* No available symbol.  */
  264.       if (name != NULL)
  265.         *name = 0;
  266.       if (address != NULL)
  267.         *address = 0;
  268.       if (endaddr != NULL)
  269.         *endaddr = 0;
  270.       if (is_gnu_ifunc_p != NULL)
  271.         *is_gnu_ifunc_p = 0;
  272.       return 0;
  273.     }

  275.   cache_pc_function_low = BMSYMBOL_VALUE_ADDRESS (msymbol);
  276.   cache_pc_function_name = MSYMBOL_LINKAGE_NAME (msymbol.minsym);
  277.   cache_pc_function_section = section;
  278.   cache_pc_function_is_gnu_ifunc = (MSYMBOL_TYPE (msymbol.minsym)
  279.                                     == mst_text_gnu_ifunc);
  280.   cache_pc_function_high = minimal_symbol_upper_bound (msymbol);

  282. return_cached_value:

  284.   if (address)
  285.     {
  286.       if (pc_in_unmapped_range (pc, section))
  287.         *address = overlay_unmapped_address (cache_pc_function_low, section);
  288.       else
  289.         *address = cache_pc_function_low;
  290.     }

  292.   if (name)
  293.     *name = cache_pc_function_name;

  295.   if (endaddr)
  296.     {
  297.       if (pc_in_unmapped_range (pc, section))
  298.         {
  299.           /* Because the high address is actually beyond the end of
  300.              the function (and therefore possibly beyond the end of
  301.              the overlay), we must actually convert (high - 1) and
  302.              then add one to that.  */

  304.           *endaddr = 1 + overlay_unmapped_address (cache_pc_function_high - 1,
  305.                                                    section);
  306.         }
  307.       else
  308.         *endaddr = cache_pc_function_high;
  309.     }

  311.   if (is_gnu_ifunc_p)
  312.     *is_gnu_ifunc_p = cache_pc_function_is_gnu_ifunc;

  314.   return 1;
  315. }

  317. /* See find_pc_partial_function_gnu_ifunc, only the IS_GNU_IFUNC_P parameter
  318.    is omitted here for backward API compatibility.  */

  320. int
  321. ‌find_pc_partial_function (CORE_ADDR pc, const char **name, CORE_ADDR *address,
  322.                           CORE_ADDR *endaddr)
  323. {
  324.   return find_pc_partial_function_gnu_ifunc (pc, name, address, endaddr, NULL);
  325. }

  327. /* Return the innermost stack frame that is executing inside of BLOCK and is
  328.    at least as old as the selected frame. Return NULL if there is no
  329.    such frame.  If BLOCK is NULL, just return NULL.  */

  331. struct frame_info *
  332. ‌block_innermost_frame (const struct block *block)
  333. {
  334.   struct frame_info *frame;

  336.   if (block == NULL)
  337.     return NULL;

  339.   frame = get_selected_frame_if_set ();
  340.   if (frame == NULL)
  341.     frame = get_current_frame ();
  342.   while (frame != NULL)
  343.     {
  344.       const struct block *frame_block = get_frame_block (frame, NULL);
  345.       if (frame_block != NULL && contained_in (frame_block, block))
  346.         return frame;

  348.       frame = get_prev_frame (frame);
  349.     }

  351.   return NULL;
  352. }