1 /* GDB routines for manipulating objfiles.
3 Copyright (C) 1992-2019 Free Software Foundation, Inc.
5 Contributed by Cygnus Support, using pieces from other GDB modules.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 /* This file contains support routines for creating, manipulating, and
23 destroying objfile structures. */
26 #include "bfd.h" /* Binary File Description */
30 #include "gdb-stabs.h"
33 #include "expression.h"
34 #include "parser-defs.h"
36 #include <sys/types.h>
39 #include "gdb_obstack.h"
42 #include "breakpoint.h"
44 #include "dictionary.h"
47 #include "arch-utils.h"
49 #include "observable.h"
50 #include "complaints.h"
55 #include "common/pathstuff.h"
59 /* Keep a registry of per-objfile data-pointers required by other GDB
62 DEFINE_REGISTRY (objfile, REGISTRY_ACCESS_FIELD)
64 /* Externally visible variables that are owned by this module.
65 See declarations in objfile.h for more info. */
67 struct objfile_pspace_info
69 struct obj_section **sections;
72 /* Nonzero if object files have been added since the section map
74 int new_objfiles_available;
76 /* Nonzero if the section map MUST be updated before use. */
77 int section_map_dirty;
79 /* Nonzero if section map updates should be inhibited if possible. */
83 /* Per-program-space data key. */
84 static const struct program_space_data *objfiles_pspace_data;
87 objfiles_pspace_data_cleanup (struct program_space *pspace, void *arg)
89 struct objfile_pspace_info *info = (struct objfile_pspace_info *) arg;
91 xfree (info->sections);
95 /* Get the current svr4 data. If none is found yet, add it now. This
96 function always returns a valid object. */
98 static struct objfile_pspace_info *
99 get_objfile_pspace_data (struct program_space *pspace)
101 struct objfile_pspace_info *info;
103 info = ((struct objfile_pspace_info *)
104 program_space_data (pspace, objfiles_pspace_data));
107 info = XCNEW (struct objfile_pspace_info);
108 set_program_space_data (pspace, objfiles_pspace_data, info);
116 /* Per-BFD data key. */
118 static const struct bfd_data *objfiles_bfd_data;
120 objfile_per_bfd_storage::~objfile_per_bfd_storage ()
124 /* Create the per-BFD storage object for OBJFILE. If ABFD is not
125 NULL, and it already has a per-BFD storage object, use that.
126 Otherwise, allocate a new per-BFD storage object. Note that it is
127 not safe to call this multiple times for a given OBJFILE -- it can
128 only be called when allocating or re-initializing OBJFILE. */
130 static struct objfile_per_bfd_storage *
131 get_objfile_bfd_data (struct objfile *objfile, struct bfd *abfd)
133 struct objfile_per_bfd_storage *storage = NULL;
136 storage = ((struct objfile_per_bfd_storage *)
137 bfd_data (abfd, objfiles_bfd_data));
141 storage = new objfile_per_bfd_storage;
142 /* If the object requires gdb to do relocations, we simply fall
143 back to not sharing data across users. These cases are rare
144 enough that this seems reasonable. */
145 if (abfd != NULL && !gdb_bfd_requires_relocations (abfd))
146 set_bfd_data (abfd, objfiles_bfd_data, storage);
148 /* Look up the gdbarch associated with the BFD. */
150 storage->gdbarch = gdbarch_from_bfd (abfd);
156 /* A deleter for objfile_per_bfd_storage that can be passed as a
157 cleanup function to the BFD registry. */
160 objfile_bfd_data_free (struct bfd *unused, void *d)
162 delete (struct objfile_per_bfd_storage *) d;
165 /* See objfiles.h. */
168 set_objfile_per_bfd (struct objfile *objfile)
170 objfile->per_bfd = get_objfile_bfd_data (objfile, objfile->obfd);
173 /* Set the objfile's per-BFD notion of the "main" name and
177 set_objfile_main_name (struct objfile *objfile,
178 const char *name, enum language lang)
180 if (objfile->per_bfd->name_of_main == NULL
181 || strcmp (objfile->per_bfd->name_of_main, name) != 0)
182 objfile->per_bfd->name_of_main
183 = (const char *) obstack_copy0 (&objfile->per_bfd->storage_obstack, name,
185 objfile->per_bfd->language_of_main = lang;
188 /* Helper structure to map blocks to static link properties in hash tables. */
190 struct static_link_htab_entry
192 const struct block *block;
193 const struct dynamic_prop *static_link;
196 /* Return a hash code for struct static_link_htab_entry *P. */
199 static_link_htab_entry_hash (const void *p)
201 const struct static_link_htab_entry *e
202 = (const struct static_link_htab_entry *) p;
204 return htab_hash_pointer (e->block);
207 /* Return whether P1 an P2 (pointers to struct static_link_htab_entry) are
208 mappings for the same block. */
211 static_link_htab_entry_eq (const void *p1, const void *p2)
213 const struct static_link_htab_entry *e1
214 = (const struct static_link_htab_entry *) p1;
215 const struct static_link_htab_entry *e2
216 = (const struct static_link_htab_entry *) p2;
218 return e1->block == e2->block;
221 /* Register STATIC_LINK as the static link for BLOCK, which is part of OBJFILE.
222 Must not be called more than once for each BLOCK. */
225 objfile_register_static_link (struct objfile *objfile,
226 const struct block *block,
227 const struct dynamic_prop *static_link)
230 struct static_link_htab_entry lookup_entry;
231 struct static_link_htab_entry *entry;
233 if (objfile->static_links == NULL)
234 objfile->static_links = htab_create_alloc
235 (1, &static_link_htab_entry_hash, static_link_htab_entry_eq, NULL,
238 /* Create a slot for the mapping, make sure it's the first mapping for this
239 block and then create the mapping itself. */
240 lookup_entry.block = block;
241 slot = htab_find_slot (objfile->static_links, &lookup_entry, INSERT);
242 gdb_assert (*slot == NULL);
244 entry = XOBNEW (&objfile->objfile_obstack, static_link_htab_entry);
245 entry->block = block;
246 entry->static_link = static_link;
247 *slot = (void *) entry;
250 /* Look for a static link for BLOCK, which is part of OBJFILE. Return NULL if
253 const struct dynamic_prop *
254 objfile_lookup_static_link (struct objfile *objfile,
255 const struct block *block)
257 struct static_link_htab_entry *entry;
258 struct static_link_htab_entry lookup_entry;
260 if (objfile->static_links == NULL)
262 lookup_entry.block = block;
264 = (struct static_link_htab_entry *) htab_find (objfile->static_links,
269 gdb_assert (entry->block == block);
270 return entry->static_link;
275 /* Called via bfd_map_over_sections to build up the section table that
276 the objfile references. The objfile contains pointers to the start
277 of the table (objfile->sections) and to the first location after
278 the end of the table (objfile->sections_end). */
281 add_to_objfile_sections_full (struct bfd *abfd, struct bfd_section *asect,
282 struct objfile *objfile, int force)
284 struct obj_section *section;
290 aflag = bfd_get_section_flags (abfd, asect);
291 if (!(aflag & SEC_ALLOC))
295 section = &objfile->sections[gdb_bfd_section_index (abfd, asect)];
296 section->objfile = objfile;
297 section->the_bfd_section = asect;
298 section->ovly_mapped = 0;
302 add_to_objfile_sections (struct bfd *abfd, struct bfd_section *asect,
305 add_to_objfile_sections_full (abfd, asect, (struct objfile *) objfilep, 0);
308 /* Builds a section table for OBJFILE.
310 Note that the OFFSET and OVLY_MAPPED in each table entry are
311 initialized to zero. */
314 build_objfile_section_table (struct objfile *objfile)
316 int count = gdb_bfd_count_sections (objfile->obfd);
318 objfile->sections = OBSTACK_CALLOC (&objfile->objfile_obstack,
321 objfile->sections_end = (objfile->sections + count);
322 bfd_map_over_sections (objfile->obfd,
323 add_to_objfile_sections, (void *) objfile);
325 /* See gdb_bfd_section_index. */
326 add_to_objfile_sections_full (objfile->obfd, bfd_com_section_ptr, objfile, 1);
327 add_to_objfile_sections_full (objfile->obfd, bfd_und_section_ptr, objfile, 1);
328 add_to_objfile_sections_full (objfile->obfd, bfd_abs_section_ptr, objfile, 1);
329 add_to_objfile_sections_full (objfile->obfd, bfd_ind_section_ptr, objfile, 1);
332 /* Given a pointer to an initialized bfd (ABFD) and some flag bits,
333 initialize the new objfile as best we can and link it into the list
334 of all known objfiles.
336 NAME should contain original non-canonicalized filename or other
337 identifier as entered by user. If there is no better source use
338 bfd_get_filename (ABFD). NAME may be NULL only if ABFD is NULL.
339 NAME content is copied into returned objfile.
341 The FLAGS word contains various bits (OBJF_*) that can be taken as
342 requests for specific operations. Other bits like OBJF_SHARED are
343 simply copied through to the new objfile flags member. */
345 objfile::objfile (bfd *abfd, const char *name, objfile_flags flags_)
347 pspace (current_program_space),
348 partial_symtabs (new psymtab_storage ()),
351 const char *expanded_name;
353 /* We could use obstack_specify_allocation here instead, but
354 gdb_obstack.h specifies the alloc/dealloc functions. */
355 obstack_init (&objfile_obstack);
357 objfile_alloc_data (this);
359 gdb::unique_xmalloc_ptr<char> name_holder;
362 gdb_assert (abfd == NULL);
363 gdb_assert ((flags & OBJF_NOT_FILENAME) != 0);
364 expanded_name = "<<anonymous objfile>>";
366 else if ((flags & OBJF_NOT_FILENAME) != 0
367 || is_target_filename (name))
368 expanded_name = name;
371 name_holder = gdb_abspath (name);
372 expanded_name = name_holder.get ();
375 = (char *) obstack_copy0 (&objfile_obstack,
377 strlen (expanded_name));
379 /* Update the per-objfile information that comes from the bfd, ensuring
380 that any data that is reference is saved in the per-objfile data
386 mtime = bfd_get_mtime (abfd);
388 /* Build section table. */
389 build_objfile_section_table (this);
392 per_bfd = get_objfile_bfd_data (this, abfd);
394 /* Add this file onto the tail of the linked list of other such files. */
396 if (object_files == NULL)
400 struct objfile *last_one;
402 for (last_one = object_files;
404 last_one = last_one->next);
405 last_one->next = this;
408 /* Rebuild section map next time we need it. */
409 get_objfile_pspace_data (pspace)->new_objfiles_available = 1;
412 /* Retrieve the gdbarch associated with OBJFILE. */
415 get_objfile_arch (const struct objfile *objfile)
417 return objfile->per_bfd->gdbarch;
420 /* If there is a valid and known entry point, function fills *ENTRY_P with it
421 and returns non-zero; otherwise it returns zero. */
424 entry_point_address_query (CORE_ADDR *entry_p)
426 if (symfile_objfile == NULL || !symfile_objfile->per_bfd->ei.entry_point_p)
429 *entry_p = (symfile_objfile->per_bfd->ei.entry_point
430 + ANOFFSET (symfile_objfile->section_offsets,
431 symfile_objfile->per_bfd->ei.the_bfd_section_index));
436 /* Get current entry point address. Call error if it is not known. */
439 entry_point_address (void)
443 if (!entry_point_address_query (&retval))
444 error (_("Entry point address is not known."));
449 /* Iterator on PARENT and every separate debug objfile of PARENT.
450 The usage pattern is:
451 for (objfile = parent;
453 objfile = objfile_separate_debug_iterate (parent, objfile))
458 objfile_separate_debug_iterate (const struct objfile *parent,
459 const struct objfile *objfile)
463 /* If any, return the first child. */
464 res = objfile->separate_debug_objfile;
468 /* Common case where there is no separate debug objfile. */
469 if (objfile == parent)
472 /* Return the brother if any. Note that we don't iterate on brothers of
474 res = objfile->separate_debug_objfile_link;
478 for (res = objfile->separate_debug_objfile_backlink;
480 res = res->separate_debug_objfile_backlink)
482 gdb_assert (res != NULL);
483 if (res->separate_debug_objfile_link)
484 return res->separate_debug_objfile_link;
489 /* Put one object file before a specified on in the global list.
490 This can be used to make sure an object file is destroyed before
491 another when using objfiles_safe to free all objfiles. */
493 put_objfile_before (struct objfile *objfile, struct objfile *before_this)
495 struct objfile **objp;
497 unlink_objfile (objfile);
499 for (objp = &object_files; *objp != NULL; objp = &((*objp)->next))
501 if (*objp == before_this)
503 objfile->next = *objp;
509 internal_error (__FILE__, __LINE__,
510 _("put_objfile_before: before objfile not in list"));
513 /* Unlink OBJFILE from the list of known objfiles, if it is found in the
516 It is not a bug, or error, to call this function if OBJFILE is not known
517 to be in the current list. This is done in the case of mapped objfiles,
518 for example, just to ensure that the mapped objfile doesn't appear twice
519 in the list. Since the list is threaded, linking in a mapped objfile
520 twice would create a circular list.
522 If OBJFILE turns out to be in the list, we zap it's NEXT pointer after
523 unlinking it, just to ensure that we have completely severed any linkages
524 between the OBJFILE and the list. */
527 unlink_objfile (struct objfile *objfile)
529 struct objfile **objpp;
531 for (objpp = &object_files; *objpp != NULL; objpp = &((*objpp)->next))
533 if (*objpp == objfile)
535 *objpp = (*objpp)->next;
536 objfile->next = NULL;
541 internal_error (__FILE__, __LINE__,
542 _("unlink_objfile: objfile already unlinked"));
545 /* Add OBJFILE as a separate debug objfile of PARENT. */
548 add_separate_debug_objfile (struct objfile *objfile, struct objfile *parent)
550 gdb_assert (objfile && parent);
552 /* Must not be already in a list. */
553 gdb_assert (objfile->separate_debug_objfile_backlink == NULL);
554 gdb_assert (objfile->separate_debug_objfile_link == NULL);
555 gdb_assert (objfile->separate_debug_objfile == NULL);
556 gdb_assert (parent->separate_debug_objfile_backlink == NULL);
557 gdb_assert (parent->separate_debug_objfile_link == NULL);
559 objfile->separate_debug_objfile_backlink = parent;
560 objfile->separate_debug_objfile_link = parent->separate_debug_objfile;
561 parent->separate_debug_objfile = objfile;
563 /* Put the separate debug object before the normal one, this is so that
564 usage of objfiles_safe will stay safe. */
565 put_objfile_before (objfile, parent);
568 /* Free all separate debug objfile of OBJFILE, but don't free OBJFILE
572 free_objfile_separate_debug (struct objfile *objfile)
574 struct objfile *child;
576 for (child = objfile->separate_debug_objfile; child;)
578 struct objfile *next_child = child->separate_debug_objfile_link;
584 /* Destroy an objfile and all the symtabs and psymtabs under it. */
588 /* First notify observers that this objfile is about to be freed. */
589 gdb::observers::free_objfile.notify (this);
591 /* Free all separate debug objfiles. */
592 free_objfile_separate_debug (this);
594 if (separate_debug_objfile_backlink)
596 /* We freed the separate debug file, make sure the base objfile
597 doesn't reference it. */
598 struct objfile *child;
600 child = separate_debug_objfile_backlink->separate_debug_objfile;
604 /* THIS is the first child. */
605 separate_debug_objfile_backlink->separate_debug_objfile =
606 separate_debug_objfile_link;
610 /* Find THIS in the list. */
613 if (child->separate_debug_objfile_link == this)
615 child->separate_debug_objfile_link =
616 separate_debug_objfile_link;
619 child = child->separate_debug_objfile_link;
625 /* Remove any references to this objfile in the global value
627 preserve_values (this);
629 /* It still may reference data modules have associated with the objfile and
630 the symbol file data. */
631 forget_cached_source_info_for_objfile (this);
633 breakpoint_free_objfile (this);
634 btrace_free_objfile (this);
636 /* First do any symbol file specific actions required when we are
637 finished with a particular symbol file. Note that if the objfile
638 is using reusable symbol information (via mmalloc) then each of
639 these routines is responsible for doing the correct thing, either
640 freeing things which are valid only during this particular gdb
641 execution, or leaving them to be reused during the next one. */
644 (*sf->sym_finish) (this);
646 /* Discard any data modules have associated with the objfile. The function
647 still may reference obfd. */
648 objfile_free_data (this);
651 gdb_bfd_unref (obfd);
655 /* Remove it from the chain of all objfiles. */
657 unlink_objfile (this);
659 if (this == symfile_objfile)
660 symfile_objfile = NULL;
662 /* Before the symbol table code was redone to make it easier to
663 selectively load and remove information particular to a specific
664 linkage unit, gdb used to do these things whenever the monolithic
665 symbol table was blown away. How much still needs to be done
666 is unknown, but we play it safe for now and keep each action until
667 it is shown to be no longer needed. */
669 /* Not all our callers call clear_symtab_users (objfile_purge_solibs,
670 for example), so we need to call this here. */
671 clear_pc_function_cache ();
673 /* Check to see if the current_source_symtab belongs to this objfile,
674 and if so, call clear_current_source_symtab_and_line. */
677 struct symtab_and_line cursal = get_current_source_symtab_and_line ();
679 if (cursal.symtab && SYMTAB_OBJFILE (cursal.symtab) == this)
680 clear_current_source_symtab_and_line ();
683 /* Free the obstacks for non-reusable objfiles. */
684 obstack_free (&objfile_obstack, 0);
686 /* Rebuild section map next time we need it. */
687 get_objfile_pspace_data (pspace)->section_map_dirty = 1;
689 /* Free the map for static links. There's no need to free static link
690 themselves since they were allocated on the objstack. */
691 if (static_links != NULL)
692 htab_delete (static_links);
695 /* Free all the object files at once and clean up their users. */
698 free_all_objfiles (void)
702 /* Any objfile referencewould become stale. */
703 for (so = master_so_list (); so; so = so->next)
704 gdb_assert (so->objfile == NULL);
706 for (objfile *objfile : current_program_space->objfiles_safe ())
708 clear_symtab_users (0);
711 /* A helper function for objfile_relocate1 that relocates a single
715 relocate_one_symbol (struct symbol *sym, struct objfile *objfile,
716 struct section_offsets *delta)
718 fixup_symbol_section (sym, objfile);
720 /* The RS6000 code from which this was taken skipped
721 any symbols in STRUCT_DOMAIN or UNDEF_DOMAIN.
722 But I'm leaving out that test, on the theory that
723 they can't possibly pass the tests below. */
724 if ((SYMBOL_CLASS (sym) == LOC_LABEL
725 || SYMBOL_CLASS (sym) == LOC_STATIC)
726 && SYMBOL_SECTION (sym) >= 0)
728 SYMBOL_VALUE_ADDRESS (sym) += ANOFFSET (delta, SYMBOL_SECTION (sym));
732 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
733 entries in new_offsets. SEPARATE_DEBUG_OBJFILE is not touched here.
734 Return non-zero iff any change happened. */
737 objfile_relocate1 (struct objfile *objfile,
738 const struct section_offsets *new_offsets)
740 struct section_offsets *delta =
741 ((struct section_offsets *)
742 alloca (SIZEOF_N_SECTION_OFFSETS (objfile->num_sections)));
744 int something_changed = 0;
746 for (int i = 0; i < objfile->num_sections; ++i)
749 ANOFFSET (new_offsets, i) - ANOFFSET (objfile->section_offsets, i);
750 if (ANOFFSET (delta, i) != 0)
751 something_changed = 1;
753 if (!something_changed)
756 /* OK, get all the symtabs. */
758 for (compunit_symtab *cust : objfile->compunits ())
760 for (symtab *s : compunit_filetabs (cust))
764 /* First the line table. */
765 l = SYMTAB_LINETABLE (s);
768 for (int i = 0; i < l->nitems; ++i)
769 l->item[i].pc += ANOFFSET (delta,
770 COMPUNIT_BLOCK_LINE_SECTION
776 for (compunit_symtab *cust : objfile->compunits ())
778 const struct blockvector *bv = COMPUNIT_BLOCKVECTOR (cust);
779 int block_line_section = COMPUNIT_BLOCK_LINE_SECTION (cust);
781 if (BLOCKVECTOR_MAP (bv))
782 addrmap_relocate (BLOCKVECTOR_MAP (bv),
783 ANOFFSET (delta, block_line_section));
785 for (int i = 0; i < BLOCKVECTOR_NBLOCKS (bv); ++i)
789 struct mdict_iterator miter;
791 b = BLOCKVECTOR_BLOCK (bv, i);
792 BLOCK_START (b) += ANOFFSET (delta, block_line_section);
793 BLOCK_END (b) += ANOFFSET (delta, block_line_section);
795 if (BLOCK_RANGES (b) != nullptr)
796 for (int j = 0; j < BLOCK_NRANGES (b); j++)
798 BLOCK_RANGE_START (b, j)
799 += ANOFFSET (delta, block_line_section);
800 BLOCK_RANGE_END (b, j) += ANOFFSET (delta,
804 /* We only want to iterate over the local symbols, not any
805 symbols in included symtabs. */
806 ALL_DICT_SYMBOLS (BLOCK_MULTIDICT (b), miter, sym)
808 relocate_one_symbol (sym, objfile, delta);
814 /* This stores relocated addresses and so must be cleared. This
815 will cause it to be recreated on demand. */
816 objfile->psymbol_map.clear ();
818 /* Relocate isolated symbols. */
822 for (iter = objfile->template_symbols; iter; iter = iter->hash_next)
823 relocate_one_symbol (iter, objfile, delta);
829 for (i = 0; i < objfile->num_sections; ++i)
830 (objfile->section_offsets)->offsets[i] = ANOFFSET (new_offsets, i);
833 /* Rebuild section map next time we need it. */
834 get_objfile_pspace_data (objfile->pspace)->section_map_dirty = 1;
836 /* Update the table in exec_ops, used to read memory. */
837 struct obj_section *s;
838 ALL_OBJFILE_OSECTIONS (objfile, s)
840 int idx = s - objfile->sections;
842 exec_set_section_address (bfd_get_filename (objfile->obfd), idx,
843 obj_section_addr (s));
850 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
851 entries in new_offsets. Process also OBJFILE's SEPARATE_DEBUG_OBJFILEs.
853 The number and ordering of sections does differ between the two objfiles.
854 Only their names match. Also the file offsets will differ (objfile being
855 possibly prelinked but separate_debug_objfile is probably not prelinked) but
856 the in-memory absolute address as specified by NEW_OFFSETS must match both
860 objfile_relocate (struct objfile *objfile,
861 const struct section_offsets *new_offsets)
863 struct objfile *debug_objfile;
866 changed |= objfile_relocate1 (objfile, new_offsets);
868 for (debug_objfile = objfile->separate_debug_objfile;
870 debug_objfile = objfile_separate_debug_iterate (objfile, debug_objfile))
872 section_addr_info objfile_addrs
873 = build_section_addr_info_from_objfile (objfile);
875 /* Here OBJFILE_ADDRS contain the correct absolute addresses, the
876 relative ones must be already created according to debug_objfile. */
878 addr_info_make_relative (&objfile_addrs, debug_objfile->obfd);
880 gdb_assert (debug_objfile->num_sections
881 == gdb_bfd_count_sections (debug_objfile->obfd));
882 std::vector<struct section_offsets>
883 new_debug_offsets (SIZEOF_N_SECTION_OFFSETS (debug_objfile->num_sections));
884 relative_addr_info_to_section_offsets (new_debug_offsets.data (),
885 debug_objfile->num_sections,
888 changed |= objfile_relocate1 (debug_objfile, new_debug_offsets.data ());
891 /* Relocate breakpoints as necessary, after things are relocated. */
893 breakpoint_re_set ();
896 /* Rebase (add to the offsets) OBJFILE by SLIDE. SEPARATE_DEBUG_OBJFILE is
898 Return non-zero iff any change happened. */
901 objfile_rebase1 (struct objfile *objfile, CORE_ADDR slide)
903 struct section_offsets *new_offsets =
904 ((struct section_offsets *)
905 alloca (SIZEOF_N_SECTION_OFFSETS (objfile->num_sections)));
908 for (i = 0; i < objfile->num_sections; ++i)
909 new_offsets->offsets[i] = slide;
911 return objfile_relocate1 (objfile, new_offsets);
914 /* Rebase (add to the offsets) OBJFILE by SLIDE. Process also OBJFILE's
915 SEPARATE_DEBUG_OBJFILEs. */
918 objfile_rebase (struct objfile *objfile, CORE_ADDR slide)
920 struct objfile *debug_objfile;
923 changed |= objfile_rebase1 (objfile, slide);
925 for (debug_objfile = objfile->separate_debug_objfile;
927 debug_objfile = objfile_separate_debug_iterate (objfile, debug_objfile))
928 changed |= objfile_rebase1 (debug_objfile, slide);
930 /* Relocate breakpoints as necessary, after things are relocated. */
932 breakpoint_re_set ();
935 /* Return non-zero if OBJFILE has partial symbols. */
938 objfile_has_partial_symbols (struct objfile *objfile)
943 /* If we have not read psymbols, but we have a function capable of reading
944 them, then that is an indication that they are in fact available. Without
945 this function the symbols may have been already read in but they also may
946 not be present in this objfile. */
947 if ((objfile->flags & OBJF_PSYMTABS_READ) == 0
948 && objfile->sf->sym_read_psymbols != NULL)
951 return objfile->sf->qf->has_symbols (objfile);
954 /* Return non-zero if OBJFILE has full symbols. */
957 objfile_has_full_symbols (struct objfile *objfile)
959 return objfile->compunit_symtabs != NULL;
962 /* Return non-zero if OBJFILE has full or partial symbols, either directly
963 or through a separate debug file. */
966 objfile_has_symbols (struct objfile *objfile)
970 for (o = objfile; o; o = objfile_separate_debug_iterate (objfile, o))
971 if (objfile_has_partial_symbols (o) || objfile_has_full_symbols (o))
977 /* Many places in gdb want to test just to see if we have any partial
978 symbols available. This function returns zero if none are currently
979 available, nonzero otherwise. */
982 have_partial_symbols (void)
984 for (objfile *ofp : current_program_space->objfiles ())
986 if (objfile_has_partial_symbols (ofp))
992 /* Many places in gdb want to test just to see if we have any full
993 symbols available. This function returns zero if none are currently
994 available, nonzero otherwise. */
997 have_full_symbols (void)
999 for (objfile *ofp : current_program_space->objfiles ())
1001 if (objfile_has_full_symbols (ofp))
1008 /* This operations deletes all objfile entries that represent solibs that
1009 weren't explicitly loaded by the user, via e.g., the add-symbol-file
1013 objfile_purge_solibs (void)
1015 for (objfile *objf : current_program_space->objfiles_safe ())
1017 /* We assume that the solib package has been purged already, or will
1020 if (!(objf->flags & OBJF_USERLOADED) && (objf->flags & OBJF_SHARED))
1026 /* Many places in gdb want to test just to see if we have any minimal
1027 symbols available. This function returns zero if none are currently
1028 available, nonzero otherwise. */
1031 have_minimal_symbols (void)
1033 for (objfile *ofp : current_program_space->objfiles ())
1035 if (ofp->per_bfd->minimal_symbol_count > 0)
1043 /* Qsort comparison function. */
1046 qsort_cmp (const void *a, const void *b)
1048 const struct obj_section *sect1 = *(const struct obj_section **) a;
1049 const struct obj_section *sect2 = *(const struct obj_section **) b;
1050 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1051 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1053 if (sect1_addr < sect2_addr)
1055 else if (sect1_addr > sect2_addr)
1059 /* Sections are at the same address. This could happen if
1060 A) we have an objfile and a separate debuginfo.
1061 B) we are confused, and have added sections without proper relocation,
1062 or something like that. */
1064 const struct objfile *const objfile1 = sect1->objfile;
1065 const struct objfile *const objfile2 = sect2->objfile;
1067 if (objfile1->separate_debug_objfile == objfile2
1068 || objfile2->separate_debug_objfile == objfile1)
1070 /* Case A. The ordering doesn't matter: separate debuginfo files
1071 will be filtered out later. */
1076 /* Case B. Maintain stable sort order, so bugs in GDB are easier to
1077 triage. This section could be slow (since we iterate over all
1078 objfiles in each call to qsort_cmp), but this shouldn't happen
1079 very often (GDB is already in a confused state; one hopes this
1080 doesn't happen at all). If you discover that significant time is
1081 spent in the loops below, do 'set complaints 100' and examine the
1082 resulting complaints. */
1084 if (objfile1 == objfile2)
1086 /* Both sections came from the same objfile. We are really confused.
1087 Sort on sequence order of sections within the objfile. */
1089 const struct obj_section *osect;
1091 ALL_OBJFILE_OSECTIONS (objfile1, osect)
1094 else if (osect == sect2)
1097 /* We should have found one of the sections before getting here. */
1098 gdb_assert_not_reached ("section not found");
1102 /* Sort on sequence number of the objfile in the chain. */
1104 for (objfile *objfile : current_program_space->objfiles ())
1105 if (objfile == objfile1)
1107 else if (objfile == objfile2)
1110 /* We should have found one of the objfiles before getting here. */
1111 gdb_assert_not_reached ("objfile not found");
1116 gdb_assert_not_reached ("unexpected code path");
1120 /* Select "better" obj_section to keep. We prefer the one that came from
1121 the real object, rather than the one from separate debuginfo.
1122 Most of the time the two sections are exactly identical, but with
1123 prelinking the .rel.dyn section in the real object may have different
1126 static struct obj_section *
1127 preferred_obj_section (struct obj_section *a, struct obj_section *b)
1129 gdb_assert (obj_section_addr (a) == obj_section_addr (b));
1130 gdb_assert ((a->objfile->separate_debug_objfile == b->objfile)
1131 || (b->objfile->separate_debug_objfile == a->objfile));
1132 gdb_assert ((a->objfile->separate_debug_objfile_backlink == b->objfile)
1133 || (b->objfile->separate_debug_objfile_backlink == a->objfile));
1135 if (a->objfile->separate_debug_objfile != NULL)
1140 /* Return 1 if SECTION should be inserted into the section map.
1141 We want to insert only non-overlay and non-TLS section. */
1144 insert_section_p (const struct bfd *abfd,
1145 const struct bfd_section *section)
1147 const bfd_vma lma = bfd_section_lma (abfd, section);
1149 if (overlay_debugging && lma != 0 && lma != bfd_section_vma (abfd, section)
1150 && (bfd_get_file_flags (abfd) & BFD_IN_MEMORY) == 0)
1151 /* This is an overlay section. IN_MEMORY check is needed to avoid
1152 discarding sections from the "system supplied DSO" (aka vdso)
1153 on some Linux systems (e.g. Fedora 11). */
1155 if ((bfd_get_section_flags (abfd, section) & SEC_THREAD_LOCAL) != 0)
1156 /* This is a TLS section. */
1162 /* Filter out overlapping sections where one section came from the real
1163 objfile, and the other from a separate debuginfo file.
1164 Return the size of table after redundant sections have been eliminated. */
1167 filter_debuginfo_sections (struct obj_section **map, int map_size)
1171 for (i = 0, j = 0; i < map_size - 1; i++)
1173 struct obj_section *const sect1 = map[i];
1174 struct obj_section *const sect2 = map[i + 1];
1175 const struct objfile *const objfile1 = sect1->objfile;
1176 const struct objfile *const objfile2 = sect2->objfile;
1177 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1178 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1180 if (sect1_addr == sect2_addr
1181 && (objfile1->separate_debug_objfile == objfile2
1182 || objfile2->separate_debug_objfile == objfile1))
1184 map[j++] = preferred_obj_section (sect1, sect2);
1193 gdb_assert (i == map_size - 1);
1197 /* The map should not have shrunk to less than half the original size. */
1198 gdb_assert (map_size / 2 <= j);
1203 /* Filter out overlapping sections, issuing a warning if any are found.
1204 Overlapping sections could really be overlay sections which we didn't
1205 classify as such in insert_section_p, or we could be dealing with a
1209 filter_overlapping_sections (struct obj_section **map, int map_size)
1213 for (i = 0, j = 0; i < map_size - 1; )
1218 for (k = i + 1; k < map_size; k++)
1220 struct obj_section *const sect1 = map[i];
1221 struct obj_section *const sect2 = map[k];
1222 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1223 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1224 const CORE_ADDR sect1_endaddr = obj_section_endaddr (sect1);
1226 gdb_assert (sect1_addr <= sect2_addr);
1228 if (sect1_endaddr <= sect2_addr)
1232 /* We have an overlap. Report it. */
1234 struct objfile *const objf1 = sect1->objfile;
1235 struct objfile *const objf2 = sect2->objfile;
1237 const struct bfd_section *const bfds1 = sect1->the_bfd_section;
1238 const struct bfd_section *const bfds2 = sect2->the_bfd_section;
1240 const CORE_ADDR sect2_endaddr = obj_section_endaddr (sect2);
1242 struct gdbarch *const gdbarch = get_objfile_arch (objf1);
1244 complaint (_("unexpected overlap between:\n"
1245 " (A) section `%s' from `%s' [%s, %s)\n"
1246 " (B) section `%s' from `%s' [%s, %s).\n"
1247 "Will ignore section B"),
1248 bfd_section_name (abfd1, bfds1), objfile_name (objf1),
1249 paddress (gdbarch, sect1_addr),
1250 paddress (gdbarch, sect1_endaddr),
1251 bfd_section_name (abfd2, bfds2), objfile_name (objf2),
1252 paddress (gdbarch, sect2_addr),
1253 paddress (gdbarch, sect2_endaddr));
1261 gdb_assert (i == map_size - 1);
1269 /* Update PMAP, PMAP_SIZE with sections from all objfiles, excluding any
1270 TLS, overlay and overlapping sections. */
1273 update_section_map (struct program_space *pspace,
1274 struct obj_section ***pmap, int *pmap_size)
1276 struct objfile_pspace_info *pspace_info;
1277 int alloc_size, map_size, i;
1278 struct obj_section *s, **map;
1280 pspace_info = get_objfile_pspace_data (pspace);
1281 gdb_assert (pspace_info->section_map_dirty != 0
1282 || pspace_info->new_objfiles_available != 0);
1288 for (objfile *objfile : pspace->objfiles ())
1289 ALL_OBJFILE_OSECTIONS (objfile, s)
1290 if (insert_section_p (objfile->obfd, s->the_bfd_section))
1293 /* This happens on detach/attach (e.g. in gdb.base/attach.exp). */
1294 if (alloc_size == 0)
1301 map = XNEWVEC (struct obj_section *, alloc_size);
1304 for (objfile *objfile : pspace->objfiles ())
1305 ALL_OBJFILE_OSECTIONS (objfile, s)
1306 if (insert_section_p (objfile->obfd, s->the_bfd_section))
1309 qsort (map, alloc_size, sizeof (*map), qsort_cmp);
1310 map_size = filter_debuginfo_sections(map, alloc_size);
1311 map_size = filter_overlapping_sections(map, map_size);
1313 if (map_size < alloc_size)
1314 /* Some sections were eliminated. Trim excess space. */
1315 map = XRESIZEVEC (struct obj_section *, map, map_size);
1317 gdb_assert (alloc_size == map_size);
1320 *pmap_size = map_size;
1323 /* Bsearch comparison function. */
1326 bsearch_cmp (const void *key, const void *elt)
1328 const CORE_ADDR pc = *(CORE_ADDR *) key;
1329 const struct obj_section *section = *(const struct obj_section **) elt;
1331 if (pc < obj_section_addr (section))
1333 if (pc < obj_section_endaddr (section))
1338 /* Returns a section whose range includes PC or NULL if none found. */
1340 struct obj_section *
1341 find_pc_section (CORE_ADDR pc)
1343 struct objfile_pspace_info *pspace_info;
1344 struct obj_section *s, **sp;
1346 /* Check for mapped overlay section first. */
1347 s = find_pc_mapped_section (pc);
1351 pspace_info = get_objfile_pspace_data (current_program_space);
1352 if (pspace_info->section_map_dirty
1353 || (pspace_info->new_objfiles_available
1354 && !pspace_info->inhibit_updates))
1356 update_section_map (current_program_space,
1357 &pspace_info->sections,
1358 &pspace_info->num_sections);
1360 /* Don't need updates to section map until objfiles are added,
1361 removed or relocated. */
1362 pspace_info->new_objfiles_available = 0;
1363 pspace_info->section_map_dirty = 0;
1366 /* The C standard (ISO/IEC 9899:TC2) requires the BASE argument to
1367 bsearch be non-NULL. */
1368 if (pspace_info->sections == NULL)
1370 gdb_assert (pspace_info->num_sections == 0);
1374 sp = (struct obj_section **) bsearch (&pc,
1375 pspace_info->sections,
1376 pspace_info->num_sections,
1377 sizeof (*pspace_info->sections),
1385 /* Return non-zero if PC is in a section called NAME. */
1388 pc_in_section (CORE_ADDR pc, const char *name)
1390 struct obj_section *s;
1393 s = find_pc_section (pc);
1396 && s->the_bfd_section->name != NULL
1397 && strcmp (s->the_bfd_section->name, name) == 0);
1402 /* Set section_map_dirty so section map will be rebuilt next time it
1403 is used. Called by reread_symbols. */
1406 objfiles_changed (void)
1408 /* Rebuild section map next time we need it. */
1409 get_objfile_pspace_data (current_program_space)->section_map_dirty = 1;
1412 /* See comments in objfiles.h. */
1414 scoped_restore_tmpl<int>
1415 inhibit_section_map_updates (struct program_space *pspace)
1417 return scoped_restore_tmpl<int>
1418 (&get_objfile_pspace_data (pspace)->inhibit_updates, 1);
1421 /* Return 1 if ADDR maps into one of the sections of OBJFILE and 0
1425 is_addr_in_objfile (CORE_ADDR addr, const struct objfile *objfile)
1427 struct obj_section *osect;
1429 if (objfile == NULL)
1432 ALL_OBJFILE_OSECTIONS (objfile, osect)
1434 if (section_is_overlay (osect) && !section_is_mapped (osect))
1437 if (obj_section_addr (osect) <= addr
1438 && addr < obj_section_endaddr (osect))
1445 shared_objfile_contains_address_p (struct program_space *pspace,
1448 for (objfile *objfile : pspace->objfiles ())
1450 if ((objfile->flags & OBJF_SHARED) != 0
1451 && is_addr_in_objfile (address, objfile))
1458 /* The default implementation for the "iterate_over_objfiles_in_search_order"
1459 gdbarch method. It is equivalent to use the objfiles iterable,
1460 searching the objfiles in the order they are stored internally,
1461 ignoring CURRENT_OBJFILE.
1463 On most platorms, it should be close enough to doing the best
1464 we can without some knowledge specific to the architecture. */
1467 default_iterate_over_objfiles_in_search_order
1468 (struct gdbarch *gdbarch,
1469 iterate_over_objfiles_in_search_order_cb_ftype *cb,
1470 void *cb_data, struct objfile *current_objfile)
1474 for (objfile *objfile : current_program_space->objfiles ())
1476 stop = cb (objfile, cb_data);
1482 /* See objfiles.h. */
1485 objfile_name (const struct objfile *objfile)
1487 if (objfile->obfd != NULL)
1488 return bfd_get_filename (objfile->obfd);
1490 return objfile->original_name;
1493 /* See objfiles.h. */
1496 objfile_filename (const struct objfile *objfile)
1498 if (objfile->obfd != NULL)
1499 return bfd_get_filename (objfile->obfd);
1504 /* See objfiles.h. */
1507 objfile_debug_name (const struct objfile *objfile)
1509 return lbasename (objfile->original_name);
1512 /* See objfiles.h. */
1515 objfile_flavour_name (struct objfile *objfile)
1517 if (objfile->obfd != NULL)
1518 return bfd_flavour_name (bfd_get_flavour (objfile->obfd));
1523 _initialize_objfiles (void)
1525 objfiles_pspace_data
1526 = register_program_space_data_with_cleanup (NULL,
1527 objfiles_pspace_data_cleanup);
1529 objfiles_bfd_data = register_bfd_data_with_cleanup (NULL,
1530 objfile_bfd_data_free);