1 /* GDB routines for manipulating objfiles.
3 Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
4 2002, 2003, 2004, 2007, 2008, 2009, 2010, 2011
5 Free Software Foundation, Inc.
7 Contributed by Cygnus Support, using pieces from other GDB modules.
9 This file is part of GDB.
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 /* This file contains support routines for creating, manipulating, and
25 destroying objfile structures. */
28 #include "bfd.h" /* Binary File Description */
32 #include "gdb-stabs.h"
35 #include "mdebugread.h"
36 #include "expression.h"
37 #include "parser-defs.h"
39 #include "gdb_assert.h"
40 #include <sys/types.h>
43 #include "gdb_obstack.h"
44 #include "gdb_string.h"
47 #include "breakpoint.h"
49 #include "dictionary.h"
52 #include "arch-utils.h"
55 #include "complaints.h"
59 /* Prototypes for local functions */
61 static void objfile_alloc_data (struct objfile
*objfile
);
62 static void objfile_free_data (struct objfile
*objfile
);
64 /* Externally visible variables that are owned by this module.
65 See declarations in objfile.h for more info. */
67 struct objfile
*rt_common_objfile
; /* For runtime common symbols */
69 struct objfile_pspace_info
71 int objfiles_changed_p
;
72 struct obj_section
**sections
;
76 /* Per-program-space data key. */
77 static const struct program_space_data
*objfiles_pspace_data
;
80 objfiles_pspace_data_cleanup (struct program_space
*pspace
, void *arg
)
82 struct objfile_pspace_info
*info
;
84 info
= program_space_data (pspace
, objfiles_pspace_data
);
87 xfree (info
->sections
);
92 /* Get the current svr4 data. If none is found yet, add it now. This
93 function always returns a valid object. */
95 static struct objfile_pspace_info
*
96 get_objfile_pspace_data (struct program_space
*pspace
)
98 struct objfile_pspace_info
*info
;
100 info
= program_space_data (pspace
, objfiles_pspace_data
);
103 info
= XZALLOC (struct objfile_pspace_info
);
104 set_program_space_data (pspace
, objfiles_pspace_data
, info
);
110 /* Records whether any objfiles appeared or disappeared since we last updated
111 address to obj section map. */
113 /* Locate all mappable sections of a BFD file.
114 objfile_p_char is a char * to get it through
115 bfd_map_over_sections; we cast it back to its proper type. */
117 /* Called via bfd_map_over_sections to build up the section table that
118 the objfile references. The objfile contains pointers to the start
119 of the table (objfile->sections) and to the first location after
120 the end of the table (objfile->sections_end). */
123 add_to_objfile_sections (struct bfd
*abfd
, struct bfd_section
*asect
,
124 void *objfile_p_char
)
126 struct objfile
*objfile
= (struct objfile
*) objfile_p_char
;
127 struct obj_section section
;
130 aflag
= bfd_get_section_flags (abfd
, asect
);
132 if (!(aflag
& SEC_ALLOC
))
135 if (0 == bfd_section_size (abfd
, asect
))
137 section
.objfile
= objfile
;
138 section
.the_bfd_section
= asect
;
139 section
.ovly_mapped
= 0;
140 obstack_grow (&objfile
->objfile_obstack
,
141 (char *) §ion
, sizeof (section
));
142 objfile
->sections_end
143 = (struct obj_section
*) (((size_t) objfile
->sections_end
) + 1);
146 /* Builds a section table for OBJFILE.
147 Returns 0 if OK, 1 on error (in which case bfd_error contains the
150 Note that while we are building the table, which goes into the
151 psymbol obstack, we hijack the sections_end pointer to instead hold
152 a count of the number of sections. When bfd_map_over_sections
153 returns, this count is used to compute the pointer to the end of
154 the sections table, which then overwrites the count.
156 Also note that the OFFSET and OVLY_MAPPED in each table entry
157 are initialized to zero.
159 Also note that if anything else writes to the psymbol obstack while
160 we are building the table, we're pretty much hosed. */
163 build_objfile_section_table (struct objfile
*objfile
)
165 objfile
->sections_end
= 0;
166 bfd_map_over_sections (objfile
->obfd
,
167 add_to_objfile_sections
, (void *) objfile
);
168 objfile
->sections
= obstack_finish (&objfile
->objfile_obstack
);
169 objfile
->sections_end
= objfile
->sections
+ (size_t) objfile
->sections_end
;
173 /* Given a pointer to an initialized bfd (ABFD) and some flag bits
174 allocate a new objfile struct, fill it in as best we can, link it
175 into the list of all known objfiles, and return a pointer to the
178 The FLAGS word contains various bits (OBJF_*) that can be taken as
179 requests for specific operations. Other bits like OBJF_SHARED are
180 simply copied through to the new objfile flags member. */
182 /* NOTE: carlton/2003-02-04: This function is called with args NULL, 0
183 by jv-lang.c, to create an artificial objfile used to hold
184 information about dynamically-loaded Java classes. Unfortunately,
185 that branch of this function doesn't get tested very frequently, so
186 it's prone to breakage. (E.g. at one time the name was set to NULL
187 in that situation, which broke a loop over all names in the dynamic
188 library loader.) If you change this function, please try to leave
189 things in a consistent state even if abfd is NULL. */
192 allocate_objfile (bfd
*abfd
, int flags
)
194 struct objfile
*objfile
;
196 objfile
= (struct objfile
*) xzalloc (sizeof (struct objfile
));
197 objfile
->psymbol_cache
= psymbol_bcache_init ();
198 objfile
->macro_cache
= bcache_xmalloc (NULL
, NULL
);
199 objfile
->filename_cache
= bcache_xmalloc (NULL
, NULL
);
200 /* We could use obstack_specify_allocation here instead, but
201 gdb_obstack.h specifies the alloc/dealloc functions. */
202 obstack_init (&objfile
->objfile_obstack
);
203 terminate_minimal_symbol_table (objfile
);
205 objfile_alloc_data (objfile
);
207 /* Update the per-objfile information that comes from the bfd, ensuring
208 that any data that is reference is saved in the per-objfile data
211 objfile
->obfd
= gdb_bfd_ref (abfd
);
214 /* Look up the gdbarch associated with the BFD. */
215 objfile
->gdbarch
= gdbarch_from_bfd (abfd
);
217 objfile
->name
= xstrdup (bfd_get_filename (abfd
));
218 objfile
->mtime
= bfd_get_mtime (abfd
);
220 /* Build section table. */
222 if (build_objfile_section_table (objfile
))
224 error (_("Can't find the file sections in `%s': %s"),
225 objfile
->name
, bfd_errmsg (bfd_get_error ()));
230 objfile
->name
= xstrdup ("<<anonymous objfile>>");
233 objfile
->pspace
= current_program_space
;
235 /* Initialize the section indexes for this objfile, so that we can
236 later detect if they are used w/o being properly assigned to. */
238 objfile
->sect_index_text
= -1;
239 objfile
->sect_index_data
= -1;
240 objfile
->sect_index_bss
= -1;
241 objfile
->sect_index_rodata
= -1;
243 /* Add this file onto the tail of the linked list of other such files. */
245 objfile
->next
= NULL
;
246 if (object_files
== NULL
)
247 object_files
= objfile
;
250 struct objfile
*last_one
;
252 for (last_one
= object_files
;
254 last_one
= last_one
->next
);
255 last_one
->next
= objfile
;
258 /* Save passed in flag bits. */
259 objfile
->flags
|= flags
;
261 /* Rebuild section map next time we need it. */
262 get_objfile_pspace_data (objfile
->pspace
)->objfiles_changed_p
= 1;
267 /* Retrieve the gdbarch associated with OBJFILE. */
269 get_objfile_arch (struct objfile
*objfile
)
271 return objfile
->gdbarch
;
274 /* Initialize entry point information for this objfile. */
277 init_entry_point_info (struct objfile
*objfile
)
279 /* Save startup file's range of PC addresses to help blockframe.c
280 decide where the bottom of the stack is. */
282 if (bfd_get_file_flags (objfile
->obfd
) & EXEC_P
)
284 /* Executable file -- record its entry point so we'll recognize
285 the startup file because it contains the entry point. */
286 objfile
->ei
.entry_point
= bfd_get_start_address (objfile
->obfd
);
287 objfile
->ei
.entry_point_p
= 1;
289 else if (bfd_get_file_flags (objfile
->obfd
) & DYNAMIC
290 && bfd_get_start_address (objfile
->obfd
) != 0)
292 /* Some shared libraries may have entry points set and be
293 runnable. There's no clear way to indicate this, so just check
294 for values other than zero. */
295 objfile
->ei
.entry_point
= bfd_get_start_address (objfile
->obfd
);
296 objfile
->ei
.entry_point_p
= 1;
300 /* Examination of non-executable.o files. Short-circuit this stuff. */
301 objfile
->ei
.entry_point_p
= 0;
305 /* If there is a valid and known entry point, function fills *ENTRY_P with it
306 and returns non-zero; otherwise it returns zero. */
309 entry_point_address_query (CORE_ADDR
*entry_p
)
311 struct gdbarch
*gdbarch
;
312 CORE_ADDR entry_point
;
314 if (symfile_objfile
== NULL
|| !symfile_objfile
->ei
.entry_point_p
)
317 gdbarch
= get_objfile_arch (symfile_objfile
);
319 entry_point
= symfile_objfile
->ei
.entry_point
;
321 /* Make certain that the address points at real code, and not a
322 function descriptor. */
323 entry_point
= gdbarch_convert_from_func_ptr_addr (gdbarch
, entry_point
,
326 /* Remove any ISA markers, so that this matches entries in the
328 entry_point
= gdbarch_addr_bits_remove (gdbarch
, entry_point
);
330 *entry_p
= entry_point
;
334 /* Get current entry point address. Call error if it is not known. */
337 entry_point_address (void)
341 if (!entry_point_address_query (&retval
))
342 error (_("Entry point address is not known."));
347 /* Iterator on PARENT and every separate debug objfile of PARENT.
348 The usage pattern is:
349 for (objfile = parent;
351 objfile = objfile_separate_debug_iterate (parent, objfile))
356 objfile_separate_debug_iterate (const struct objfile
*parent
,
357 const struct objfile
*objfile
)
361 /* If any, return the first child. */
362 res
= objfile
->separate_debug_objfile
;
366 /* Common case where there is no separate debug objfile. */
367 if (objfile
== parent
)
370 /* Return the brother if any. Note that we don't iterate on brothers of
372 res
= objfile
->separate_debug_objfile_link
;
376 for (res
= objfile
->separate_debug_objfile_backlink
;
378 res
= res
->separate_debug_objfile_backlink
)
380 gdb_assert (res
!= NULL
);
381 if (res
->separate_debug_objfile_link
)
382 return res
->separate_debug_objfile_link
;
387 /* Put one object file before a specified on in the global list.
388 This can be used to make sure an object file is destroyed before
389 another when using ALL_OBJFILES_SAFE to free all objfiles. */
391 put_objfile_before (struct objfile
*objfile
, struct objfile
*before_this
)
393 struct objfile
**objp
;
395 unlink_objfile (objfile
);
397 for (objp
= &object_files
; *objp
!= NULL
; objp
= &((*objp
)->next
))
399 if (*objp
== before_this
)
401 objfile
->next
= *objp
;
407 internal_error (__FILE__
, __LINE__
,
408 _("put_objfile_before: before objfile not in list"));
411 /* Put OBJFILE at the front of the list. */
414 objfile_to_front (struct objfile
*objfile
)
416 struct objfile
**objp
;
417 for (objp
= &object_files
; *objp
!= NULL
; objp
= &((*objp
)->next
))
419 if (*objp
== objfile
)
421 /* Unhook it from where it is. */
422 *objp
= objfile
->next
;
423 /* Put it in the front. */
424 objfile
->next
= object_files
;
425 object_files
= objfile
;
431 /* Unlink OBJFILE from the list of known objfiles, if it is found in the
434 It is not a bug, or error, to call this function if OBJFILE is not known
435 to be in the current list. This is done in the case of mapped objfiles,
436 for example, just to ensure that the mapped objfile doesn't appear twice
437 in the list. Since the list is threaded, linking in a mapped objfile
438 twice would create a circular list.
440 If OBJFILE turns out to be in the list, we zap it's NEXT pointer after
441 unlinking it, just to ensure that we have completely severed any linkages
442 between the OBJFILE and the list. */
445 unlink_objfile (struct objfile
*objfile
)
447 struct objfile
**objpp
;
449 for (objpp
= &object_files
; *objpp
!= NULL
; objpp
= &((*objpp
)->next
))
451 if (*objpp
== objfile
)
453 *objpp
= (*objpp
)->next
;
454 objfile
->next
= NULL
;
459 internal_error (__FILE__
, __LINE__
,
460 _("unlink_objfile: objfile already unlinked"));
463 /* Add OBJFILE as a separate debug objfile of PARENT. */
466 add_separate_debug_objfile (struct objfile
*objfile
, struct objfile
*parent
)
468 gdb_assert (objfile
&& parent
);
470 /* Must not be already in a list. */
471 gdb_assert (objfile
->separate_debug_objfile_backlink
== NULL
);
472 gdb_assert (objfile
->separate_debug_objfile_link
== NULL
);
474 objfile
->separate_debug_objfile_backlink
= parent
;
475 objfile
->separate_debug_objfile_link
= parent
->separate_debug_objfile
;
476 parent
->separate_debug_objfile
= objfile
;
478 /* Put the separate debug object before the normal one, this is so that
479 usage of the ALL_OBJFILES_SAFE macro will stay safe. */
480 put_objfile_before (objfile
, parent
);
483 /* Free all separate debug objfile of OBJFILE, but don't free OBJFILE
487 free_objfile_separate_debug (struct objfile
*objfile
)
489 struct objfile
*child
;
491 for (child
= objfile
->separate_debug_objfile
; child
;)
493 struct objfile
*next_child
= child
->separate_debug_objfile_link
;
494 free_objfile (child
);
499 /* Destroy an objfile and all the symtabs and psymtabs under it. Note
500 that as much as possible is allocated on the objfile_obstack
501 so that the memory can be efficiently freed.
503 Things which we do NOT free because they are not in malloc'd memory
504 or not in memory specific to the objfile include:
508 FIXME: If the objfile is using reusable symbol information (via mmalloc),
509 then we need to take into account the fact that more than one process
510 may be using the symbol information at the same time (when mmalloc is
511 extended to support cooperative locking). When more than one process
512 is using the mapped symbol info, we need to be more careful about when
513 we free objects in the reusable area. */
516 free_objfile (struct objfile
*objfile
)
518 /* Free all separate debug objfiles. */
519 free_objfile_separate_debug (objfile
);
521 if (objfile
->separate_debug_objfile_backlink
)
523 /* We freed the separate debug file, make sure the base objfile
524 doesn't reference it. */
525 struct objfile
*child
;
527 child
= objfile
->separate_debug_objfile_backlink
->separate_debug_objfile
;
529 if (child
== objfile
)
531 /* OBJFILE is the first child. */
532 objfile
->separate_debug_objfile_backlink
->separate_debug_objfile
=
533 objfile
->separate_debug_objfile_link
;
537 /* Find OBJFILE in the list. */
540 if (child
->separate_debug_objfile_link
== objfile
)
542 child
->separate_debug_objfile_link
=
543 objfile
->separate_debug_objfile_link
;
546 child
= child
->separate_debug_objfile_link
;
552 /* Remove any references to this objfile in the global value
554 preserve_values (objfile
);
556 /* It still may reference data modules have associated with the objfile and
557 the symbol file data. */
558 forget_cached_source_info_for_objfile (objfile
);
560 /* First do any symbol file specific actions required when we are
561 finished with a particular symbol file. Note that if the objfile
562 is using reusable symbol information (via mmalloc) then each of
563 these routines is responsible for doing the correct thing, either
564 freeing things which are valid only during this particular gdb
565 execution, or leaving them to be reused during the next one. */
567 if (objfile
->sf
!= NULL
)
569 (*objfile
->sf
->sym_finish
) (objfile
);
572 /* Discard any data modules have associated with the objfile. The function
573 still may reference objfile->obfd. */
574 objfile_free_data (objfile
);
576 gdb_bfd_unref (objfile
->obfd
);
578 /* Remove it from the chain of all objfiles. */
580 unlink_objfile (objfile
);
582 if (objfile
== symfile_objfile
)
583 symfile_objfile
= NULL
;
585 if (objfile
== rt_common_objfile
)
586 rt_common_objfile
= NULL
;
588 /* Before the symbol table code was redone to make it easier to
589 selectively load and remove information particular to a specific
590 linkage unit, gdb used to do these things whenever the monolithic
591 symbol table was blown away. How much still needs to be done
592 is unknown, but we play it safe for now and keep each action until
593 it is shown to be no longer needed. */
595 /* Not all our callers call clear_symtab_users (objfile_purge_solibs,
596 for example), so we need to call this here. */
597 clear_pc_function_cache ();
599 /* Clear globals which might have pointed into a removed objfile.
600 FIXME: It's not clear which of these are supposed to persist
601 between expressions and which ought to be reset each time. */
602 expression_context_block
= NULL
;
603 innermost_block
= NULL
;
605 /* Check to see if the current_source_symtab belongs to this objfile,
606 and if so, call clear_current_source_symtab_and_line. */
609 struct symtab_and_line cursal
= get_current_source_symtab_and_line ();
611 if (cursal
.symtab
&& cursal
.symtab
->objfile
== objfile
)
612 clear_current_source_symtab_and_line ();
615 /* The last thing we do is free the objfile struct itself. */
617 xfree (objfile
->name
);
618 if (objfile
->global_psymbols
.list
)
619 xfree (objfile
->global_psymbols
.list
);
620 if (objfile
->static_psymbols
.list
)
621 xfree (objfile
->static_psymbols
.list
);
622 /* Free the obstacks for non-reusable objfiles. */
623 psymbol_bcache_free (objfile
->psymbol_cache
);
624 bcache_xfree (objfile
->macro_cache
);
625 bcache_xfree (objfile
->filename_cache
);
626 if (objfile
->demangled_names_hash
)
627 htab_delete (objfile
->demangled_names_hash
);
628 obstack_free (&objfile
->objfile_obstack
, 0);
630 /* Rebuild section map next time we need it. */
631 get_objfile_pspace_data (objfile
->pspace
)->objfiles_changed_p
= 1;
637 do_free_objfile_cleanup (void *obj
)
643 make_cleanup_free_objfile (struct objfile
*obj
)
645 return make_cleanup (do_free_objfile_cleanup
, obj
);
648 /* Free all the object files at once and clean up their users. */
651 free_all_objfiles (void)
653 struct objfile
*objfile
, *temp
;
656 /* Any objfile referencewould become stale. */
657 for (so
= master_so_list (); so
; so
= so
->next
)
658 gdb_assert (so
->objfile
== NULL
);
660 ALL_OBJFILES_SAFE (objfile
, temp
)
662 free_objfile (objfile
);
664 clear_symtab_users (0);
667 /* A helper function for objfile_relocate1 that relocates a single
671 relocate_one_symbol (struct symbol
*sym
, struct objfile
*objfile
,
672 struct section_offsets
*delta
)
674 fixup_symbol_section (sym
, objfile
);
676 /* The RS6000 code from which this was taken skipped
677 any symbols in STRUCT_DOMAIN or UNDEF_DOMAIN.
678 But I'm leaving out that test, on the theory that
679 they can't possibly pass the tests below. */
680 if ((SYMBOL_CLASS (sym
) == LOC_LABEL
681 || SYMBOL_CLASS (sym
) == LOC_STATIC
)
682 && SYMBOL_SECTION (sym
) >= 0)
684 SYMBOL_VALUE_ADDRESS (sym
) += ANOFFSET (delta
, SYMBOL_SECTION (sym
));
688 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
689 entries in new_offsets. SEPARATE_DEBUG_OBJFILE is not touched here.
690 Return non-zero iff any change happened. */
693 objfile_relocate1 (struct objfile
*objfile
,
694 struct section_offsets
*new_offsets
)
696 struct obj_section
*s
;
697 struct section_offsets
*delta
=
698 ((struct section_offsets
*)
699 alloca (SIZEOF_N_SECTION_OFFSETS (objfile
->num_sections
)));
702 int something_changed
= 0;
704 for (i
= 0; i
< objfile
->num_sections
; ++i
)
707 ANOFFSET (new_offsets
, i
) - ANOFFSET (objfile
->section_offsets
, i
);
708 if (ANOFFSET (delta
, i
) != 0)
709 something_changed
= 1;
711 if (!something_changed
)
714 /* OK, get all the symtabs. */
718 ALL_OBJFILE_SYMTABS (objfile
, s
)
721 struct blockvector
*bv
;
724 /* First the line table. */
728 for (i
= 0; i
< l
->nitems
; ++i
)
729 l
->item
[i
].pc
+= ANOFFSET (delta
, s
->block_line_section
);
732 /* Don't relocate a shared blockvector more than once. */
736 bv
= BLOCKVECTOR (s
);
737 if (BLOCKVECTOR_MAP (bv
))
738 addrmap_relocate (BLOCKVECTOR_MAP (bv
),
739 ANOFFSET (delta
, s
->block_line_section
));
741 for (i
= 0; i
< BLOCKVECTOR_NBLOCKS (bv
); ++i
)
745 struct dict_iterator iter
;
747 b
= BLOCKVECTOR_BLOCK (bv
, i
);
748 BLOCK_START (b
) += ANOFFSET (delta
, s
->block_line_section
);
749 BLOCK_END (b
) += ANOFFSET (delta
, s
->block_line_section
);
751 ALL_BLOCK_SYMBOLS (b
, iter
, sym
)
753 relocate_one_symbol (sym
, objfile
, delta
);
759 /* Relocate isolated symbols. */
763 for (iter
= objfile
->template_symbols
; iter
; iter
= iter
->hash_next
)
764 relocate_one_symbol (iter
, objfile
, delta
);
767 if (objfile
->psymtabs_addrmap
)
768 addrmap_relocate (objfile
->psymtabs_addrmap
,
769 ANOFFSET (delta
, SECT_OFF_TEXT (objfile
)));
772 objfile
->sf
->qf
->relocate (objfile
, new_offsets
, delta
);
775 struct minimal_symbol
*msym
;
777 ALL_OBJFILE_MSYMBOLS (objfile
, msym
)
778 if (SYMBOL_SECTION (msym
) >= 0)
779 SYMBOL_VALUE_ADDRESS (msym
) += ANOFFSET (delta
, SYMBOL_SECTION (msym
));
781 /* Relocating different sections by different amounts may cause the symbols
782 to be out of order. */
783 msymbols_sort (objfile
);
785 if (objfile
->ei
.entry_point_p
)
787 /* Relocate ei.entry_point with its section offset, use SECT_OFF_TEXT
788 only as a fallback. */
789 struct obj_section
*s
;
790 s
= find_pc_section (objfile
->ei
.entry_point
);
792 objfile
->ei
.entry_point
+= ANOFFSET (delta
, s
->the_bfd_section
->index
);
794 objfile
->ei
.entry_point
+= ANOFFSET (delta
, SECT_OFF_TEXT (objfile
));
800 for (i
= 0; i
< objfile
->num_sections
; ++i
)
801 (objfile
->section_offsets
)->offsets
[i
] = ANOFFSET (new_offsets
, i
);
804 /* Rebuild section map next time we need it. */
805 get_objfile_pspace_data (objfile
->pspace
)->objfiles_changed_p
= 1;
807 /* Update the table in exec_ops, used to read memory. */
808 ALL_OBJFILE_OSECTIONS (objfile
, s
)
810 int idx
= s
->the_bfd_section
->index
;
812 exec_set_section_address (bfd_get_filename (objfile
->obfd
), idx
,
813 obj_section_addr (s
));
820 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
821 entries in new_offsets. Process also OBJFILE's SEPARATE_DEBUG_OBJFILEs.
823 The number and ordering of sections does differ between the two objfiles.
824 Only their names match. Also the file offsets will differ (objfile being
825 possibly prelinked but separate_debug_objfile is probably not prelinked) but
826 the in-memory absolute address as specified by NEW_OFFSETS must match both
830 objfile_relocate (struct objfile
*objfile
, struct section_offsets
*new_offsets
)
832 struct objfile
*debug_objfile
;
835 changed
|= objfile_relocate1 (objfile
, new_offsets
);
837 for (debug_objfile
= objfile
->separate_debug_objfile
;
839 debug_objfile
= objfile_separate_debug_iterate (objfile
, debug_objfile
))
841 struct section_addr_info
*objfile_addrs
;
842 struct section_offsets
*new_debug_offsets
;
843 struct cleanup
*my_cleanups
;
845 objfile_addrs
= build_section_addr_info_from_objfile (objfile
);
846 my_cleanups
= make_cleanup (xfree
, objfile_addrs
);
848 /* Here OBJFILE_ADDRS contain the correct absolute addresses, the
849 relative ones must be already created according to debug_objfile. */
851 addr_info_make_relative (objfile_addrs
, debug_objfile
->obfd
);
853 gdb_assert (debug_objfile
->num_sections
854 == bfd_count_sections (debug_objfile
->obfd
));
856 xmalloc (SIZEOF_N_SECTION_OFFSETS (debug_objfile
->num_sections
));
857 make_cleanup (xfree
, new_debug_offsets
);
858 relative_addr_info_to_section_offsets (new_debug_offsets
,
859 debug_objfile
->num_sections
,
862 changed
|= objfile_relocate1 (debug_objfile
, new_debug_offsets
);
864 do_cleanups (my_cleanups
);
867 /* Relocate breakpoints as necessary, after things are relocated. */
869 breakpoint_re_set ();
872 /* Return non-zero if OBJFILE has partial symbols. */
875 objfile_has_partial_symbols (struct objfile
*objfile
)
880 /* If we have not read psymbols, but we have a function capable of reading
881 them, then that is an indication that they are in fact available. Without
882 this function the symbols may have been already read in but they also may
883 not be present in this objfile. */
884 if ((objfile
->flags
& OBJF_PSYMTABS_READ
) == 0
885 && objfile
->sf
->sym_read_psymbols
!= NULL
)
888 return objfile
->sf
->qf
->has_symbols (objfile
);
891 /* Return non-zero if OBJFILE has full symbols. */
894 objfile_has_full_symbols (struct objfile
*objfile
)
896 return objfile
->symtabs
!= NULL
;
899 /* Return non-zero if OBJFILE has full or partial symbols, either directly
900 or through a separate debug file. */
903 objfile_has_symbols (struct objfile
*objfile
)
907 for (o
= objfile
; o
; o
= objfile_separate_debug_iterate (objfile
, o
))
908 if (objfile_has_partial_symbols (o
) || objfile_has_full_symbols (o
))
914 /* Many places in gdb want to test just to see if we have any partial
915 symbols available. This function returns zero if none are currently
916 available, nonzero otherwise. */
919 have_partial_symbols (void)
925 if (objfile_has_partial_symbols (ofp
))
931 /* Many places in gdb want to test just to see if we have any full
932 symbols available. This function returns zero if none are currently
933 available, nonzero otherwise. */
936 have_full_symbols (void)
942 if (objfile_has_full_symbols (ofp
))
949 /* This operations deletes all objfile entries that represent solibs that
950 weren't explicitly loaded by the user, via e.g., the add-symbol-file
954 objfile_purge_solibs (void)
956 struct objfile
*objf
;
957 struct objfile
*temp
;
959 ALL_OBJFILES_SAFE (objf
, temp
)
961 /* We assume that the solib package has been purged already, or will
964 if (!(objf
->flags
& OBJF_USERLOADED
) && (objf
->flags
& OBJF_SHARED
))
970 /* Many places in gdb want to test just to see if we have any minimal
971 symbols available. This function returns zero if none are currently
972 available, nonzero otherwise. */
975 have_minimal_symbols (void)
981 if (ofp
->minimal_symbol_count
> 0)
989 /* Qsort comparison function. */
992 qsort_cmp (const void *a
, const void *b
)
994 const struct obj_section
*sect1
= *(const struct obj_section
**) a
;
995 const struct obj_section
*sect2
= *(const struct obj_section
**) b
;
996 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
997 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
999 if (sect1_addr
< sect2_addr
)
1001 else if (sect1_addr
> sect2_addr
)
1005 /* Sections are at the same address. This could happen if
1006 A) we have an objfile and a separate debuginfo.
1007 B) we are confused, and have added sections without proper relocation,
1008 or something like that. */
1010 const struct objfile
*const objfile1
= sect1
->objfile
;
1011 const struct objfile
*const objfile2
= sect2
->objfile
;
1013 if (objfile1
->separate_debug_objfile
== objfile2
1014 || objfile2
->separate_debug_objfile
== objfile1
)
1016 /* Case A. The ordering doesn't matter: separate debuginfo files
1017 will be filtered out later. */
1022 /* Case B. Maintain stable sort order, so bugs in GDB are easier to
1023 triage. This section could be slow (since we iterate over all
1024 objfiles in each call to qsort_cmp), but this shouldn't happen
1025 very often (GDB is already in a confused state; one hopes this
1026 doesn't happen at all). If you discover that significant time is
1027 spent in the loops below, do 'set complaints 100' and examine the
1028 resulting complaints. */
1030 if (objfile1
== objfile2
)
1032 /* Both sections came from the same objfile. We are really confused.
1033 Sort on sequence order of sections within the objfile. */
1035 const struct obj_section
*osect
;
1037 ALL_OBJFILE_OSECTIONS (objfile1
, osect
)
1040 else if (osect
== sect2
)
1043 /* We should have found one of the sections before getting here. */
1044 gdb_assert_not_reached ("section not found");
1048 /* Sort on sequence number of the objfile in the chain. */
1050 const struct objfile
*objfile
;
1052 ALL_OBJFILES (objfile
)
1053 if (objfile
== objfile1
)
1055 else if (objfile
== objfile2
)
1058 /* We should have found one of the objfiles before getting here. */
1059 gdb_assert_not_reached ("objfile not found");
1064 gdb_assert_not_reached ("unexpected code path");
1068 /* Select "better" obj_section to keep. We prefer the one that came from
1069 the real object, rather than the one from separate debuginfo.
1070 Most of the time the two sections are exactly identical, but with
1071 prelinking the .rel.dyn section in the real object may have different
1074 static struct obj_section
*
1075 preferred_obj_section (struct obj_section
*a
, struct obj_section
*b
)
1077 gdb_assert (obj_section_addr (a
) == obj_section_addr (b
));
1078 gdb_assert ((a
->objfile
->separate_debug_objfile
== b
->objfile
)
1079 || (b
->objfile
->separate_debug_objfile
== a
->objfile
));
1080 gdb_assert ((a
->objfile
->separate_debug_objfile_backlink
== b
->objfile
)
1081 || (b
->objfile
->separate_debug_objfile_backlink
== a
->objfile
));
1083 if (a
->objfile
->separate_debug_objfile
!= NULL
)
1088 /* Return 1 if SECTION should be inserted into the section map.
1089 We want to insert only non-overlay and non-TLS section. */
1092 insert_section_p (const struct bfd
*abfd
,
1093 const struct bfd_section
*section
)
1095 const bfd_vma lma
= bfd_section_lma (abfd
, section
);
1097 if (overlay_debugging
&& lma
!= 0 && lma
!= bfd_section_vma (abfd
, section
)
1098 && (bfd_get_file_flags (abfd
) & BFD_IN_MEMORY
) == 0)
1099 /* This is an overlay section. IN_MEMORY check is needed to avoid
1100 discarding sections from the "system supplied DSO" (aka vdso)
1101 on some Linux systems (e.g. Fedora 11). */
1103 if ((bfd_get_section_flags (abfd
, section
) & SEC_THREAD_LOCAL
) != 0)
1104 /* This is a TLS section. */
1110 /* Filter out overlapping sections where one section came from the real
1111 objfile, and the other from a separate debuginfo file.
1112 Return the size of table after redundant sections have been eliminated. */
1115 filter_debuginfo_sections (struct obj_section
**map
, int map_size
)
1119 for (i
= 0, j
= 0; i
< map_size
- 1; i
++)
1121 struct obj_section
*const sect1
= map
[i
];
1122 struct obj_section
*const sect2
= map
[i
+ 1];
1123 const struct objfile
*const objfile1
= sect1
->objfile
;
1124 const struct objfile
*const objfile2
= sect2
->objfile
;
1125 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
1126 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
1128 if (sect1_addr
== sect2_addr
1129 && (objfile1
->separate_debug_objfile
== objfile2
1130 || objfile2
->separate_debug_objfile
== objfile1
))
1132 map
[j
++] = preferred_obj_section (sect1
, sect2
);
1141 gdb_assert (i
== map_size
- 1);
1145 /* The map should not have shrunk to less than half the original size. */
1146 gdb_assert (map_size
/ 2 <= j
);
1151 /* Filter out overlapping sections, issuing a warning if any are found.
1152 Overlapping sections could really be overlay sections which we didn't
1153 classify as such in insert_section_p, or we could be dealing with a
1157 filter_overlapping_sections (struct obj_section
**map
, int map_size
)
1161 for (i
= 0, j
= 0; i
< map_size
- 1; )
1166 for (k
= i
+ 1; k
< map_size
; k
++)
1168 struct obj_section
*const sect1
= map
[i
];
1169 struct obj_section
*const sect2
= map
[k
];
1170 const CORE_ADDR sect1_addr
= obj_section_addr (sect1
);
1171 const CORE_ADDR sect2_addr
= obj_section_addr (sect2
);
1172 const CORE_ADDR sect1_endaddr
= obj_section_endaddr (sect1
);
1174 gdb_assert (sect1_addr
<= sect2_addr
);
1176 if (sect1_endaddr
<= sect2_addr
)
1180 /* We have an overlap. Report it. */
1182 struct objfile
*const objf1
= sect1
->objfile
;
1183 struct objfile
*const objf2
= sect2
->objfile
;
1185 const struct bfd
*const abfd1
= objf1
->obfd
;
1186 const struct bfd
*const abfd2
= objf2
->obfd
;
1188 const struct bfd_section
*const bfds1
= sect1
->the_bfd_section
;
1189 const struct bfd_section
*const bfds2
= sect2
->the_bfd_section
;
1191 const CORE_ADDR sect2_endaddr
= obj_section_endaddr (sect2
);
1193 struct gdbarch
*const gdbarch
= get_objfile_arch (objf1
);
1195 complaint (&symfile_complaints
,
1196 _("unexpected overlap between:\n"
1197 " (A) section `%s' from `%s' [%s, %s)\n"
1198 " (B) section `%s' from `%s' [%s, %s).\n"
1199 "Will ignore section B"),
1200 bfd_section_name (abfd1
, bfds1
), objf1
->name
,
1201 paddress (gdbarch
, sect1_addr
),
1202 paddress (gdbarch
, sect1_endaddr
),
1203 bfd_section_name (abfd2
, bfds2
), objf2
->name
,
1204 paddress (gdbarch
, sect2_addr
),
1205 paddress (gdbarch
, sect2_endaddr
));
1213 gdb_assert (i
== map_size
- 1);
1221 /* Update PMAP, PMAP_SIZE with sections from all objfiles, excluding any
1222 TLS, overlay and overlapping sections. */
1225 update_section_map (struct program_space
*pspace
,
1226 struct obj_section
***pmap
, int *pmap_size
)
1228 int alloc_size
, map_size
, i
;
1229 struct obj_section
*s
, **map
;
1230 struct objfile
*objfile
;
1232 gdb_assert (get_objfile_pspace_data (pspace
)->objfiles_changed_p
!= 0);
1238 ALL_PSPACE_OBJFILES (pspace
, objfile
)
1239 ALL_OBJFILE_OSECTIONS (objfile
, s
)
1240 if (insert_section_p (objfile
->obfd
, s
->the_bfd_section
))
1243 /* This happens on detach/attach (e.g. in gdb.base/attach.exp). */
1244 if (alloc_size
== 0)
1251 map
= xmalloc (alloc_size
* sizeof (*map
));
1254 ALL_PSPACE_OBJFILES (pspace
, objfile
)
1255 ALL_OBJFILE_OSECTIONS (objfile
, s
)
1256 if (insert_section_p (objfile
->obfd
, s
->the_bfd_section
))
1259 qsort (map
, alloc_size
, sizeof (*map
), qsort_cmp
);
1260 map_size
= filter_debuginfo_sections(map
, alloc_size
);
1261 map_size
= filter_overlapping_sections(map
, map_size
);
1263 if (map_size
< alloc_size
)
1264 /* Some sections were eliminated. Trim excess space. */
1265 map
= xrealloc (map
, map_size
* sizeof (*map
));
1267 gdb_assert (alloc_size
== map_size
);
1270 *pmap_size
= map_size
;
1273 /* Bsearch comparison function. */
1276 bsearch_cmp (const void *key
, const void *elt
)
1278 const CORE_ADDR pc
= *(CORE_ADDR
*) key
;
1279 const struct obj_section
*section
= *(const struct obj_section
**) elt
;
1281 if (pc
< obj_section_addr (section
))
1283 if (pc
< obj_section_endaddr (section
))
1288 /* Returns a section whose range includes PC or NULL if none found. */
1290 struct obj_section
*
1291 find_pc_section (CORE_ADDR pc
)
1293 struct objfile_pspace_info
*pspace_info
;
1294 struct obj_section
*s
, **sp
;
1296 /* Check for mapped overlay section first. */
1297 s
= find_pc_mapped_section (pc
);
1301 pspace_info
= get_objfile_pspace_data (current_program_space
);
1302 if (pspace_info
->objfiles_changed_p
!= 0)
1304 update_section_map (current_program_space
,
1305 &pspace_info
->sections
,
1306 &pspace_info
->num_sections
);
1308 /* Don't need updates to section map until objfiles are added,
1309 removed or relocated. */
1310 pspace_info
->objfiles_changed_p
= 0;
1313 /* The C standard (ISO/IEC 9899:TC2) requires the BASE argument to
1314 bsearch be non-NULL. */
1315 if (pspace_info
->sections
== NULL
)
1317 gdb_assert (pspace_info
->num_sections
== 0);
1321 sp
= (struct obj_section
**) bsearch (&pc
,
1322 pspace_info
->sections
,
1323 pspace_info
->num_sections
,
1324 sizeof (*pspace_info
->sections
),
1332 /* In SVR4, we recognize a trampoline by it's section name.
1333 That is, if the pc is in a section named ".plt" then we are in
1337 in_plt_section (CORE_ADDR pc
, char *name
)
1339 struct obj_section
*s
;
1342 s
= find_pc_section (pc
);
1345 && s
->the_bfd_section
->name
!= NULL
1346 && strcmp (s
->the_bfd_section
->name
, ".plt") == 0);
1351 /* Keep a registry of per-objfile data-pointers required by other GDB
1357 void (*save
) (struct objfile
*, void *);
1358 void (*free
) (struct objfile
*, void *);
1361 struct objfile_data_registration
1363 struct objfile_data
*data
;
1364 struct objfile_data_registration
*next
;
1367 struct objfile_data_registry
1369 struct objfile_data_registration
*registrations
;
1370 unsigned num_registrations
;
1373 static struct objfile_data_registry objfile_data_registry
= { NULL
, 0 };
1375 const struct objfile_data
*
1376 register_objfile_data_with_cleanup (void (*save
) (struct objfile
*, void *),
1377 void (*free
) (struct objfile
*, void *))
1379 struct objfile_data_registration
**curr
;
1381 /* Append new registration. */
1382 for (curr
= &objfile_data_registry
.registrations
;
1383 *curr
!= NULL
; curr
= &(*curr
)->next
);
1385 *curr
= XMALLOC (struct objfile_data_registration
);
1386 (*curr
)->next
= NULL
;
1387 (*curr
)->data
= XMALLOC (struct objfile_data
);
1388 (*curr
)->data
->index
= objfile_data_registry
.num_registrations
++;
1389 (*curr
)->data
->save
= save
;
1390 (*curr
)->data
->free
= free
;
1392 return (*curr
)->data
;
1395 const struct objfile_data
*
1396 register_objfile_data (void)
1398 return register_objfile_data_with_cleanup (NULL
, NULL
);
1402 objfile_alloc_data (struct objfile
*objfile
)
1404 gdb_assert (objfile
->data
== NULL
);
1405 objfile
->num_data
= objfile_data_registry
.num_registrations
;
1406 objfile
->data
= XCALLOC (objfile
->num_data
, void *);
1410 objfile_free_data (struct objfile
*objfile
)
1412 gdb_assert (objfile
->data
!= NULL
);
1413 clear_objfile_data (objfile
);
1414 xfree (objfile
->data
);
1415 objfile
->data
= NULL
;
1419 clear_objfile_data (struct objfile
*objfile
)
1421 struct objfile_data_registration
*registration
;
1424 gdb_assert (objfile
->data
!= NULL
);
1426 /* Process all the save handlers. */
1428 for (registration
= objfile_data_registry
.registrations
, i
= 0;
1429 i
< objfile
->num_data
;
1430 registration
= registration
->next
, i
++)
1431 if (objfile
->data
[i
] != NULL
&& registration
->data
->save
!= NULL
)
1432 registration
->data
->save (objfile
, objfile
->data
[i
]);
1434 /* Now process all the free handlers. */
1436 for (registration
= objfile_data_registry
.registrations
, i
= 0;
1437 i
< objfile
->num_data
;
1438 registration
= registration
->next
, i
++)
1439 if (objfile
->data
[i
] != NULL
&& registration
->data
->free
!= NULL
)
1440 registration
->data
->free (objfile
, objfile
->data
[i
]);
1442 memset (objfile
->data
, 0, objfile
->num_data
* sizeof (void *));
1446 set_objfile_data (struct objfile
*objfile
, const struct objfile_data
*data
,
1449 gdb_assert (data
->index
< objfile
->num_data
);
1450 objfile
->data
[data
->index
] = value
;
1454 objfile_data (struct objfile
*objfile
, const struct objfile_data
*data
)
1456 gdb_assert (data
->index
< objfile
->num_data
);
1457 return objfile
->data
[data
->index
];
1460 /* Set objfiles_changed_p so section map will be rebuilt next time it
1461 is used. Called by reread_symbols. */
1464 objfiles_changed (void)
1466 /* Rebuild section map next time we need it. */
1467 get_objfile_pspace_data (current_program_space
)->objfiles_changed_p
= 1;
1470 /* Close ABFD, and warn if that fails. */
1473 gdb_bfd_close_or_warn (struct bfd
*abfd
)
1476 char *name
= bfd_get_filename (abfd
);
1478 ret
= bfd_close (abfd
);
1481 warning (_("cannot close \"%s\": %s"),
1482 name
, bfd_errmsg (bfd_get_error ()));
1487 /* Add reference to ABFD. Returns ABFD. */
1489 gdb_bfd_ref (struct bfd
*abfd
)
1496 p_refcount
= bfd_usrdata (abfd
);
1498 if (p_refcount
!= NULL
)
1504 p_refcount
= xmalloc (sizeof (*p_refcount
));
1506 bfd_usrdata (abfd
) = p_refcount
;
1511 /* Unreference and possibly close ABFD. */
1513 gdb_bfd_unref (struct bfd
*abfd
)
1521 p_refcount
= bfd_usrdata (abfd
);
1523 /* Valid range for p_refcount: a pointer to int counter, which has a
1524 value of 1 (single owner) or 2 (shared). */
1525 gdb_assert (*p_refcount
== 1 || *p_refcount
== 2);
1528 if (*p_refcount
> 0)
1532 bfd_usrdata (abfd
) = NULL
; /* Paranoia. */
1534 name
= bfd_get_filename (abfd
);
1535 gdb_bfd_close_or_warn (abfd
);
1539 /* Provide a prototype to silence -Wmissing-prototypes. */
1540 extern initialize_file_ftype _initialize_objfiles
;
1543 _initialize_objfiles (void)
1545 objfiles_pspace_data
1546 = register_program_space_data_with_cleanup (objfiles_pspace_data_cleanup
);