gdb/gdb_bfd.c

   1 /* Definitions for BFD wrappers used by GDB.
   2
   3    Copyright (C) 2011-2015 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 "gdb_bfd.h"
  22 #include "ui-out.h"
  23 #include "gdbcmd.h"
  24 #include "hashtab.h"
  25 #include "filestuff.h"
  26 #include "vec.h"
  27 #ifdef HAVE_MMAP
  28 #include <sys/mman.h>
  29 #ifndef MAP_FAILED
  30 #define MAP_FAILED ((void *) -1)
  31 #endif
  32 #endif
  33 #include "target.h"
  34 #include "gdb/fileio.h"
  35
  36 typedef bfd *bfdp;
  37 DEF_VEC_P (bfdp);
  38
  39 /* An object of this type is stored in the section's user data when
  40    mapping a section.  */
  41
  42 struct gdb_bfd_section_data
  43 {
  44   /* Size of the data.  */
  45   bfd_size_type size;
  46   /* If the data was mmapped, this is the length of the map.  */
  47   bfd_size_type map_len;
  48   /* The data.  If NULL, the section data has not been read.  */
  49   void *data;
  50   /* If the data was mmapped, this is the map address.  */
  51   void *map_addr;
  52 };
  53
  54 /* A hash table holding every BFD that gdb knows about.  This is not
  55    to be confused with 'gdb_bfd_cache', which is used for sharing
  56    BFDs; in contrast, this hash is used just to implement
  57    "maint info bfd".  */
  58
  59 static htab_t all_bfds;
  60
  61 /* An object of this type is stored in each BFD's user data.  */
  62
  63 struct gdb_bfd_data
  64 {
  65   /* The reference count.  */
  66   int refc;
  67
  68   /* The mtime of the BFD at the point the cache entry was made.  */
  69   time_t mtime;
  70
  71   /* This is true if we have determined whether this BFD has any
  72      sections requiring relocation.  */
  73   unsigned int relocation_computed : 1;
  74
  75   /* This is true if any section needs relocation.  */
  76   unsigned int needs_relocations : 1;
  77
  78   /* This is true if we have successfully computed the file's CRC.  */
  79   unsigned int crc_computed : 1;
  80
  81   /* The file's CRC.  */
  82   unsigned long crc;
  83
  84   /* If the BFD comes from an archive, this points to the archive's
  85      BFD.  Otherwise, this is NULL.  */
  86   bfd *archive_bfd;
  87
  88   /* Table of all the bfds this bfd has included.  */
  89   VEC (bfdp) *included_bfds;
  90
  91   /* The registry.  */
  92   REGISTRY_FIELDS;
  93 };
  94
  95 #define GDB_BFD_DATA_ACCESSOR(ABFD) \
  96   ((struct gdb_bfd_data *) bfd_usrdata (ABFD))
  97
  98 DEFINE_REGISTRY (bfd, GDB_BFD_DATA_ACCESSOR)
  99
 100 /* A hash table storing all the BFDs maintained in the cache.  */
 101
 102 static htab_t gdb_bfd_cache;
 103
 104 /* The type of an object being looked up in gdb_bfd_cache.  We use
 105    htab's capability of storing one kind of object (BFD in this case)
 106    and using a different sort of object for searching.  */
 107
 108 struct gdb_bfd_cache_search
 109 {
 110   /* The filename.  */
 111   const char *filename;
 112   /* The mtime.  */
 113   time_t mtime;
 114 };
 115
 116 /* A hash function for BFDs.  */
 117
 118 static hashval_t
 119 hash_bfd (const void *b)
 120 {
 121   const bfd *abfd = b;
 122
 123   /* It is simplest to just hash the filename.  */
 124   return htab_hash_string (bfd_get_filename (abfd));
 125 }
 126
 127 /* An equality function for BFDs.  Note that this expects the caller
 128    to search using struct gdb_bfd_cache_search only, not BFDs.  */
 129
 130 static int
 131 eq_bfd (const void *a, const void *b)
 132 {
 133   const bfd *abfd = a;
 134   const struct gdb_bfd_cache_search *s = b;
 135   struct gdb_bfd_data *gdata = bfd_usrdata (abfd);
 136
 137   return (gdata->mtime == s->mtime
 138           && strcmp (bfd_get_filename (abfd), s->filename) == 0);
 139 }
 140
 141 /* See gdb_bfd.h.  */
 142
 143 int
 144 is_target_filename (const char *name)
 145 {
 146   return startswith (name, TARGET_SYSROOT_PREFIX);
 147 }
 148
 149 /* See gdb_bfd.h.  */
 150
 151 int
 152 gdb_bfd_has_target_filename (struct bfd *abfd)
 153 {
 154   return is_target_filename (bfd_get_filename (abfd));
 155 }
 156
 157
 158 /* Return the system error number corresponding to ERRNUM.  */
 159
 160 static int
 161 fileio_errno_to_host (int errnum)
 162 {
 163   switch (errnum)
 164     {
 165       case FILEIO_EPERM:
 166         return EPERM;
 167       case FILEIO_ENOENT:
 168         return ENOENT;
 169       case FILEIO_EINTR:
 170         return EINTR;
 171       case FILEIO_EIO:
 172         return EIO;
 173       case FILEIO_EBADF:
 174         return EBADF;
 175       case FILEIO_EACCES:
 176         return EACCES;
 177       case FILEIO_EFAULT:
 178         return EFAULT;
 179       case FILEIO_EBUSY:
 180         return EBUSY;
 181       case FILEIO_EEXIST:
 182         return EEXIST;
 183       case FILEIO_ENODEV:
 184         return ENODEV;
 185       case FILEIO_ENOTDIR:
 186         return ENOTDIR;
 187       case FILEIO_EISDIR:
 188         return EISDIR;
 189       case FILEIO_EINVAL:
 190         return EINVAL;
 191       case FILEIO_ENFILE:
 192         return ENFILE;
 193       case FILEIO_EMFILE:
 194         return EMFILE;
 195       case FILEIO_EFBIG:
 196         return EFBIG;
 197       case FILEIO_ENOSPC:
 198         return ENOSPC;
 199       case FILEIO_ESPIPE:
 200         return ESPIPE;
 201       case FILEIO_EROFS:
 202         return EROFS;
 203       case FILEIO_ENOSYS:
 204         return ENOSYS;
 205       case FILEIO_ENAMETOOLONG:
 206         return ENAMETOOLONG;
 207     }
 208   return -1;
 209 }
 210
 211 /* Wrapper for target_fileio_open suitable for passing as the
 212    OPEN_FUNC argument to gdb_bfd_openr_iovec.  The supplied
 213    OPEN_CLOSURE is unused.  */
 214
 215 static void *
 216 gdb_bfd_iovec_fileio_open (struct bfd *abfd, void *open_closure)
 217 {
 218   const char *filename = bfd_get_filename (abfd);
 219   int fd, target_errno;
 220   int *stream;
 221
 222   gdb_assert (is_target_filename (filename));
 223
 224   fd = target_fileio_open (filename + strlen (TARGET_SYSROOT_PREFIX),
 225                            FILEIO_O_RDONLY, 0,
 226                            &target_errno);
 227   if (fd == -1)
 228     {
 229       errno = fileio_errno_to_host (target_errno);
 230       bfd_set_error (bfd_error_system_call);
 231       return NULL;
 232     }
 233
 234   stream = XCNEW (int);
 235   *stream = fd;
 236   return stream;
 237 }
 238
 239 /* Wrapper for target_fileio_pread suitable for passing as the
 240    PREAD_FUNC argument to gdb_bfd_openr_iovec.  */
 241
 242 static file_ptr
 243 gdb_bfd_iovec_fileio_pread (struct bfd *abfd, void *stream, void *buf,
 244                             file_ptr nbytes, file_ptr offset)
 245 {
 246   int fd = *(int *) stream;
 247   int target_errno;
 248   file_ptr pos, bytes;
 249
 250   pos = 0;
 251   while (nbytes > pos)
 252     {
 253       bytes = target_fileio_pread (fd, (gdb_byte *) buf + pos,
 254                                    nbytes - pos, offset + pos,
 255                                    &target_errno);
 256       if (bytes == 0)
 257         /* Success, but no bytes, means end-of-file.  */
 258         break;
 259       if (bytes == -1)
 260         {
 261           errno = fileio_errno_to_host (target_errno);
 262           bfd_set_error (bfd_error_system_call);
 263           return -1;
 264         }
 265
 266       pos += bytes;
 267     }
 268
 269   return pos;
 270 }
 271
 272 /* Wrapper for target_fileio_close suitable for passing as the
 273    CLOSE_FUNC argument to gdb_bfd_openr_iovec.  */
 274
 275 static int
 276 gdb_bfd_iovec_fileio_close (struct bfd *abfd, void *stream)
 277 {
 278   int fd = *(int *) stream;
 279   int target_errno;
 280
 281   xfree (stream);
 282
 283   /* Ignore errors on close.  These may happen with remote
 284      targets if the connection has already been torn down.  */
 285   target_fileio_close (fd, &target_errno);
 286
 287   /* Zero means success.  */
 288   return 0;
 289 }
 290
 291 /* Wrapper for target_fileio_fstat suitable for passing as the
 292    STAT_FUNC argument to gdb_bfd_openr_iovec.  */
 293
 294 static int
 295 gdb_bfd_iovec_fileio_fstat (struct bfd *abfd, void *stream,
 296                             struct stat *sb)
 297 {
 298   int fd = *(int *) stream;
 299   int target_errno;
 300   int result;
 301
 302   result = target_fileio_fstat (fd, sb, &target_errno);
 303   if (result == -1)
 304     {
 305       errno = fileio_errno_to_host (target_errno);
 306       bfd_set_error (bfd_error_system_call);
 307     }
 308
 309   return result;
 310 }
 311
 312 /* See gdb_bfd.h.  */
 313
 314 struct bfd *
 315 gdb_bfd_open (const char *name, const char *target, int fd)
 316 {
 317   hashval_t hash;
 318   void **slot;
 319   bfd *abfd;
 320   struct gdb_bfd_cache_search search;
 321   struct stat st;
 322
 323   if (is_target_filename (name))
 324     {
 325       if (!target_filesystem_is_local ())
 326         {
 327           gdb_assert (fd == -1);
 328
 329           abfd = gdb_bfd_openr_iovec (name, target,
 330                                       gdb_bfd_iovec_fileio_open, NULL,
 331                                       gdb_bfd_iovec_fileio_pread,
 332                                       gdb_bfd_iovec_fileio_close,
 333                                       gdb_bfd_iovec_fileio_fstat);
 334
 335           if (abfd != NULL || errno != ENOSYS)
 336             return abfd;
 337
 338           /* gdb_bfd_iovec_fileio_open failed with ENOSYS.  This can
 339              happen, for example, with vgdb (Valgrind GDB), which
 340              presents itself as a remote target but works on the local
 341              filesystem: it does not implement remote get and users
 342              are not expected to set gdb_sysroot.  To handle this case
 343              we fall back to trying the local filesystem iff
 344              gdb_sysroot is exactly TARGET_SYSROOT_PREFIX.  */
 345           if (gdb_sysroot == NULL
 346               || strcmp (gdb_sysroot, TARGET_SYSROOT_PREFIX) != 0)
 347             return NULL;
 348         }
 349
 350       name += strlen (TARGET_SYSROOT_PREFIX);
 351     }
 352
 353   if (gdb_bfd_cache == NULL)
 354     gdb_bfd_cache = htab_create_alloc (1, hash_bfd, eq_bfd, NULL,
 355                                        xcalloc, xfree);
 356
 357   if (fd == -1)
 358     {
 359       fd = gdb_open_cloexec (name, O_RDONLY | O_BINARY, 0);
 360       if (fd == -1)
 361         {
 362           bfd_set_error (bfd_error_system_call);
 363           return NULL;
 364         }
 365     }
 366
 367   search.filename = name;
 368   if (fstat (fd, &st) < 0)
 369     {
 370       /* Weird situation here.  */
 371       search.mtime = 0;
 372     }
 373   else
 374     search.mtime = st.st_mtime;
 375
 376   /* Note that this must compute the same result as hash_bfd.  */
 377   hash = htab_hash_string (name);
 378   /* Note that we cannot use htab_find_slot_with_hash here, because
 379      opening the BFD may fail; and this would violate hashtab
 380      invariants.  */
 381   abfd = htab_find_with_hash (gdb_bfd_cache, &search, hash);
 382   if (abfd != NULL)
 383     {
 384       close (fd);
 385       gdb_bfd_ref (abfd);
 386       return abfd;
 387     }
 388
 389   abfd = bfd_fopen (name, target, FOPEN_RB, fd);
 390   if (abfd == NULL)
 391     return NULL;
 392
 393   slot = htab_find_slot_with_hash (gdb_bfd_cache, &search, hash, INSERT);
 394   gdb_assert (!*slot);
 395   *slot = abfd;
 396
 397   gdb_bfd_ref (abfd);
 398   return abfd;
 399 }
 400
 401 /* A helper function that releases any section data attached to the
 402    BFD.  */
 403
 404 static void
 405 free_one_bfd_section (bfd *abfd, asection *sectp, void *ignore)
 406 {
 407   struct gdb_bfd_section_data *sect = bfd_get_section_userdata (abfd, sectp);
 408
 409   if (sect != NULL && sect->data != NULL)
 410     {
 411 #ifdef HAVE_MMAP
 412       if (sect->map_addr != NULL)
 413         {
 414           int res;
 415
 416           res = munmap (sect->map_addr, sect->map_len);
 417           gdb_assert (res == 0);
 418         }
 419       else
 420 #endif
 421         xfree (sect->data);
 422     }
 423 }
 424
 425 /* Close ABFD, and warn if that fails.  */
 426
 427 static int
 428 gdb_bfd_close_or_warn (struct bfd *abfd)
 429 {
 430   int ret;
 431   char *name = bfd_get_filename (abfd);
 432
 433   bfd_map_over_sections (abfd, free_one_bfd_section, NULL);
 434
 435   ret = bfd_close (abfd);
 436
 437   if (!ret)
 438     warning (_("cannot close \"%s\": %s"),
 439              name, bfd_errmsg (bfd_get_error ()));
 440
 441   return ret;
 442 }
 443
 444 /* See gdb_bfd.h.  */
 445
 446 void
 447 gdb_bfd_ref (struct bfd *abfd)
 448 {
 449   struct gdb_bfd_data *gdata;
 450   void **slot;
 451
 452   if (abfd == NULL)
 453     return;
 454
 455   gdata = bfd_usrdata (abfd);
 456
 457   if (gdata != NULL)
 458     {
 459       gdata->refc += 1;
 460       return;
 461     }
 462
 463   /* Ask BFD to decompress sections in bfd_get_full_section_contents.  */
 464   abfd->flags |= BFD_DECOMPRESS;
 465
 466   gdata = bfd_zalloc (abfd, sizeof (struct gdb_bfd_data));
 467   gdata->refc = 1;
 468   gdata->mtime = bfd_get_mtime (abfd);
 469   gdata->archive_bfd = NULL;
 470   bfd_usrdata (abfd) = gdata;
 471
 472   bfd_alloc_data (abfd);
 473
 474   /* This is the first we've seen it, so add it to the hash table.  */
 475   slot = htab_find_slot (all_bfds, abfd, INSERT);
 476   gdb_assert (slot && !*slot);
 477   *slot = abfd;
 478 }
 479
 480 /* See gdb_bfd.h.  */
 481
 482 void
 483 gdb_bfd_unref (struct bfd *abfd)
 484 {
 485   int ix;
 486   struct gdb_bfd_data *gdata;
 487   struct gdb_bfd_cache_search search;
 488   bfd *archive_bfd, *included_bfd;
 489
 490   if (abfd == NULL)
 491     return;
 492
 493   gdata = bfd_usrdata (abfd);
 494   gdb_assert (gdata->refc >= 1);
 495
 496   gdata->refc -= 1;
 497   if (gdata->refc > 0)
 498     return;
 499
 500   archive_bfd = gdata->archive_bfd;
 501   search.filename = bfd_get_filename (abfd);
 502
 503   if (gdb_bfd_cache && search.filename)
 504     {
 505       hashval_t hash = htab_hash_string (search.filename);
 506       void **slot;
 507
 508       search.mtime = gdata->mtime;
 509       slot = htab_find_slot_with_hash (gdb_bfd_cache, &search, hash,
 510                                        NO_INSERT);
 511
 512       if (slot && *slot)
 513         htab_clear_slot (gdb_bfd_cache, slot);
 514     }
 515
 516   for (ix = 0;
 517        VEC_iterate (bfdp, gdata->included_bfds, ix, included_bfd);
 518        ++ix)
 519     gdb_bfd_unref (included_bfd);
 520   VEC_free (bfdp, gdata->included_bfds);
 521
 522   bfd_free_data (abfd);
 523   bfd_usrdata (abfd) = NULL;  /* Paranoia.  */
 524
 525   htab_remove_elt (all_bfds, abfd);
 526
 527   gdb_bfd_close_or_warn (abfd);
 528
 529   gdb_bfd_unref (archive_bfd);
 530 }
 531
 532 /* A helper function that returns the section data descriptor
 533    associated with SECTION.  If no such descriptor exists, a new one
 534    is allocated and cleared.  */
 535
 536 static struct gdb_bfd_section_data *
 537 get_section_descriptor (asection *section)
 538 {
 539   struct gdb_bfd_section_data *result;
 540
 541   result = bfd_get_section_userdata (section->owner, section);
 542
 543   if (result == NULL)
 544     {
 545       result = bfd_zalloc (section->owner, sizeof (*result));
 546       bfd_set_section_userdata (section->owner, section, result);
 547     }
 548
 549   return result;
 550 }
 551
 552 /* See gdb_bfd.h.  */
 553
 554 const gdb_byte *
 555 gdb_bfd_map_section (asection *sectp, bfd_size_type *size)
 556 {
 557   bfd *abfd;
 558   struct gdb_bfd_section_data *descriptor;
 559   bfd_byte *data;
 560
 561   gdb_assert ((sectp->flags & SEC_RELOC) == 0);
 562   gdb_assert (size != NULL);
 563
 564   abfd = sectp->owner;
 565
 566   descriptor = get_section_descriptor (sectp);
 567
 568   /* If the data was already read for this BFD, just reuse it.  */
 569   if (descriptor->data != NULL)
 570     goto done;
 571
 572 #ifdef HAVE_MMAP
 573   if (!bfd_is_section_compressed (abfd, sectp))
 574     {
 575       /* The page size, used when mmapping.  */
 576       static int pagesize;
 577
 578       if (pagesize == 0)
 579         pagesize = getpagesize ();
 580
 581       /* Only try to mmap sections which are large enough: we don't want
 582          to waste space due to fragmentation.  */
 583
 584       if (bfd_get_section_size (sectp) > 4 * pagesize)
 585         {
 586           descriptor->size = bfd_get_section_size (sectp);
 587           descriptor->data = bfd_mmap (abfd, 0, descriptor->size, PROT_READ,
 588                                        MAP_PRIVATE, sectp->filepos,
 589                                        &descriptor->map_addr,
 590                                        &descriptor->map_len);
 591
 592           if ((caddr_t)descriptor->data != MAP_FAILED)
 593             {
 594 #if HAVE_POSIX_MADVISE
 595               posix_madvise (descriptor->map_addr, descriptor->map_len,
 596                              POSIX_MADV_WILLNEED);
 597 #endif
 598               goto done;
 599             }
 600
 601           /* On failure, clear out the section data and try again.  */
 602           memset (descriptor, 0, sizeof (*descriptor));
 603         }
 604     }
 605 #endif /* HAVE_MMAP */
 606
 607   /* Handle compressed sections, or ordinary uncompressed sections in
 608      the no-mmap case.  */
 609
 610   descriptor->size = bfd_get_section_size (sectp);
 611   descriptor->data = NULL;
 612
 613   data = NULL;
 614   if (!bfd_get_full_section_contents (abfd, sectp, &data))
 615     error (_("Can't read data for section '%s' in file '%s'"),
 616            bfd_get_section_name (abfd, sectp),
 617            bfd_get_filename (abfd));
 618   descriptor->data = data;
 619
 620  done:
 621   gdb_assert (descriptor->data != NULL);
 622   *size = descriptor->size;
 623   return descriptor->data;
 624 }
 625
 626 /* Return 32-bit CRC for ABFD.  If successful store it to *FILE_CRC_RETURN and
 627    return 1.  Otherwise print a warning and return 0.  ABFD seek position is
 628    not preserved.  */
 629
 630 static int
 631 get_file_crc (bfd *abfd, unsigned long *file_crc_return)
 632 {
 633   unsigned long file_crc = 0;
 634
 635   if (bfd_seek (abfd, 0, SEEK_SET) != 0)
 636     {
 637       warning (_("Problem reading \"%s\" for CRC: %s"),
 638                bfd_get_filename (abfd), bfd_errmsg (bfd_get_error ()));
 639       return 0;
 640     }
 641
 642   for (;;)
 643     {
 644       gdb_byte buffer[8 * 1024];
 645       bfd_size_type count;
 646
 647       count = bfd_bread (buffer, sizeof (buffer), abfd);
 648       if (count == (bfd_size_type) -1)
 649         {
 650           warning (_("Problem reading \"%s\" for CRC: %s"),
 651                    bfd_get_filename (abfd), bfd_errmsg (bfd_get_error ()));
 652           return 0;
 653         }
 654       if (count == 0)
 655         break;
 656       file_crc = bfd_calc_gnu_debuglink_crc32 (file_crc, buffer, count);
 657     }
 658
 659   *file_crc_return = file_crc;
 660   return 1;
 661 }
 662
 663 /* See gdb_bfd.h.  */
 664
 665 int
 666 gdb_bfd_crc (struct bfd *abfd, unsigned long *crc_out)
 667 {
 668   struct gdb_bfd_data *gdata = bfd_usrdata (abfd);
 669
 670   if (!gdata->crc_computed)
 671     gdata->crc_computed = get_file_crc (abfd, &gdata->crc);
 672
 673   if (gdata->crc_computed)
 674     *crc_out = gdata->crc;
 675   return gdata->crc_computed;
 676 }
 677
 678 \f
 679
 680 /* See gdb_bfd.h.  */
 681
 682 bfd *
 683 gdb_bfd_fopen (const char *filename, const char *target, const char *mode,
 684                int fd)
 685 {
 686   bfd *result = bfd_fopen (filename, target, mode, fd);
 687
 688   if (result)
 689     gdb_bfd_ref (result);
 690
 691   return result;
 692 }
 693
 694 /* See gdb_bfd.h.  */
 695
 696 bfd *
 697 gdb_bfd_openr (const char *filename, const char *target)
 698 {
 699   bfd *result = bfd_openr (filename, target);
 700
 701   if (result)
 702     gdb_bfd_ref (result);
 703
 704   return result;
 705 }
 706
 707 /* See gdb_bfd.h.  */
 708
 709 bfd *
 710 gdb_bfd_openw (const char *filename, const char *target)
 711 {
 712   bfd *result = bfd_openw (filename, target);
 713
 714   if (result)
 715     gdb_bfd_ref (result);
 716
 717   return result;
 718 }
 719
 720 /* See gdb_bfd.h.  */
 721
 722 bfd *
 723 gdb_bfd_openr_iovec (const char *filename, const char *target,
 724                      void *(*open_func) (struct bfd *nbfd,
 725                                          void *open_closure),
 726                      void *open_closure,
 727                      file_ptr (*pread_func) (struct bfd *nbfd,
 728                                              void *stream,
 729                                              void *buf,
 730                                              file_ptr nbytes,
 731                                              file_ptr offset),
 732                      int (*close_func) (struct bfd *nbfd,
 733                                         void *stream),
 734                      int (*stat_func) (struct bfd *abfd,
 735                                        void *stream,
 736                                        struct stat *sb))
 737 {
 738   bfd *result = bfd_openr_iovec (filename, target,
 739                                  open_func, open_closure,
 740                                  pread_func, close_func, stat_func);
 741
 742   if (result)
 743     gdb_bfd_ref (result);
 744
 745   return result;
 746 }
 747
 748 /* See gdb_bfd.h.  */
 749
 750 void
 751 gdb_bfd_mark_parent (bfd *child, bfd *parent)
 752 {
 753   struct gdb_bfd_data *gdata;
 754
 755   gdb_bfd_ref (child);
 756   /* No need to stash the filename here, because we also keep a
 757      reference on the parent archive.  */
 758
 759   gdata = bfd_usrdata (child);
 760   if (gdata->archive_bfd == NULL)
 761     {
 762       gdata->archive_bfd = parent;
 763       gdb_bfd_ref (parent);
 764     }
 765   else
 766     gdb_assert (gdata->archive_bfd == parent);
 767 }
 768
 769 /* See gdb_bfd.h.  */
 770
 771 bfd *
 772 gdb_bfd_openr_next_archived_file (bfd *archive, bfd *previous)
 773 {
 774   bfd *result = bfd_openr_next_archived_file (archive, previous);
 775
 776   if (result)
 777     gdb_bfd_mark_parent (result, archive);
 778
 779   return result;
 780 }
 781
 782 /* See gdb_bfd.h.  */
 783
 784 void
 785 gdb_bfd_record_inclusion (bfd *includer, bfd *includee)
 786 {
 787   struct gdb_bfd_data *gdata;
 788
 789   gdb_bfd_ref (includee);
 790   gdata = bfd_usrdata (includer);
 791   VEC_safe_push (bfdp, gdata->included_bfds, includee);
 792 }
 793
 794 /* See gdb_bfd.h.  */
 795
 796 bfd *
 797 gdb_bfd_fdopenr (const char *filename, const char *target, int fd)
 798 {
 799   bfd *result = bfd_fdopenr (filename, target, fd);
 800
 801   if (result)
 802     gdb_bfd_ref (result);
 803
 804   return result;
 805 }
 806
 807 \f
 808
 809 gdb_static_assert (ARRAY_SIZE (_bfd_std_section) == 4);
 810
 811 /* See gdb_bfd.h.  */
 812
 813 int
 814 gdb_bfd_section_index (bfd *abfd, asection *section)
 815 {
 816   if (section == NULL)
 817     return -1;
 818   else if (section == bfd_com_section_ptr)
 819     return bfd_count_sections (abfd);
 820   else if (section == bfd_und_section_ptr)
 821     return bfd_count_sections (abfd) + 1;
 822   else if (section == bfd_abs_section_ptr)
 823     return bfd_count_sections (abfd) + 2;
 824   else if (section == bfd_ind_section_ptr)
 825     return bfd_count_sections (abfd) + 3;
 826   return section->index;
 827 }
 828
 829 /* See gdb_bfd.h.  */
 830
 831 int
 832 gdb_bfd_count_sections (bfd *abfd)
 833 {
 834   return bfd_count_sections (abfd) + 4;
 835 }
 836
 837 /* See gdb_bfd.h.  */
 838
 839 int
 840 gdb_bfd_requires_relocations (bfd *abfd)
 841 {
 842   struct gdb_bfd_data *gdata = bfd_usrdata (abfd);
 843
 844   if (gdata->relocation_computed == 0)
 845     {
 846       asection *sect;
 847
 848       for (sect = abfd->sections; sect != NULL; sect = sect->next)
 849         if ((sect->flags & SEC_RELOC) != 0)
 850           {
 851             gdata->needs_relocations = 1;
 852             break;
 853           }
 854
 855       gdata->relocation_computed = 1;
 856     }
 857
 858   return gdata->needs_relocations;
 859 }
 860
 861 \f
 862
 863 /* A callback for htab_traverse that prints a single BFD.  */
 864
 865 static int
 866 print_one_bfd (void **slot, void *data)
 867 {
 868   bfd *abfd = *slot;
 869   struct gdb_bfd_data *gdata = bfd_usrdata (abfd);
 870   struct ui_out *uiout = data;
 871   struct cleanup *inner;
 872
 873   inner = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
 874   ui_out_field_int (uiout, "refcount", gdata->refc);
 875   ui_out_field_string (uiout, "addr", host_address_to_string (abfd));
 876   ui_out_field_string (uiout, "filename", bfd_get_filename (abfd));
 877   ui_out_text (uiout, "\n");
 878   do_cleanups (inner);
 879
 880   return 1;
 881 }
 882
 883 /* Implement the 'maint info bfd' command.  */
 884
 885 static void
 886 maintenance_info_bfds (char *arg, int from_tty)
 887 {
 888   struct cleanup *cleanup;
 889   struct ui_out *uiout = current_uiout;
 890
 891   cleanup = make_cleanup_ui_out_table_begin_end (uiout, 3, -1, "bfds");
 892   ui_out_table_header (uiout, 10, ui_left, "refcount", "Refcount");
 893   ui_out_table_header (uiout, 18, ui_left, "addr", "Address");
 894   ui_out_table_header (uiout, 40, ui_left, "filename", "Filename");
 895
 896   ui_out_table_body (uiout);
 897   htab_traverse (all_bfds, print_one_bfd, uiout);
 898
 899   do_cleanups (cleanup);
 900 }
 901
 902 /* -Wmissing-prototypes */
 903 extern initialize_file_ftype _initialize_gdb_bfd;
 904
 905 void
 906 _initialize_gdb_bfd (void)
 907 {
 908   all_bfds = htab_create_alloc (10, htab_hash_pointer, htab_eq_pointer,
 909                                 NULL, xcalloc, xfree);
 910
 911   add_cmd ("bfds", class_maintenance, maintenance_info_bfds, _("\
 912 List the BFDs that are currently open."),
 913            &maintenanceinfolist);
 914 }