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 *current_objfile; /* For symbol file being read in */
68 struct objfile *rt_common_objfile; /* For runtime common symbols */
70 struct objfile_pspace_info
72 int objfiles_changed_p;
73 struct obj_section **sections;
77 /* Per-program-space data key. */
78 static const struct program_space_data *objfiles_pspace_data;
81 objfiles_pspace_data_cleanup (struct program_space *pspace, void *arg)
83 struct objfile_pspace_info *info;
85 info = program_space_data (pspace, objfiles_pspace_data);
88 xfree (info->sections);
93 /* Get the current svr4 data. If none is found yet, add it now. This
94 function always returns a valid object. */
96 static struct objfile_pspace_info *
97 get_objfile_pspace_data (struct program_space *pspace)
99 struct objfile_pspace_info *info;
101 info = program_space_data (pspace, objfiles_pspace_data);
104 info = XZALLOC (struct objfile_pspace_info);
105 set_program_space_data (pspace, objfiles_pspace_data, info);
111 /* Records whether any objfiles appeared or disappeared since we last updated
112 address to obj section map. */
114 /* Locate all mappable sections of a BFD file.
115 objfile_p_char is a char * to get it through
116 bfd_map_over_sections; we cast it back to its proper type. */
118 /* Called via bfd_map_over_sections to build up the section table that
119 the objfile references. The objfile contains pointers to the start
120 of the table (objfile->sections) and to the first location after
121 the end of the table (objfile->sections_end). */
124 add_to_objfile_sections (struct bfd *abfd, struct bfd_section *asect,
125 void *objfile_p_char)
127 struct objfile *objfile = (struct objfile *) objfile_p_char;
128 struct obj_section section;
131 aflag = bfd_get_section_flags (abfd, asect);
133 if (!(aflag & SEC_ALLOC))
136 if (0 == bfd_section_size (abfd, asect))
138 section.objfile = objfile;
139 section.the_bfd_section = asect;
140 section.ovly_mapped = 0;
141 obstack_grow (&objfile->objfile_obstack,
142 (char *) §ion, sizeof (section));
143 objfile->sections_end
144 = (struct obj_section *) (((size_t) objfile->sections_end) + 1);
147 /* Builds a section table for OBJFILE.
148 Returns 0 if OK, 1 on error (in which case bfd_error contains the
151 Note that while we are building the table, which goes into the
152 psymbol obstack, we hijack the sections_end pointer to instead hold
153 a count of the number of sections. When bfd_map_over_sections
154 returns, this count is used to compute the pointer to the end of
155 the sections table, which then overwrites the count.
157 Also note that the OFFSET and OVLY_MAPPED in each table entry
158 are initialized to zero.
160 Also note that if anything else writes to the psymbol obstack while
161 we are building the table, we're pretty much hosed. */
164 build_objfile_section_table (struct objfile *objfile)
166 /* objfile->sections can be already set when reading a mapped symbol
167 file. I believe that we do need to rebuild the section table in
168 this case (we rebuild other things derived from the bfd), but we
169 can't free the old one (it's in the objfile_obstack). So we just
170 waste some memory. */
172 objfile->sections_end = 0;
173 bfd_map_over_sections (objfile->obfd,
174 add_to_objfile_sections, (void *) objfile);
175 objfile->sections = obstack_finish (&objfile->objfile_obstack);
176 objfile->sections_end = objfile->sections + (size_t) objfile->sections_end;
180 /* Given a pointer to an initialized bfd (ABFD) and some flag bits
181 allocate a new objfile struct, fill it in as best we can, link it
182 into the list of all known objfiles, and return a pointer to the
185 The FLAGS word contains various bits (OBJF_*) that can be taken as
186 requests for specific operations. Other bits like OBJF_SHARED are
187 simply copied through to the new objfile flags member. */
189 /* NOTE: carlton/2003-02-04: This function is called with args NULL, 0
190 by jv-lang.c, to create an artificial objfile used to hold
191 information about dynamically-loaded Java classes. Unfortunately,
192 that branch of this function doesn't get tested very frequently, so
193 it's prone to breakage. (E.g. at one time the name was set to NULL
194 in that situation, which broke a loop over all names in the dynamic
195 library loader.) If you change this function, please try to leave
196 things in a consistent state even if abfd is NULL. */
199 allocate_objfile (bfd *abfd, int flags)
201 struct objfile *objfile;
203 objfile = (struct objfile *) xzalloc (sizeof (struct objfile));
204 objfile->psymbol_cache = psymbol_bcache_init ();
205 objfile->macro_cache = bcache_xmalloc (NULL, NULL);
206 objfile->filename_cache = bcache_xmalloc (NULL, NULL);
207 /* We could use obstack_specify_allocation here instead, but
208 gdb_obstack.h specifies the alloc/dealloc functions. */
209 obstack_init (&objfile->objfile_obstack);
210 terminate_minimal_symbol_table (objfile);
212 objfile_alloc_data (objfile);
214 /* Update the per-objfile information that comes from the bfd, ensuring
215 that any data that is reference is saved in the per-objfile data
218 objfile->obfd = gdb_bfd_ref (abfd);
221 /* Look up the gdbarch associated with the BFD. */
222 objfile->gdbarch = gdbarch_from_bfd (abfd);
224 objfile->name = xstrdup (bfd_get_filename (abfd));
225 objfile->mtime = bfd_get_mtime (abfd);
227 /* Build section table. */
229 if (build_objfile_section_table (objfile))
231 error (_("Can't find the file sections in `%s': %s"),
232 objfile->name, bfd_errmsg (bfd_get_error ()));
237 objfile->name = xstrdup ("<<anonymous objfile>>");
240 objfile->pspace = current_program_space;
242 /* Initialize the section indexes for this objfile, so that we can
243 later detect if they are used w/o being properly assigned to. */
245 objfile->sect_index_text = -1;
246 objfile->sect_index_data = -1;
247 objfile->sect_index_bss = -1;
248 objfile->sect_index_rodata = -1;
250 /* We don't yet have a C++-specific namespace symtab. */
252 objfile->cp_namespace_symtab = NULL;
254 /* Add this file onto the tail of the linked list of other such files. */
256 objfile->next = NULL;
257 if (object_files == NULL)
258 object_files = objfile;
261 struct objfile *last_one;
263 for (last_one = object_files;
265 last_one = last_one->next);
266 last_one->next = objfile;
269 /* Save passed in flag bits. */
270 objfile->flags |= flags;
272 /* Rebuild section map next time we need it. */
273 get_objfile_pspace_data (objfile->pspace)->objfiles_changed_p = 1;
278 /* Retrieve the gdbarch associated with OBJFILE. */
280 get_objfile_arch (struct objfile *objfile)
282 return objfile->gdbarch;
285 /* Initialize entry point information for this objfile. */
288 init_entry_point_info (struct objfile *objfile)
290 /* Save startup file's range of PC addresses to help blockframe.c
291 decide where the bottom of the stack is. */
293 if (bfd_get_file_flags (objfile->obfd) & EXEC_P)
295 /* Executable file -- record its entry point so we'll recognize
296 the startup file because it contains the entry point. */
297 objfile->ei.entry_point = bfd_get_start_address (objfile->obfd);
298 objfile->ei.entry_point_p = 1;
300 else if (bfd_get_file_flags (objfile->obfd) & DYNAMIC
301 && bfd_get_start_address (objfile->obfd) != 0)
303 /* Some shared libraries may have entry points set and be
304 runnable. There's no clear way to indicate this, so just check
305 for values other than zero. */
306 objfile->ei.entry_point = bfd_get_start_address (objfile->obfd);
307 objfile->ei.entry_point_p = 1;
311 /* Examination of non-executable.o files. Short-circuit this stuff. */
312 objfile->ei.entry_point_p = 0;
316 /* If there is a valid and known entry point, function fills *ENTRY_P with it
317 and returns non-zero; otherwise it returns zero. */
320 entry_point_address_query (CORE_ADDR *entry_p)
322 struct gdbarch *gdbarch;
323 CORE_ADDR entry_point;
325 if (symfile_objfile == NULL || !symfile_objfile->ei.entry_point_p)
328 gdbarch = get_objfile_arch (symfile_objfile);
330 entry_point = symfile_objfile->ei.entry_point;
332 /* Make certain that the address points at real code, and not a
333 function descriptor. */
334 entry_point = gdbarch_convert_from_func_ptr_addr (gdbarch, entry_point,
337 /* Remove any ISA markers, so that this matches entries in the
339 entry_point = gdbarch_addr_bits_remove (gdbarch, entry_point);
341 *entry_p = entry_point;
345 /* Get current entry point address. Call error if it is not known. */
348 entry_point_address (void)
352 if (!entry_point_address_query (&retval))
353 error (_("Entry point address is not known."));
358 /* Create the terminating entry of OBJFILE's minimal symbol table.
359 If OBJFILE->msymbols is zero, allocate a single entry from
360 OBJFILE->objfile_obstack; otherwise, just initialize
361 OBJFILE->msymbols[OBJFILE->minimal_symbol_count]. */
363 terminate_minimal_symbol_table (struct objfile *objfile)
365 if (! objfile->msymbols)
366 objfile->msymbols = ((struct minimal_symbol *)
367 obstack_alloc (&objfile->objfile_obstack,
368 sizeof (objfile->msymbols[0])));
371 struct minimal_symbol *m
372 = &objfile->msymbols[objfile->minimal_symbol_count];
374 memset (m, 0, sizeof (*m));
375 /* Don't rely on these enumeration values being 0's. */
376 MSYMBOL_TYPE (m) = mst_unknown;
377 SYMBOL_SET_LANGUAGE (m, language_unknown);
381 /* Iterator on PARENT and every separate debug objfile of PARENT.
382 The usage pattern is:
383 for (objfile = parent;
385 objfile = objfile_separate_debug_iterate (parent, objfile))
390 objfile_separate_debug_iterate (const struct objfile *parent,
391 const struct objfile *objfile)
395 /* If any, return the first child. */
396 res = objfile->separate_debug_objfile;
400 /* Common case where there is no separate debug objfile. */
401 if (objfile == parent)
404 /* Return the brother if any. Note that we don't iterate on brothers of
406 res = objfile->separate_debug_objfile_link;
410 for (res = objfile->separate_debug_objfile_backlink;
412 res = res->separate_debug_objfile_backlink)
414 gdb_assert (res != NULL);
415 if (res->separate_debug_objfile_link)
416 return res->separate_debug_objfile_link;
421 /* Put one object file before a specified on in the global list.
422 This can be used to make sure an object file is destroyed before
423 another when using ALL_OBJFILES_SAFE to free all objfiles. */
425 put_objfile_before (struct objfile *objfile, struct objfile *before_this)
427 struct objfile **objp;
429 unlink_objfile (objfile);
431 for (objp = &object_files; *objp != NULL; objp = &((*objp)->next))
433 if (*objp == before_this)
435 objfile->next = *objp;
441 internal_error (__FILE__, __LINE__,
442 _("put_objfile_before: before objfile not in list"));
445 /* Put OBJFILE at the front of the list. */
448 objfile_to_front (struct objfile *objfile)
450 struct objfile **objp;
451 for (objp = &object_files; *objp != NULL; objp = &((*objp)->next))
453 if (*objp == objfile)
455 /* Unhook it from where it is. */
456 *objp = objfile->next;
457 /* Put it in the front. */
458 objfile->next = object_files;
459 object_files = objfile;
465 /* Unlink OBJFILE from the list of known objfiles, if it is found in the
468 It is not a bug, or error, to call this function if OBJFILE is not known
469 to be in the current list. This is done in the case of mapped objfiles,
470 for example, just to ensure that the mapped objfile doesn't appear twice
471 in the list. Since the list is threaded, linking in a mapped objfile
472 twice would create a circular list.
474 If OBJFILE turns out to be in the list, we zap it's NEXT pointer after
475 unlinking it, just to ensure that we have completely severed any linkages
476 between the OBJFILE and the list. */
479 unlink_objfile (struct objfile *objfile)
481 struct objfile **objpp;
483 for (objpp = &object_files; *objpp != NULL; objpp = &((*objpp)->next))
485 if (*objpp == objfile)
487 *objpp = (*objpp)->next;
488 objfile->next = NULL;
493 internal_error (__FILE__, __LINE__,
494 _("unlink_objfile: objfile already unlinked"));
497 /* Add OBJFILE as a separate debug objfile of PARENT. */
500 add_separate_debug_objfile (struct objfile *objfile, struct objfile *parent)
502 gdb_assert (objfile && parent);
504 /* Must not be already in a list. */
505 gdb_assert (objfile->separate_debug_objfile_backlink == NULL);
506 gdb_assert (objfile->separate_debug_objfile_link == NULL);
508 objfile->separate_debug_objfile_backlink = parent;
509 objfile->separate_debug_objfile_link = parent->separate_debug_objfile;
510 parent->separate_debug_objfile = objfile;
512 /* Put the separate debug object before the normal one, this is so that
513 usage of the ALL_OBJFILES_SAFE macro will stay safe. */
514 put_objfile_before (objfile, parent);
517 /* Free all separate debug objfile of OBJFILE, but don't free OBJFILE
521 free_objfile_separate_debug (struct objfile *objfile)
523 struct objfile *child;
525 for (child = objfile->separate_debug_objfile; child;)
527 struct objfile *next_child = child->separate_debug_objfile_link;
528 free_objfile (child);
533 /* Destroy an objfile and all the symtabs and psymtabs under it. Note
534 that as much as possible is allocated on the objfile_obstack
535 so that the memory can be efficiently freed.
537 Things which we do NOT free because they are not in malloc'd memory
538 or not in memory specific to the objfile include:
542 FIXME: If the objfile is using reusable symbol information (via mmalloc),
543 then we need to take into account the fact that more than one process
544 may be using the symbol information at the same time (when mmalloc is
545 extended to support cooperative locking). When more than one process
546 is using the mapped symbol info, we need to be more careful about when
547 we free objects in the reusable area. */
550 free_objfile (struct objfile *objfile)
552 /* Free all separate debug objfiles. */
553 free_objfile_separate_debug (objfile);
555 if (objfile->separate_debug_objfile_backlink)
557 /* We freed the separate debug file, make sure the base objfile
558 doesn't reference it. */
559 struct objfile *child;
561 child = objfile->separate_debug_objfile_backlink->separate_debug_objfile;
563 if (child == objfile)
565 /* OBJFILE is the first child. */
566 objfile->separate_debug_objfile_backlink->separate_debug_objfile =
567 objfile->separate_debug_objfile_link;
571 /* Find OBJFILE in the list. */
574 if (child->separate_debug_objfile_link == objfile)
576 child->separate_debug_objfile_link =
577 objfile->separate_debug_objfile_link;
580 child = child->separate_debug_objfile_link;
586 /* Remove any references to this objfile in the global value
588 preserve_values (objfile);
590 /* First do any symbol file specific actions required when we are
591 finished with a particular symbol file. Note that if the objfile
592 is using reusable symbol information (via mmalloc) then each of
593 these routines is responsible for doing the correct thing, either
594 freeing things which are valid only during this particular gdb
595 execution, or leaving them to be reused during the next one. */
597 if (objfile->sf != NULL)
599 (*objfile->sf->sym_finish) (objfile);
602 /* Discard any data modules have associated with the objfile. */
603 objfile_free_data (objfile);
605 gdb_bfd_unref (objfile->obfd);
607 /* Remove it from the chain of all objfiles. */
609 unlink_objfile (objfile);
611 if (objfile == symfile_objfile)
612 symfile_objfile = NULL;
614 if (objfile == rt_common_objfile)
615 rt_common_objfile = NULL;
617 /* Before the symbol table code was redone to make it easier to
618 selectively load and remove information particular to a specific
619 linkage unit, gdb used to do these things whenever the monolithic
620 symbol table was blown away. How much still needs to be done
621 is unknown, but we play it safe for now and keep each action until
622 it is shown to be no longer needed. */
624 /* Not all our callers call clear_symtab_users (objfile_purge_solibs,
625 for example), so we need to call this here. */
626 clear_pc_function_cache ();
628 /* Clear globals which might have pointed into a removed objfile.
629 FIXME: It's not clear which of these are supposed to persist
630 between expressions and which ought to be reset each time. */
631 expression_context_block = NULL;
632 innermost_block = NULL;
634 /* Check to see if the current_source_symtab belongs to this objfile,
635 and if so, call clear_current_source_symtab_and_line. */
638 struct symtab_and_line cursal = get_current_source_symtab_and_line ();
641 ALL_OBJFILE_SYMTABS (objfile, s)
643 if (s == cursal.symtab)
644 clear_current_source_symtab_and_line ();
648 /* The last thing we do is free the objfile struct itself. */
650 xfree (objfile->name);
651 if (objfile->global_psymbols.list)
652 xfree (objfile->global_psymbols.list);
653 if (objfile->static_psymbols.list)
654 xfree (objfile->static_psymbols.list);
655 /* Free the obstacks for non-reusable objfiles. */
656 psymbol_bcache_free (objfile->psymbol_cache);
657 bcache_xfree (objfile->macro_cache);
658 bcache_xfree (objfile->filename_cache);
659 if (objfile->demangled_names_hash)
660 htab_delete (objfile->demangled_names_hash);
661 obstack_free (&objfile->objfile_obstack, 0);
663 /* Rebuild section map next time we need it. */
664 get_objfile_pspace_data (objfile->pspace)->objfiles_changed_p = 1;
670 do_free_objfile_cleanup (void *obj)
676 make_cleanup_free_objfile (struct objfile *obj)
678 return make_cleanup (do_free_objfile_cleanup, obj);
681 /* Free all the object files at once and clean up their users. */
684 free_all_objfiles (void)
686 struct objfile *objfile, *temp;
689 /* Any objfile referencewould become stale. */
690 for (so = master_so_list (); so; so = so->next)
691 gdb_assert (so->objfile == NULL);
693 ALL_OBJFILES_SAFE (objfile, temp)
695 free_objfile (objfile);
697 clear_symtab_users (0);
700 /* A helper function for objfile_relocate1 that relocates a single
704 relocate_one_symbol (struct symbol *sym, struct objfile *objfile,
705 struct section_offsets *delta)
707 fixup_symbol_section (sym, objfile);
709 /* The RS6000 code from which this was taken skipped
710 any symbols in STRUCT_DOMAIN or UNDEF_DOMAIN.
711 But I'm leaving out that test, on the theory that
712 they can't possibly pass the tests below. */
713 if ((SYMBOL_CLASS (sym) == LOC_LABEL
714 || SYMBOL_CLASS (sym) == LOC_STATIC)
715 && SYMBOL_SECTION (sym) >= 0)
717 SYMBOL_VALUE_ADDRESS (sym) += ANOFFSET (delta, SYMBOL_SECTION (sym));
721 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
722 entries in new_offsets. SEPARATE_DEBUG_OBJFILE is not touched here.
723 Return non-zero iff any change happened. */
726 objfile_relocate1 (struct objfile *objfile,
727 struct section_offsets *new_offsets)
729 struct obj_section *s;
730 struct section_offsets *delta =
731 ((struct section_offsets *)
732 alloca (SIZEOF_N_SECTION_OFFSETS (objfile->num_sections)));
735 int something_changed = 0;
737 for (i = 0; i < objfile->num_sections; ++i)
740 ANOFFSET (new_offsets, i) - ANOFFSET (objfile->section_offsets, i);
741 if (ANOFFSET (delta, i) != 0)
742 something_changed = 1;
744 if (!something_changed)
747 /* OK, get all the symtabs. */
751 ALL_OBJFILE_SYMTABS (objfile, s)
754 struct blockvector *bv;
757 /* First the line table. */
761 for (i = 0; i < l->nitems; ++i)
762 l->item[i].pc += ANOFFSET (delta, s->block_line_section);
765 /* Don't relocate a shared blockvector more than once. */
769 bv = BLOCKVECTOR (s);
770 if (BLOCKVECTOR_MAP (bv))
771 addrmap_relocate (BLOCKVECTOR_MAP (bv),
772 ANOFFSET (delta, s->block_line_section));
774 for (i = 0; i < BLOCKVECTOR_NBLOCKS (bv); ++i)
778 struct dict_iterator iter;
780 b = BLOCKVECTOR_BLOCK (bv, i);
781 BLOCK_START (b) += ANOFFSET (delta, s->block_line_section);
782 BLOCK_END (b) += ANOFFSET (delta, s->block_line_section);
784 ALL_BLOCK_SYMBOLS (b, iter, sym)
786 relocate_one_symbol (sym, objfile, delta);
792 /* Relocate isolated symbols. */
796 for (iter = objfile->template_symbols; iter; iter = iter->hash_next)
797 relocate_one_symbol (iter, objfile, delta);
800 if (objfile->psymtabs_addrmap)
801 addrmap_relocate (objfile->psymtabs_addrmap,
802 ANOFFSET (delta, SECT_OFF_TEXT (objfile)));
805 objfile->sf->qf->relocate (objfile, new_offsets, delta);
808 struct minimal_symbol *msym;
810 ALL_OBJFILE_MSYMBOLS (objfile, msym)
811 if (SYMBOL_SECTION (msym) >= 0)
812 SYMBOL_VALUE_ADDRESS (msym) += ANOFFSET (delta, SYMBOL_SECTION (msym));
814 /* Relocating different sections by different amounts may cause the symbols
815 to be out of order. */
816 msymbols_sort (objfile);
818 if (objfile->ei.entry_point_p)
820 /* Relocate ei.entry_point with its section offset, use SECT_OFF_TEXT
821 only as a fallback. */
822 struct obj_section *s;
823 s = find_pc_section (objfile->ei.entry_point);
825 objfile->ei.entry_point += ANOFFSET (delta, s->the_bfd_section->index);
827 objfile->ei.entry_point += ANOFFSET (delta, SECT_OFF_TEXT (objfile));
833 for (i = 0; i < objfile->num_sections; ++i)
834 (objfile->section_offsets)->offsets[i] = ANOFFSET (new_offsets, i);
837 /* Rebuild section map next time we need it. */
838 get_objfile_pspace_data (objfile->pspace)->objfiles_changed_p = 1;
840 /* Update the table in exec_ops, used to read memory. */
841 ALL_OBJFILE_OSECTIONS (objfile, s)
843 int idx = s->the_bfd_section->index;
845 exec_set_section_address (bfd_get_filename (objfile->obfd), idx,
846 obj_section_addr (s));
853 /* Relocate OBJFILE to NEW_OFFSETS. There should be OBJFILE->NUM_SECTIONS
854 entries in new_offsets. Process also OBJFILE's SEPARATE_DEBUG_OBJFILEs.
856 The number and ordering of sections does differ between the two objfiles.
857 Only their names match. Also the file offsets will differ (objfile being
858 possibly prelinked but separate_debug_objfile is probably not prelinked) but
859 the in-memory absolute address as specified by NEW_OFFSETS must match both
863 objfile_relocate (struct objfile *objfile, struct section_offsets *new_offsets)
865 struct objfile *debug_objfile;
868 changed |= objfile_relocate1 (objfile, new_offsets);
870 for (debug_objfile = objfile->separate_debug_objfile;
872 debug_objfile = objfile_separate_debug_iterate (objfile, debug_objfile))
874 struct section_addr_info *objfile_addrs;
875 struct section_offsets *new_debug_offsets;
876 struct cleanup *my_cleanups;
878 objfile_addrs = build_section_addr_info_from_objfile (objfile);
879 my_cleanups = make_cleanup (xfree, objfile_addrs);
881 /* Here OBJFILE_ADDRS contain the correct absolute addresses, the
882 relative ones must be already created according to debug_objfile. */
884 addr_info_make_relative (objfile_addrs, debug_objfile->obfd);
886 gdb_assert (debug_objfile->num_sections
887 == bfd_count_sections (debug_objfile->obfd));
889 xmalloc (SIZEOF_N_SECTION_OFFSETS (debug_objfile->num_sections));
890 make_cleanup (xfree, new_debug_offsets);
891 relative_addr_info_to_section_offsets (new_debug_offsets,
892 debug_objfile->num_sections,
895 changed |= objfile_relocate1 (debug_objfile, new_debug_offsets);
897 do_cleanups (my_cleanups);
900 /* Relocate breakpoints as necessary, after things are relocated. */
902 breakpoint_re_set ();
905 /* Return non-zero if OBJFILE has partial symbols. */
908 objfile_has_partial_symbols (struct objfile *objfile)
913 /* If we have not read psymbols, but we have a function capable of reading
914 them, then that is an indication that they are in fact available. Without
915 this function the symbols may have been already read in but they also may
916 not be present in this objfile. */
917 if ((objfile->flags & OBJF_PSYMTABS_READ) == 0
918 && objfile->sf->sym_read_psymbols != NULL)
921 return objfile->sf->qf->has_symbols (objfile);
924 /* Return non-zero if OBJFILE has full symbols. */
927 objfile_has_full_symbols (struct objfile *objfile)
929 return objfile->symtabs != NULL;
932 /* Return non-zero if OBJFILE has full or partial symbols, either directly
933 or through a separate debug file. */
936 objfile_has_symbols (struct objfile *objfile)
940 for (o = objfile; o; o = objfile_separate_debug_iterate (objfile, o))
941 if (objfile_has_partial_symbols (o) || objfile_has_full_symbols (o))
947 /* Many places in gdb want to test just to see if we have any partial
948 symbols available. This function returns zero if none are currently
949 available, nonzero otherwise. */
952 have_partial_symbols (void)
958 if (objfile_has_partial_symbols (ofp))
964 /* Many places in gdb want to test just to see if we have any full
965 symbols available. This function returns zero if none are currently
966 available, nonzero otherwise. */
969 have_full_symbols (void)
975 if (objfile_has_full_symbols (ofp))
982 /* This operations deletes all objfile entries that represent solibs that
983 weren't explicitly loaded by the user, via e.g., the add-symbol-file
987 objfile_purge_solibs (void)
989 struct objfile *objf;
990 struct objfile *temp;
992 ALL_OBJFILES_SAFE (objf, temp)
994 /* We assume that the solib package has been purged already, or will
997 if (!(objf->flags & OBJF_USERLOADED) && (objf->flags & OBJF_SHARED))
1003 /* Many places in gdb want to test just to see if we have any minimal
1004 symbols available. This function returns zero if none are currently
1005 available, nonzero otherwise. */
1008 have_minimal_symbols (void)
1010 struct objfile *ofp;
1014 if (ofp->minimal_symbol_count > 0)
1022 /* Qsort comparison function. */
1025 qsort_cmp (const void *a, const void *b)
1027 const struct obj_section *sect1 = *(const struct obj_section **) a;
1028 const struct obj_section *sect2 = *(const struct obj_section **) b;
1029 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1030 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1032 if (sect1_addr < sect2_addr)
1034 else if (sect1_addr > sect2_addr)
1038 /* Sections are at the same address. This could happen if
1039 A) we have an objfile and a separate debuginfo.
1040 B) we are confused, and have added sections without proper relocation,
1041 or something like that. */
1043 const struct objfile *const objfile1 = sect1->objfile;
1044 const struct objfile *const objfile2 = sect2->objfile;
1046 if (objfile1->separate_debug_objfile == objfile2
1047 || objfile2->separate_debug_objfile == objfile1)
1049 /* Case A. The ordering doesn't matter: separate debuginfo files
1050 will be filtered out later. */
1055 /* Case B. Maintain stable sort order, so bugs in GDB are easier to
1056 triage. This section could be slow (since we iterate over all
1057 objfiles in each call to qsort_cmp), but this shouldn't happen
1058 very often (GDB is already in a confused state; one hopes this
1059 doesn't happen at all). If you discover that significant time is
1060 spent in the loops below, do 'set complaints 100' and examine the
1061 resulting complaints. */
1063 if (objfile1 == objfile2)
1065 /* Both sections came from the same objfile. We are really confused.
1066 Sort on sequence order of sections within the objfile. */
1068 const struct obj_section *osect;
1070 ALL_OBJFILE_OSECTIONS (objfile1, osect)
1073 else if (osect == sect2)
1076 /* We should have found one of the sections before getting here. */
1077 gdb_assert_not_reached ("section not found");
1081 /* Sort on sequence number of the objfile in the chain. */
1083 const struct objfile *objfile;
1085 ALL_OBJFILES (objfile)
1086 if (objfile == objfile1)
1088 else if (objfile == objfile2)
1091 /* We should have found one of the objfiles before getting here. */
1092 gdb_assert_not_reached ("objfile not found");
1097 gdb_assert_not_reached ("unexpected code path");
1101 /* Select "better" obj_section to keep. We prefer the one that came from
1102 the real object, rather than the one from separate debuginfo.
1103 Most of the time the two sections are exactly identical, but with
1104 prelinking the .rel.dyn section in the real object may have different
1107 static struct obj_section *
1108 preferred_obj_section (struct obj_section *a, struct obj_section *b)
1110 gdb_assert (obj_section_addr (a) == obj_section_addr (b));
1111 gdb_assert ((a->objfile->separate_debug_objfile == b->objfile)
1112 || (b->objfile->separate_debug_objfile == a->objfile));
1113 gdb_assert ((a->objfile->separate_debug_objfile_backlink == b->objfile)
1114 || (b->objfile->separate_debug_objfile_backlink == a->objfile));
1116 if (a->objfile->separate_debug_objfile != NULL)
1121 /* Return 1 if SECTION should be inserted into the section map.
1122 We want to insert only non-overlay and non-TLS section. */
1125 insert_section_p (const struct bfd *abfd,
1126 const struct bfd_section *section)
1128 const bfd_vma lma = bfd_section_lma (abfd, section);
1130 if (lma != 0 && lma != bfd_section_vma (abfd, section)
1131 && (bfd_get_file_flags (abfd) & BFD_IN_MEMORY) == 0)
1132 /* This is an overlay section. IN_MEMORY check is needed to avoid
1133 discarding sections from the "system supplied DSO" (aka vdso)
1134 on some Linux systems (e.g. Fedora 11). */
1136 if ((bfd_get_section_flags (abfd, section) & SEC_THREAD_LOCAL) != 0)
1137 /* This is a TLS section. */
1143 /* Filter out overlapping sections where one section came from the real
1144 objfile, and the other from a separate debuginfo file.
1145 Return the size of table after redundant sections have been eliminated. */
1148 filter_debuginfo_sections (struct obj_section **map, int map_size)
1152 for (i = 0, j = 0; i < map_size - 1; i++)
1154 struct obj_section *const sect1 = map[i];
1155 struct obj_section *const sect2 = map[i + 1];
1156 const struct objfile *const objfile1 = sect1->objfile;
1157 const struct objfile *const objfile2 = sect2->objfile;
1158 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1159 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1161 if (sect1_addr == sect2_addr
1162 && (objfile1->separate_debug_objfile == objfile2
1163 || objfile2->separate_debug_objfile == objfile1))
1165 map[j++] = preferred_obj_section (sect1, sect2);
1174 gdb_assert (i == map_size - 1);
1178 /* The map should not have shrunk to less than half the original size. */
1179 gdb_assert (map_size / 2 <= j);
1184 /* Filter out overlapping sections, issuing a warning if any are found.
1185 Overlapping sections could really be overlay sections which we didn't
1186 classify as such in insert_section_p, or we could be dealing with a
1190 filter_overlapping_sections (struct obj_section **map, int map_size)
1194 for (i = 0, j = 0; i < map_size - 1; )
1199 for (k = i + 1; k < map_size; k++)
1201 struct obj_section *const sect1 = map[i];
1202 struct obj_section *const sect2 = map[k];
1203 const CORE_ADDR sect1_addr = obj_section_addr (sect1);
1204 const CORE_ADDR sect2_addr = obj_section_addr (sect2);
1205 const CORE_ADDR sect1_endaddr = obj_section_endaddr (sect1);
1207 gdb_assert (sect1_addr <= sect2_addr);
1209 if (sect1_endaddr <= sect2_addr)
1213 /* We have an overlap. Report it. */
1215 struct objfile *const objf1 = sect1->objfile;
1216 struct objfile *const objf2 = sect2->objfile;
1218 const struct bfd *const abfd1 = objf1->obfd;
1219 const struct bfd *const abfd2 = objf2->obfd;
1221 const struct bfd_section *const bfds1 = sect1->the_bfd_section;
1222 const struct bfd_section *const bfds2 = sect2->the_bfd_section;
1224 const CORE_ADDR sect2_endaddr = obj_section_endaddr (sect2);
1226 struct gdbarch *const gdbarch = get_objfile_arch (objf1);
1228 complaint (&symfile_complaints,
1229 _("unexpected overlap between:\n"
1230 " (A) section `%s' from `%s' [%s, %s)\n"
1231 " (B) section `%s' from `%s' [%s, %s).\n"
1232 "Will ignore section B"),
1233 bfd_section_name (abfd1, bfds1), objf1->name,
1234 paddress (gdbarch, sect1_addr),
1235 paddress (gdbarch, sect1_endaddr),
1236 bfd_section_name (abfd2, bfds2), objf2->name,
1237 paddress (gdbarch, sect2_addr),
1238 paddress (gdbarch, sect2_endaddr));
1246 gdb_assert (i == map_size - 1);
1254 /* Update PMAP, PMAP_SIZE with sections from all objfiles, excluding any
1255 TLS, overlay and overlapping sections. */
1258 update_section_map (struct program_space *pspace,
1259 struct obj_section ***pmap, int *pmap_size)
1261 int alloc_size, map_size, i;
1262 struct obj_section *s, **map;
1263 struct objfile *objfile;
1265 gdb_assert (get_objfile_pspace_data (pspace)->objfiles_changed_p != 0);
1271 ALL_PSPACE_OBJFILES (pspace, objfile)
1272 ALL_OBJFILE_OSECTIONS (objfile, s)
1273 if (insert_section_p (objfile->obfd, s->the_bfd_section))
1276 /* This happens on detach/attach (e.g. in gdb.base/attach.exp). */
1277 if (alloc_size == 0)
1284 map = xmalloc (alloc_size * sizeof (*map));
1287 ALL_PSPACE_OBJFILES (pspace, objfile)
1288 ALL_OBJFILE_OSECTIONS (objfile, s)
1289 if (insert_section_p (objfile->obfd, s->the_bfd_section))
1292 qsort (map, alloc_size, sizeof (*map), qsort_cmp);
1293 map_size = filter_debuginfo_sections(map, alloc_size);
1294 map_size = filter_overlapping_sections(map, map_size);
1296 if (map_size < alloc_size)
1297 /* Some sections were eliminated. Trim excess space. */
1298 map = xrealloc (map, map_size * sizeof (*map));
1300 gdb_assert (alloc_size == map_size);
1303 *pmap_size = map_size;
1306 /* Bsearch comparison function. */
1309 bsearch_cmp (const void *key, const void *elt)
1311 const CORE_ADDR pc = *(CORE_ADDR *) key;
1312 const struct obj_section *section = *(const struct obj_section **) elt;
1314 if (pc < obj_section_addr (section))
1316 if (pc < obj_section_endaddr (section))
1321 /* Returns a section whose range includes PC or NULL if none found. */
1323 struct obj_section *
1324 find_pc_section (CORE_ADDR pc)
1326 struct objfile_pspace_info *pspace_info;
1327 struct obj_section *s, **sp;
1329 /* Check for mapped overlay section first. */
1330 s = find_pc_mapped_section (pc);
1334 pspace_info = get_objfile_pspace_data (current_program_space);
1335 if (pspace_info->objfiles_changed_p != 0)
1337 update_section_map (current_program_space,
1338 &pspace_info->sections,
1339 &pspace_info->num_sections);
1341 /* Don't need updates to section map until objfiles are added,
1342 removed or relocated. */
1343 pspace_info->objfiles_changed_p = 0;
1346 /* The C standard (ISO/IEC 9899:TC2) requires the BASE argument to
1347 bsearch be non-NULL. */
1348 if (pspace_info->sections == NULL)
1350 gdb_assert (pspace_info->num_sections == 0);
1354 sp = (struct obj_section **) bsearch (&pc,
1355 pspace_info->sections,
1356 pspace_info->num_sections,
1357 sizeof (*pspace_info->sections),
1365 /* In SVR4, we recognize a trampoline by it's section name.
1366 That is, if the pc is in a section named ".plt" then we are in
1370 in_plt_section (CORE_ADDR pc, char *name)
1372 struct obj_section *s;
1375 s = find_pc_section (pc);
1378 && s->the_bfd_section->name != NULL
1379 && strcmp (s->the_bfd_section->name, ".plt") == 0);
1384 /* Keep a registry of per-objfile data-pointers required by other GDB
1390 void (*save) (struct objfile *, void *);
1391 void (*free) (struct objfile *, void *);
1394 struct objfile_data_registration
1396 struct objfile_data *data;
1397 struct objfile_data_registration *next;
1400 struct objfile_data_registry
1402 struct objfile_data_registration *registrations;
1403 unsigned num_registrations;
1406 static struct objfile_data_registry objfile_data_registry = { NULL, 0 };
1408 const struct objfile_data *
1409 register_objfile_data_with_cleanup (void (*save) (struct objfile *, void *),
1410 void (*free) (struct objfile *, void *))
1412 struct objfile_data_registration **curr;
1414 /* Append new registration. */
1415 for (curr = &objfile_data_registry.registrations;
1416 *curr != NULL; curr = &(*curr)->next);
1418 *curr = XMALLOC (struct objfile_data_registration);
1419 (*curr)->next = NULL;
1420 (*curr)->data = XMALLOC (struct objfile_data);
1421 (*curr)->data->index = objfile_data_registry.num_registrations++;
1422 (*curr)->data->save = save;
1423 (*curr)->data->free = free;
1425 return (*curr)->data;
1428 const struct objfile_data *
1429 register_objfile_data (void)
1431 return register_objfile_data_with_cleanup (NULL, NULL);
1435 objfile_alloc_data (struct objfile *objfile)
1437 gdb_assert (objfile->data == NULL);
1438 objfile->num_data = objfile_data_registry.num_registrations;
1439 objfile->data = XCALLOC (objfile->num_data, void *);
1443 objfile_free_data (struct objfile *objfile)
1445 gdb_assert (objfile->data != NULL);
1446 clear_objfile_data (objfile);
1447 xfree (objfile->data);
1448 objfile->data = NULL;
1452 clear_objfile_data (struct objfile *objfile)
1454 struct objfile_data_registration *registration;
1457 gdb_assert (objfile->data != NULL);
1459 /* Process all the save handlers. */
1461 for (registration = objfile_data_registry.registrations, i = 0;
1462 i < objfile->num_data;
1463 registration = registration->next, i++)
1464 if (objfile->data[i] != NULL && registration->data->save != NULL)
1465 registration->data->save (objfile, objfile->data[i]);
1467 /* Now process all the free handlers. */
1469 for (registration = objfile_data_registry.registrations, i = 0;
1470 i < objfile->num_data;
1471 registration = registration->next, i++)
1472 if (objfile->data[i] != NULL && registration->data->free != NULL)
1473 registration->data->free (objfile, objfile->data[i]);
1475 memset (objfile->data, 0, objfile->num_data * sizeof (void *));
1479 set_objfile_data (struct objfile *objfile, const struct objfile_data *data,
1482 gdb_assert (data->index < objfile->num_data);
1483 objfile->data[data->index] = value;
1487 objfile_data (struct objfile *objfile, const struct objfile_data *data)
1489 gdb_assert (data->index < objfile->num_data);
1490 return objfile->data[data->index];
1493 /* Set objfiles_changed_p so section map will be rebuilt next time it
1494 is used. Called by reread_symbols. */
1497 objfiles_changed (void)
1499 /* Rebuild section map next time we need it. */
1500 get_objfile_pspace_data (current_program_space)->objfiles_changed_p = 1;
1503 /* Close ABFD, and warn if that fails. */
1506 gdb_bfd_close_or_warn (struct bfd *abfd)
1509 char *name = bfd_get_filename (abfd);
1511 ret = bfd_close (abfd);
1514 warning (_("cannot close \"%s\": %s"),
1515 name, bfd_errmsg (bfd_get_error ()));
1520 /* Add reference to ABFD. Returns ABFD. */
1522 gdb_bfd_ref (struct bfd *abfd)
1529 p_refcount = bfd_usrdata (abfd);
1531 if (p_refcount != NULL)
1537 p_refcount = xmalloc (sizeof (*p_refcount));
1539 bfd_usrdata (abfd) = p_refcount;
1544 /* Unreference and possibly close ABFD. */
1546 gdb_bfd_unref (struct bfd *abfd)
1554 p_refcount = bfd_usrdata (abfd);
1556 /* Valid range for p_refcount: a pointer to int counter, which has a
1557 value of 1 (single owner) or 2 (shared). */
1558 gdb_assert (*p_refcount == 1 || *p_refcount == 2);
1561 if (*p_refcount > 0)
1565 bfd_usrdata (abfd) = NULL; /* Paranoia. */
1567 name = bfd_get_filename (abfd);
1568 gdb_bfd_close_or_warn (abfd);
1572 /* Provide a prototype to silence -Wmissing-prototypes. */
1573 extern initialize_file_ftype _initialize_objfiles;
1576 _initialize_objfiles (void)
1578 objfiles_pspace_data
1579 = register_program_space_data_with_cleanup (objfiles_pspace_data_cleanup);