LCOV - code coverage report
Current view: top level - libdwfl - offline.c (source / functions) Hit Total Coverage
Test: elfutils-0.192 Lines: 97 134 72.4 %
Date: 2024-12-02 18:41:01 Functions: 8 8 100.0 %
Legend: Lines: hit not hit | Branches: + taken - not taken # not executed Branches: 57 95 60.0 %

           Branch data     Line data    Source code
       1                 :            : /* Recover relocatibility for addresses computed from debug information.
       2                 :            :    Copyright (C) 2005-2009, 2012 Red Hat, Inc.
       3                 :            :    Copyright (C) 2022 Mark J. Wielaard <mark@klomp.org>
       4                 :            :    Copyright (C) 2022 Google LLC
       5                 :            :    This file is part of elfutils.
       6                 :            : 
       7                 :            :    This file is free software; you can redistribute it and/or modify
       8                 :            :    it under the terms of either
       9                 :            : 
      10                 :            :      * the GNU Lesser General Public License as published by the Free
      11                 :            :        Software Foundation; either version 3 of the License, or (at
      12                 :            :        your option) any later version
      13                 :            : 
      14                 :            :    or
      15                 :            : 
      16                 :            :      * the GNU General Public License as published by the Free
      17                 :            :        Software Foundation; either version 2 of the License, or (at
      18                 :            :        your option) any later version
      19                 :            : 
      20                 :            :    or both in parallel, as here.
      21                 :            : 
      22                 :            :    elfutils is distributed in the hope that it will be useful, but
      23                 :            :    WITHOUT ANY WARRANTY; without even the implied warranty of
      24                 :            :    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      25                 :            :    General Public License for more details.
      26                 :            : 
      27                 :            :    You should have received copies of the GNU General Public License and
      28                 :            :    the GNU Lesser General Public License along with this program.  If
      29                 :            :    not, see <http://www.gnu.org/licenses/>.  */
      30                 :            : 
      31                 :            : #ifdef HAVE_CONFIG_H
      32                 :            : # include <config.h>
      33                 :            : #endif
      34                 :            : 
      35                 :            : #include "libelfP.h"
      36                 :            : #include "libdwflP.h"
      37                 :            : #include <fcntl.h>
      38                 :            : 
      39                 :            : /* Since dwfl_report_elf lays out the sections already, this will only be
      40                 :            :    called when the section headers of the debuginfo file are being
      41                 :            :    consulted instead, or for the section placed at 0.  With binutils
      42                 :            :    strip-to-debug, the symbol table is in the debuginfo file and relocation
      43                 :            :    looks there.  */
      44                 :            : int
      45                 :      50774 : dwfl_offline_section_address (Dwfl_Module *mod,
      46                 :            :                               void **userdata __attribute__ ((unused)),
      47                 :            :                               const char *modname __attribute__ ((unused)),
      48                 :            :                               Dwarf_Addr base __attribute__ ((unused)),
      49                 :            :                               const char *secname __attribute__ ((unused)),
      50                 :            :                               Elf32_Word shndx,
      51                 :            :                               const GElf_Shdr *shdr __attribute__ ((unused)),
      52                 :            :                               Dwarf_Addr *addr)
      53                 :            : {
      54         [ +  - ]:      50774 :   if (mod->e_type != ET_REL
      55         [ +  - ]:      50774 :       || shdr->sh_addr != 0
      56         [ +  - ]:      50774 :       || !(shdr->sh_flags & SHF_ALLOC)
      57         [ -  + ]:      50774 :       || shndx == 0)
      58                 :            :     return -1;
      59                 :            : 
      60         [ +  + ]:      50774 :   if (mod->debug.elf == NULL)
      61                 :            :     /* We are only here because sh_addr is zero even though layout is complete.
      62                 :            :        The first section in the first file under -e is placed at 0.  */
      63                 :            :     return 0;
      64                 :            : 
      65                 :            :   /* The section numbers might not match between the two files.
      66                 :            :      The best we can rely on is the order of SHF_ALLOC sections.  */
      67                 :            : 
      68                 :        120 :   Elf_Scn *ourscn = elf_getscn (mod->debug.elf, shndx);
      69                 :        120 :   Elf_Scn *scn = NULL;
      70                 :        120 :   uint_fast32_t skip_alloc = 0;
      71         [ +  + ]:        210 :   while ((scn = elf_nextscn (mod->debug.elf, scn)) != ourscn)
      72                 :            :     {
      73         [ -  + ]:         90 :       assert (scn != NULL);
      74                 :         90 :       GElf_Shdr shdr_mem;
      75                 :         90 :       GElf_Shdr *sh = gelf_getshdr (scn, &shdr_mem);
      76         [ -  + ]:         90 :       if (unlikely (sh == NULL))
      77                 :          0 :         return -1;
      78         [ +  + ]:         90 :       if (sh->sh_flags & SHF_ALLOC)
      79                 :         56 :         ++skip_alloc;
      80                 :            :     }
      81                 :            : 
      82                 :            :   scn = NULL;
      83         [ -  + ]:        180 :   while ((scn = elf_nextscn (mod->main.elf, scn)) != NULL)
      84                 :            :     {
      85                 :        180 :       GElf_Shdr shdr_mem;
      86                 :        180 :       GElf_Shdr *main_shdr = gelf_getshdr (scn, &shdr_mem);
      87         [ +  - ]:        180 :       if (unlikely (main_shdr == NULL))
      88                 :        120 :         return -1;
      89   [ +  +  +  + ]:        180 :       if ((main_shdr->sh_flags & SHF_ALLOC) && skip_alloc-- == 0)
      90                 :            :         {
      91         [ -  + ]:        120 :           assert (main_shdr->sh_flags == shdr->sh_flags);
      92                 :        120 :           *addr = main_shdr->sh_addr;
      93                 :        120 :           return 0;
      94                 :            :         }
      95                 :            :     }
      96                 :            : 
      97                 :            :   /* This should never happen.  */
      98                 :            :   return -1;
      99                 :            : }
     100                 :            : INTDEF (dwfl_offline_section_address)
     101                 :            : 
     102                 :            : /* Forward declarations.  */
     103                 :            : static Dwfl_Module *process_elf (Dwfl *dwfl, const char *name,
     104                 :            :                                  const char *file_name, int fd, Elf *elf);
     105                 :            : static Dwfl_Module *process_archive (Dwfl *dwfl, const char *name,
     106                 :            :                                      const char *file_name, int fd, Elf *elf,
     107                 :            :                                      int (*predicate) (const char *module,
     108                 :            :                                                        const char *file));
     109                 :            : 
     110                 :            : /* Report one module for an ELF file, or many for an archive.
     111                 :            :    Always consumes ELF and FD.  */
     112                 :            : static Dwfl_Module *
     113                 :       1428 : process_file (Dwfl *dwfl, const char *name, const char *file_name, int fd,
     114                 :            :               Elf *elf, int (*predicate) (const char *module,
     115                 :            :                                           const char *file))
     116                 :            : {
     117      [ -  +  + ]:       1428 :   switch (elf_kind (elf))
     118                 :            :     {
     119                 :          0 :     default:
     120                 :            :     case ELF_K_NONE:
     121         [ #  # ]:          0 :       __libdwfl_seterrno (elf == NULL ? DWFL_E_LIBELF : DWFL_E_BADELF);
     122                 :          0 :       return NULL;
     123                 :            : 
     124                 :       1424 :     case ELF_K_ELF:
     125                 :       1424 :       return process_elf (dwfl, name, file_name, fd, elf);
     126                 :            : 
     127                 :          4 :     case ELF_K_AR:
     128                 :          4 :       return process_archive (dwfl, name, file_name, fd, elf, predicate);
     129                 :            :     }
     130                 :            : }
     131                 :            : 
     132                 :            : /* Report the open ELF file as a module.  Always consumes ELF and FD.  */
     133                 :            : static Dwfl_Module *
     134                 :       1424 : process_elf (Dwfl *dwfl, const char *name, const char *file_name, int fd,
     135                 :            :              Elf *elf)
     136                 :            : {
     137                 :       1424 :   Dwfl_Module *mod = __libdwfl_report_elf (dwfl, name, file_name, fd, elf,
     138                 :            :                                            dwfl->offline_next_address, true,
     139                 :            :                                            false);
     140         [ +  - ]:       1424 :   if (mod != NULL)
     141                 :            :     {
     142                 :            :       /* If this is an ET_EXEC file with fixed addresses, the address range
     143                 :            :          it consumed may or may not intersect with the arbitrary range we
     144                 :            :          will use for relocatable modules.  Make sure we always use a free
     145                 :            :          range for the offline allocations.  If this module did use
     146                 :            :          offline_next_address, it may have rounded it up for the module's
     147                 :            :          alignment requirements.  */
     148         [ +  + ]:       1424 :       if ((dwfl->offline_next_address >= mod->low_addr
     149         [ +  + ]:        774 :            || mod->low_addr - dwfl->offline_next_address < OFFLINE_REDZONE)
     150         [ +  - ]:        672 :           && dwfl->offline_next_address < mod->high_addr + OFFLINE_REDZONE)
     151                 :        672 :         dwfl->offline_next_address = mod->high_addr + OFFLINE_REDZONE;
     152                 :            : 
     153                 :            :       /* Don't keep the file descriptor around.  */
     154   [ +  +  +  - ]:       1424 :       if (mod->main.fd != -1 && elf_cntl (mod->main.elf, ELF_C_FDREAD) == 0)
     155                 :            :         {
     156                 :            :           /* Grab the path in case we want to report this file as
     157                 :            :              Dwarf later.  */
     158                 :       1396 :           mod->elfpath = __libdw_elfpath (mod->main.fd);
     159                 :       1396 :           close (mod->main.fd);
     160                 :       1396 :           mod->main.fd = -1;
     161                 :            :         }
     162                 :            :     }
     163                 :            : 
     164                 :       1424 :   return mod;
     165                 :            : }
     166                 :            : 
     167                 :            : /* Always consumes MEMBER.  Returns elf_next result on success.
     168                 :            :    For errors returns ELF_C_NULL with *MOD set to null.  */
     169                 :            : static Elf_Cmd
     170                 :         16 : process_archive_member (Dwfl *dwfl, const char *name, const char *file_name,
     171                 :            :                         int (*predicate) (const char *module, const char *file),
     172                 :            :                         int fd, Elf *member, Dwfl_Module **mod)
     173                 :            : {
     174                 :         16 :   const Elf_Arhdr *h = elf_getarhdr (member);
     175         [ -  + ]:         16 :   if (unlikely (h == NULL))
     176                 :            :     {
     177                 :          0 :       __libdwfl_seterrno (DWFL_E_LIBELF);
     178                 :          0 :     fail:
     179                 :          0 :       elf_end (member);
     180                 :          0 :       *mod = NULL;
     181                 :          0 :       return ELF_C_NULL;
     182                 :            :     }
     183                 :            : 
     184   [ +  +  -  + ]:         16 :   if (!strcmp (h->ar_name, "/") || !strcmp (h->ar_name, "//")
     185         [ +  + ]:         14 :       || !strcmp (h->ar_name, "/SYM64/"))
     186                 :            :     {
     187                 :          4 :     skip:;
     188                 :            :       /* Skip this and go to the next.  */
     189                 :          4 :       Elf_Cmd result = elf_next (member);
     190                 :          4 :       elf_end (member);
     191                 :          4 :       return result;
     192                 :            :     }
     193                 :            : 
     194                 :         12 :   char *member_name;
     195         [ -  + ]:         12 :   if (unlikely (asprintf (&member_name, "%s(%s)", file_name, h->ar_name) < 0))
     196                 :            :     {
     197                 :          0 :     nomem:
     198                 :          0 :       __libdwfl_seterrno (DWFL_E_NOMEM);
     199                 :          0 :       elf_end (member);
     200                 :          0 :       *mod = NULL;
     201                 :          0 :       return ELF_C_NULL;
     202                 :            :     }
     203                 :            : 
     204                 :         12 :   char *module_name = NULL;
     205   [ +  -  -  + ]:         12 :   if (name == NULL || name[0] == '\0')
     206                 :          0 :     name = h->ar_name;
     207         [ -  + ]:         12 :   else if (unlikely (asprintf (&module_name, "%s:%s", name, h->ar_name) < 0))
     208                 :            :     {
     209                 :          0 :       free (member_name);
     210                 :          0 :       goto nomem;
     211                 :            :     }
     212                 :            :   else
     213                 :         12 :     name = module_name;
     214                 :            : 
     215         [ -  + ]:         12 :   if (predicate != NULL)
     216                 :            :     {
     217                 :            :       /* Let the predicate decide whether to use this one.  */
     218                 :          0 :       int want = (*predicate) (name, member_name);
     219         [ #  # ]:          0 :       if (want <= 0)
     220                 :            :         {
     221                 :          0 :           free (member_name);
     222                 :          0 :           free (module_name);
     223         [ #  # ]:          0 :           if (unlikely (want < 0))
     224                 :            :             {
     225                 :          0 :               __libdwfl_seterrno (DWFL_E_CB);
     226                 :          0 :               goto fail;
     227                 :            :             }
     228                 :          0 :           goto skip;
     229                 :            :         }
     230                 :            :     }
     231                 :            : 
     232                 :            :   /* We let __libdwfl_report_elf cache the fd in mod->main.fd,
     233                 :            :      though it's the same fd for all the members.
     234                 :            :      On module teardown we will close it only on the last Elf reference.  */
     235                 :         12 :   *mod = process_file (dwfl, name, member_name, fd, member, predicate);
     236                 :         12 :   free (member_name);
     237                 :         12 :   free (module_name);
     238                 :            : 
     239         [ -  + ]:         12 :   if (*mod == NULL)
     240                 :            :     {
     241                 :          0 :       elf_end (member);
     242                 :          0 :       return ELF_C_NULL;
     243                 :            :     }
     244                 :            : 
     245                 :            :   /* Advance the archive-reading offset for the next iteration.  */
     246                 :         12 :   return elf_next (member);
     247                 :            : }
     248                 :            : 
     249                 :            : /* Report each member of the archive as its own module.  */
     250                 :            : static Dwfl_Module *
     251                 :          4 : process_archive (Dwfl *dwfl, const char *name, const char *file_name, int fd,
     252                 :            :                  Elf *archive,
     253                 :            :                  int (*predicate) (const char *module, const char *file))
     254                 :            : 
     255                 :            : {
     256                 :          4 :   Dwfl_Module *mod = NULL;
     257                 :            :   /* elf_begin supports opening archives even with fd == -1 passed.  */
     258                 :          4 :   Elf *member = elf_begin (fd, archive->cmd, archive);
     259         [ -  + ]:          4 :   if (unlikely (member == NULL)) /* Empty archive.  */
     260                 :            :     {
     261                 :          0 :       __libdwfl_seterrno (DWFL_E_BADELF);
     262                 :          0 :       return NULL;
     263                 :            :     }
     264                 :            : 
     265                 :         16 :   while (process_archive_member (dwfl, name, file_name, predicate,
     266         [ +  + ]:         16 :                                  fd, member, &mod) != ELF_C_NULL)
     267                 :         12 :     member = elf_begin (fd, archive->cmd, archive);
     268                 :            : 
     269                 :            :   /* We can drop the archive Elf handle even if we're still using members
     270                 :            :      in live modules.  When the last module's elf_end on a member returns
     271                 :            :      zero, that module will close FD.  If no modules survived the predicate,
     272                 :            :      we are all done with the file right here.  */
     273         [ +  - ]:          4 :   if (mod != NULL               /* If no modules, caller will clean up.  */
     274         [ -  + ]:          4 :       && elf_end (archive) == 0)
     275                 :          4 :     close (fd);
     276                 :            : 
     277                 :            :   return mod;
     278                 :            : }
     279                 :            : 
     280                 :            : Dwfl_Module *
     281                 :            : internal_function
     282                 :       1410 : __libdwfl_report_offline (Dwfl *dwfl, const char *name,
     283                 :            :                           const char *file_name, int fd, bool closefd,
     284                 :            :                           int (*predicate) (const char *module,
     285                 :            :                                             const char *file))
     286                 :            : {
     287                 :       1410 :   Elf *elf;
     288                 :       1410 :   Dwfl_Error error = __libdw_open_file (&fd, &elf, closefd, true);
     289         [ -  + ]:       1410 :   if (error != DWFL_E_NOERROR)
     290                 :            :     {
     291                 :          0 :       __libdwfl_seterrno (error);
     292                 :          0 :       return NULL;
     293                 :            :     }
     294                 :       1410 :   Dwfl_Module *mod = process_file (dwfl, name, file_name, fd, elf, predicate);
     295         [ -  + ]:       1410 :   if (mod == NULL)
     296                 :            :     {
     297                 :          0 :       elf_end (elf);
     298         [ #  # ]:          0 :       if (closefd)
     299                 :          0 :         close (fd);
     300                 :            :     }
     301                 :            :   return mod;
     302                 :            : }
     303                 :            : 
     304                 :            : Dwfl_Module *
     305                 :       1410 : dwfl_report_offline (Dwfl *dwfl, const char *name,
     306                 :            :                      const char *file_name, int fd)
     307                 :            : {
     308         [ -  + ]:       1410 :   if (dwfl == NULL)
     309                 :            :     return NULL;
     310                 :            : 
     311                 :       1410 :   bool closefd = false;
     312         [ +  + ]:       1410 :   if (fd < 0)
     313                 :            :     {
     314                 :        412 :       closefd = true;
     315                 :        412 :       fd = open (file_name, O_RDONLY);
     316         [ -  + ]:        412 :       if (fd < 0)
     317                 :            :         {
     318                 :          0 :           __libdwfl_seterrno (DWFL_E_ERRNO);
     319                 :          0 :           return NULL;
     320                 :            :         }
     321                 :            :     }
     322                 :            : 
     323                 :       1410 :   return __libdwfl_report_offline (dwfl, name, file_name, fd, closefd, NULL);
     324                 :            : }
     325                 :            : INTDEF (dwfl_report_offline)
     326                 :            : 
     327                 :            : Dwfl_Module *
     328                 :         12 : dwfl_report_offline_memory (Dwfl *dwfl, const char *name,
     329                 :            :                             const char *file_name, char *data, size_t size)
     330                 :            : {
     331         [ -  + ]:         12 :   if (dwfl == NULL)
     332                 :            :     return NULL;
     333                 :            : 
     334                 :         12 :   Elf *elf;
     335                 :         12 :   Dwfl_Error error = __libdw_open_elf_memory (data, size, &elf, true);
     336         [ +  + ]:         12 :   if (error != DWFL_E_NOERROR)
     337                 :            :     {
     338                 :          6 :       __libdwfl_seterrno (error);
     339                 :          6 :       return NULL;
     340                 :            :     }
     341                 :            :   /* It is ok to pass fd == -1 here, because libelf uses it as a value for
     342                 :            :      "no file opened" and supports working with files without fd, thanks to
     343                 :            :      the existence of the elf_memory function.  */
     344                 :          6 :   Dwfl_Module *mod = process_file (dwfl, name, file_name, -1, elf, NULL);
     345         [ -  + ]:          6 :   if (mod == NULL)
     346                 :          0 :     elf_end (elf);
     347                 :            :   return mod;
     348                 :            : }
     349                 :            : INTDEF (dwfl_report_offline_memory)

Generated by: LCOV version 1.16