binutils/bfd/linker.c

62 	routines are used as examples throughout this section.
194 	add, notably symbol flags, a section, and an offset.  The
196 	<<BSF_INDIRECT>>.  The section is a section in the object
295 @* Relocating the section contents::
300 Information provided by the linker, Relocating the section contents, Performing the Final Link, Performing the Final Link
312 	Each section in the output file will have a list of
316 	contents of the output section in terms of the contents of
324 Relocating the section contents, Writing the symbol table, Information provided by the linker, Performing the Final Link
326 	Relocating the section contents
329 	<<link_order>> structures attached to each section of the
336 	<<bfd_indirect_link_order>> whose associated section belongs
339 	output section in terms of a section belonging to one of the
341 	contents of the section and any associated relocs, apply the
342 	relocs to the section contents, and write out the modified
343 	section contents.  If performing a relocatable link, the
357 	writing section contents is <<aout_link_input_section>>.  The
362 Writing the symbol table, , Relocating the section contents, Performing the Final Link
789    section.  We want the symbols to act as though the values in the
1184       if (! bfd_is_com_section (p->section)
1202       if (! bfd_is_com_section (p->section))
1245 	     undefs list.  We add the section to a common section
1263 	  if (p->section == bfd_com_section_ptr)
1264 	    h->u.c.p->section = bfd_make_section_old_way (symbfd, "COMMON");
1266 	    h->u.c.p->section = bfd_make_section_old_way (symbfd,
1267 							  p->section->name);
1268 	  h->u.c.p->section->flags = SEC_ALLOC;
1324 	       || bfd_is_ind_section (p->section))
1503       return h->u.def.section->owner;
1505       return h->u.c.p->section->owner;
1514    SECTION is the section in which the symbol is defined; this may be
1516    VALUE is the value of the symbol, relative to the section.
1533 				  asection *section,
1544   if (bfd_is_ind_section (section)
1551   else if (bfd_is_und_section (section))
1560   else if (bfd_is_com_section (section))
1585       if (! (*info->callbacks->notice) (info, h->root.string, abfd, section,
1628 		  h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
1643 	    h->u.def.section = section;
1688 				h->root.string, abfd, section, value)))
1721 	  /* The section of a common symbol is only used if the common
1723              hook for the linker script to decide which output section
1725              section of a common symbol will be bfd_com_section_ptr,
1726              the code here will choose a common symbol section named
1731 	  if (section == bfd_com_section_ptr)
1733 	      h->u.c.p->section = bfd_make_section_old_way (abfd, "COMMON");
1734 	      h->u.c.p->section->flags = SEC_ALLOC;
1736 	  else if (section->owner != abfd)
1738 	      h->u.c.p->section = bfd_make_section_old_way (abfd,
1739 							    section->name);
1740 	      h->u.c.p->section->flags = SEC_ALLOC;
1743 	    h->u.c.p->section = section;
1755 	     two sizes, and use the section required by the larger symbol.  */
1759 		  h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
1776 		 hence we want to select the section used by the larger
1778 		 small common section if it is now too large.  */
1779 	      if (section == bfd_com_section_ptr)
1781 		  h->u.c.p->section
1783 		  h->u.c.p->section->flags = SEC_ALLOC;
1785 	      else if (section->owner != abfd)
1787 		  h->u.c.p->section
1788 		    = bfd_make_section_old_way (abfd, section->name);
1789 		  h->u.c.p->section->flags = SEC_ALLOC;
1792 		h->u.c.p->section = section;
1806 	      obfd = h->u.def.section->owner;
1832 		  msec = h->u.def.section;
1847 		  && bfd_is_abs_section (section)
1853 		      abfd, section, value)))
1863 		  h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
1911 						abfd, section, value))
2024 	p->u.indirect.section->linker_mark = TRUE;
2047       /* Allocate space for the output relocs for each section.  */
2065 		  input_section = p->u.indirect.section;
2191 	      newsym->section = sec;
2277 		  sym->section = h->root.u.def.section;
2283 		  sym->section = h->root.u.def.section;
2288 		  if (! bfd_is_com_section (sym->section))
2290 		      BFD_ASSERT (bfd_is_und_section (sym->section));
2291 		      sym->section = bfd_com_section_ptr;
2293 		  /* We do not set the section of the symbol to
2294 		     h->root.u.c.p->section.  That value was saved so
2298 		     it, so we do not want to use that section.  */
2323       else if (bfd_is_ind_section (sym->section))
2332       else if (bfd_is_und_section (sym->section)
2333 	       || bfd_is_com_section (sym->section))
2350 		      || ! (sym->section->flags & SEC_MERGE))
2375       /* If this symbol is in a section which is not being included
2378       if (!bfd_is_abs_section (sym->section)
2380 					    sym->section->output_section))
2395 /* Set the section and value of a generic BFD symbol based on a linker
2409       if (sym->section != NULL)
2416 	  sym->section = bfd_abs_section_ptr;
2421       sym->section = bfd_und_section_ptr;
2425       sym->section = bfd_und_section_ptr;
2430       sym->section = h->u.def.section;
2435       sym->section = h->u.def.section;
2440       if (sym->section == NULL)
2441 	sym->section = bfd_com_section_ptr;
2442       else if (! bfd_is_com_section (sym->section))
2444 	  BFD_ASSERT (bfd_is_und_section (sym->section));
2445 	  sym->section = bfd_com_section_ptr;
2447       /* Do not set the section; see _bfd_generic_link_output_symbols.  */
2534     r->sym_ptr_ptr = link_order->u.reloc.p->u.section->symbol_ptr_ptr;
2585 		   ? bfd_section_name (abfd, link_order->u.reloc.p->u.section)
2611 /* Allocate a new link_order for a section.  */
2614 bfd_new_link_order (bfd *abfd, asection *section)
2625   if (section->map_tail.link_order != NULL)
2626     section->map_tail.link_order->next = new;
2628     section->map_head.link_order = new;
2629   section->map_tail.link_order = new;
2731   input_section = link_order->u.indirect.section;
2772 	 before we can relocate the section.  */
2809   /* Get and relocate the section contents.  */
2822   /* Output the section contents.  */
2901    once into the output.  This routine checks each section, and
2902    arrange to discard it if a section of the same name has already
2905    section name.  bfd_section_already_linked is called via
2995      in the section being discarded.  Those relocations will have to
3003      into a single large link once section, which defeats the purpose
3018       /* We may have 3 different sections on the list: group section,
3019 	 comdat section and linkonce section. SEC may be a linkonce or
3020 	 comdat section. We always ignore group section. For non-COFF
3021 	 inputs, we also ignore comdat section.
3023 	 FIXME: Is that safe to match a linkonce section with a comdat
3024 	 section for COFF inputs?  */
3039 	  /* The section has already been linked.  See if we should
3051 		(_("%B: warning: ignoring duplicate section `%A'\n"),
3065 		  (_("%B: warning: duplicate section `%A' has different size\n"),
3072 	     section.  Since there might be a symbol in the section
3073 	     being discarded, we must retain a pointer to the section
3082   /* This is the first section with this name.  Record it.  */
3086 /* Convert symbols in excluded output sections to use a kept section.  */
3099       asection *s = h->u.def.section;
3109 	  /* Find preceding kept section.  */
3115 	  /* Find following kept section.  Start at prev->next because
3127 	     is to choose a section that will be in the same segment
3156 		 section if that will result in a positive valued sym.  */
3162 	  h->u.def.section = op;