LCOV - code coverage report
Current view: top level - libdwfl - dwfl_module_addrsym.c (source / functions) Hit Total Coverage
Test: elfutils-0.191 Lines: 96 113 85.0 %
Date: 2024-08-30 14:58:23 Functions: 5 6 83.3 %
Legend: Lines: hit not hit | Branches: + taken - not taken # not executed Branches: 82 106 77.4 %

           Branch data     Line data    Source code
       1                 :            : /* Find debugging and symbol information for a module in libdwfl.
       2                 :            :    Copyright (C) 2005-2013 Red Hat, Inc.
       3                 :            :    This file is part of elfutils.
       4                 :            : 
       5                 :            :    This file is free software; you can redistribute it and/or modify
       6                 :            :    it under the terms of either
       7                 :            : 
       8                 :            :      * the GNU Lesser General Public License as published by the Free
       9                 :            :        Software Foundation; either version 3 of the License, or (at
      10                 :            :        your option) any later version
      11                 :            : 
      12                 :            :    or
      13                 :            : 
      14                 :            :      * the GNU General Public License as published by the Free
      15                 :            :        Software Foundation; either version 2 of the License, or (at
      16                 :            :        your option) any later version
      17                 :            : 
      18                 :            :    or both in parallel, as here.
      19                 :            : 
      20                 :            :    elfutils is distributed in the hope that it will be useful, but
      21                 :            :    WITHOUT ANY WARRANTY; without even the implied warranty of
      22                 :            :    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      23                 :            :    General Public License for more details.
      24                 :            : 
      25                 :            :    You should have received copies of the GNU General Public License and
      26                 :            :    the GNU Lesser General Public License along with this program.  If
      27                 :            :    not, see <http://www.gnu.org/licenses/>.  */
      28                 :            : 
      29                 :            : #ifdef HAVE_CONFIG_H
      30                 :            : # include <config.h>
      31                 :            : #endif
      32                 :            : 
      33                 :            : #include "libdwflP.h"
      34                 :            : 
      35                 :            : struct search_state
      36                 :            : {
      37                 :            :   Dwfl_Module *mod;
      38                 :            :   GElf_Addr addr;
      39                 :            : 
      40                 :            :   GElf_Sym *closest_sym;
      41                 :            :   bool adjust_st_value;
      42                 :            :   GElf_Word addr_shndx;
      43                 :            :   Elf *addr_symelf;
      44                 :            : 
      45                 :            :   /* Keep track of the closest symbol we have seen so far.
      46                 :            :      Here we store only symbols with nonzero st_size.  */
      47                 :            :   const char *closest_name;
      48                 :            :   GElf_Addr closest_value;
      49                 :            :   GElf_Word closest_shndx;
      50                 :            :   Elf *closest_elf;
      51                 :            : 
      52                 :            :   /* Keep track of an eligible symbol with st_size == 0 as a fallback.  */
      53                 :            :   const char *sizeless_name;
      54                 :            :   GElf_Sym sizeless_sym;
      55                 :            :   GElf_Addr sizeless_value;
      56                 :            :   GElf_Word sizeless_shndx;
      57                 :            :   Elf *sizeless_elf;
      58                 :            : 
      59                 :            :   /* Keep track of the lowest address a relevant sizeless symbol could have.  */
      60                 :            :   GElf_Addr min_label;
      61                 :            : };
      62                 :            : 
      63                 :            : /* Return true iff we consider ADDR to lie in the same section as SYM.  */
      64                 :            : static inline bool
      65                 :       4528 : same_section (struct search_state *state,
      66                 :            :               GElf_Addr value, Elf *symelf, GElf_Word shndx)
      67                 :            : {
      68                 :            :   /* For absolute symbols and the like, only match exactly.  */
      69         [ +  + ]:       4528 :   if (shndx >= SHN_LORESERVE)
      70                 :        408 :     return value == state->addr;
      71                 :            : 
      72                 :            :   /* If value might not be st_value, the shndx of the symbol might
      73                 :            :       not match the section of the value. Explicitly look both up.  */
      74         [ +  - ]:       4120 :   if (! state->adjust_st_value)
      75                 :            :     {
      76                 :       4120 :       Dwarf_Addr v;
      77         [ +  + ]:       4120 :       if (state->addr_shndx == SHN_UNDEF)
      78                 :            :         {
      79                 :       3122 :           v = state->addr;
      80                 :       3122 :           state->addr_shndx = __libdwfl_find_section_ndx (state->mod, &v);
      81                 :            :         }
      82                 :            : 
      83                 :       4120 :       v = value;
      84                 :       4120 :       return state->addr_shndx == __libdwfl_find_section_ndx (state->mod, &v);
      85                 :            :     }
      86                 :            : 
      87                 :            :   /* Figure out what section ADDR lies in.  */
      88   [ #  #  #  # ]:          0 :   if (state->addr_shndx == SHN_UNDEF || state->addr_symelf != symelf)
      89                 :            :     {
      90                 :          0 :       GElf_Addr mod_addr = dwfl_deadjust_st_value (state->mod, symelf,
      91                 :            :                                                    state->addr);
      92                 :          0 :       Elf_Scn *scn = NULL;
      93                 :          0 :       state->addr_shndx = SHN_ABS;
      94                 :          0 :       state->addr_symelf = symelf;
      95         [ #  # ]:          0 :       while ((scn = elf_nextscn (symelf, scn)) != NULL)
      96                 :            :         {
      97                 :          0 :           GElf_Shdr shdr_mem;
      98                 :          0 :           GElf_Shdr *shdr = gelf_getshdr (scn, &shdr_mem);
      99         [ #  # ]:          0 :           if (likely (shdr != NULL)
     100         [ #  # ]:          0 :               && mod_addr >= shdr->sh_addr
     101         [ #  # ]:          0 :               && mod_addr < shdr->sh_addr + shdr->sh_size)
     102                 :            :             {
     103                 :          0 :               state->addr_shndx = elf_ndxscn (scn);
     104                 :          0 :               break;
     105                 :            :             }
     106                 :            :         }
     107                 :            :     }
     108                 :            : 
     109   [ #  #  #  # ]:          0 :   return shndx == state->addr_shndx && state->addr_symelf == symelf;
     110                 :            : }
     111                 :            : 
     112                 :            : /* Return GELF_ST_BIND as higher-is-better integer.  */
     113                 :            : static inline int
     114                 :      36524 : binding_value (const GElf_Sym *symp)
     115                 :            : {
     116                 :      36524 :   switch (GELF_ST_BIND (symp->st_info))
     117                 :            :     {
     118                 :            :     case STB_GLOBAL:
     119                 :            :       return 3;
     120                 :            :     case STB_WEAK:
     121                 :            :       return 2;
     122                 :            :     case STB_LOCAL:
     123                 :            :       return 1;
     124                 :            :     default:
     125                 :            :       return 0;
     126                 :            :     }
     127                 :            : }
     128                 :            : 
     129                 :            : /* Try one symbol and associated value from the search table.  */
     130                 :            : static inline void
     131                 :    5282620 : try_sym_value (struct search_state *state,
     132                 :            :                GElf_Addr value, GElf_Sym *sym,
     133                 :            :                const char *name, GElf_Word shndx,
     134                 :            :                Elf *elf, bool resolved)
     135                 :            : {
     136                 :            :     /* Even if we don't choose this symbol, its existence excludes
     137                 :            :        any sizeless symbol (assembly label) that is below its upper
     138                 :            :        bound.  */
     139         [ +  + ]:    5282620 :     if (value + sym->st_size > state->min_label)
     140                 :     283572 :       state->min_label = value + sym->st_size;
     141                 :            : 
     142   [ +  +  +  + ]:    5282620 :     if (sym->st_size == 0 || state->addr - value < sym->st_size)
     143                 :            :       {
     144                 :            :         /* This symbol is a better candidate than the current one
     145                 :            :            if it's closer to ADDR or is global when it was local.  */
     146         [ +  + ]:      44184 :         if (state->closest_name == NULL
     147         [ +  + ]:      18274 :             || state->closest_value < value
     148   [ +  -  +  -  :      54786 :             || binding_value (state->closest_sym) < binding_value (sym))
                   +  + ]
     149                 :            :           {
     150         [ +  + ]:      26004 :             if (sym->st_size != 0)
     151                 :            :               {
     152                 :      13204 :                 *state->closest_sym = *sym;
     153                 :      13204 :                 state->closest_value = value;
     154                 :      13204 :                 state->closest_shndx = shndx;
     155                 :      13204 :                 state->closest_elf = elf;
     156                 :      13204 :                 state->closest_name = name;
     157                 :            :               }
     158         [ +  + ]:      12800 :             else if (state->closest_name == NULL
     159         [ +  + ]:      12720 :                      && value >= state->min_label
     160   [ +  +  +  + ]:       4648 :                      && same_section (state, value,
     161                 :        120 :                                       resolved ? state->mod->main.elf : elf,
     162                 :            :                                       shndx))
     163                 :            :               {
     164                 :            :                 /* Handwritten assembly symbols sometimes have no
     165                 :            :                    st_size.  If no symbol with proper size includes
     166                 :            :                    the address, we'll use the closest one that is in
     167                 :            :                    the same section as ADDR.  */
     168                 :       1520 :                 state->sizeless_sym = *sym;
     169                 :       1520 :                 state->sizeless_value = value;
     170                 :       1520 :                 state->sizeless_shndx = shndx;
     171                 :       1520 :                 state->sizeless_elf = elf;
     172                 :       1520 :                 state->sizeless_name = name;
     173                 :            :               }
     174                 :            :           }
     175                 :            :         /* When the beginning of its range is no closer,
     176                 :            :            the end of its range might be.  Otherwise follow
     177                 :            :            GELF_ST_BIND preference.  If all are equal prefer
     178                 :            :            the first symbol found.  */
     179         [ +  + ]:      18180 :         else if (sym->st_size != 0
     180         [ +  + ]:        188 :                  && state->closest_value == value
     181         [ +  + ]:        186 :                  && ((state->closest_sym->st_size > sym->st_size
     182                 :          8 :                       && (binding_value (state->closest_sym)
     183         [ +  - ]:          8 :                           <= binding_value (sym)))
     184                 :            :                      || (state->closest_sym->st_size >= sym->st_size
     185                 :            :                          && (binding_value (state->closest_sym)
     186                 :            :                              < binding_value (sym)))))
     187                 :            :           {
     188                 :          8 :             *state->closest_sym = *sym;
     189                 :          8 :             state->closest_value = value;
     190                 :          8 :             state->closest_shndx = shndx;
     191                 :          8 :             state->closest_elf = elf;
     192                 :          8 :             state->closest_name = name;
     193                 :            :           }
     194                 :            :       }
     195                 :    5282620 : }
     196                 :            : 
     197                 :            : /* Look through the symbol table for a matching symbol.  */
     198                 :            : static inline void
     199                 :      20680 : search_table (struct search_state *state, int start, int end)
     200                 :            : {
     201         [ +  + ]:   36351562 :       for (int i = start; i < end; ++i)
     202                 :            :         {
     203                 :   36330882 :           GElf_Sym sym;
     204                 :   36330882 :           GElf_Addr value;
     205                 :   36330882 :           GElf_Word shndx;
     206                 :   36330882 :           Elf *elf;
     207                 :   36330882 :           bool resolved;
     208                 :   72661764 :           const char *name = __libdwfl_getsym (state->mod, i, &sym, &value,
     209                 :            :                                                &shndx, &elf, NULL,
     210                 :            :                                                &resolved,
     211                 :   36330882 :                                                state->adjust_st_value);
     212   [ +  -  +  + ]:   36330882 :           if (name != NULL && name[0] != '\0'
     213         [ +  + ]:   36306558 :               && sym.st_shndx != SHN_UNDEF
     214         [ +  + ]:   34825224 :               && value <= state->addr
     215         [ +  + ]:    7381442 :               && GELF_ST_TYPE (sym.st_info) != STT_SECTION
     216         [ +  + ]:    7381400 :               && GELF_ST_TYPE (sym.st_info) != STT_FILE
     217         [ +  + ]:    5311922 :               && GELF_ST_TYPE (sym.st_info) != STT_TLS)
     218                 :            :             {
     219                 :    5282612 :               try_sym_value (state, value, &sym, name, shndx, elf, resolved);
     220                 :            : 
     221                 :            :               /* If this is an addrinfo variant and the value could be
     222                 :            :                  resolved then also try matching the (adjusted) st_value.  */
     223   [ +  +  +  - ]:    5282612 :               if (resolved && state->mod->e_type != ET_REL)
     224                 :            :                 {
     225                 :        662 :                   GElf_Addr adjusted_st_value;
     226                 :        662 :                   adjusted_st_value = dwfl_adjusted_st_value (state->mod, elf,
     227                 :            :                                                               sym.st_value);
     228         [ +  - ]:        662 :                   if (value != adjusted_st_value
     229         [ +  + ]:        662 :                       && adjusted_st_value <= state->addr)
     230                 :          8 :                     try_sym_value (state, adjusted_st_value, &sym, name, shndx,
     231                 :            :                                    elf, false);
     232                 :            :                 }
     233                 :            :             }
     234                 :            :         }
     235                 :      20680 : }
     236                 :            : 
     237                 :            : /* Returns the name of the symbol "closest" to ADDR.
     238                 :            :    Never returns symbols at addresses above ADDR.
     239                 :            : 
     240                 :            :    Wrapper for old dwfl_module_addrsym and new dwfl_module_addrinfo.
     241                 :            :    adjust_st_value set to true returns adjusted SYM st_value, set to false
     242                 :            :    it will not adjust SYM at all, but does match against resolved values.   */
     243                 :            : static const char *
     244                 :      13902 : __libdwfl_addrsym (Dwfl_Module *_mod, GElf_Addr _addr, GElf_Off *off,
     245                 :            :                    GElf_Sym *_closest_sym, GElf_Word *shndxp,
     246                 :            :                    Elf **elfp, Dwarf_Addr *biasp, bool _adjust_st_value)
     247                 :            : {
     248                 :      13902 :   int syments = INTUSE(dwfl_module_getsymtab) (_mod);
     249         [ +  + ]:      13902 :   if (syments < 0)
     250                 :            :     return NULL;
     251                 :            : 
     252                 :      13884 :   struct search_state state =
     253                 :            :     {
     254                 :            :       .addr = _addr,
     255                 :            :       .mod = _mod,
     256                 :            :       .closest_sym = _closest_sym,
     257                 :            :       .adjust_st_value = _adjust_st_value,
     258                 :            :       .addr_shndx = SHN_UNDEF,
     259                 :            :       .addr_symelf = NULL,
     260                 :            :       .closest_name = NULL,
     261                 :            :       .closest_value = 0,
     262                 :            :       .closest_shndx = SHN_UNDEF,
     263                 :            :       .closest_elf = NULL,
     264                 :            :       .sizeless_name = NULL,
     265                 :            :       .sizeless_sym = { 0, 0, 0, 0, 0, SHN_UNDEF },
     266                 :            :       .sizeless_value = 0,
     267                 :            :       .sizeless_shndx = SHN_UNDEF,
     268                 :            :       .sizeless_elf = NULL,
     269                 :            :       .min_label = 0
     270                 :            :     };
     271                 :            : 
     272                 :            :   /* First go through global symbols.  mod->first_global and
     273                 :            :      mod->aux_first_global are setup by dwfl_module_getsymtab to the
     274                 :            :      index of the first global symbol in those symbol tables.  Both
     275                 :            :      are non-zero when the table exist, except when there is only a
     276                 :            :      dynsym table loaded through phdrs, then first_global is zero and
     277                 :            :      there will be no auxiliary table.  All symbols with local binding
     278                 :            :      come first in the symbol table, then all globals.  The zeroth,
     279                 :            :      null entry, in the auxiliary table is skipped if there is a main
     280                 :            :      table.  */
     281                 :      13884 :   int first_global = INTUSE (dwfl_module_getsymtab_first_global) (state.mod);
     282         [ -  + ]:      13884 :   if (first_global < 0)
     283                 :            :     return NULL;
     284         [ +  + ]:      13894 :   search_table (&state, first_global == 0 ? 1 : first_global, syments);
     285                 :            : 
     286                 :            :   /* If we found nothing searching the global symbols, then try the locals.
     287                 :            :      Unless we have a global sizeless symbol that matches exactly.  */
     288   [ +  +  +  + ]:      13884 :   if (state.closest_name == NULL && first_global > 1
     289   [ +  +  +  + ]:       6920 :       && (state.sizeless_name == NULL || state.sizeless_value != state.addr))
     290                 :       6796 :     search_table (&state, 1, first_global);
     291                 :            : 
     292                 :            :   /* If we found no proper sized symbol to use, fall back to the best
     293                 :            :      candidate sizeless symbol we found, if any.  */
     294         [ +  + ]:      13884 :   if (state.closest_name == NULL
     295         [ +  + ]:        694 :       && state.sizeless_name != NULL
     296         [ +  + ]:        310 :       && state.sizeless_value >= state.min_label)
     297                 :            :     {
     298                 :        274 :       *state.closest_sym = state.sizeless_sym;
     299                 :        274 :       state.closest_value = state.sizeless_value;
     300                 :        274 :       state.closest_shndx = state.sizeless_shndx;
     301                 :        274 :       state.closest_elf = state.sizeless_elf;
     302                 :        274 :       state.closest_name = state.sizeless_name;
     303                 :            :     }
     304                 :            : 
     305                 :      13884 :   *off = state.addr - state.closest_value;
     306                 :            : 
     307         [ +  + ]:      13884 :   if (shndxp != NULL)
     308                 :        362 :     *shndxp = state.closest_shndx;
     309         [ +  + ]:      13884 :   if (elfp != NULL)
     310                 :        362 :     *elfp = state.closest_elf;
     311         [ +  + ]:      13884 :   if (biasp != NULL)
     312                 :        362 :     *biasp = dwfl_adjusted_st_value (state.mod, state.closest_elf, 0);
     313                 :      13884 :   return state.closest_name;
     314                 :            : }
     315                 :            : 
     316                 :            : 
     317                 :            : const char *
     318                 :          0 : dwfl_module_addrsym (Dwfl_Module *mod, GElf_Addr addr,
     319                 :            :                      GElf_Sym *closest_sym, GElf_Word *shndxp)
     320                 :            : {
     321                 :          0 :   GElf_Off off;
     322                 :          0 :   return __libdwfl_addrsym (mod, addr, &off, closest_sym, shndxp,
     323                 :            :                             NULL, NULL, true);
     324                 :            : }
     325                 :            : INTDEF (dwfl_module_addrsym)
     326                 :            : 
     327                 :            : const char
     328                 :      13902 : *dwfl_module_addrinfo (Dwfl_Module *mod, GElf_Addr address,
     329                 :            :                        GElf_Off *offset, GElf_Sym *sym,
     330                 :            :                        GElf_Word *shndxp, Elf **elfp, Dwarf_Addr *bias)
     331                 :            : {
     332                 :      13902 :   return __libdwfl_addrsym (mod, address, offset, sym, shndxp, elfp, bias,
     333                 :            :                             false);
     334                 :            : }
     335                 :            : INTDEF (dwfl_module_addrinfo)

Generated by: LCOV version 1.16