gdb/build-id.c

   1 /* build-id-related functions.
   2
   3    Copyright (C) 1991-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 #include "defs.h"
  21 #include "bfd.h"
  22 #include "gdb_bfd.h"
  23 #include "build-id.h"
  24 #include "gdbsupport/gdb_vecs.h"
  25 #include "symfile.h"
  26 #include "objfiles.h"
  27 #include "filenames.h"
  28 #include "gdbcore.h"
  29
  30 /* See build-id.h.  */
  31
  32 const struct bfd_build_id *
  33 build_id_bfd_get (bfd *abfd)
  34 {
  35   if (!bfd_check_format (abfd, bfd_object)
  36       && !bfd_check_format (abfd, bfd_core))
  37     return NULL;
  38
  39   if (abfd->build_id != NULL)
  40     return abfd->build_id;
  41
  42   /* No build-id */
  43   return NULL;
  44 }
  45
  46 /* See build-id.h.  */
  47
  48 int
  49 build_id_verify (bfd *abfd, size_t check_len, const bfd_byte *check)
  50 {
  51   const struct bfd_build_id *found;
  52   int retval = 0;
  53
  54   found = build_id_bfd_get (abfd);
  55
  56   if (found == NULL)
  57     warning (_("File \"%s\" has no build-id, file skipped"),
  58              bfd_get_filename (abfd));
  59   else if (found->size != check_len
  60            || memcmp (found->data, check, found->size) != 0)
  61     warning (_("File \"%s\" has a different build-id, file skipped"),
  62              bfd_get_filename (abfd));
  63   else
  64     retval = 1;
  65
  66   return retval;
  67 }
  68
  69 /* Helper for build_id_to_debug_bfd.  LINK is a path to a potential
  70    build-id-based separate debug file, potentially a symlink to the real file.
  71    If the file exists and matches BUILD_ID, return a BFD reference to it.  */
  72
  73 static gdb_bfd_ref_ptr
  74 build_id_to_debug_bfd_1 (const std::string &link, size_t build_id_len,
  75                          const bfd_byte *build_id)
  76 {
  77   if (separate_debug_file_debug)
  78     {
  79       printf_unfiltered (_("  Trying %s..."), link.c_str ());
  80       gdb_flush (gdb_stdout);
  81     }
  82
  83   /* lrealpath() is expensive even for the usually non-existent files.  */
  84   gdb::unique_xmalloc_ptr<char> filename_holder;
  85   const char *filename = nullptr;
  86   if (startswith (link, TARGET_SYSROOT_PREFIX))
  87     filename = link.c_str ();
  88   else if (access (link.c_str (), F_OK) == 0)
  89     {
  90       filename_holder.reset (lrealpath (link.c_str ()));
  91       filename = filename_holder.get ();
  92     }
  93
  94   if (filename == NULL)
  95     {
  96       if (separate_debug_file_debug)
  97         printf_unfiltered (_(" no, unable to compute real path\n"));
  98
  99       return {};
 100     }
 101
 102   /* We expect to be silent on the non-existing files.  */
 103   gdb_bfd_ref_ptr debug_bfd = gdb_bfd_open (filename, gnutarget);
 104
 105   if (debug_bfd == NULL)
 106     {
 107       if (separate_debug_file_debug)
 108         printf_unfiltered (_(" no, unable to open.\n"));
 109
 110       return {};
 111     }
 112
 113   if (!build_id_verify (debug_bfd.get(), build_id_len, build_id))
 114     {
 115       if (separate_debug_file_debug)
 116         printf_unfiltered (_(" no, build-id does not match.\n"));
 117
 118       return {};
 119     }
 120
 121   if (separate_debug_file_debug)
 122     printf_unfiltered (_(" yes!\n"));
 123
 124   return debug_bfd;
 125 }
 126
 127 /* Common code for finding BFDs of a given build-id.  This function
 128    works with both debuginfo files (SUFFIX == ".debug") and executable
 129    files (SUFFIX == "").  */
 130
 131 static gdb_bfd_ref_ptr
 132 build_id_to_bfd_suffix (size_t build_id_len, const bfd_byte *build_id,
 133                         const char *suffix)
 134 {
 135   /* Keep backward compatibility so that DEBUG_FILE_DIRECTORY being "" will
 136      cause "/.build-id/..." lookups.  */
 137
 138   std::vector<gdb::unique_xmalloc_ptr<char>> debugdir_vec
 139     = dirnames_to_char_ptr_vec (debug_file_directory.c_str ());
 140
 141   for (const gdb::unique_xmalloc_ptr<char> &debugdir : debugdir_vec)
 142     {
 143       const gdb_byte *data = build_id;
 144       size_t size = build_id_len;
 145
 146       /* Compute where the file named after the build-id would be.
 147
 148          If debugdir is "/usr/lib/debug" and the build-id is abcdef, this will
 149          give "/usr/lib/debug/.build-id/ab/cdef.debug".  */
 150       std::string link = debugdir.get ();
 151       link += "/.build-id/";
 152
 153       if (size > 0)
 154         {
 155           size--;
 156           string_appendf (link, "%02x/", (unsigned) *data++);
 157         }
 158
 159       while (size-- > 0)
 160         string_appendf (link, "%02x", (unsigned) *data++);
 161
 162       link += suffix;
 163
 164       gdb_bfd_ref_ptr debug_bfd
 165         = build_id_to_debug_bfd_1 (link, build_id_len, build_id);
 166       if (debug_bfd != NULL)
 167         return debug_bfd;
 168
 169       /* Try to look under the sysroot as well.  If the sysroot is
 170          "/the/sysroot", it will give
 171          "/the/sysroot/usr/lib/debug/.build-id/ab/cdef.debug".  */
 172
 173       if (!gdb_sysroot.empty ())
 174         {
 175           link = gdb_sysroot + link;
 176           debug_bfd = build_id_to_debug_bfd_1 (link, build_id_len, build_id);
 177           if (debug_bfd != NULL)
 178             return debug_bfd;
 179         }
 180     }
 181
 182   return {};
 183 }
 184
 185 /* See build-id.h.  */
 186
 187 gdb_bfd_ref_ptr
 188 build_id_to_debug_bfd (size_t build_id_len, const bfd_byte *build_id)
 189 {
 190   return build_id_to_bfd_suffix (build_id_len, build_id, ".debug");
 191 }
 192
 193 /* See build-id.h.  */
 194
 195 gdb_bfd_ref_ptr
 196 build_id_to_exec_bfd (size_t build_id_len, const bfd_byte *build_id)
 197 {
 198   return build_id_to_bfd_suffix (build_id_len, build_id, "");
 199 }
 200
 201 /* See build-id.h.  */
 202
 203 std::string
 204 find_separate_debug_file_by_buildid (struct objfile *objfile)
 205 {
 206   const struct bfd_build_id *build_id;
 207
 208   build_id = build_id_bfd_get (objfile->obfd);
 209   if (build_id != NULL)
 210     {
 211       if (separate_debug_file_debug)
 212         printf_unfiltered (_("\nLooking for separate debug info (build-id) for "
 213                              "%s\n"), objfile_name (objfile));
 214
 215       gdb_bfd_ref_ptr abfd (build_id_to_debug_bfd (build_id->size,
 216                                                    build_id->data));
 217       /* Prevent looping on a stripped .debug file.  */
 218       if (abfd != NULL
 219           && filename_cmp (bfd_get_filename (abfd.get ()),
 220                            objfile_name (objfile)) == 0)
 221         warning (_("\"%s\": separate debug info file has no debug info"),
 222                  bfd_get_filename (abfd.get ()));
 223       else if (abfd != NULL)
 224         return std::string (bfd_get_filename (abfd.get ()));
 225     }
 226
 227   return std::string ();
 228 }