1 /* GDB routines for manipulating objfiles.
3 Copyright (C) 1992-2021 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 "gdbsupport/pathstuff.h"
60 /* Keep a registry of per-objfile data-pointers required by other GDB
63 DEFINE_REGISTRY (objfile
, REGISTRY_ACCESS_FIELD
)
65 /* Externally visible variables that are owned by this module.
66 See declarations in objfile.h for more info. */
68 struct objfile_pspace_info
70 objfile_pspace_info () = default;
71 ~objfile_pspace_info ();
73 struct obj_section
**sections
= nullptr;
76 /* Nonzero if object files have been added since the section map
78 int new_objfiles_available
= 0;
80 /* Nonzero if the section map MUST be updated before use. */
81 int section_map_dirty
= 0;
83 /* Nonzero if section map updates should be inhibited if possible. */
84 int inhibit_updates
= 0;
87 /* Per-program-space data key. */
88 static const struct program_space_key
<objfile_pspace_info
>
91 objfile_pspace_info::~objfile_pspace_info ()
96 /* Get the current svr4 data. If none is found yet, add it now. This
97 function always returns a valid object. */
99 static struct objfile_pspace_info
*
100 get_objfile_pspace_data (struct program_space
*pspace
)
102 struct objfile_pspace_info
*info
;
104 info
= objfiles_pspace_data
.get (pspace
);
106 info
= objfiles_pspace_data
.emplace (pspace
);
113 /* Per-BFD data key. */
115 static const struct bfd_key
<objfile_per_bfd_storage
> objfiles_bfd_data
;
117 objfile_per_bfd_storage::~objfile_per_bfd_storage ()
121 /* Create the per-BFD storage object for OBJFILE. If ABFD is not
122 NULL, and it already has a per-BFD storage object, use that.
123 Otherwise, allocate a new per-BFD storage object. Note that it is
124 not safe to call this multiple times for a given OBJFILE -- it can
125 only be called when allocating or re-initializing OBJFILE. */
127 static struct objfile_per_bfd_storage
*
128 get_objfile_bfd_data (struct objfile
*objfile
, struct bfd
*abfd
)
130 struct objfile_per_bfd_storage
*storage
= NULL
;
133 storage
= objfiles_bfd_data
.get (abfd
);
137 storage
= new objfile_per_bfd_storage
;
138 /* If the object requires gdb to do relocations, we simply fall
139 back to not sharing data across users. These cases are rare
140 enough that this seems reasonable. */
141 if (abfd
!= NULL
&& !gdb_bfd_requires_relocations (abfd
))
142 objfiles_bfd_data
.set (abfd
, storage
);
144 /* Look up the gdbarch associated with the BFD. */
146 storage
->gdbarch
= gdbarch_from_bfd (abfd
);
152 /* See objfiles.h. */
155 set_objfile_per_bfd (struct objfile
*objfile
)
157 objfile
->per_bfd
= get_objfile_bfd_data (objfile
, objfile
->obfd
);
160 /* Set the objfile's per-BFD notion of the "main" name and
164 set_objfile_main_name (struct objfile
*objfile
,
165 const char *name
, enum language lang
)
167 if (objfile
->per_bfd
->name_of_main
== NULL
168 || strcmp (objfile
->per_bfd
->name_of_main
, name
) != 0)
169 objfile
->per_bfd
->name_of_main
170 = obstack_strdup (&objfile
->per_bfd
->storage_obstack
, name
);
171 objfile
->per_bfd
->language_of_main
= lang
;
174 /* Helper structure to map blocks to static link properties in hash tables. */
176 struct static_link_htab_entry
178 const struct block
*block
;
179 const struct dynamic_prop
*static_link
;
182 /* Return a hash code for struct static_link_htab_entry *P. */
185 static_link_htab_entry_hash (const void *p
)
187 const struct static_link_htab_entry
*e
188 = (const struct static_link_htab_entry
*) p
;
190 return htab_hash_pointer (e
->block
);
193 /* Return whether P1 an P2 (pointers to struct static_link_htab_entry) are
194 mappings for the same block. */
197 static_link_htab_entry_eq (const void *p1
, const void *p2
)
199 const struct static_link_htab_entry
*e1
200 = (const struct static_link_htab_entry
*) p1
;
201 const struct static_link_htab_entry
*e2
202 = (const struct static_link_htab_entry
*) p2
;
204 return e1
->block
== e2
->block
;
207 /* Register STATIC_LINK as the static link for BLOCK, which is part of OBJFILE.
208 Must not be called more than once for each BLOCK. */
211 objfile_register_static_link (struct objfile
*objfile
,
212 const struct block
*block
,
213 const struct dynamic_prop
*static_link
)
216 struct static_link_htab_entry lookup_entry
;
217 struct static_link_htab_entry
*entry
;
219 if (objfile
->static_links
== NULL
)
220 objfile
->static_links
.reset (htab_create_alloc
221 (1, &static_link_htab_entry_hash
, static_link_htab_entry_eq
, NULL
,
224 /* Create a slot for the mapping, make sure it's the first mapping for this
225 block and then create the mapping itself. */
226 lookup_entry
.block
= block
;
227 slot
= htab_find_slot (objfile
->static_links
.get (), &lookup_entry
, INSERT
);
228 gdb_assert (*slot
== NULL
);
230 entry
= XOBNEW (&objfile
->objfile_obstack
, static_link_htab_entry
);
231 entry
->block
= block
;
232 entry
->static_link
= static_link
;
233 *slot
= (void *) entry
;
236 /* Look for a static link for BLOCK, which is part of OBJFILE. Return NULL if
239 const struct dynamic_prop
*
240 objfile_lookup_static_link (struct objfile
*objfile
,
241 const struct block
*block
)
243 struct static_link_htab_entry
*entry
;
244 struct static_link_htab_entry lookup_entry
;
246 if (objfile
->static_links
== NULL
)
248 lookup_entry
.block
= block
;
249 entry
= ((struct static_link_htab_entry
*)
250 htab_find (objfile
->static_links
.get (), &lookup_entry
));
254 gdb_assert (entry
->block
== block
);
255 return entry
->static_link
;
260 /* Build up the section table that the objfile references. The
261 objfile contains pointers to the start of the table
262 (objfile->sections) and to the first location after the end of the
263 table (objfile->sections_end). */
266 add_to_objfile_sections (struct bfd
*abfd
, struct bfd_section
*asect
,
267 struct objfile
*objfile
, int force
)
269 struct obj_section
*section
;
275 aflag
= bfd_section_flags (asect
);
276 if (!(aflag
& SEC_ALLOC
))
280 section
= &objfile
->sections
[gdb_bfd_section_index (abfd
, asect
)];
281 section
->objfile
= objfile
;
282 section
->the_bfd_section
= asect
;
283 section
->ovly_mapped
= 0;
286 /* Builds a section table for OBJFILE.
288 Note that the OFFSET and OVLY_MAPPED in each table entry are
289 initialized to zero. */
292 build_objfile_section_table (struct objfile
*objfile
)
294 int count
= gdb_bfd_count_sections (objfile
->obfd
);
296 objfile
->sections
= OBSTACK_CALLOC (&objfile
->objfile_obstack
,
299 objfile
->sections_end
= (objfile
->sections
+ count
);
300 for (asection
*sect
: gdb_bfd_sections (objfile
->obfd
))
301 add_to_objfile_sections (objfile
->obfd
, sect
, objfile
, 0);
303 /* See gdb_bfd_section_index. */
304 add_to_objfile_sections (objfile
->obfd
, bfd_com_section_ptr
, objfile
, 1);
305 add_to_objfile_sections (objfile
->obfd
, bfd_und_section_ptr
, objfile
, 1);
306 add_to_objfile_sections (objfile
->obfd
, bfd_abs_section_ptr
, objfile
, 1);
307 add_to_objfile_sections (objfile
->obfd
, bfd_ind_section_ptr
, objfile
, 1);
310 /* Given a pointer to an initialized bfd (ABFD) and some flag bits,
311 initialize the new objfile as best we can and link it into the list
312 of all known objfiles.
314 NAME should contain original non-canonicalized filename or other
315 identifier as entered by user. If there is no better source use
316 bfd_get_filename (ABFD). NAME may be NULL only if ABFD is NULL.
317 NAME content is copied into returned objfile.
319 The FLAGS word contains various bits (OBJF_*) that can be taken as
320 requests for specific operations. Other bits like OBJF_SHARED are
321 simply copied through to the new objfile flags member. */
323 objfile::objfile (bfd
*abfd
, const char *name
, objfile_flags flags_
)
325 pspace (current_program_space
),
326 partial_symtabs (new psymtab_storage ()),
329 const char *expanded_name
;
331 /* We could use obstack_specify_allocation here instead, but
332 gdb_obstack.h specifies the alloc/dealloc functions. */
333 obstack_init (&objfile_obstack
);
335 objfile_alloc_data (this);
337 gdb::unique_xmalloc_ptr
<char> name_holder
;
340 gdb_assert (abfd
== NULL
);
341 gdb_assert ((flags
& OBJF_NOT_FILENAME
) != 0);
342 expanded_name
= "<<anonymous objfile>>";
344 else if ((flags
& OBJF_NOT_FILENAME
) != 0
345 || is_target_filename (name
))
346 expanded_name
= name
;
349 name_holder
= gdb_abspath (name
);
350 expanded_name
= name_holder
.get ();
352 original_name
= obstack_strdup (&objfile_obstack
, expanded_name
);
354 /* Update the per-objfile information that comes from the bfd, ensuring
355 that any data that is reference is saved in the per-objfile data
361 mtime
= bfd_get_mtime (abfd
);
363 /* Build section table. */
364 build_objfile_section_table (this);
367 per_bfd
= get_objfile_bfd_data (this, abfd
);
370 /* If there is a valid and known entry point, function fills *ENTRY_P with it
371 and returns non-zero; otherwise it returns zero. */
374 entry_point_address_query (CORE_ADDR
*entry_p
)
376 objfile
*objf
= current_program_space
->symfile_object_file
;
377 if (objf
== NULL
|| !objf
->per_bfd
->ei
.entry_point_p
)
380 int idx
= objf
->per_bfd
->ei
.the_bfd_section_index
;
381 *entry_p
= objf
->per_bfd
->ei
.entry_point
+ objf
->section_offsets
[idx
];
386 /* Get current entry point address. Call error if it is not known. */
389 entry_point_address (void)
393 if (!entry_point_address_query (&retval
))
394 error (_("Entry point address is not known."));
399 separate_debug_iterator
&
400 separate_debug_iterator::operator++ ()
402 gdb_assert (m_objfile
!= nullptr);
406 /* If any, return the first child. */
407 res
= m_objfile
->separate_debug_objfile
;
414 /* Common case where there is no separate debug objfile. */
415 if (m_objfile
== m_parent
)
421 /* Return the brother if any. Note that we don't iterate on brothers of
423 res
= m_objfile
->separate_debug_objfile_link
;
430 for (res
= m_objfile
->separate_debug_objfile_backlink
;
432 res
= res
->separate_debug_objfile_backlink
)
434 gdb_assert (res
!= nullptr);
435 if (res
->separate_debug_objfile_link
!= nullptr)
437 m_objfile
= res
->separate_debug_objfile_link
;
445 /* Add OBJFILE as a separate debug objfile of PARENT. */
448 add_separate_debug_objfile (struct objfile
*objfile
, struct objfile
*parent
)
450 gdb_assert (objfile
&& parent
);
452 /* Must not be already in a list. */
453 gdb_assert (objfile
->separate_debug_objfile_backlink
== NULL
);
454 gdb_assert (objfile
->separate_debug_objfile_link
== NULL
);
455 gdb_assert (objfile
->separate_debug_objfile
== NULL
);
456 gdb_assert (parent
->separate_debug_objfile_backlink
== NULL
);
457 gdb_assert (parent
->separate_debug_objfile_link
== NULL
);
459 objfile
->separate_debug_objfile_backlink
= parent
;
460 objfile
->separate_debug_objfile_link
= parent
->separate_debug_objfile
;
461 parent
->separate_debug_objfile
= objfile
;
464 /* See objfiles.h. */
467 objfile::make (bfd
*bfd_
, const char *name_
, objfile_flags flags_
,
470 objfile
*result
= new objfile (bfd_
, name_
, flags_
);
471 if (parent
!= nullptr)
472 add_separate_debug_objfile (result
, parent
);
474 /* Using std::make_shared might be a bit nicer here, but that would
475 require making the constructor public. */
476 current_program_space
->add_objfile (std::shared_ptr
<objfile
> (result
),
479 /* Rebuild section map next time we need it. */
480 get_objfile_pspace_data (current_program_space
)->new_objfiles_available
= 1;
485 /* See objfiles.h. */
490 current_program_space
->remove_objfile (this);
493 /* Free all separate debug objfile of OBJFILE, but don't free OBJFILE
497 free_objfile_separate_debug (struct objfile
*objfile
)
499 struct objfile
*child
;
501 for (child
= objfile
->separate_debug_objfile
; child
;)
503 struct objfile
*next_child
= child
->separate_debug_objfile_link
;
509 /* Destroy an objfile and all the symtabs and psymtabs under it. */
513 /* First notify observers that this objfile is about to be freed. */
514 gdb::observers::free_objfile
.notify (this);
516 /* Free all separate debug objfiles. */
517 free_objfile_separate_debug (this);
519 if (separate_debug_objfile_backlink
)
521 /* We freed the separate debug file, make sure the base objfile
522 doesn't reference it. */
523 struct objfile
*child
;
525 child
= separate_debug_objfile_backlink
->separate_debug_objfile
;
529 /* THIS is the first child. */
530 separate_debug_objfile_backlink
->separate_debug_objfile
=
531 separate_debug_objfile_link
;
535 /* Find THIS in the list. */
538 if (child
->separate_debug_objfile_link
== this)
540 child
->separate_debug_objfile_link
=
541 separate_debug_objfile_link
;
544 child
= child
->separate_debug_objfile_link
;
550 /* Remove any references to this objfile in the global value
552 preserve_values (this);
554 /* It still may reference data modules have associated with the objfile and
555 the symbol file data. */
556 forget_cached_source_info_for_objfile (this);
558 breakpoint_free_objfile (this);
559 btrace_free_objfile (this);
561 /* First do any symbol file specific actions required when we are
562 finished with a particular symbol file. Note that if the objfile
563 is using reusable symbol information (via mmalloc) then each of
564 these routines is responsible for doing the correct thing, either
565 freeing things which are valid only during this particular gdb
566 execution, or leaving them to be reused during the next one. */
569 (*sf
->sym_finish
) (this);
571 /* Discard any data modules have associated with the objfile. The function
572 still may reference obfd. */
573 objfile_free_data (this);
576 gdb_bfd_unref (obfd
);
580 /* Before the symbol table code was redone to make it easier to
581 selectively load and remove information particular to a specific
582 linkage unit, gdb used to do these things whenever the monolithic
583 symbol table was blown away. How much still needs to be done
584 is unknown, but we play it safe for now and keep each action until
585 it is shown to be no longer needed. */
587 /* Not all our callers call clear_symtab_users (objfile_purge_solibs,
588 for example), so we need to call this here. */
589 clear_pc_function_cache ();
591 /* Check to see if the current_source_symtab belongs to this objfile,
592 and if so, call clear_current_source_symtab_and_line. */
595 struct symtab_and_line cursal
= get_current_source_symtab_and_line ();
597 if (cursal
.symtab
&& SYMTAB_OBJFILE (cursal
.symtab
) == this)
598 clear_current_source_symtab_and_line ();
601 /* Free the obstacks for non-reusable objfiles. */
602 obstack_free (&objfile_obstack
, 0);
604 /* Rebuild section map next time we need it. */
605 get_objfile_pspace_data (pspace
)->section_map_dirty
= 1;
609 /* A helper function for objfile_relocate1 that relocates a single
613 relocate_one_symbol (struct symbol
*sym
, struct objfile
*objfile
,
614 const section_offsets
&delta
)
616 fixup_symbol_section (sym
, objfile
);
618 /* The RS6000 code from which this was taken skipped
619 any symbols in STRUCT_DOMAIN or UNDEF_DOMAIN.
620 But I'm leaving out that test, on the theory that
621 they can't possibly pass the tests below. */
622 if ((SYMBOL_CLASS (sym
) == LOC_LABEL
623 || SYMBOL_CLASS (sym
) == LOC_STATIC
)
624 && sym
->section_index () >= 0)
626 SET_SYMBOL_VALUE_ADDRESS (sym
,
627 SYMBOL_VALUE_ADDRESS (sym
)
628 + delta
[sym
->section_index ()]);
632 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
633 entries in new_offsets. SEPARATE_DEBUG_OBJFILE is not touched here.
634 Return non-zero iff any change happened. */
637 objfile_relocate1 (struct objfile
*objfile
,
638 const section_offsets
&new_offsets
)
640 section_offsets
delta (objfile
->section_offsets
.size ());
642 int something_changed
= 0;
644 for (int i
= 0; i
< objfile
->section_offsets
.size (); ++i
)
646 delta
[i
] = new_offsets
[i
] - objfile
->section_offsets
[i
];
648 something_changed
= 1;
650 if (!something_changed
)
653 /* OK, get all the symtabs. */
655 for (compunit_symtab
*cust
: objfile
->compunits ())
657 for (symtab
*s
: compunit_filetabs (cust
))
661 /* First the line table. */
662 l
= SYMTAB_LINETABLE (s
);
665 for (int i
= 0; i
< l
->nitems
; ++i
)
666 l
->item
[i
].pc
+= delta
[COMPUNIT_BLOCK_LINE_SECTION (cust
)];
671 for (compunit_symtab
*cust
: objfile
->compunits ())
673 const struct blockvector
*bv
= COMPUNIT_BLOCKVECTOR (cust
);
674 int block_line_section
= COMPUNIT_BLOCK_LINE_SECTION (cust
);
676 if (BLOCKVECTOR_MAP (bv
))
677 addrmap_relocate (BLOCKVECTOR_MAP (bv
), delta
[block_line_section
]);
679 for (int i
= 0; i
< BLOCKVECTOR_NBLOCKS (bv
); ++i
)
683 struct mdict_iterator miter
;
685 b
= BLOCKVECTOR_BLOCK (bv
, i
);
686 BLOCK_START (b
) += delta
[block_line_section
];
687 BLOCK_END (b
) += delta
[block_line_section
];
689 if (BLOCK_RANGES (b
) != nullptr)
690 for (int j
= 0; j
< BLOCK_NRANGES (b
); j
++)
692 BLOCK_RANGE_START (b
, j
) += delta
[block_line_section
];
693 BLOCK_RANGE_END (b
, j
) += delta
[block_line_section
];
696 /* We only want to iterate over the local symbols, not any
697 symbols in included symtabs. */
698 ALL_DICT_SYMBOLS (BLOCK_MULTIDICT (b
), miter
, sym
)
700 relocate_one_symbol (sym
, objfile
, delta
);
706 /* Notify the quick symbol object. */
708 objfile
->qf
->relocated ();
710 /* Relocate isolated symbols. */
714 for (iter
= objfile
->template_symbols
; iter
; iter
= iter
->hash_next
)
715 relocate_one_symbol (iter
, objfile
, delta
);
721 for (i
= 0; i
< objfile
->section_offsets
.size (); ++i
)
722 objfile
->section_offsets
[i
] = new_offsets
[i
];
725 /* Rebuild section map next time we need it. */
726 get_objfile_pspace_data (objfile
->pspace
)->section_map_dirty
= 1;
728 /* Update the table in exec_ops, used to read memory. */
729 struct obj_section
*s
;
730 ALL_OBJFILE_OSECTIONS (objfile
, s
)
732 int idx
= s
- objfile
->sections
;
734 exec_set_section_address (bfd_get_filename (objfile
->obfd
), idx
,
735 obj_section_addr (s
));
742 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
743 entries in new_offsets. Process also OBJFILE's SEPARATE_DEBUG_OBJFILEs.
745 The number and ordering of sections does differ between the two objfiles.
746 Only their names match. Also the file offsets will differ (objfile being
747 possibly prelinked but separate_debug_objfile is probably not prelinked) but
748 the in-memory absolute address as specified by NEW_OFFSETS must match both
752 objfile_relocate (struct objfile
*objfile
,
753 const section_offsets
&new_offsets
)
757 changed
|= objfile_relocate1 (objfile
, new_offsets
);
759 for (::objfile
*debug_objfile
: objfile
->separate_debug_objfiles ())
761 if (debug_objfile
== objfile
)
764 section_addr_info objfile_addrs
765 = build_section_addr_info_from_objfile (objfile
);
767 /* Here OBJFILE_ADDRS contain the correct absolute addresses, the
768 relative ones must be already created according to debug_objfile. */
770 addr_info_make_relative (&objfile_addrs
, debug_objfile
->obfd
);
772 gdb_assert (debug_objfile
->section_offsets
.size ()
773 == gdb_bfd_count_sections (debug_objfile
->obfd
));
774 section_offsets new_debug_offsets
775 (debug_objfile
->section_offsets
.size ());
776 relative_addr_info_to_section_offsets (new_debug_offsets
, objfile_addrs
);
778 changed
|= objfile_relocate1 (debug_objfile
, new_debug_offsets
);
781 /* Relocate breakpoints as necessary, after things are relocated. */
783 breakpoint_re_set ();
786 /* Rebase (add to the offsets) OBJFILE by SLIDE. SEPARATE_DEBUG_OBJFILE is
788 Return non-zero iff any change happened. */
791 objfile_rebase1 (struct objfile
*objfile
, CORE_ADDR slide
)
793 section_offsets
new_offsets (objfile
->section_offsets
.size (), slide
);
794 return objfile_relocate1 (objfile
, new_offsets
);
797 /* Rebase (add to the offsets) OBJFILE by SLIDE. Process also OBJFILE's
798 SEPARATE_DEBUG_OBJFILEs. */
801 objfile_rebase (struct objfile
*objfile
, CORE_ADDR slide
)
805 for (::objfile
*debug_objfile
: objfile
->separate_debug_objfiles ())
806 changed
|= objfile_rebase1 (debug_objfile
, slide
);
808 /* Relocate breakpoints as necessary, after things are relocated. */
810 breakpoint_re_set ();
813 /* Return non-zero if OBJFILE has full symbols. */
816 objfile_has_full_symbols (struct objfile
*objfile
)
818 return objfile
->compunit_symtabs
!= NULL
;
821 /* Return non-zero if OBJFILE has full or partial symbols, either directly
822 or through a separate debug file. */
825 objfile_has_symbols (struct objfile
*objfile
)
827 for (::objfile
*o
: objfile
->separate_debug_objfiles ())
828 if (o
->has_partial_symbols () || objfile_has_full_symbols (o
))
834 /* Many places in gdb want to test just to see if we have any partial
835 symbols available. This function returns zero if none are currently
836 available, nonzero otherwise. */
839 have_partial_symbols (void)
841 for (objfile
*ofp
: current_program_space
->objfiles ())
843 if (ofp
->has_partial_symbols ())
849 /* Many places in gdb want to test just to see if we have any full
850 symbols available. This function returns zero if none are currently
851 available, nonzero otherwise. */
854 have_full_symbols (void)
856 for (objfile
*ofp
: current_program_space
->objfiles ())
858 if (objfile_has_full_symbols (ofp
))
865 /* This operations deletes all objfile entries that represent solibs that
866 weren't explicitly loaded by the user, via e.g., the add-symbol-file
870 objfile_purge_solibs (void)
872 for (objfile
*objf
: current_program_space
->objfiles_safe ())
874 /* We assume that the solib package has been purged already, or will
877 if (!(objf
->flags
& OBJF_USERLOADED
) && (objf
->flags
& OBJF_SHARED
))
883 /* Many places in gdb want to test just to see if we have any minimal
884 symbols available. This function returns zero if none are currently
885 available, nonzero otherwise. */
888 have_minimal_symbols (void)
890 for (objfile
*ofp
: current_program_space
->objfiles ())
892 if (ofp
->per_bfd
->minimal_symbol_count
> 0)
900 /* Qsort comparison function. */
903 sort_cmp (const struct obj_section
*sect1
, const obj_section
*sect2
)
905 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
906 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
908 if (sect1_addr
< sect2_addr
)
910 else if (sect1_addr
> sect2_addr
)
914 /* Sections are at the same address. This could happen if
915 A) we have an objfile and a separate debuginfo.
916 B) we are confused, and have added sections without proper relocation,
917 or something like that. */
919 const struct objfile
*const objfile1
= sect1
->objfile
;
920 const struct objfile
*const objfile2
= sect2
->objfile
;
922 if (objfile1
->separate_debug_objfile
== objfile2
923 || objfile2
->separate_debug_objfile
== objfile1
)
925 /* Case A. The ordering doesn't matter: separate debuginfo files
926 will be filtered out later. */
931 /* Case B. Maintain stable sort order, so bugs in GDB are easier to
932 triage. This section could be slow (since we iterate over all
933 objfiles in each call to sort_cmp), but this shouldn't happen
934 very often (GDB is already in a confused state; one hopes this
935 doesn't happen at all). If you discover that significant time is
936 spent in the loops below, do 'set complaints 100' and examine the
937 resulting complaints. */
938 if (objfile1
== objfile2
)
940 /* Both sections came from the same objfile. We are really
941 confused. Sort on sequence order of sections within the
942 objfile. The order of checks is important here, if we find a
943 match on SECT2 first then either SECT2 is before SECT1, or,
944 SECT2 == SECT1, in both cases we should return false. The
945 second case shouldn't occur during normal use, but std::sort
946 does check that '!(a < a)' when compiled in debug mode. */
948 const struct obj_section
*osect
;
950 ALL_OBJFILE_OSECTIONS (objfile1
, osect
)
953 else if (osect
== sect1
)
956 /* We should have found one of the sections before getting here. */
957 gdb_assert_not_reached ("section not found");
961 /* Sort on sequence number of the objfile in the chain. */
963 for (objfile
*objfile
: current_program_space
->objfiles ())
964 if (objfile
== objfile1
)
966 else if (objfile
== objfile2
)
969 /* We should have found one of the objfiles before getting here. */
970 gdb_assert_not_reached ("objfile not found");
975 gdb_assert_not_reached ("unexpected code path");
979 /* Select "better" obj_section to keep. We prefer the one that came from
980 the real object, rather than the one from separate debuginfo.
981 Most of the time the two sections are exactly identical, but with
982 prelinking the .rel.dyn section in the real object may have different
985 static struct obj_section
*
986 preferred_obj_section (struct obj_section
*a
, struct obj_section
*b
)
988 gdb_assert (obj_section_addr (a
) == obj_section_addr (b
));
989 gdb_assert ((a
->objfile
->separate_debug_objfile
== b
->objfile
)
990 || (b
->objfile
->separate_debug_objfile
== a
->objfile
));
991 gdb_assert ((a
->objfile
->separate_debug_objfile_backlink
== b
->objfile
)
992 || (b
->objfile
->separate_debug_objfile_backlink
== a
->objfile
));
994 if (a
->objfile
->separate_debug_objfile
!= NULL
)
999 /* Return 1 if SECTION should be inserted into the section map.
1000 We want to insert only non-overlay and non-TLS section. */
1003 insert_section_p (const struct bfd
*abfd
,
1004 const struct bfd_section
*section
)
1006 const bfd_vma lma
= bfd_section_lma (section
);
1008 if (overlay_debugging
&& lma
!= 0 && lma
!= bfd_section_vma (section
)
1009 && (bfd_get_file_flags (abfd
) & BFD_IN_MEMORY
) == 0)
1010 /* This is an overlay section. IN_MEMORY check is needed to avoid
1011 discarding sections from the "system supplied DSO" (aka vdso)
1012 on some Linux systems (e.g. Fedora 11). */
1014 if ((bfd_section_flags (section
) & SEC_THREAD_LOCAL
) != 0)
1015 /* This is a TLS section. */
1021 /* Filter out overlapping sections where one section came from the real
1022 objfile, and the other from a separate debuginfo file.
1023 Return the size of table after redundant sections have been eliminated. */
1026 filter_debuginfo_sections (struct obj_section
**map
, int map_size
)
1030 for (i
= 0, j
= 0; i
< map_size
- 1; i
++)
1032 struct obj_section
*const sect1
= map
[i
];
1033 struct obj_section
*const sect2
= map
[i
+ 1];
1034 const struct objfile
*const objfile1
= sect1
->objfile
;
1035 const struct objfile
*const objfile2
= sect2
->objfile
;
1036 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
1037 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
1039 if (sect1_addr
== sect2_addr
1040 && (objfile1
->separate_debug_objfile
== objfile2
1041 || objfile2
->separate_debug_objfile
== objfile1
))
1043 map
[j
++] = preferred_obj_section (sect1
, sect2
);
1052 gdb_assert (i
== map_size
- 1);
1056 /* The map should not have shrunk to less than half the original size. */
1057 gdb_assert (map_size
/ 2 <= j
);
1062 /* Filter out overlapping sections, issuing a warning if any are found.
1063 Overlapping sections could really be overlay sections which we didn't
1064 classify as such in insert_section_p, or we could be dealing with a
1068 filter_overlapping_sections (struct obj_section
**map
, int map_size
)
1072 for (i
= 0, j
= 0; i
< map_size
- 1; )
1077 for (k
= i
+ 1; k
< map_size
; k
++)
1079 struct obj_section
*const sect1
= map
[i
];
1080 struct obj_section
*const sect2
= map
[k
];
1081 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
1082 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
1083 const CORE_ADDR sect1_endaddr
= obj_section_endaddr (sect1
);
1085 gdb_assert (sect1_addr
<= sect2_addr
);
1087 if (sect1_endaddr
<= sect2_addr
)
1091 /* We have an overlap. Report it. */
1093 struct objfile
*const objf1
= sect1
->objfile
;
1094 struct objfile
*const objf2
= sect2
->objfile
;
1096 const struct bfd_section
*const bfds1
= sect1
->the_bfd_section
;
1097 const struct bfd_section
*const bfds2
= sect2
->the_bfd_section
;
1099 const CORE_ADDR sect2_endaddr
= obj_section_endaddr (sect2
);
1101 struct gdbarch
*const gdbarch
= objf1
->arch ();
1103 complaint (_("unexpected overlap between:\n"
1104 " (A) section `%s' from `%s' [%s, %s)\n"
1105 " (B) section `%s' from `%s' [%s, %s).\n"
1106 "Will ignore section B"),
1107 bfd_section_name (bfds1
), objfile_name (objf1
),
1108 paddress (gdbarch
, sect1_addr
),
1109 paddress (gdbarch
, sect1_endaddr
),
1110 bfd_section_name (bfds2
), objfile_name (objf2
),
1111 paddress (gdbarch
, sect2_addr
),
1112 paddress (gdbarch
, sect2_endaddr
));
1120 gdb_assert (i
== map_size
- 1);
1128 /* Update PMAP, PMAP_SIZE with sections from all objfiles, excluding any
1129 TLS, overlay and overlapping sections. */
1132 update_section_map (struct program_space
*pspace
,
1133 struct obj_section
***pmap
, int *pmap_size
)
1135 struct objfile_pspace_info
*pspace_info
;
1136 int alloc_size
, map_size
, i
;
1137 struct obj_section
*s
, **map
;
1139 pspace_info
= get_objfile_pspace_data (pspace
);
1140 gdb_assert (pspace_info
->section_map_dirty
!= 0
1141 || pspace_info
->new_objfiles_available
!= 0);
1147 for (objfile
*objfile
: pspace
->objfiles ())
1148 ALL_OBJFILE_OSECTIONS (objfile
, s
)
1149 if (insert_section_p (objfile
->obfd
, s
->the_bfd_section
))
1152 /* This happens on detach/attach (e.g. in gdb.base/attach.exp). */
1153 if (alloc_size
== 0)
1160 map
= XNEWVEC (struct obj_section
*, alloc_size
);
1163 for (objfile
*objfile
: pspace
->objfiles ())
1164 ALL_OBJFILE_OSECTIONS (objfile
, s
)
1165 if (insert_section_p (objfile
->obfd
, s
->the_bfd_section
))
1168 std::sort (map
, map
+ alloc_size
, sort_cmp
);
1169 map_size
= filter_debuginfo_sections(map
, alloc_size
);
1170 map_size
= filter_overlapping_sections(map
, map_size
);
1172 if (map_size
< alloc_size
)
1173 /* Some sections were eliminated. Trim excess space. */
1174 map
= XRESIZEVEC (struct obj_section
*, map
, map_size
);
1176 gdb_assert (alloc_size
== map_size
);
1179 *pmap_size
= map_size
;
1182 /* Bsearch comparison function. */
1185 bsearch_cmp (const void *key
, const void *elt
)
1187 const CORE_ADDR pc
= *(CORE_ADDR
*) key
;
1188 const struct obj_section
*section
= *(const struct obj_section
**) elt
;
1190 if (pc
< obj_section_addr (section
))
1192 if (pc
< obj_section_endaddr (section
))
1197 /* Returns a section whose range includes PC or NULL if none found. */
1199 struct obj_section
*
1200 find_pc_section (CORE_ADDR pc
)
1202 struct objfile_pspace_info
*pspace_info
;
1203 struct obj_section
*s
, **sp
;
1205 /* Check for mapped overlay section first. */
1206 s
= find_pc_mapped_section (pc
);
1210 pspace_info
= get_objfile_pspace_data (current_program_space
);
1211 if (pspace_info
->section_map_dirty
1212 || (pspace_info
->new_objfiles_available
1213 && !pspace_info
->inhibit_updates
))
1215 update_section_map (current_program_space
,
1216 &pspace_info
->sections
,
1217 &pspace_info
->num_sections
);
1219 /* Don't need updates to section map until objfiles are added,
1220 removed or relocated. */
1221 pspace_info
->new_objfiles_available
= 0;
1222 pspace_info
->section_map_dirty
= 0;
1225 /* The C standard (ISO/IEC 9899:TC2) requires the BASE argument to
1226 bsearch be non-NULL. */
1227 if (pspace_info
->sections
== NULL
)
1229 gdb_assert (pspace_info
->num_sections
== 0);
1233 sp
= (struct obj_section
**) bsearch (&pc
,
1234 pspace_info
->sections
,
1235 pspace_info
->num_sections
,
1236 sizeof (*pspace_info
->sections
),
1244 /* Return non-zero if PC is in a section called NAME. */
1247 pc_in_section (CORE_ADDR pc
, const char *name
)
1249 struct obj_section
*s
;
1252 s
= find_pc_section (pc
);
1255 && s
->the_bfd_section
->name
!= NULL
1256 && strcmp (s
->the_bfd_section
->name
, name
) == 0);
1261 /* Set section_map_dirty so section map will be rebuilt next time it
1262 is used. Called by reread_symbols. */
1265 objfiles_changed (void)
1267 /* Rebuild section map next time we need it. */
1268 get_objfile_pspace_data (current_program_space
)->section_map_dirty
= 1;
1271 /* See comments in objfiles.h. */
1273 scoped_restore_tmpl
<int>
1274 inhibit_section_map_updates (struct program_space
*pspace
)
1276 return scoped_restore_tmpl
<int>
1277 (&get_objfile_pspace_data (pspace
)->inhibit_updates
, 1);
1280 /* See objfiles.h. */
1283 is_addr_in_objfile (CORE_ADDR addr
, const struct objfile
*objfile
)
1285 struct obj_section
*osect
;
1287 if (objfile
== NULL
)
1290 ALL_OBJFILE_OSECTIONS (objfile
, osect
)
1292 if (section_is_overlay (osect
) && !section_is_mapped (osect
))
1295 if (obj_section_addr (osect
) <= addr
1296 && addr
< obj_section_endaddr (osect
))
1302 /* See objfiles.h. */
1305 shared_objfile_contains_address_p (struct program_space
*pspace
,
1308 for (objfile
*objfile
: pspace
->objfiles ())
1310 if ((objfile
->flags
& OBJF_SHARED
) != 0
1311 && is_addr_in_objfile (address
, objfile
))
1318 /* The default implementation for the "iterate_over_objfiles_in_search_order"
1319 gdbarch method. It is equivalent to use the objfiles iterable,
1320 searching the objfiles in the order they are stored internally,
1321 ignoring CURRENT_OBJFILE.
1323 On most platforms, it should be close enough to doing the best
1324 we can without some knowledge specific to the architecture. */
1327 default_iterate_over_objfiles_in_search_order
1328 (struct gdbarch
*gdbarch
,
1329 iterate_over_objfiles_in_search_order_cb_ftype
*cb
,
1330 void *cb_data
, struct objfile
*current_objfile
)
1334 for (objfile
*objfile
: current_program_space
->objfiles ())
1336 stop
= cb (objfile
, cb_data
);
1342 /* See objfiles.h. */
1345 objfile_name (const struct objfile
*objfile
)
1347 if (objfile
->obfd
!= NULL
)
1348 return bfd_get_filename (objfile
->obfd
);
1350 return objfile
->original_name
;
1353 /* See objfiles.h. */
1356 objfile_filename (const struct objfile
*objfile
)
1358 if (objfile
->obfd
!= NULL
)
1359 return bfd_get_filename (objfile
->obfd
);
1364 /* See objfiles.h. */
1367 objfile_debug_name (const struct objfile
*objfile
)
1369 return lbasename (objfile
->original_name
);
1372 /* See objfiles.h. */
1375 objfile_flavour_name (struct objfile
*objfile
)
1377 if (objfile
->obfd
!= NULL
)
1378 return bfd_flavour_name (bfd_get_flavour (objfile
->obfd
));