home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / binutils-2.7-src.tgz / tar.out / fsf / binutils / bfd / linker.c < prev    next >
C/C++ Source or Header  |  1996-09-28  |  87KB  |  2,784 lines
  1. /* linker.c -- BFD linker routines
  2.    Copyright (C) 1993, 1994, 1995 Free Software Foundation, Inc.
  3.    Written by Steve Chamberlain and Ian Lance Taylor, Cygnus Support
  4.  
  5. This file is part of BFD, the Binary File Descriptor library.
  6.  
  7. This program is free software; you can redistribute it and/or modify
  8. it under the terms of the GNU General Public License as published by
  9. the Free Software Foundation; either version 2 of the License, or
  10. (at your option) any later version.
  11.  
  12. This program is distributed in the hope that it will be useful,
  13. but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15. GNU General Public License for more details.
  16.  
  17. You should have received a copy of the GNU General Public License
  18. along with this program; if not, write to the Free Software
  19. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  20.  
  21. #include "bfd.h"
  22. #include "sysdep.h"
  23. #include "libbfd.h"
  24. #include "bfdlink.h"
  25. #include "genlink.h"
  26.  
  27. /*
  28. SECTION
  29.     Linker Functions
  30.  
  31. @cindex Linker
  32.     The linker uses three special entry points in the BFD target
  33.     vector.  It is not necessary to write special routines for
  34.     these entry points when creating a new BFD back end, since
  35.     generic versions are provided.  However, writing them can
  36.     speed up linking and make it use significantly less runtime
  37.     memory.
  38.  
  39.     The first routine creates a hash table used by the other
  40.     routines.  The second routine adds the symbols from an object
  41.     file to the hash table.  The third routine takes all the
  42.     object files and links them together to create the output
  43.     file.  These routines are designed so that the linker proper
  44.     does not need to know anything about the symbols in the object
  45.     files that it is linking.  The linker merely arranges the
  46.     sections as directed by the linker script and lets BFD handle
  47.     the details of symbols and relocs.
  48.  
  49.     The second routine and third routines are passed a pointer to
  50.     a <<struct bfd_link_info>> structure (defined in
  51.     <<bfdlink.h>>) which holds information relevant to the link,
  52.     including the linker hash table (which was created by the
  53.     first routine) and a set of callback functions to the linker
  54.     proper.
  55.  
  56.     The generic linker routines are in <<linker.c>>, and use the
  57.     header file <<genlink.h>>.  As of this writing, the only back
  58.     ends which have implemented versions of these routines are
  59.     a.out (in <<aoutx.h>>) and ECOFF (in <<ecoff.c>>).  The a.out
  60.     routines are used as examples throughout this section.
  61.  
  62. @menu    
  63. @* Creating a Linker Hash Table::
  64. @* Adding Symbols to the Hash Table::
  65. @* Performing the Final Link::
  66. @end menu
  67.  
  68. INODE
  69. Creating a Linker Hash Table, Adding Symbols to the Hash Table, Linker Functions, Linker Functions
  70. SUBSECTION
  71.     Creating a linker hash table
  72.  
  73. @cindex _bfd_link_hash_table_create in target vector
  74. @cindex target vector (_bfd_link_hash_table_create)
  75.     The linker routines must create a hash table, which must be
  76.     derived from <<struct bfd_link_hash_table>> described in
  77.     <<bfdlink.c>>.  @xref{Hash Tables} for information on how to
  78.     create a derived hash table.  This entry point is called using
  79.     the target vector of the linker output file.
  80.  
  81.     The <<_bfd_link_hash_table_create>> entry point must allocate
  82.     and initialize an instance of the desired hash table.  If the
  83.     back end does not require any additional information to be
  84.     stored with the entries in the hash table, the entry point may
  85.     simply create a <<struct bfd_link_hash_table>>.  Most likely,
  86.     however, some additional information will be needed.
  87.  
  88.     For example, with each entry in the hash table the a.out
  89.     linker keeps the index the symbol has in the final output file
  90.     (this index number is used so that when doing a relocateable
  91.     link the symbol index used in the output file can be quickly
  92.     filled in when copying over a reloc).  The a.out linker code
  93.     defines the required structures and functions for a hash table
  94.     derived from <<struct bfd_link_hash_table>>.  The a.out linker
  95.     hash table is created by the function
  96.     <<NAME(aout,link_hash_table_create)>>; it simply allocates
  97.     space for the hash table, initializes it, and returns a
  98.     pointer to it.
  99.  
  100.     When writing the linker routines for a new back end, you will
  101.     generally not know exactly which fields will be required until
  102.     you have finished.  You should simply create a new hash table
  103.     which defines no additional fields, and then simply add fields
  104.     as they become necessary.
  105.  
  106. INODE
  107. Adding Symbols to the Hash Table, Performing the Final Link, Creating a Linker Hash Table, Linker Functions
  108. SUBSECTION
  109.     Adding symbols to the hash table
  110.  
  111. @cindex _bfd_link_add_symbols in target vector
  112. @cindex target vector (_bfd_link_add_symbols)
  113.     The linker proper will call the <<_bfd_link_add_symbols>>
  114.     entry point for each object file or archive which is to be
  115.     linked (typically these are the files named on the command
  116.     line, but some may also come from the linker script).  The
  117.     entry point is responsible for examining the file.  For an
  118.     object file, BFD must add any relevant symbol information to
  119.     the hash table.  For an archive, BFD must determine which
  120.     elements of the archive should be used and adding them to the
  121.     link.
  122.  
  123.     The a.out version of this entry point is
  124.     <<NAME(aout,link_add_symbols)>>.
  125.  
  126. @menu
  127. @* Differing file formats::
  128. @* Adding symbols from an object file::
  129. @* Adding symbols from an archive::
  130. @end menu
  131.  
  132. INODE
  133. Differing file formats, Adding symbols from an object file, Adding Symbols to the Hash Table, Adding Symbols to the Hash Table
  134. SUBSUBSECTION
  135.     Differing file formats
  136.  
  137.     Normally all the files involved in a link will be of the same
  138.     format, but it is also possible to link together different
  139.     format object files, and the back end must support that.  The
  140.     <<_bfd_link_add_symbols>> entry point is called via the target
  141.     vector of the file to be added.  This has an important
  142.     consequence: the function may not assume that the hash table
  143.     is the type created by the corresponding
  144.     <<_bfd_link_hash_table_create>> vector.  All the
  145.     <<_bfd_link_add_symbols>> function can assume about the hash
  146.     table is that it is derived from <<struct
  147.     bfd_link_hash_table>>.
  148.  
  149.     Sometimes the <<_bfd_link_add_symbols>> function must store
  150.     some information in the hash table entry to be used by the
  151.     <<_bfd_final_link>> function.  In such a case the <<creator>>
  152.     field of the hash table must be checked to make sure that the
  153.     hash table was created by an object file of the same format.
  154.  
  155.     The <<_bfd_final_link>> routine must be prepared to handle a
  156.     hash entry without any extra information added by the
  157.     <<_bfd_link_add_symbols>> function.  A hash entry without
  158.     extra information will also occur when the linker script
  159.     directs the linker to create a symbol.  Note that, regardless
  160.     of how a hash table entry is added, all the fields will be
  161.     initialized to some sort of null value by the hash table entry
  162.     initialization function.
  163.  
  164.     See <<ecoff_link_add_externals>> for an example of how to
  165.     check the <<creator>> field before saving information (in this
  166.     case, the ECOFF external symbol debugging information) in a
  167.     hash table entry.
  168.  
  169. INODE
  170. Adding symbols from an object file, Adding symbols from an archive, Differing file formats, Adding Symbols to the Hash Table
  171. SUBSUBSECTION
  172.     Adding symbols from an object file
  173.  
  174.     When the <<_bfd_link_add_symbols>> routine is passed an object
  175.     file, it must add all externally visible symbols in that
  176.     object file to the hash table.  The actual work of adding the
  177.     symbol to the hash table is normally handled by the function
  178.     <<_bfd_generic_link_add_one_symbol>>.  The
  179.     <<_bfd_link_add_symbols>> routine is responsible for reading
  180.     all the symbols from the object file and passing the correct
  181.     information to <<_bfd_generic_link_add_one_symbol>>.
  182.  
  183.     The <<_bfd_link_add_symbols>> routine should not use
  184.     <<bfd_canonicalize_symtab>> to read the symbols.  The point of
  185.     providing this routine is to avoid the overhead of converting
  186.     the symbols into generic <<asymbol>> structures.
  187.  
  188. @findex _bfd_generic_link_add_one_symbol
  189.     <<_bfd_generic_link_add_one_symbol>> handles the details of
  190.     combining common symbols, warning about multiple definitions,
  191.     and so forth.  It takes arguments which describe the symbol to
  192.     add, notably symbol flags, a section, and an offset.  The
  193.     symbol flags include such things as <<BSF_WEAK>> or
  194.     <<BSF_INDIRECT>>.  The section is a section in the object
  195.     file, or something like <<bfd_und_section_ptr>> for an undefined
  196.     symbol or <<bfd_com_section_ptr>> for a common symbol.
  197.  
  198.     If the <<_bfd_final_link>> routine is also going to need to
  199.     read the symbol information, the <<_bfd_link_add_symbols>>
  200.     routine should save it somewhere attached to the object file
  201.     BFD.  However, the information should only be saved if the
  202.     <<keep_memory>> field of the <<info>> argument is true, so
  203.     that the <<-no-keep-memory>> linker switch is effective.
  204.  
  205.     The a.out function which adds symbols from an object file is
  206.     <<aout_link_add_object_symbols>>, and most of the interesting
  207.     work is in <<aout_link_add_symbols>>.  The latter saves
  208.     pointers to the hash tables entries created by
  209.     <<_bfd_generic_link_add_one_symbol>> indexed by symbol number,
  210.     so that the <<_bfd_final_link>> routine does not have to call
  211.     the hash table lookup routine to locate the entry.
  212.  
  213. INODE
  214. Adding symbols from an archive, , Adding symbols from an object file, Adding Symbols to the Hash Table
  215. SUBSUBSECTION
  216.     Adding symbols from an archive
  217.  
  218.     When the <<_bfd_link_add_symbols>> routine is passed an
  219.     archive, it must look through the symbols defined by the
  220.     archive and decide which elements of the archive should be
  221.     included in the link.  For each such element it must call the
  222.     <<add_archive_element>> linker callback, and it must add the
  223.     symbols from the object file to the linker hash table.
  224.  
  225. @findex _bfd_generic_link_add_archive_symbols
  226.     In most cases the work of looking through the symbols in the
  227.     archive should be done by the
  228.     <<_bfd_generic_link_add_archive_symbols>> function.  This
  229.     function builds a hash table from the archive symbol table and
  230.     looks through the list of undefined symbols to see which
  231.     elements should be included.
  232.     <<_bfd_generic_link_add_archive_symbols>> is passed a function
  233.     to call to make the final decision about adding an archive
  234.     element to the link and to do the actual work of adding the
  235.     symbols to the linker hash table.
  236.  
  237.     The function passed to
  238.     <<_bfd_generic_link_add_archive_symbols>> must read the
  239.     symbols of the archive element and decide whether the archive
  240.     element should be included in the link.  If the element is to
  241.     be included, the <<add_archive_element>> linker callback
  242.     routine must be called with the element as an argument, and
  243.     the elements symbols must be added to the linker hash table
  244.     just as though the element had itself been passed to the
  245.     <<_bfd_link_add_symbols>> function.
  246.  
  247.     When the a.out <<_bfd_link_add_symbols>> function receives an
  248.     archive, it calls <<_bfd_generic_link_add_archive_symbols>>
  249.     passing <<aout_link_check_archive_element>> as the function
  250.     argument. <<aout_link_check_archive_element>> calls
  251.     <<aout_link_check_ar_symbols>>.  If the latter decides to add
  252.     the element (an element is only added if it provides a real,
  253.     non-common, definition for a previously undefined or common
  254.     symbol) it calls the <<add_archive_element>> callback and then
  255.     <<aout_link_check_archive_element>> calls
  256.     <<aout_link_add_symbols>> to actually add the symbols to the
  257.     linker hash table.
  258.  
  259.     The ECOFF back end is unusual in that it does not normally
  260.     call <<_bfd_generic_link_add_archive_symbols>>, because ECOFF
  261.     archives already contain a hash table of symbols.  The ECOFF
  262.     back end searches the archive itself to avoid the overhead of
  263.     creating a new hash table.
  264.  
  265. INODE
  266. Performing the Final Link, , Adding Symbols to the Hash Table, Linker Functions
  267. SUBSECTION
  268.     Performing the final link
  269.  
  270. @cindex _bfd_link_final_link in target vector
  271. @cindex target vector (_bfd_final_link)
  272.     When all the input files have been processed, the linker calls
  273.     the <<_bfd_final_link>> entry point of the output BFD.  This
  274.     routine is responsible for producing the final output file,
  275.     which has several aspects.  It must relocate the contents of
  276.     the input sections and copy the data into the output sections.
  277.     It must build an output symbol table including any local
  278.     symbols from the input files and the global symbols from the
  279.     hash table.  When producing relocateable output, it must
  280.     modify the input relocs and write them into the output file.
  281.     There may also be object format dependent work to be done.
  282.  
  283.     The linker will also call the <<write_object_contents>> entry
  284.     point when the BFD is closed.  The two entry points must work
  285.     together in order to produce the correct output file.
  286.  
  287.     The details of how this works are inevitably dependent upon
  288.     the specific object file format.  The a.out
  289.     <<_bfd_final_link>> routine is <<NAME(aout,final_link)>>.
  290.  
  291. @menu
  292. @* Information provided by the linker::
  293. @* Relocating the section contents::
  294. @* Writing the symbol table::
  295. @end menu
  296.  
  297. INODE
  298. Information provided by the linker, Relocating the section contents, Performing the Final Link, Performing the Final Link
  299. SUBSUBSECTION
  300.     Information provided by the linker
  301.  
  302.     Before the linker calls the <<_bfd_final_link>> entry point,
  303.     it sets up some data structures for the function to use.
  304.  
  305.     The <<input_bfds>> field of the <<bfd_link_info>> structure
  306.     will point to a list of all the input files included in the
  307.     link.  These files are linked through the <<link_next>> field
  308.     of the <<bfd>> structure.
  309.  
  310.     Each section in the output file will have a list of
  311.     <<link_order>> structures attached to the <<link_order_head>>
  312.     field (the <<link_order>> structure is defined in
  313.     <<bfdlink.h>>).  These structures describe how to create the
  314.     contents of the output section in terms of the contents of
  315.     various input sections, fill constants, and, eventually, other
  316.     types of information.  They also describe relocs that must be
  317.     created by the BFD backend, but do not correspond to any input
  318.     file; this is used to support -Ur, which builds constructors
  319.     while generating a relocateable object file.
  320.  
  321. INODE
  322. Relocating the section contents, Writing the symbol table, Information provided by the linker, Performing the Final Link
  323. SUBSUBSECTION
  324.     Relocating the section contents
  325.  
  326.     The <<_bfd_final_link>> function should look through the
  327.     <<link_order>> structures attached to each section of the
  328.     output file.  Each <<link_order>> structure should either be
  329.     handled specially, or it should be passed to the function
  330.     <<_bfd_default_link_order>> which will do the right thing
  331.     (<<_bfd_default_link_order>> is defined in <<linker.c>>).
  332.  
  333.     For efficiency, a <<link_order>> of type
  334.     <<bfd_indirect_link_order>> whose associated section belongs
  335.     to a BFD of the same format as the output BFD must be handled
  336.     specially.  This type of <<link_order>> describes part of an
  337.     output section in terms of a section belonging to one of the
  338.     input files.  The <<_bfd_final_link>> function should read the
  339.     contents of the section and any associated relocs, apply the
  340.     relocs to the section contents, and write out the modified
  341.     section contents.  If performing a relocateable link, the
  342.     relocs themselves must also be modified and written out.
  343.  
  344. @findex _bfd_relocate_contents
  345. @findex _bfd_final_link_relocate
  346.     The functions <<_bfd_relocate_contents>> and
  347.     <<_bfd_final_link_relocate>> provide some general support for
  348.     performing the actual relocations, notably overflow checking.
  349.     Their arguments include information about the symbol the
  350.     relocation is against and a <<reloc_howto_type>> argument
  351.     which describes the relocation to perform.  These functions
  352.     are defined in <<reloc.c>>.
  353.  
  354.     The a.out function which handles reading, relocating, and
  355.     writing section contents is <<aout_link_input_section>>.  The
  356.     actual relocation is done in <<aout_link_input_section_std>>
  357.     and <<aout_link_input_section_ext>>.
  358.  
  359. INODE
  360. Writing the symbol table, , Relocating the section contents, Performing the Final Link
  361. SUBSUBSECTION
  362.     Writing the symbol table
  363.  
  364.     The <<_bfd_final_link>> function must gather all the symbols
  365.     in the input files and write them out.  It must also write out
  366.     all the symbols in the global hash table.  This must be
  367.     controlled by the <<strip>> and <<discard>> fields of the
  368.     <<bfd_link_info>> structure.
  369.  
  370.     The local symbols of the input files will not have been
  371.     entered into the linker hash table.  The <<_bfd_final_link>>
  372.     routine must consider each input file and include the symbols
  373.     in the output file.  It may be convenient to do this when
  374.     looking through the <<link_order>> structures, or it may be
  375.     done by stepping through the <<input_bfds>> list.
  376.  
  377.     The <<_bfd_final_link>> routine must also traverse the global
  378.     hash table to gather all the externally visible symbols.  It
  379.     is possible that most of the externally visible symbols may be
  380.     written out when considering the symbols of each input file,
  381.     but it is still necessary to traverse the hash table since the
  382.     linker script may have defined some symbols that are not in
  383.     any of the input files.
  384.  
  385.     The <<strip>> field of the <<bfd_link_info>> structure
  386.     controls which symbols are written out.  The possible values
  387.     are listed in <<bfdlink.h>>.  If the value is <<strip_some>>,
  388.     then the <<keep_hash>> field of the <<bfd_link_info>>
  389.     structure is a hash table of symbols to keep; each symbol
  390.     should be looked up in this hash table, and only symbols which
  391.     are present should be included in the output file.
  392.  
  393.     If the <<strip>> field of the <<bfd_link_info>> structure
  394.     permits local symbols to be written out, the <<discard>> field
  395.     is used to further controls which local symbols are included
  396.     in the output file.  If the value is <<discard_l>>, then all
  397.     local symbols which begin with a certain prefix are discarded;
  398.     this prefix is described by the <<lprefix>> and
  399.     <<lprefix_len>> fields of the <<bfd_link_info>> structure.
  400.  
  401.     The a.out backend handles symbols by calling
  402.     <<aout_link_write_symbols>> on each input BFD and then
  403.     traversing the global hash table with the function
  404.     <<aout_link_write_other_symbol>>.  It builds a string table
  405.     while writing out the symbols, which is written to the output
  406.     file at the end of <<NAME(aout,final_link)>>.
  407. */
  408.  
  409. static boolean generic_link_read_symbols
  410.   PARAMS ((bfd *));
  411. static boolean generic_link_add_symbols
  412.   PARAMS ((bfd *, struct bfd_link_info *, boolean collect));
  413. static boolean generic_link_add_object_symbols
  414.   PARAMS ((bfd *, struct bfd_link_info *, boolean collect));
  415. static boolean generic_link_check_archive_element_no_collect
  416.   PARAMS ((bfd *, struct bfd_link_info *, boolean *pneeded));
  417. static boolean generic_link_check_archive_element_collect
  418.   PARAMS ((bfd *, struct bfd_link_info *, boolean *pneeded));
  419. static boolean generic_link_check_archive_element
  420.   PARAMS ((bfd *, struct bfd_link_info *, boolean *pneeded, boolean collect));
  421. static boolean generic_link_add_symbol_list
  422.   PARAMS ((bfd *, struct bfd_link_info *, bfd_size_type count, asymbol **,
  423.        boolean collect));
  424. static bfd *hash_entry_bfd PARAMS ((struct bfd_link_hash_entry *));
  425. static void set_symbol_from_hash
  426.   PARAMS ((asymbol *, struct bfd_link_hash_entry *));
  427. static boolean generic_add_output_symbol
  428.   PARAMS ((bfd *, size_t *psymalloc, asymbol *));
  429. static boolean default_fill_link_order
  430.   PARAMS ((bfd *, struct bfd_link_info *, asection *,
  431.        struct bfd_link_order *));
  432. /*Amiga hack - used in amigaoslink.c so must be global */
  433. /*static*/ boolean default_indirect_link_order
  434.   PARAMS ((bfd *, struct bfd_link_info *, asection *,
  435.        struct bfd_link_order *, boolean));
  436.  
  437. /* The link hash table structure is defined in bfdlink.h.  It provides
  438.    a base hash table which the backend specific hash tables are built
  439.    upon.  */
  440.  
  441. /* Routine to create an entry in the link hash table.  */
  442.  
  443. struct bfd_hash_entry *
  444. _bfd_link_hash_newfunc (entry, table, string)
  445.      struct bfd_hash_entry *entry;
  446.      struct bfd_hash_table *table;
  447.      const char *string;
  448. {
  449.   struct bfd_link_hash_entry *ret = (struct bfd_link_hash_entry *) entry;
  450.  
  451.   /* Allocate the structure if it has not already been allocated by a
  452.      subclass.  */
  453.   if (ret == (struct bfd_link_hash_entry *) NULL)
  454.     ret = ((struct bfd_link_hash_entry *)
  455.        bfd_hash_allocate (table, sizeof (struct bfd_link_hash_entry)));
  456.   if (ret == (struct bfd_link_hash_entry *) NULL)
  457.     return NULL;
  458.  
  459.   /* Call the allocation method of the superclass.  */
  460.   ret = ((struct bfd_link_hash_entry *)
  461.      bfd_hash_newfunc ((struct bfd_hash_entry *) ret, table, string));
  462.  
  463.   if (ret)
  464.     {
  465.       /* Initialize the local fields.  */
  466.       ret->type = bfd_link_hash_new;
  467.       ret->next = NULL;
  468.     }
  469.  
  470.   return (struct bfd_hash_entry *) ret;
  471. }
  472.  
  473. /* Initialize a link hash table.  The BFD argument is the one
  474.    responsible for creating this table.  */
  475.  
  476. boolean
  477. _bfd_link_hash_table_init (table, abfd, newfunc)
  478.      struct bfd_link_hash_table *table;
  479.      bfd *abfd;
  480.      struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
  481.                         struct bfd_hash_table *,
  482.                         const char *));
  483. {
  484.   table->creator = abfd->xvec;
  485.   table->undefs = NULL;
  486.   table->undefs_tail = NULL;
  487.   return bfd_hash_table_init (&table->table, newfunc);
  488. }
  489.  
  490. /* Look up a symbol in a link hash table.  If follow is true, we
  491.    follow bfd_link_hash_indirect and bfd_link_hash_warning links to
  492.    the real symbol.  */
  493.  
  494. struct bfd_link_hash_entry *
  495. bfd_link_hash_lookup (table, string, create, copy, follow)
  496.      struct bfd_link_hash_table *table;
  497.      const char *string;
  498.      boolean create;
  499.      boolean copy;
  500.      boolean follow;
  501. {
  502.   struct bfd_link_hash_entry *ret;
  503.  
  504.   ret = ((struct bfd_link_hash_entry *)
  505.      bfd_hash_lookup (&table->table, string, create, copy));
  506.  
  507.   if (follow && ret != (struct bfd_link_hash_entry *) NULL)
  508.     {
  509.       while (ret->type == bfd_link_hash_indirect
  510.          || ret->type == bfd_link_hash_warning)
  511.     ret = ret->u.i.link;
  512.     }
  513.  
  514.   return ret;
  515. }
  516.  
  517. /* Look up a symbol in the main linker hash table if the symbol might
  518.    be wrapped.  This should only be used for references to an
  519.    undefined symbol, not for definitions of a symbol.  */
  520.  
  521. struct bfd_link_hash_entry *
  522. bfd_wrapped_link_hash_lookup (abfd, info, string, create, copy, follow)
  523.      bfd *abfd;
  524.      struct bfd_link_info *info;
  525.      const char *string;
  526.      boolean create;
  527.      boolean copy;
  528.      boolean follow;
  529. {
  530.   if (info->wrap_hash != NULL)
  531.     {
  532.       const char *l;
  533.  
  534.       l = string;
  535.       if (*l == bfd_get_symbol_leading_char (abfd))
  536.     ++l;
  537.  
  538. #undef WRAP
  539. #define WRAP "__wrap_"
  540.  
  541.       if (bfd_hash_lookup (info->wrap_hash, l, false, false) != NULL)
  542.     {
  543.       char *n;
  544.       struct bfd_link_hash_entry *h;
  545.  
  546.       /* This symbol is being wrapped.  We want to replace all
  547.              references to SYM with references to __wrap_SYM.  */
  548.  
  549.       n = (char *) bfd_malloc (strlen (l) + sizeof WRAP + 1);
  550.       if (n == NULL)
  551.         return NULL;
  552.  
  553.       /* Note that symbol_leading_char may be '\0'.  */
  554.       n[0] = bfd_get_symbol_leading_char (abfd);
  555.       n[1] = '\0';
  556.       strcat (n, WRAP);
  557.       strcat (n, l);
  558.       h = bfd_link_hash_lookup (info->hash, n, create, true, follow);
  559.       free (n);
  560.       return h;
  561.     }
  562.  
  563. #undef WRAP
  564.  
  565. #undef REAL
  566. #define REAL "__real_"
  567.  
  568.       if (*l == '_'
  569.       && strncmp (l, REAL, sizeof REAL - 1) == 0
  570.       && bfd_hash_lookup (info->wrap_hash, l + sizeof REAL - 1,
  571.                   false, false) != NULL)
  572.     {
  573.       char *n;
  574.       struct bfd_link_hash_entry *h;
  575.  
  576.       /* This is a reference to __real_SYM, where SYM is being
  577.              wrapped.  We want to replace all references to __real_SYM
  578.              with references to SYM.  */
  579.  
  580.       n = (char *) bfd_malloc (strlen (l + sizeof REAL - 1) + 2);
  581.       if (n == NULL)
  582.         return NULL;
  583.  
  584.       /* Note that symbol_leading_char may be '\0'.  */
  585.       n[0] = bfd_get_symbol_leading_char (abfd);
  586.       n[1] = '\0';
  587.       strcat (n, l + sizeof REAL - 1);
  588.       h = bfd_link_hash_lookup (info->hash, n, create, true, follow);
  589.       free (n);
  590.       return h;
  591.     }
  592.  
  593. #undef REAL
  594.     }
  595.  
  596.   return bfd_link_hash_lookup (info->hash, string, create, copy, follow);
  597. }
  598.  
  599. /* Traverse a generic link hash table.  The only reason this is not a
  600.    macro is to do better type checking.  This code presumes that an
  601.    argument passed as a struct bfd_hash_entry * may be caught as a
  602.    struct bfd_link_hash_entry * with no explicit cast required on the
  603.    call.  */
  604.  
  605. void 
  606. bfd_link_hash_traverse (table, func, info)
  607.      struct bfd_link_hash_table *table;
  608.      boolean (*func) PARAMS ((struct bfd_link_hash_entry *, PTR));
  609.      PTR info;
  610. {
  611.   bfd_hash_traverse (&table->table,
  612.              ((boolean (*) PARAMS ((struct bfd_hash_entry *, PTR)))
  613.               func),
  614.              info);
  615. }
  616.  
  617. /* Add a symbol to the linker hash table undefs list.  */
  618.  
  619. INLINE void
  620. bfd_link_add_undef (table, h)
  621.      struct bfd_link_hash_table *table;
  622.      struct bfd_link_hash_entry *h;
  623. {
  624.   BFD_ASSERT (h->next == NULL);
  625.   if (table->undefs_tail != (struct bfd_link_hash_entry *) NULL)
  626.     table->undefs_tail->next = h;
  627.   if (table->undefs == (struct bfd_link_hash_entry *) NULL)
  628.     table->undefs = h;
  629.   table->undefs_tail = h;
  630. }
  631.  
  632. /* Routine to create an entry in an generic link hash table.  */
  633.  
  634. struct bfd_hash_entry *
  635. _bfd_generic_link_hash_newfunc (entry, table, string)
  636.      struct bfd_hash_entry *entry;
  637.      struct bfd_hash_table *table;
  638.      const char *string;
  639. {
  640.   struct generic_link_hash_entry *ret =
  641.     (struct generic_link_hash_entry *) entry;
  642.  
  643.   /* Allocate the structure if it has not already been allocated by a
  644.      subclass.  */
  645.   if (ret == (struct generic_link_hash_entry *) NULL)
  646.     ret = ((struct generic_link_hash_entry *)
  647.        bfd_hash_allocate (table, sizeof (struct generic_link_hash_entry)));
  648.   if (ret == (struct generic_link_hash_entry *) NULL)
  649.     return NULL;
  650.  
  651.   /* Call the allocation method of the superclass.  */
  652.   ret = ((struct generic_link_hash_entry *)
  653.      _bfd_link_hash_newfunc ((struct bfd_hash_entry *) ret,
  654.                  table, string));
  655.  
  656.   if (ret)
  657.     {
  658.       /* Set local fields.  */
  659.       ret->written = false;
  660.       ret->sym = NULL;
  661.     }
  662.  
  663.   return (struct bfd_hash_entry *) ret;
  664. }
  665.  
  666. /* Create an generic link hash table.  */
  667.  
  668. struct bfd_link_hash_table *
  669. _bfd_generic_link_hash_table_create (abfd)
  670.      bfd *abfd;
  671. {
  672.   struct generic_link_hash_table *ret;
  673.  
  674.   ret = ((struct generic_link_hash_table *)
  675.      bfd_alloc (abfd, sizeof (struct generic_link_hash_table)));
  676.   if (ret == NULL)
  677.     return (struct bfd_link_hash_table *) NULL;
  678.   if (! _bfd_link_hash_table_init (&ret->root, abfd,
  679.                    _bfd_generic_link_hash_newfunc))
  680.     {
  681.       free (ret);
  682.       return (struct bfd_link_hash_table *) NULL;
  683.     }
  684.   return &ret->root;
  685. }
  686.  
  687. /* Grab the symbols for an object file when doing a generic link.  We
  688.    store the symbols in the outsymbols field.  We need to keep them
  689.    around for the entire link to ensure that we only read them once.
  690.    If we read them multiple times, we might wind up with relocs and
  691.    the hash table pointing to different instances of the symbol
  692.    structure.  */
  693.  
  694. static boolean
  695. generic_link_read_symbols (abfd)
  696.      bfd *abfd;
  697. {
  698.   if (abfd->outsymbols == (asymbol **) NULL)
  699.     {
  700.       long symsize;
  701.       long symcount;
  702.  
  703.       symsize = bfd_get_symtab_upper_bound (abfd);
  704.       if (symsize < 0)
  705.     return false;
  706.       abfd->outsymbols = (asymbol **) bfd_alloc (abfd, symsize);
  707.       if (abfd->outsymbols == NULL && symsize != 0)
  708.     return false;
  709.       symcount = bfd_canonicalize_symtab (abfd, abfd->outsymbols);
  710.       if (symcount < 0)
  711.     return false;
  712.       abfd->symcount = symcount;
  713.     }
  714.  
  715.   return true;
  716. }
  717.  
  718. /* Generic function to add symbols to from an object file to the
  719.    global hash table.  This version does not automatically collect
  720.    constructors by name.  */
  721.  
  722. boolean
  723. _bfd_generic_link_add_symbols (abfd, info)
  724.      bfd *abfd;
  725.      struct bfd_link_info *info;
  726. {
  727.   return generic_link_add_symbols (abfd, info, false);
  728. }
  729.  
  730. /* Generic function to add symbols from an object file to the global
  731.    hash table.  This version automatically collects constructors by
  732.    name, as the collect2 program does.  It should be used for any
  733.    target which does not provide some other mechanism for setting up
  734.    constructors and destructors; these are approximately those targets
  735.    for which gcc uses collect2 and do not support stabs.  */
  736.  
  737. boolean
  738. _bfd_generic_link_add_symbols_collect (abfd, info)
  739.      bfd *abfd;
  740.      struct bfd_link_info *info;
  741. {
  742.   return generic_link_add_symbols (abfd, info, true);
  743. }
  744.  
  745. /* Add symbols from an object file to the global hash table.  */
  746.  
  747. static boolean
  748. generic_link_add_symbols (abfd, info, collect)
  749.      bfd *abfd;
  750.      struct bfd_link_info *info;
  751.      boolean collect;
  752. {
  753.   boolean ret;
  754.  
  755.   switch (bfd_get_format (abfd))
  756.     {
  757.     case bfd_object:
  758.       ret = generic_link_add_object_symbols (abfd, info, collect);
  759.       break;
  760.     case bfd_archive:
  761.       ret = (_bfd_generic_link_add_archive_symbols
  762.          (abfd, info,
  763.           (collect
  764.            ? generic_link_check_archive_element_collect
  765.            : generic_link_check_archive_element_no_collect)));
  766.       break;
  767.     default:
  768.       bfd_set_error (bfd_error_wrong_format);
  769.       ret = false;
  770.     }
  771.  
  772.   return ret;
  773. }
  774.  
  775. /* Add symbols from an object file to the global hash table.  */
  776.  
  777. static boolean
  778. generic_link_add_object_symbols (abfd, info, collect)
  779.      bfd *abfd;
  780.      struct bfd_link_info *info;
  781.      boolean collect;
  782. {
  783.   if (! generic_link_read_symbols (abfd))
  784.     return false;
  785.   return generic_link_add_symbol_list (abfd, info,
  786.                        _bfd_generic_link_get_symcount (abfd),
  787.                        _bfd_generic_link_get_symbols (abfd),
  788.                        collect);
  789. }
  790.  
  791. /* We build a hash table of all symbols defined in an archive.  */
  792.  
  793. /* An archive symbol may be defined by multiple archive elements.
  794.    This linked list is used to hold the elements.  */
  795.  
  796. struct archive_list
  797. {
  798.   struct archive_list *next;
  799.   int indx;
  800. };
  801.  
  802. /* An entry in an archive hash table.  */
  803.  
  804. struct archive_hash_entry
  805. {
  806.   struct bfd_hash_entry root;
  807.   /* Where the symbol is defined.  */
  808.   struct archive_list *defs;
  809. };
  810.  
  811. /* An archive hash table itself.  */
  812.  
  813. struct archive_hash_table
  814. {
  815.   struct bfd_hash_table table;
  816. };
  817.  
  818. static struct bfd_hash_entry *archive_hash_newfunc
  819.   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
  820. static boolean archive_hash_table_init
  821.   PARAMS ((struct archive_hash_table *,
  822.        struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
  823.                        struct bfd_hash_table *,
  824.                        const char *)));
  825.  
  826. /* Create a new entry for an archive hash table.  */
  827.  
  828. static struct bfd_hash_entry *
  829. archive_hash_newfunc (entry, table, string)
  830.      struct bfd_hash_entry *entry;
  831.      struct bfd_hash_table *table;
  832.      const char *string;
  833. {
  834.   struct archive_hash_entry *ret = (struct archive_hash_entry *) entry;
  835.  
  836.   /* Allocate the structure if it has not already been allocated by a
  837.      subclass.  */
  838.   if (ret == (struct archive_hash_entry *) NULL)
  839.     ret = ((struct archive_hash_entry *)
  840.        bfd_hash_allocate (table, sizeof (struct archive_hash_entry)));
  841.   if (ret == (struct archive_hash_entry *) NULL)
  842.     return NULL;
  843.  
  844.   /* Call the allocation method of the superclass.  */
  845.   ret = ((struct archive_hash_entry *)
  846.      bfd_hash_newfunc ((struct bfd_hash_entry *) ret, table, string));
  847.  
  848.   if (ret)
  849.     {
  850.       /* Initialize the local fields.  */
  851.       ret->defs = (struct archive_list *) NULL;
  852.     }
  853.  
  854.   return (struct bfd_hash_entry *) ret;
  855. }
  856.  
  857. /* Initialize an archive hash table.  */
  858.  
  859. static boolean
  860. archive_hash_table_init (table, newfunc)
  861.      struct archive_hash_table *table;
  862.      struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
  863.                         struct bfd_hash_table *,
  864.                         const char *));
  865. {
  866.   return bfd_hash_table_init (&table->table, newfunc);
  867. }
  868.  
  869. /* Look up an entry in an archive hash table.  */
  870.  
  871. #define archive_hash_lookup(t, string, create, copy) \
  872.   ((struct archive_hash_entry *) \
  873.    bfd_hash_lookup (&(t)->table, (string), (create), (copy)))
  874.  
  875. /* Allocate space in an archive hash table.  */
  876.  
  877. #define archive_hash_allocate(t, size) bfd_hash_allocate (&(t)->table, (size))
  878.  
  879. /* Free an archive hash table.  */
  880.  
  881. #define archive_hash_table_free(t) bfd_hash_table_free (&(t)->table)
  882.  
  883. /* Generic function to add symbols from an archive file to the global
  884.    hash file.  This function presumes that the archive symbol table
  885.    has already been read in (this is normally done by the
  886.    bfd_check_format entry point).  It looks through the undefined and
  887.    common symbols and searches the archive symbol table for them.  If
  888.    it finds an entry, it includes the associated object file in the
  889.    link.
  890.  
  891.    The old linker looked through the archive symbol table for
  892.    undefined symbols.  We do it the other way around, looking through
  893.    undefined symbols for symbols defined in the archive.  The
  894.    advantage of the newer scheme is that we only have to look through
  895.    the list of undefined symbols once, whereas the old method had to
  896.    re-search the symbol table each time a new object file was added.
  897.  
  898.    The CHECKFN argument is used to see if an object file should be
  899.    included.  CHECKFN should set *PNEEDED to true if the object file
  900.    should be included, and must also call the bfd_link_info
  901.    add_archive_element callback function and handle adding the symbols
  902.    to the global hash table.  CHECKFN should only return false if some
  903.    sort of error occurs.
  904.  
  905.    For some formats, such as a.out, it is possible to look through an
  906.    object file but not actually include it in the link.  The
  907.    archive_pass field in a BFD is used to avoid checking the symbols
  908.    of an object files too many times.  When an object is included in
  909.    the link, archive_pass is set to -1.  If an object is scanned but
  910.    not included, archive_pass is set to the pass number.  The pass
  911.    number is incremented each time a new object file is included.  The
  912.    pass number is used because when a new object file is included it
  913.    may create new undefined symbols which cause a previously examined
  914.    object file to be included.  */
  915.  
  916. boolean
  917. _bfd_generic_link_add_archive_symbols (abfd, info, checkfn)
  918.      bfd *abfd;
  919.      struct bfd_link_info *info;
  920.      boolean (*checkfn) PARAMS ((bfd *, struct bfd_link_info *,
  921.                  boolean *pneeded));
  922. {
  923.   carsym *arsyms;
  924.   carsym *arsym_end;
  925.   register carsym *arsym;
  926.   int pass;
  927.   struct archive_hash_table arsym_hash;
  928.   int indx;
  929.   struct bfd_link_hash_entry **pundef;
  930.  
  931.   if (! bfd_has_map (abfd))
  932.     {
  933.       /* An empty archive is a special case.  */
  934.       if (bfd_openr_next_archived_file (abfd, (bfd *) NULL) == NULL)
  935.     return true;
  936.       bfd_set_error (bfd_error_no_armap);
  937.       return false;
  938.     }
  939.  
  940.   arsyms = bfd_ardata (abfd)->symdefs;
  941.   arsym_end = arsyms + bfd_ardata (abfd)->symdef_count;
  942.  
  943.   /* In order to quickly determine whether an symbol is defined in
  944.      this archive, we build a hash table of the symbols.  */
  945.   if (! archive_hash_table_init (&arsym_hash, archive_hash_newfunc))
  946.     return false;
  947.   for (arsym = arsyms, indx = 0; arsym < arsym_end; arsym++, indx++)
  948.     {
  949.       struct archive_hash_entry *arh;
  950.       struct archive_list *l, **pp;
  951.  
  952.       arh = archive_hash_lookup (&arsym_hash, arsym->name, true, false);
  953.       if (arh == (struct archive_hash_entry *) NULL)
  954.     goto error_return;
  955.       l = ((struct archive_list *)
  956.        archive_hash_allocate (&arsym_hash, sizeof (struct archive_list)));
  957.       if (l == NULL)
  958.     goto error_return;
  959.       l->indx = indx;
  960.       for (pp = &arh->defs;
  961.        *pp != (struct archive_list *) NULL;
  962.        pp = &(*pp)->next)
  963.     ;
  964.       *pp = l;
  965.       l->next = NULL;
  966.     }
  967.  
  968.   /* The archive_pass field in the archive itself is used to
  969.      initialize PASS, sine we may search the same archive multiple
  970.      times.  */
  971.   pass = abfd->archive_pass + 1;
  972.  
  973.   /* New undefined symbols are added to the end of the list, so we
  974.      only need to look through it once.  */
  975.   pundef = &info->hash->undefs;
  976.   while (*pundef != (struct bfd_link_hash_entry *) NULL)
  977.     {
  978.       struct bfd_link_hash_entry *h;
  979.       struct archive_hash_entry *arh;
  980.       struct archive_list *l;
  981.  
  982.       h = *pundef;
  983.  
  984.       /* When a symbol is defined, it is not necessarily removed from
  985.      the list.  */
  986.       if (h->type != bfd_link_hash_undefined
  987.       && h->type != bfd_link_hash_common)
  988.     {
  989.       /* Remove this entry from the list, for general cleanliness
  990.          and because we are going to look through the list again
  991.          if we search any more libraries.  We can't remove the
  992.          entry if it is the tail, because that would lose any
  993.          entries we add to the list later on (it would also cause
  994.          us to lose track of whether the symbol has been
  995.          referenced).  */
  996.       if (*pundef != info->hash->undefs_tail)
  997.         *pundef = (*pundef)->next;
  998.       else
  999.         pundef = &(*pundef)->next;
  1000.       continue;
  1001.     }
  1002.  
  1003.       /* Look for this symbol in the archive symbol map.  */
  1004.       arh = archive_hash_lookup (&arsym_hash, h->root.string, false, false);
  1005.       if (arh == (struct archive_hash_entry *) NULL)
  1006.     {
  1007.       pundef = &(*pundef)->next;
  1008.       continue;
  1009.     }
  1010.  
  1011.       /* Look at all the objects which define this symbol.  */
  1012.       for (l = arh->defs; l != (struct archive_list *) NULL; l = l->next)
  1013.     {
  1014.       bfd *element;
  1015.       boolean needed;
  1016.  
  1017.       /* If the symbol has gotten defined along the way, quit.  */
  1018.       if (h->type != bfd_link_hash_undefined
  1019.           && h->type != bfd_link_hash_common)
  1020.         break;
  1021.  
  1022.       element = bfd_get_elt_at_index (abfd, l->indx);
  1023.       if (element == (bfd *) NULL)
  1024.         goto error_return;
  1025.  
  1026.       /* If we've already included this element, or if we've
  1027.          already checked it on this pass, continue.  */
  1028.       if (element->archive_pass == -1
  1029.           || element->archive_pass == pass)
  1030.         continue;
  1031.  
  1032.       /* If we can't figure this element out, just ignore it.  */
  1033.       if (! bfd_check_format (element, bfd_object))
  1034.         {
  1035.           element->archive_pass = -1;
  1036.           continue;
  1037.         }
  1038.  
  1039.       /* CHECKFN will see if this element should be included, and
  1040.          go ahead and include it if appropriate.  */
  1041.       if (! (*checkfn) (element, info, &needed))
  1042.         goto error_return;
  1043.  
  1044.       if (! needed)
  1045.         element->archive_pass = pass;
  1046.       else
  1047.         {
  1048.           element->archive_pass = -1;
  1049.  
  1050.           /* Increment the pass count to show that we may need to
  1051.          recheck object files which were already checked.  */
  1052.           ++pass;
  1053.         }
  1054.     }
  1055.  
  1056.       pundef = &(*pundef)->next;
  1057.     }
  1058.  
  1059.   archive_hash_table_free (&arsym_hash);
  1060.  
  1061.   /* Save PASS in case we are called again.  */
  1062.   abfd->archive_pass = pass;
  1063.  
  1064.   return true;
  1065.  
  1066.  error_return:
  1067.   archive_hash_table_free (&arsym_hash);
  1068.   return false;
  1069. }
  1070.  
  1071. /* See if we should include an archive element.  This version is used
  1072.    when we do not want to automatically collect constructors based on
  1073.    the symbol name, presumably because we have some other mechanism
  1074.    for finding them.  */
  1075.  
  1076. static boolean
  1077. generic_link_check_archive_element_no_collect (abfd, info, pneeded)
  1078.      bfd *abfd;
  1079.      struct bfd_link_info *info;
  1080.      boolean *pneeded;
  1081. {
  1082.   return generic_link_check_archive_element (abfd, info, pneeded, false);
  1083. }
  1084.  
  1085. /* See if we should include an archive element.  This version is used
  1086.    when we want to automatically collect constructors based on the
  1087.    symbol name, as collect2 does.  */
  1088.  
  1089. static boolean
  1090. generic_link_check_archive_element_collect (abfd, info, pneeded)
  1091.      bfd *abfd;
  1092.      struct bfd_link_info *info;
  1093.      boolean *pneeded;
  1094. {
  1095.   return generic_link_check_archive_element (abfd, info, pneeded, true);
  1096. }
  1097.  
  1098. /* See if we should include an archive element.  Optionally collect
  1099.    constructors.  */
  1100.  
  1101. static boolean
  1102. generic_link_check_archive_element (abfd, info, pneeded, collect)
  1103.      bfd *abfd;
  1104.      struct bfd_link_info *info;
  1105.      boolean *pneeded;
  1106.      boolean collect;
  1107. {
  1108.   asymbol **pp, **ppend;
  1109.  
  1110.   *pneeded = false;
  1111.  
  1112.   if (! generic_link_read_symbols (abfd))
  1113.     return false;
  1114.  
  1115.   pp = _bfd_generic_link_get_symbols (abfd);
  1116.   ppend = pp + _bfd_generic_link_get_symcount (abfd);
  1117.   for (; pp < ppend; pp++)
  1118.     {
  1119.       asymbol *p;
  1120.       struct bfd_link_hash_entry *h;
  1121.  
  1122.       p = *pp;
  1123.  
  1124.       /* We are only interested in globally visible symbols.  */
  1125.       if (! bfd_is_com_section (p->section)
  1126.       && (p->flags & (BSF_GLOBAL | BSF_INDIRECT | BSF_WEAK)) == 0)
  1127.     continue;
  1128.  
  1129.       /* We are only interested if we know something about this
  1130.      symbol, and it is undefined or common.  An undefined weak
  1131.      symbol (type bfd_link_hash_undefweak) is not considered to be
  1132.      a reference when pulling files out of an archive.  See the
  1133.      SVR4 ABI, p. 4-27.  */
  1134.       h = bfd_link_hash_lookup (info->hash, bfd_asymbol_name (p), false,
  1135.                 false, true);
  1136.       if (h == (struct bfd_link_hash_entry *) NULL
  1137.       || (h->type != bfd_link_hash_undefined
  1138.           && h->type != bfd_link_hash_common))
  1139.     continue;
  1140.  
  1141.       /* P is a symbol we are looking for.  */
  1142.  
  1143.       if (! bfd_is_com_section (p->section))
  1144.     {
  1145.       bfd_size_type symcount;
  1146.       asymbol **symbols;
  1147.  
  1148.       /* This object file defines this symbol, so pull it in.  */
  1149.       if (! (*info->callbacks->add_archive_element) (info, abfd,
  1150.                              bfd_asymbol_name (p)))
  1151.         return false;
  1152.       symcount = _bfd_generic_link_get_symcount (abfd);
  1153.       symbols = _bfd_generic_link_get_symbols (abfd);
  1154.       if (! generic_link_add_symbol_list (abfd, info, symcount,
  1155.                           symbols, collect))
  1156.         return false;
  1157.       *pneeded = true;
  1158.       return true;
  1159.     }
  1160.  
  1161.       /* P is a common symbol.  */
  1162.  
  1163.       if (h->type == bfd_link_hash_undefined)
  1164.     {
  1165.       bfd *symbfd;
  1166.       bfd_vma size;
  1167.       unsigned int power;
  1168.  
  1169.       symbfd = h->u.undef.abfd;
  1170.       if (symbfd == (bfd *) NULL)
  1171.         {
  1172.           /* This symbol was created as undefined from outside
  1173.          BFD.  We assume that we should link in the object
  1174.          file.  This is for the -u option in the linker.  */
  1175.           if (! (*info->callbacks->add_archive_element)
  1176.           (info, abfd, bfd_asymbol_name (p)))
  1177.         return false;
  1178.           *pneeded = true;
  1179.           return true;
  1180.         }
  1181.  
  1182.       /* Turn the symbol into a common symbol but do not link in
  1183.          the object file.  This is how a.out works.  Object
  1184.          formats that require different semantics must implement
  1185.          this function differently.  This symbol is already on the
  1186.          undefs list.  We add the section to a common section
  1187.          attached to symbfd to ensure that it is in a BFD which
  1188.          will be linked in.  */
  1189.       h->type = bfd_link_hash_common;
  1190.       h->u.c.p =
  1191.         ((struct bfd_link_hash_common_entry *)
  1192.          bfd_hash_allocate (&info->hash->table,
  1193.                 sizeof (struct bfd_link_hash_common_entry)));
  1194.       if (h->u.c.p == NULL)
  1195.         return false;
  1196.  
  1197.       size = bfd_asymbol_value (p);
  1198.       h->u.c.size = size;
  1199.  
  1200.       power = bfd_log2 (size);
  1201.       if (power > 4)
  1202.         power = 4;
  1203.       h->u.c.p->alignment_power = power;
  1204.  
  1205.       if (p->section == bfd_com_section_ptr)
  1206.         h->u.c.p->section = bfd_make_section_old_way (symbfd, "COMMON");
  1207.       else
  1208.         h->u.c.p->section = bfd_make_section_old_way (symbfd,
  1209.                               p->section->name);
  1210.       h->u.c.p->section->flags = SEC_ALLOC;
  1211.     }
  1212.       else
  1213.     {
  1214.       /* Adjust the size of the common symbol if necessary.  This
  1215.          is how a.out works.  Object formats that require
  1216.          different semantics must implement this function
  1217.          differently.  */
  1218.       if (bfd_asymbol_value (p) > h->u.c.size)
  1219.         h->u.c.size = bfd_asymbol_value (p);
  1220.     }
  1221.     }
  1222.  
  1223.   /* This archive element is not needed.  */
  1224.   return true;
  1225. }
  1226.  
  1227. /* Add the symbols from an object file to the global hash table.  ABFD
  1228.    is the object file.  INFO is the linker information.  SYMBOL_COUNT
  1229.    is the number of symbols.  SYMBOLS is the list of symbols.  COLLECT
  1230.    is true if constructors should be automatically collected by name
  1231.    as is done by collect2.  */
  1232.  
  1233. static boolean
  1234. generic_link_add_symbol_list (abfd, info, symbol_count, symbols, collect)
  1235.      bfd *abfd;
  1236.      struct bfd_link_info *info;
  1237.      bfd_size_type symbol_count;
  1238.      asymbol **symbols;
  1239.      boolean collect;
  1240. {
  1241.   asymbol **pp, **ppend;
  1242.  
  1243.   pp = symbols;
  1244.   ppend = symbols + symbol_count;
  1245.   for (; pp < ppend; pp++)
  1246.     {
  1247.       asymbol *p;
  1248.  
  1249.       p = *pp;
  1250.  
  1251.       if ((p->flags & (BSF_INDIRECT
  1252.                | BSF_WARNING
  1253.                | BSF_GLOBAL
  1254.                | BSF_CONSTRUCTOR
  1255.                | BSF_WEAK)) != 0
  1256.       || bfd_is_und_section (bfd_get_section (p))
  1257.       || bfd_is_com_section (bfd_get_section (p))
  1258.       || bfd_is_ind_section (bfd_get_section (p)))
  1259.     {
  1260.       const char *name;
  1261.       const char *string;
  1262.       struct generic_link_hash_entry *h;
  1263.  
  1264.       name = bfd_asymbol_name (p);
  1265.       if (((p->flags & BSF_INDIRECT) != 0
  1266.            || bfd_is_ind_section (p->section))
  1267.           && pp + 1 < ppend)
  1268.         {
  1269.           pp++;
  1270.           string = bfd_asymbol_name (*pp);
  1271.         }
  1272.       else if ((p->flags & BSF_WARNING) != 0
  1273.            && pp + 1 < ppend)
  1274.         {
  1275.           /* The name of P is actually the warning string, and the
  1276.          next symbol is the one to warn about.  */
  1277.           string = name;
  1278.           pp++;
  1279.           name = bfd_asymbol_name (*pp);
  1280.         }
  1281.       else
  1282.         string = NULL;
  1283.  
  1284.       h = NULL;
  1285.       if (! (_bfd_generic_link_add_one_symbol
  1286.          (info, abfd, name, p->flags, bfd_get_section (p),
  1287.           p->value, string, false, collect,
  1288.           (struct bfd_link_hash_entry **) &h)))
  1289.         return false;
  1290.  
  1291.       /* If this is a constructor symbol, and the linker didn't do
  1292.              anything with it, then we want to just pass the symbol
  1293.              through to the output file.  This will happen when
  1294.              linking with -r.  */
  1295.       if ((p->flags & BSF_CONSTRUCTOR) != 0
  1296.           && (h == NULL || h->root.type == bfd_link_hash_new))
  1297.         {
  1298.           p->udata.p = NULL;
  1299.           continue;
  1300.         }
  1301.  
  1302.       /* Save the BFD symbol so that we don't lose any backend
  1303.          specific information that may be attached to it.  We only
  1304.          want this one if it gives more information than the
  1305.          existing one; we don't want to replace a defined symbol
  1306.          with an undefined one.  This routine may be called with a
  1307.          hash table other than the generic hash table, so we only
  1308.          do this if we are certain that the hash table is a
  1309.          generic one.  */
  1310.       if (info->hash->creator == abfd->xvec)
  1311.         {
  1312.           if (h->sym == (asymbol *) NULL
  1313.           || (! bfd_is_und_section (bfd_get_section (p))
  1314.               && (! bfd_is_com_section (bfd_get_section (p))
  1315.               || bfd_is_und_section (bfd_get_section (h->sym)))))
  1316.         {
  1317.           h->sym = p;
  1318.           /* BSF_OLD_COMMON is a hack to support COFF reloc
  1319.              reading, and it should go away when the COFF
  1320.              linker is switched to the new version.  */
  1321.           if (bfd_is_com_section (bfd_get_section (p)))
  1322.             p->flags |= BSF_OLD_COMMON;
  1323.         }
  1324.  
  1325.           /* Store a back pointer from the symbol to the hash
  1326.          table entry for the benefit of relaxation code until
  1327.          it gets rewritten to not use asymbol structures.
  1328.          Setting this is also used to check whether these
  1329.          symbols were set up by the generic linker.  */
  1330.           p->udata.p = (PTR) h;
  1331.         }
  1332.     }
  1333.     }
  1334.  
  1335.   return true;
  1336. }
  1337.  
  1338. /* We use a state table to deal with adding symbols from an object
  1339.    file.  The first index into the state table describes the symbol
  1340.    from the object file.  The second index into the state table is the
  1341.    type of the symbol in the hash table.  */
  1342.  
  1343. /* The symbol from the object file is turned into one of these row
  1344.    values.  */
  1345.  
  1346. enum link_row
  1347. {
  1348.   UNDEF_ROW,        /* Undefined.  */
  1349.   UNDEFW_ROW,        /* Weak undefined.  */
  1350.   DEF_ROW,        /* Defined.  */
  1351.   DEFW_ROW,        /* Weak defined.  */
  1352.   COMMON_ROW,        /* Common.  */
  1353.   INDR_ROW,        /* Indirect.  */
  1354.   WARN_ROW,        /* Warning.  */
  1355.   SET_ROW        /* Member of set.  */
  1356. };
  1357.  
  1358. /* apparently needed for Hitachi 3050R(HI-UX/WE2)? */
  1359. #undef FAIL
  1360.  
  1361. /* The actions to take in the state table.  */
  1362.  
  1363. enum link_action
  1364. {
  1365.   FAIL,        /* Abort. */
  1366.   UND,        /* Mark symbol undefined.  */
  1367.   WEAK,        /* Mark symbol weak undefined.  */
  1368.   DEF,        /* Mark symbol defined.  */
  1369.   DEFW,        /* Mark symbol weak defined.  */
  1370.   COM,        /* Mark symbol common.  */
  1371.   REF,        /* Mark defined symbol referenced.  */
  1372.   CREF,        /* Possibly warn about common reference to defined symbol.  */
  1373.   CDEF,        /* Define existing common symbol.  */
  1374.   NOACT,    /* No action.  */
  1375.   BIG,        /* Mark symbol common using largest size.  */
  1376.   MDEF,        /* Multiple definition error.  */
  1377.   MIND,        /* Multiple indirect symbols.  */
  1378.   IND,        /* Make indirect symbol.  */
  1379.   CIND,        /* Make indirect symbol from existing common symbol.  */
  1380.   SET,        /* Add value to set.  */
  1381.   MWARN,    /* Make warning symbol.  */
  1382.   WARN,        /* Issue warning.  */
  1383.   CWARN,    /* Warn if referenced, else MWARN.  */
  1384.   CYCLE,    /* Repeat with symbol pointed to.  */
  1385.   REFC,        /* Mark indirect symbol referenced and then CYCLE.  */
  1386.   WARNC        /* Issue warning and then CYCLE.  */
  1387. };
  1388.  
  1389. /* The state table itself.  The first index is a link_row and the
  1390.    second index is a bfd_link_hash_type.  */
  1391.  
  1392. static const enum link_action link_action[8][8] =
  1393. {
  1394.   /* current\prev    new    undef  undefw def    defw   com    indr   warn  */
  1395.   /* UNDEF_ROW     */  {UND,   NOACT, UND,   REF,   REF,   NOACT, REFC,  WARNC },
  1396.   /* UNDEFW_ROW    */  {WEAK,  NOACT, NOACT, REF,   REF,   NOACT, REFC,  WARNC },
  1397.   /* DEF_ROW     */  {DEF,   DEF,   DEF,   MDEF,  DEF,   CDEF,  MDEF,  CYCLE },
  1398.   /* DEFW_ROW     */  {DEFW,  DEFW,  DEFW,  NOACT, NOACT, NOACT, NOACT, CYCLE },
  1399.   /* COMMON_ROW    */  {COM,   COM,   COM,   CREF,  CREF,  BIG,   CREF,  WARNC },
  1400.   /* INDR_ROW    */  {IND,   IND,   IND,   MDEF,  IND,   CIND,  MIND,  CYCLE },
  1401.   /* WARN_ROW   */  {MWARN, WARN,  WARN,  CWARN, CWARN, WARN,  CWARN, MWARN },
  1402.   /* SET_ROW    */  {SET,   SET,   SET,   SET,   SET,   SET,   CYCLE, CYCLE }
  1403. };
  1404.  
  1405. /* Most of the entries in the LINK_ACTION table are straightforward,
  1406.    but a few are somewhat subtle.
  1407.  
  1408.    A reference to an indirect symbol (UNDEF_ROW/indr or
  1409.    UNDEFW_ROW/indr) is counted as a reference both to the indirect
  1410.    symbol and to the symbol the indirect symbol points to.
  1411.  
  1412.    A reference to a warning symbol (UNDEF_ROW/warn or UNDEFW_ROW/warn)
  1413.    causes the warning to be issued.
  1414.  
  1415.    A common definition of an indirect symbol (COMMON_ROW/indr) is
  1416.    treated as a multiple definition error.  Likewise for an indirect
  1417.    definition of a common symbol (INDR_ROW/com).
  1418.  
  1419.    An indirect definition of a warning (INDR_ROW/warn) does not cause
  1420.    the warning to be issued.
  1421.  
  1422.    If a warning is created for an indirect symbol (WARN_ROW/indr) no
  1423.    warning is created for the symbol the indirect symbol points to.
  1424.  
  1425.    Adding an entry to a set does not count as a reference to a set,
  1426.    and no warning is issued (SET_ROW/warn).  */
  1427.  
  1428. /* Return the BFD in which a hash entry has been defined, if known.  */
  1429.  
  1430. static bfd *
  1431. hash_entry_bfd (h)
  1432.      struct bfd_link_hash_entry *h;
  1433. {
  1434.   while (h->type == bfd_link_hash_warning)
  1435.     h = h->u.i.link;
  1436.   switch (h->type)
  1437.     {
  1438.     default:
  1439.       return NULL;
  1440.     case bfd_link_hash_undefined:
  1441.     case bfd_link_hash_undefweak:
  1442.       return h->u.undef.abfd;
  1443.     case bfd_link_hash_defined:
  1444.     case bfd_link_hash_defweak:
  1445.       return h->u.def.section->owner;
  1446.     case bfd_link_hash_common:
  1447.       return h->u.c.p->section->owner;
  1448.     }
  1449.   /*NOTREACHED*/
  1450. }
  1451.  
  1452. /* Add a symbol to the global hash table.
  1453.    ABFD is the BFD the symbol comes from.
  1454.    NAME is the name of the symbol.
  1455.    FLAGS is the BSF_* bits associated with the symbol.
  1456.    SECTION is the section in which the symbol is defined; this may be
  1457.      bfd_und_section_ptr or bfd_com_section_ptr.
  1458.    VALUE is the value of the symbol, relative to the section.
  1459.    STRING is used for either an indirect symbol, in which case it is
  1460.      the name of the symbol to indirect to, or a warning symbol, in
  1461.      which case it is the warning string.
  1462.    COPY is true if NAME or STRING must be copied into locally
  1463.      allocated memory if they need to be saved.
  1464.    COLLECT is true if we should automatically collect gcc constructor
  1465.      or destructor names as collect2 does.
  1466.    HASHP, if not NULL, is a place to store the created hash table
  1467.      entry; if *HASHP is not NULL, the caller has already looked up
  1468.      the hash table entry, and stored it in *HASHP. */
  1469.  
  1470. boolean
  1471. _bfd_generic_link_add_one_symbol (info, abfd, name, flags, section, value,
  1472.                   string, copy, collect, hashp)
  1473.      struct bfd_link_info *info;
  1474.      bfd *abfd;
  1475.      const char *name;
  1476.      flagword flags;
  1477.      asection *section;
  1478.      bfd_vma value;
  1479.      const char *string;
  1480.      boolean copy;
  1481.      boolean collect;
  1482.      struct bfd_link_hash_entry **hashp;
  1483. {
  1484.   enum link_row row;
  1485.   struct bfd_link_hash_entry *h;
  1486.   boolean cycle;
  1487.  
  1488.   if (bfd_is_ind_section (section)
  1489.       || (flags & BSF_INDIRECT) != 0)
  1490.     row = INDR_ROW;
  1491.   else if ((flags & BSF_WARNING) != 0)
  1492.     row = WARN_ROW;
  1493.   else if ((flags & BSF_CONSTRUCTOR) != 0)
  1494.     row = SET_ROW;
  1495.   else if (bfd_is_und_section (section))
  1496.     {
  1497.       if ((flags & BSF_WEAK) != 0)
  1498.     row = UNDEFW_ROW;
  1499.       else
  1500.     row = UNDEF_ROW;
  1501.     }
  1502.   else if ((flags & BSF_WEAK) != 0)
  1503.     row = DEFW_ROW;
  1504.   else if (bfd_is_com_section (section))
  1505.     row = COMMON_ROW;
  1506.   else
  1507.     row = DEF_ROW;
  1508.  
  1509.   if (hashp != NULL && *hashp != NULL)
  1510.     h = *hashp;
  1511.   else
  1512.     {
  1513.       if (row == UNDEF_ROW || row == UNDEFW_ROW)
  1514.     h = bfd_wrapped_link_hash_lookup (abfd, info, name, true, copy, false);
  1515.       else
  1516.     h = bfd_link_hash_lookup (info->hash, name, true, copy, false);
  1517.       if (h == NULL)
  1518.     {
  1519.       if (hashp != NULL)
  1520.         *hashp = NULL;
  1521.       return false;
  1522.     }
  1523.     }
  1524.  
  1525.   if (info->notice_all
  1526.       || (info->notice_hash != (struct bfd_hash_table *) NULL
  1527.       && (bfd_hash_lookup (info->notice_hash, name, false, false)
  1528.           != (struct bfd_hash_entry *) NULL)))
  1529.     {
  1530.       if (! (*info->callbacks->notice) (info, h->root.string, abfd, section,
  1531.                     value))
  1532.     return false;
  1533.     }
  1534.  
  1535.   if (hashp != (struct bfd_link_hash_entry **) NULL)
  1536.     *hashp = h;
  1537.  
  1538.   do
  1539.     {
  1540.       enum link_action action;
  1541.  
  1542.       cycle = false;
  1543.       action = link_action[(int) row][(int) h->type];
  1544.       switch (action)
  1545.     {
  1546.     case FAIL:
  1547.       abort ();
  1548.  
  1549.     case NOACT:
  1550.       /* Do nothing.  */
  1551.       break;
  1552.  
  1553.     case UND:
  1554.       /* Make a new undefined symbol.  */
  1555.       h->type = bfd_link_hash_undefined;
  1556.       h->u.undef.abfd = abfd;
  1557.       bfd_link_add_undef (info->hash, h);
  1558.       break;
  1559.  
  1560.     case WEAK:
  1561.       /* Make a new weak undefined symbol.  */
  1562.       h->type = bfd_link_hash_undefweak;
  1563.       h->u.undef.abfd = abfd;
  1564.       break;
  1565.  
  1566.     case CDEF:
  1567.       /* We have found a definition for a symbol which was
  1568.          previously common.  */
  1569.       BFD_ASSERT (h->type == bfd_link_hash_common);
  1570.       if (! ((*info->callbacks->multiple_common)
  1571.          (info, h->root.string,
  1572.           h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
  1573.           abfd, bfd_link_hash_defined, (bfd_vma) 0)))
  1574.         return false;
  1575.       /* Fall through.  */
  1576.     case DEF:
  1577.     case DEFW:
  1578.       {
  1579.         enum bfd_link_hash_type oldtype;
  1580.  
  1581.         /* Define a symbol.  */
  1582.         oldtype = h->type;
  1583.         if (action == DEFW)
  1584.           h->type = bfd_link_hash_defweak;
  1585.         else
  1586.           h->type = bfd_link_hash_defined;
  1587.         h->u.def.section = section;
  1588.         h->u.def.value = value;
  1589.  
  1590.         /* If we have been asked to, we act like collect2 and
  1591.            identify all functions that might be global
  1592.            constructors and destructors and pass them up in a
  1593.            callback.  We only do this for certain object file
  1594.            types, since many object file types can handle this
  1595.            automatically.  */
  1596.         if (collect && name[0] == '_')
  1597.           {
  1598.         const char *s;
  1599.  
  1600.         /* A constructor or destructor name starts like this:
  1601.            _+GLOBAL_[_.$][ID][_.$] where the first [_.$] and
  1602.            the second are the same character (we accept any
  1603.            character there, in case a new object file format
  1604.            comes along with even worse naming restrictions).  */
  1605.  
  1606. #define CONS_PREFIX "GLOBAL_"
  1607. #define CONS_PREFIX_LEN (sizeof CONS_PREFIX - 1)
  1608.  
  1609.         s = name + 1;
  1610.         while (*s == '_')
  1611.           ++s;
  1612.         if (s[0] == 'G'
  1613.             && strncmp (s, CONS_PREFIX, CONS_PREFIX_LEN - 1) == 0)
  1614.           {
  1615.             char c;
  1616.  
  1617.             c = s[CONS_PREFIX_LEN + 1];
  1618.             if ((c == 'I' || c == 'D')
  1619.             && s[CONS_PREFIX_LEN] == s[CONS_PREFIX_LEN + 2])
  1620.               {
  1621.             /* If this is a definition of a symbol which
  1622.                            was previously weakly defined, we are in
  1623.                            trouble.  We have already added a
  1624.                            constructor entry for the weak defined
  1625.                            symbol, and now we are trying to add one
  1626.                            for the new symbol.  Fortunately, this case
  1627.                            should never arise in practice.  */
  1628.             if (oldtype == bfd_link_hash_defweak)
  1629.               abort ();
  1630.  
  1631.             if (! ((*info->callbacks->constructor)
  1632.                    (info,
  1633.                 c == 'I' ? true : false,
  1634.                 h->root.string, abfd, section, value)))
  1635.               return false;
  1636.               }
  1637.           }
  1638.           }
  1639.       }
  1640.  
  1641.       break;
  1642.  
  1643.     case COM:
  1644.       /* We have found a common definition for a symbol.  */
  1645.       if (h->type == bfd_link_hash_new)
  1646.         bfd_link_add_undef (info->hash, h);
  1647.       h->type = bfd_link_hash_common;
  1648.       h->u.c.p =
  1649.         ((struct bfd_link_hash_common_entry *)
  1650.          bfd_hash_allocate (&info->hash->table,
  1651.                 sizeof (struct bfd_link_hash_common_entry)));
  1652.       if (h->u.c.p == NULL)
  1653.         return false;
  1654.  
  1655.       h->u.c.size = value;
  1656.  
  1657.       /* Select a default alignment based on the size.  This may
  1658.              be overridden by the caller.  */
  1659.       {
  1660.         unsigned int power;
  1661.  
  1662.         power = bfd_log2 (value);
  1663.         if (power > 4)
  1664.           power = 4;
  1665.         h->u.c.p->alignment_power = power;
  1666.       }
  1667.  
  1668.       /* The section of a common symbol is only used if the common
  1669.              symbol is actually allocated.  It basically provides a
  1670.              hook for the linker script to decide which output section
  1671.              the common symbols should be put in.  In most cases, the
  1672.              section of a common symbol will be bfd_com_section_ptr,
  1673.              the code here will choose a common symbol section named
  1674.              "COMMON", and the linker script will contain *(COMMON) in
  1675.              the appropriate place.  A few targets use separate common
  1676.              sections for small symbols, and they require special
  1677.              handling.  */
  1678.       if (section == bfd_com_section_ptr)
  1679.         {
  1680.           h->u.c.p->section = bfd_make_section_old_way (abfd, "COMMON");
  1681.           h->u.c.p->section->flags = SEC_ALLOC;
  1682.         }
  1683.       else if (section->owner != abfd)
  1684.         {
  1685.           h->u.c.p->section = bfd_make_section_old_way (abfd,
  1686.                                 section->name);
  1687.           h->u.c.p->section->flags = SEC_ALLOC;
  1688.         }
  1689.       else
  1690.         h->u.c.p->section = section;
  1691.       break;
  1692.  
  1693.     case REF:
  1694.       /* A reference to a defined symbol.  */
  1695.       if (h->next == NULL && info->hash->undefs_tail != h)
  1696.         h->next = h;
  1697.       break;
  1698.  
  1699.     case BIG:
  1700.       /* We have found a common definition for a symbol which
  1701.          already had a common definition.  Use the maximum of the
  1702.          two sizes.  */
  1703.       BFD_ASSERT (h->type == bfd_link_hash_common);
  1704.       if (! ((*info->callbacks->multiple_common)
  1705.          (info, h->root.string,
  1706.           h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
  1707.           abfd, bfd_link_hash_common, value)))
  1708.         return false;
  1709.       if (value > h->u.c.size)
  1710.         {
  1711.           unsigned int power;
  1712.  
  1713.           h->u.c.size = value;
  1714.  
  1715.           /* Select a default alignment based on the size.  This may
  1716.          be overridden by the caller.  */
  1717.           power = bfd_log2 (value);
  1718.           if (power > 4)
  1719.         power = 4;
  1720.           h->u.c.p->alignment_power = power;
  1721.         }
  1722.       break;
  1723.  
  1724.     case CREF:
  1725.       {
  1726.         bfd *obfd;
  1727.  
  1728.         /* We have found a common definition for a symbol which
  1729.            was already defined.  FIXME: It would nice if we could
  1730.            report the BFD which defined an indirect symbol, but we
  1731.            don't have anywhere to store the information.  */
  1732.         if (h->type == bfd_link_hash_defined
  1733.         || h->type == bfd_link_hash_defweak)
  1734.           obfd = h->u.def.section->owner;
  1735.         else
  1736.           obfd = NULL;
  1737.         if (! ((*info->callbacks->multiple_common)
  1738.            (info, h->root.string, obfd, h->type, (bfd_vma) 0,
  1739.             abfd, bfd_link_hash_common, value)))
  1740.           return false;
  1741.       }
  1742.       break;
  1743.  
  1744.     case MIND:
  1745.       /* Multiple indirect symbols.  This is OK if they both point
  1746.          to the same symbol.  */
  1747.       if (strcmp (h->u.i.link->root.string, string) == 0)
  1748.         break;
  1749.       /* Fall through.  */
  1750.     case MDEF:
  1751.       /* Handle a multiple definition.  */
  1752.       {
  1753.         asection *msec;
  1754.         bfd_vma mval;
  1755.  
  1756.         switch (h->type)
  1757.           {
  1758.           case bfd_link_hash_defined:
  1759.         msec = h->u.def.section;
  1760.         mval = h->u.def.value;
  1761.         break;
  1762.           case bfd_link_hash_indirect:
  1763.         msec = bfd_ind_section_ptr;
  1764.         mval = 0;
  1765.         break;
  1766.           default:
  1767.         abort ();
  1768.           }
  1769.  
  1770.         /* Ignore a redefinition of an absolute symbol to the same
  1771.                value; it's harmless.  */
  1772.         if (h->type == bfd_link_hash_defined
  1773.         && bfd_is_abs_section (msec)
  1774.         && bfd_is_abs_section (section)
  1775.         && value == mval)
  1776.           break;
  1777.  
  1778.         if (! ((*info->callbacks->multiple_definition)
  1779.            (info, h->root.string, msec->owner, msec, mval, abfd,
  1780.             section, value)))
  1781.           return false;
  1782.       }
  1783.       break;
  1784.  
  1785.     case CIND:
  1786.       /* Create an indirect symbol from an existing common symbol.  */
  1787.       BFD_ASSERT (h->type == bfd_link_hash_common);
  1788.       if (! ((*info->callbacks->multiple_common)
  1789.          (info, h->root.string,
  1790.           h->u.c.p->section->owner, bfd_link_hash_common, h->u.c.size,
  1791.           abfd, bfd_link_hash_indirect, (bfd_vma) 0)))
  1792.         return false;
  1793.       /* Fall through.  */
  1794.     case IND:
  1795.       /* Create an indirect symbol.  */
  1796.       {
  1797.         struct bfd_link_hash_entry *inh;
  1798.  
  1799.         /* STRING is the name of the symbol we want to indirect
  1800.            to.  */
  1801.         inh = bfd_wrapped_link_hash_lookup (abfd, info, string, true,
  1802.                         copy, false);
  1803.         if (inh == (struct bfd_link_hash_entry *) NULL)
  1804.           return false;
  1805.         if (inh->type == bfd_link_hash_new)
  1806.           {
  1807.         inh->type = bfd_link_hash_undefined;
  1808.         inh->u.undef.abfd = abfd;
  1809.         bfd_link_add_undef (info->hash, inh);
  1810.           }
  1811.  
  1812.         /* If the indirect symbol has been referenced, we need to
  1813.            push the reference down to the symbol we are
  1814.            referencing.  */
  1815.         if (h->type != bfd_link_hash_new)
  1816.           {
  1817.         row = UNDEF_ROW;
  1818.         cycle = true;
  1819.           }
  1820.  
  1821.         h->type = bfd_link_hash_indirect;
  1822.         h->u.i.link = inh;
  1823.       }
  1824.       break;
  1825.  
  1826.     case SET:
  1827.       /* Add an entry to a set.  */
  1828.       if (! (*info->callbacks->add_to_set) (info, h, BFD_RELOC_CTOR,
  1829.                         abfd, section, value))
  1830.         return false;
  1831.       break;
  1832.  
  1833.     case WARNC:
  1834.       /* Issue a warning and cycle.  */
  1835.       if (h->u.i.warning != NULL)
  1836.         {
  1837.           if (! (*info->callbacks->warning) (info, h->u.i.warning,
  1838.                          h->root.string, abfd,
  1839.                          (asection *) NULL,
  1840.                          (bfd_vma) 0))
  1841.         return false;
  1842.           /* Only issue a warning once.  */
  1843.           h->u.i.warning = NULL;
  1844.         }
  1845.       /* Fall through.  */
  1846.     case CYCLE:
  1847.       /* Try again with the referenced symbol.  */
  1848.       h = h->u.i.link;
  1849.       cycle = true;
  1850.       break;
  1851.  
  1852.     case REFC:
  1853.       /* A reference to an indirect symbol.  */
  1854.       if (h->next == NULL && info->hash->undefs_tail != h)
  1855.         h->next = h;
  1856.       h = h->u.i.link;
  1857.       cycle = true;
  1858.       break;
  1859.  
  1860.     case WARN:
  1861.       /* Issue a warning.  */
  1862.       if (! (*info->callbacks->warning) (info, string, h->root.string,
  1863.                          hash_entry_bfd (h),
  1864.                          (asection *) NULL, (bfd_vma) 0))
  1865.         return false;
  1866.       break;
  1867.  
  1868.     case CWARN:
  1869.       /* Warn if this symbol has been referenced already,
  1870.          otherwise add a warning.  A symbol has been referenced if
  1871.          the next field is not NULL, or it is the tail of the
  1872.          undefined symbol list.  The REF case above helps to
  1873.          ensure this.  */
  1874.       if (h->next != NULL || info->hash->undefs_tail == h)
  1875.         {
  1876.           if (! (*info->callbacks->warning) (info, string, h->root.string,
  1877.                          hash_entry_bfd (h),
  1878.                          (asection *) NULL,
  1879.                          (bfd_vma) 0))
  1880.         return false;
  1881.           break;
  1882.         }
  1883.       /* Fall through.  */
  1884.     case MWARN:
  1885.       /* Make a warning symbol.  */
  1886.       {
  1887.         struct bfd_link_hash_entry *sub;
  1888.  
  1889.         /* STRING is the warning to give.  */
  1890.         sub = ((struct bfd_link_hash_entry *)
  1891.            ((*info->hash->table.newfunc)
  1892.             ((struct bfd_hash_entry *) NULL, &info->hash->table,
  1893.              h->root.string)));
  1894.         if (sub == NULL)
  1895.           return false;
  1896.         *sub = *h;
  1897.         sub->type = bfd_link_hash_warning;
  1898.         sub->u.i.link = h;
  1899.         if (! copy)
  1900.           sub->u.i.warning = string;
  1901.         else
  1902.           {
  1903.         char *w;
  1904.  
  1905.         w = bfd_hash_allocate (&info->hash->table,
  1906.                        strlen (string) + 1);
  1907.         if (w == NULL)
  1908.           return false;
  1909.         strcpy (w, string);
  1910.         sub->u.i.warning = w;
  1911.           }
  1912.  
  1913.         bfd_hash_replace (&info->hash->table,
  1914.                   (struct bfd_hash_entry *) h,
  1915.                   (struct bfd_hash_entry *) sub);
  1916.         if (hashp != NULL)
  1917.           *hashp = sub;
  1918.       }
  1919.       break;
  1920.     }
  1921.     }
  1922.   while (cycle);
  1923.  
  1924.   return true;
  1925. }
  1926.  
  1927. /* Generic final link routine.  */
  1928.  
  1929. boolean
  1930. _bfd_generic_final_link (abfd, info)
  1931.      bfd *abfd;
  1932.      struct bfd_link_info *info;
  1933. {
  1934.   bfd *sub;
  1935.   asection *o;
  1936.   struct bfd_link_order *p;
  1937.   size_t outsymalloc;
  1938.   struct generic_write_global_symbol_info wginfo;
  1939.  
  1940.   abfd->outsymbols = (asymbol **) NULL;
  1941.   abfd->symcount = 0;
  1942.   outsymalloc = 0;
  1943.  
  1944.   /* Build the output symbol table.  */
  1945.   for (sub = info->input_bfds; sub != (bfd *) NULL; sub = sub->link_next)
  1946.     if (! _bfd_generic_link_output_symbols (abfd, sub, info, &outsymalloc))
  1947.       return false;
  1948.  
  1949.   /* Accumulate the global symbols.  */
  1950.   wginfo.info = info;
  1951.   wginfo.output_bfd = abfd;
  1952.   wginfo.psymalloc = &outsymalloc;
  1953.   _bfd_generic_link_hash_traverse (_bfd_generic_hash_table (info),
  1954.                    _bfd_generic_link_write_global_symbol,
  1955.                    (PTR) &wginfo);
  1956.  
  1957.   if (info->relocateable)
  1958.     {
  1959.       /* Allocate space for the output relocs for each section.  */
  1960.       for (o = abfd->sections;
  1961.        o != (asection *) NULL;
  1962.        o = o->next)
  1963.     {
  1964.       o->reloc_count = 0;
  1965.       for (p = o->link_order_head;
  1966.            p != (struct bfd_link_order *) NULL;
  1967.            p = p->next)
  1968.         {
  1969.           if (p->type == bfd_section_reloc_link_order
  1970.           || p->type == bfd_symbol_reloc_link_order)
  1971.         ++o->reloc_count;
  1972.           else if (p->type == bfd_indirect_link_order)
  1973.         {
  1974.           asection *input_section;
  1975.           bfd *input_bfd;
  1976.           long relsize;
  1977.           arelent **relocs;
  1978.           asymbol **symbols;
  1979.           long reloc_count;
  1980.  
  1981.           input_section = p->u.indirect.section;
  1982.           input_bfd = input_section->owner;
  1983.           relsize = bfd_get_reloc_upper_bound (input_bfd,
  1984.                                input_section);
  1985.           if (relsize < 0)
  1986.             return false;
  1987.           relocs = (arelent **) bfd_malloc ((size_t) relsize);
  1988.           if (!relocs && relsize != 0)
  1989.             return false;
  1990.           symbols = _bfd_generic_link_get_symbols (input_bfd);
  1991.           reloc_count = bfd_canonicalize_reloc (input_bfd,
  1992.                             input_section,
  1993.                             relocs,
  1994.                             symbols);
  1995.           if (reloc_count < 0)
  1996.             return false;
  1997.           BFD_ASSERT ((unsigned long) reloc_count
  1998.                   == input_section->reloc_count);
  1999.           o->reloc_count += reloc_count;
  2000.           free (relocs);
  2001.         }
  2002.         }
  2003.       if (o->reloc_count > 0)
  2004.         {
  2005.           o->orelocation = ((arelent **)
  2006.                 bfd_alloc (abfd,
  2007.                        (o->reloc_count
  2008.                         * sizeof (arelent *))));
  2009.           if (!o->orelocation)
  2010.         return false;
  2011.           o->flags |= SEC_RELOC;
  2012.           /* Reset the count so that it can be used as an index
  2013.          when putting in the output relocs.  */
  2014.           o->reloc_count = 0;
  2015.         }
  2016.     }
  2017.     }
  2018.  
  2019.   /* Handle all the link order information for the sections.  */
  2020.   for (o = abfd->sections;
  2021.        o != (asection *) NULL;
  2022.        o = o->next)
  2023.     {
  2024.       for (p = o->link_order_head;
  2025.        p != (struct bfd_link_order *) NULL;
  2026.        p = p->next)
  2027.     {
  2028.       switch (p->type)
  2029.         {
  2030.         case bfd_section_reloc_link_order:
  2031.         case bfd_symbol_reloc_link_order:
  2032.           if (! _bfd_generic_reloc_link_order (abfd, info, o, p))
  2033.         return false;
  2034.           break;
  2035.         case bfd_indirect_link_order:
  2036.           if (! default_indirect_link_order (abfd, info, o, p, true))
  2037.         return false;
  2038.           break;
  2039.         default:
  2040.           if (! _bfd_default_link_order (abfd, info, o, p))
  2041.         return false;
  2042.           break;
  2043.         }
  2044.     }
  2045.     }
  2046.  
  2047.   return true;
  2048. }
  2049.  
  2050. /* Add an output symbol to the output BFD.  */
  2051.  
  2052. static boolean
  2053. generic_add_output_symbol (output_bfd, psymalloc, sym)
  2054.      bfd *output_bfd;
  2055.      size_t *psymalloc;
  2056.      asymbol *sym;
  2057. {
  2058.   if (output_bfd->symcount >= *psymalloc)
  2059.     {
  2060.       asymbol **newsyms;
  2061.  
  2062.       if (*psymalloc == 0)
  2063.     *psymalloc = 124;
  2064.       else
  2065.     *psymalloc *= 2;
  2066.       newsyms = (asymbol **) bfd_realloc (output_bfd->outsymbols,
  2067.                       *psymalloc * sizeof (asymbol *));
  2068.       if (newsyms == (asymbol **) NULL)
  2069.     return false;
  2070.       output_bfd->outsymbols = newsyms;
  2071.     }
  2072.  
  2073.   output_bfd->outsymbols[output_bfd->symcount] = sym;
  2074.   ++output_bfd->symcount;
  2075.  
  2076.   return true;
  2077. }
  2078.  
  2079. /* Handle the symbols for an input BFD.  */
  2080.  
  2081. boolean
  2082. _bfd_generic_link_output_symbols (output_bfd, input_bfd, info, psymalloc)
  2083.      bfd *output_bfd;
  2084.      bfd *input_bfd;
  2085.      struct bfd_link_info *info;
  2086.      size_t *psymalloc;
  2087. {
  2088.   asymbol **sym_ptr;
  2089.   asymbol **sym_end;
  2090.  
  2091.   if (! generic_link_read_symbols (input_bfd))
  2092.     return false;
  2093.  
  2094.   /* Create a filename symbol if we are supposed to.  */
  2095.   if (info->create_object_symbols_section != (asection *) NULL)
  2096.     {
  2097.       asection *sec;
  2098.  
  2099.       for (sec = input_bfd->sections;
  2100.        sec != (asection *) NULL;
  2101.        sec = sec->next)
  2102.     {
  2103.       if (sec->output_section == info->create_object_symbols_section)
  2104.         {
  2105.           asymbol *newsym;
  2106.  
  2107.           newsym = bfd_make_empty_symbol (input_bfd);
  2108.           if (!newsym)
  2109.         return false;
  2110.           newsym->name = input_bfd->filename;
  2111.           newsym->value = 0;
  2112.           newsym->flags = BSF_LOCAL | BSF_FILE;
  2113.           newsym->section = sec;
  2114.  
  2115.           if (! generic_add_output_symbol (output_bfd, psymalloc,
  2116.                            newsym))
  2117.         return false;
  2118.  
  2119.           break;
  2120.         }
  2121.     }
  2122.     }
  2123.  
  2124.   /* Adjust the values of the globally visible symbols, and write out
  2125.      local symbols.  */
  2126.   sym_ptr = _bfd_generic_link_get_symbols (input_bfd);
  2127.   sym_end = sym_ptr + _bfd_generic_link_get_symcount (input_bfd);
  2128.   for (; sym_ptr < sym_end; sym_ptr++)
  2129.     {
  2130.       asymbol *sym;
  2131.       struct generic_link_hash_entry *h;
  2132.       boolean output;
  2133.  
  2134.       h = (struct generic_link_hash_entry *) NULL;
  2135.       sym = *sym_ptr;
  2136.       if ((sym->flags & (BSF_INDIRECT
  2137.              | BSF_WARNING
  2138.              | BSF_GLOBAL
  2139.              | BSF_CONSTRUCTOR
  2140.              | BSF_WEAK)) != 0
  2141.       || bfd_is_und_section (bfd_get_section (sym))
  2142.       || bfd_is_com_section (bfd_get_section (sym))
  2143.       || bfd_is_ind_section (bfd_get_section (sym)))
  2144.     {
  2145.       if (sym->udata.p != NULL)
  2146.         h = (struct generic_link_hash_entry *) sym->udata.p;
  2147.       else if ((sym->flags & BSF_CONSTRUCTOR) != 0)
  2148.         {
  2149.           /* This case normally means that the main linker code
  2150.                  deliberately ignored this constructor symbol.  We
  2151.                  should just pass it through.  This will screw up if
  2152.                  the constructor symbol is from a different,
  2153.                  non-generic, object file format, but the case will
  2154.                  only arise when linking with -r, which will probably
  2155.                  fail anyhow, since there will be no way to represent
  2156.                  the relocs in the output format being used.  */
  2157.           h = NULL;
  2158.         }
  2159.       else if (bfd_is_und_section (bfd_get_section (sym)))
  2160.         h = ((struct generic_link_hash_entry *)
  2161.          bfd_wrapped_link_hash_lookup (output_bfd, info,
  2162.                            bfd_asymbol_name (sym),
  2163.                            false, false, true));
  2164.       else
  2165.         h = _bfd_generic_link_hash_lookup (_bfd_generic_hash_table (info),
  2166.                            bfd_asymbol_name (sym),
  2167.                            false, false, true);
  2168.  
  2169.       if (h != (struct generic_link_hash_entry *) NULL)
  2170.         {
  2171.           /* Force all references to this symbol to point to
  2172.          the same area in memory.  It is possible that
  2173.          this routine will be called with a hash table
  2174.          other than a generic hash table, so we double
  2175.          check that.  */
  2176.           if (info->hash->creator == input_bfd->xvec)
  2177.         {
  2178.           if (h->sym != (asymbol *) NULL)
  2179.             *sym_ptr = sym = h->sym;
  2180.         }
  2181.  
  2182.           switch (h->root.type)
  2183.         {
  2184.         default:
  2185.         case bfd_link_hash_new:
  2186.           abort ();
  2187.         case bfd_link_hash_undefined:
  2188.           break;
  2189.         case bfd_link_hash_undefweak:
  2190.           sym->flags |= BSF_WEAK;
  2191.           break;
  2192.         case bfd_link_hash_indirect:
  2193.           h = (struct generic_link_hash_entry *) h->root.u.i.link;
  2194.           /* fall through */
  2195.         case bfd_link_hash_defined:
  2196.           sym->flags |= BSF_GLOBAL;
  2197.           sym->flags &=~ BSF_CONSTRUCTOR;
  2198.           sym->value = h->root.u.def.value;
  2199.           sym->section = h->root.u.def.section;
  2200.           break;
  2201.         case bfd_link_hash_defweak:
  2202.           sym->flags |= BSF_WEAK;
  2203.           sym->flags &=~ BSF_CONSTRUCTOR;
  2204.           sym->value = h->root.u.def.value;
  2205.           sym->section = h->root.u.def.section;
  2206.           break;
  2207.         case bfd_link_hash_common:
  2208.           sym->value = h->root.u.c.size;
  2209.           sym->flags |= BSF_GLOBAL;
  2210.           if (! bfd_is_com_section (sym->section))
  2211.             {
  2212.               BFD_ASSERT (bfd_is_und_section (sym->section));
  2213.               sym->section = bfd_com_section_ptr;
  2214.             }
  2215.           /* We do not set the section of the symbol to
  2216.              h->root.u.c.p->section.  That value was saved so
  2217.              that we would know where to allocate the symbol
  2218.              if it was defined.  In this case the type is
  2219.              still bfd_link_hash_common, so we did not define
  2220.              it, so we do not want to use that section.  */
  2221.           break;
  2222.         }
  2223.         }
  2224.     }
  2225.  
  2226.       /* This switch is straight from the old code in
  2227.      write_file_locals in ldsym.c.  */
  2228.       if (info->strip == strip_all
  2229.       || (info->strip == strip_some
  2230.           && (bfd_hash_lookup (info->keep_hash, bfd_asymbol_name (sym),
  2231.                    false, false)
  2232.           == (struct bfd_hash_entry *) NULL)))
  2233.     output = false;
  2234.       else if ((sym->flags & (BSF_GLOBAL | BSF_WEAK)) != 0)
  2235.     {
  2236.       /* If this symbol is marked as occurring now, rather
  2237.          than at the end, output it now.  This is used for
  2238.          COFF C_EXT FCN symbols.  FIXME: There must be a
  2239.          better way.  */
  2240.       if (bfd_asymbol_bfd (sym) == input_bfd
  2241.           && (sym->flags & BSF_NOT_AT_END) != 0)
  2242.         output = true;
  2243.       else
  2244.         output = false;
  2245.     }
  2246.       else if (bfd_is_ind_section (sym->section))
  2247.     output = false;
  2248.       else if ((sym->flags & BSF_DEBUGGING) != 0)
  2249.     {
  2250.       if (info->strip == strip_none)
  2251.         output = true;
  2252.       else
  2253.         output = false;
  2254.     }
  2255.       else if (bfd_is_und_section (sym->section)
  2256.            || bfd_is_com_section (sym->section))
  2257.     output = false;
  2258.       else if ((sym->flags & BSF_LOCAL) != 0)
  2259.     {
  2260.       if ((sym->flags & BSF_WARNING) != 0)
  2261.         output = false;
  2262.       else
  2263.         {
  2264.           switch (info->discard)
  2265.         {
  2266.         default:
  2267.         case discard_all:
  2268.           output = false;
  2269.           break;
  2270.         case discard_l:
  2271.           if (bfd_asymbol_name (sym)[0] == info->lprefix[0]
  2272.               && (info->lprefix_len == 1
  2273.               || strncmp (bfd_asymbol_name (sym), info->lprefix,
  2274.                       info->lprefix_len) == 0))
  2275.             output = false;
  2276.           else
  2277.             output = true;
  2278.           break;
  2279.         case discard_none:
  2280.           output = true;
  2281.           break;
  2282.         }
  2283.         }
  2284.     }
  2285.       else if ((sym->flags & BSF_CONSTRUCTOR))
  2286.     {
  2287.       if (info->strip != strip_all)
  2288.         output = true;
  2289.       else
  2290.         output = false;
  2291.     }
  2292.       else
  2293.     abort ();
  2294.  
  2295.       if (output)
  2296.     {
  2297.       if (! generic_add_output_symbol (output_bfd, psymalloc, sym))
  2298.         return false;
  2299.       if (h != (struct generic_link_hash_entry *) NULL)
  2300.         h->written = true;
  2301.     }
  2302.     }
  2303.  
  2304.   return true;
  2305. }
  2306.  
  2307. /* Set the section and value of a generic BFD symbol based on a linker
  2308.    hash table entry.  */
  2309.  
  2310. static void
  2311. set_symbol_from_hash (sym, h)
  2312.      asymbol *sym;
  2313.      struct bfd_link_hash_entry *h;
  2314. {
  2315.   switch (h->type)
  2316.     {
  2317.     default:
  2318.       abort ();
  2319.       break;
  2320.     case bfd_link_hash_new:
  2321.       /* This can happen when a constructor symbol is seen but we are
  2322.          not building constructors.  */
  2323.       if (sym->section != NULL)
  2324.     {
  2325.       BFD_ASSERT ((sym->flags & BSF_CONSTRUCTOR) != 0);
  2326.     }
  2327.       else
  2328.     {
  2329.       sym->flags |= BSF_CONSTRUCTOR;
  2330.       sym->section = bfd_abs_section_ptr;
  2331.       sym->value = 0;
  2332.     }
  2333.       break;
  2334.     case bfd_link_hash_undefined:
  2335.       sym->section = bfd_und_section_ptr;
  2336.       sym->value = 0;
  2337.       break;
  2338.     case bfd_link_hash_undefweak:
  2339.       sym->section = bfd_und_section_ptr;
  2340.       sym->value = 0;
  2341.       sym->flags |= BSF_WEAK;
  2342.       break;
  2343.     case bfd_link_hash_defined:
  2344.       sym->section = h->u.def.section;
  2345.       sym->value = h->u.def.value;
  2346.       break;
  2347.     case bfd_link_hash_defweak:
  2348.       sym->flags |= BSF_WEAK;
  2349.       sym->section = h->u.def.section;
  2350.       sym->value = h->u.def.value;
  2351.       break;
  2352.     case bfd_link_hash_common:
  2353.       sym->value = h->u.c.size;
  2354.       if (sym->section == NULL)
  2355.     sym->section = bfd_com_section_ptr;
  2356.       else if (! bfd_is_com_section (sym->section))
  2357.     {
  2358.       BFD_ASSERT (bfd_is_und_section (sym->section));
  2359.       sym->section = bfd_com_section_ptr;
  2360.     }
  2361.       /* Do not set the section; see _bfd_generic_link_output_symbols.  */
  2362.       break;
  2363.     case bfd_link_hash_indirect:
  2364.     case bfd_link_hash_warning:
  2365.       /* FIXME: What should we do here?  */
  2366.       break;
  2367.     }
  2368. }
  2369.  
  2370. /* Write out a global symbol, if it hasn't already been written out.
  2371.    This is called for each symbol in the hash table.  */
  2372.  
  2373. boolean
  2374. _bfd_generic_link_write_global_symbol (h, data)
  2375.      struct generic_link_hash_entry *h;
  2376.      PTR data;
  2377. {
  2378.   struct generic_write_global_symbol_info *wginfo =
  2379.     (struct generic_write_global_symbol_info *) data;
  2380.   asymbol *sym;
  2381.  
  2382.   if (h->written)
  2383.     return true;
  2384.  
  2385.   h->written = true;
  2386.  
  2387.   if (wginfo->info->strip == strip_all
  2388.       || (wginfo->info->strip == strip_some
  2389.       && bfd_hash_lookup (wginfo->info->keep_hash, h->root.root.string,
  2390.                   false, false) == NULL))
  2391.     return true;
  2392.  
  2393.   if (h->sym != (asymbol *) NULL)
  2394.     sym = h->sym;
  2395.   else
  2396.     {
  2397.       sym = bfd_make_empty_symbol (wginfo->output_bfd);
  2398.       if (!sym)
  2399.     return false;
  2400.       sym->name = h->root.root.string;
  2401.       sym->flags = 0;
  2402.     }
  2403.  
  2404.   set_symbol_from_hash (sym, &h->root);
  2405.  
  2406.   sym->flags |= BSF_GLOBAL;
  2407.  
  2408.   if (! generic_add_output_symbol (wginfo->output_bfd, wginfo->psymalloc,
  2409.                    sym))
  2410.     {
  2411.       /* FIXME: No way to return failure.  */
  2412.       abort ();
  2413.     }
  2414.  
  2415.   return true;
  2416. }
  2417.  
  2418. /* Create a relocation.  */
  2419.  
  2420. boolean
  2421. _bfd_generic_reloc_link_order (abfd, info, sec, link_order)
  2422.      bfd *abfd;
  2423.      struct bfd_link_info *info;
  2424.      asection *sec;
  2425.      struct bfd_link_order *link_order;
  2426. {
  2427.   arelent *r;
  2428.  
  2429.   if (! info->relocateable)
  2430.     abort ();
  2431.   if (sec->orelocation == (arelent **) NULL)
  2432.     abort ();
  2433.  
  2434.   r = (arelent *) bfd_alloc (abfd, sizeof (arelent));
  2435.   if (r == (arelent *) NULL)
  2436.     return false;
  2437.       
  2438.   r->address = link_order->offset;
  2439.   r->howto = bfd_reloc_type_lookup (abfd, link_order->u.reloc.p->reloc);
  2440.   if (r->howto == 0)
  2441.     {
  2442.       bfd_set_error (bfd_error_bad_value);
  2443.       return false;
  2444.     }
  2445.  
  2446.   /* Get the symbol to use for the relocation.  */
  2447.   if (link_order->type == bfd_section_reloc_link_order)
  2448.     r->sym_ptr_ptr = link_order->u.reloc.p->u.section->symbol_ptr_ptr;
  2449.   else
  2450.     {
  2451.       struct generic_link_hash_entry *h;
  2452.  
  2453.       h = ((struct generic_link_hash_entry *)
  2454.        bfd_wrapped_link_hash_lookup (abfd, info,
  2455.                      link_order->u.reloc.p->u.name,
  2456.                      false, false, true));
  2457.       if (h == (struct generic_link_hash_entry *) NULL
  2458.       || ! h->written)
  2459.     {
  2460.       if (! ((*info->callbacks->unattached_reloc)
  2461.          (info, link_order->u.reloc.p->u.name,
  2462.           (bfd *) NULL, (asection *) NULL, (bfd_vma) 0)))
  2463.         return false;
  2464.       bfd_set_error (bfd_error_bad_value);
  2465.       return false;
  2466.     }
  2467.       r->sym_ptr_ptr = &h->sym;
  2468.     }
  2469.  
  2470.   /* If this is an inplace reloc, write the addend to the object file.
  2471.      Otherwise, store it in the reloc addend.  */
  2472.   if (! r->howto->partial_inplace)
  2473.     r->addend = link_order->u.reloc.p->addend;
  2474.   else
  2475.     {
  2476.       bfd_size_type size;
  2477.       bfd_reloc_status_type rstat;
  2478.       bfd_byte *buf;
  2479.       boolean ok;
  2480.  
  2481.       size = bfd_get_reloc_size (r->howto);
  2482.       buf = (bfd_byte *) bfd_zmalloc (size);
  2483.       if (buf == (bfd_byte *) NULL)
  2484.     return false;
  2485.       rstat = _bfd_relocate_contents (r->howto, abfd,
  2486.                       link_order->u.reloc.p->addend, buf);
  2487.       switch (rstat)
  2488.     {
  2489.     case bfd_reloc_ok:
  2490.       break;
  2491.     default:
  2492.     case bfd_reloc_outofrange:
  2493.       abort ();
  2494.     case bfd_reloc_overflow:
  2495.       if (! ((*info->callbacks->reloc_overflow)
  2496.          (info,
  2497.           (link_order->type == bfd_section_reloc_link_order
  2498.            ? bfd_section_name (abfd, link_order->u.reloc.p->u.section)
  2499.            : link_order->u.reloc.p->u.name),
  2500.           r->howto->name, link_order->u.reloc.p->addend,
  2501.           (bfd *) NULL, (asection *) NULL, (bfd_vma) 0)))
  2502.         {
  2503.           free (buf);
  2504.           return false;
  2505.         }
  2506.       break;
  2507.     }
  2508.       ok = bfd_set_section_contents (abfd, sec, (PTR) buf,
  2509.                      (file_ptr) link_order->offset, size);
  2510.       free (buf);
  2511.       if (! ok)
  2512.     return false;
  2513.  
  2514.       r->addend = 0;
  2515.     }
  2516.  
  2517.   sec->orelocation[sec->reloc_count] = r;
  2518.   ++sec->reloc_count;
  2519.  
  2520.   return true;
  2521. }
  2522.  
  2523. /* Allocate a new link_order for a section.  */
  2524.  
  2525. struct bfd_link_order *
  2526. bfd_new_link_order (abfd, section)
  2527.      bfd *abfd;
  2528.      asection *section;
  2529. {
  2530.   struct bfd_link_order *new;
  2531.  
  2532.   new = ((struct bfd_link_order *)
  2533.      bfd_alloc_by_size_t (abfd, sizeof (struct bfd_link_order)));
  2534.   if (!new)
  2535.     return NULL;
  2536.  
  2537.   new->type = bfd_undefined_link_order;
  2538.   new->offset = 0;
  2539.   new->size = 0;
  2540.   new->next = (struct bfd_link_order *) NULL;
  2541.  
  2542.   if (section->link_order_tail != (struct bfd_link_order *) NULL)
  2543.     section->link_order_tail->next = new;
  2544.   else
  2545.     section->link_order_head = new;
  2546.   section->link_order_tail = new;
  2547.  
  2548.   return new;
  2549. }
  2550.  
  2551. /* Default link order processing routine.  Note that we can not handle
  2552.    the reloc_link_order types here, since they depend upon the details
  2553.    of how the particular backends generates relocs.  */
  2554.  
  2555. boolean
  2556. _bfd_default_link_order (abfd, info, sec, link_order)
  2557.      bfd *abfd;
  2558.      struct bfd_link_info *info;
  2559.      asection *sec;
  2560.      struct bfd_link_order *link_order;
  2561. {
  2562.   switch (link_order->type)
  2563.     {
  2564.     case bfd_undefined_link_order:
  2565.     case bfd_section_reloc_link_order:
  2566.     case bfd_symbol_reloc_link_order:
  2567.     default:
  2568.       abort ();
  2569.     case bfd_indirect_link_order:
  2570.       return default_indirect_link_order (abfd, info, sec, link_order,
  2571.                       false);
  2572.     case bfd_fill_link_order:
  2573.       return default_fill_link_order (abfd, info, sec, link_order);
  2574.     case bfd_data_link_order:
  2575.       return bfd_set_section_contents (abfd, sec,
  2576.                        (PTR) link_order->u.data.contents,
  2577.                        (file_ptr) link_order->offset,
  2578.                        link_order->size);
  2579.     }
  2580. }
  2581.  
  2582. /* Default routine to handle a bfd_fill_link_order.  */
  2583.  
  2584. /*ARGSUSED*/
  2585. static boolean
  2586. default_fill_link_order (abfd, info, sec, link_order)
  2587.      bfd *abfd;
  2588.      struct bfd_link_info *info;
  2589.      asection *sec;
  2590.      struct bfd_link_order *link_order;
  2591. {
  2592.   size_t size;
  2593.   char *space;
  2594.   size_t i;
  2595.   int fill;
  2596.   boolean result;
  2597.  
  2598.   BFD_ASSERT ((sec->flags & SEC_HAS_CONTENTS) != 0);
  2599.  
  2600.   size = (size_t) link_order->size;
  2601.   space = (char *) bfd_malloc (size);
  2602.   if (space == NULL && size != 0)
  2603.     return false;
  2604.  
  2605.   fill = link_order->u.fill.value;
  2606.   for (i = 0; i < size; i += 2)
  2607.     space[i] = fill >> 8;
  2608.   for (i = 1; i < size; i += 2)
  2609.     space[i] = fill;
  2610.   result = bfd_set_section_contents (abfd, sec, space,
  2611.                      (file_ptr) link_order->offset,
  2612.                      link_order->size);
  2613.   free (space);
  2614.   return result;
  2615. }
  2616.  
  2617. /* Default routine to handle a bfd_indirect_link_order.  */
  2618.  
  2619. /*static*/ boolean
  2620. default_indirect_link_order (output_bfd, info, output_section, link_order,
  2621.                  generic_linker)
  2622.      bfd *output_bfd;
  2623.      struct bfd_link_info *info;
  2624.      asection *output_section;
  2625.      struct bfd_link_order *link_order;
  2626.      boolean generic_linker;
  2627. {
  2628.   asection *input_section;
  2629.   bfd *input_bfd;
  2630.   bfd_byte *contents = NULL;
  2631.   bfd_byte *new_contents;
  2632.  
  2633.   BFD_ASSERT ((output_section->flags & SEC_HAS_CONTENTS) != 0);
  2634.  
  2635.   if (link_order->size == 0)
  2636.     return true;
  2637.  
  2638.   input_section = link_order->u.indirect.section;
  2639.   input_bfd = input_section->owner;
  2640.  
  2641.   BFD_ASSERT (input_section->output_section == output_section);
  2642.   BFD_ASSERT (input_section->output_offset == link_order->offset);
  2643.   BFD_ASSERT (input_section->_cooked_size == link_order->size);
  2644.  
  2645.   if (info->relocateable
  2646.       && input_section->reloc_count > 0
  2647.       && output_section->orelocation == (arelent **) NULL)
  2648.     {
  2649.       /* Space has not been allocated for the output relocations.
  2650.      This can happen when we are called by a specific backend
  2651.      because somebody is attempting to link together different
  2652.      types of object files.  Handling this case correctly is
  2653.      difficult, and sometimes impossible.  */
  2654.       abort ();
  2655.     }
  2656.  
  2657.   if (! generic_linker)
  2658.     {
  2659.       asymbol **sympp;
  2660.       asymbol **symppend;
  2661.  
  2662.       /* Get the canonical symbols.  The generic linker will always
  2663.      have retrieved them by this point, but we are being called by
  2664.      a specific linker, presumably because we are linking
  2665.      different types of object files together.  */
  2666.       if (! generic_link_read_symbols (input_bfd))
  2667.     return false;
  2668.  
  2669.       /* Since we have been called by a specific linker, rather than
  2670.      the generic linker, the values of the symbols will not be
  2671.      right.  They will be the values as seen in the input file,
  2672.      not the values of the final link.  We need to fix them up
  2673.      before we can relocate the section.  */
  2674.       sympp = _bfd_generic_link_get_symbols (input_bfd);
  2675.       symppend = sympp + _bfd_generic_link_get_symcount (input_bfd);
  2676.       for (; sympp < symppend; sympp++)
  2677.     {
  2678.       asymbol *sym;
  2679.       struct bfd_link_hash_entry *h;
  2680.  
  2681.       sym = *sympp;
  2682.  
  2683.       if ((sym->flags & (BSF_INDIRECT
  2684.                  | BSF_WARNING
  2685.                  | BSF_GLOBAL
  2686.                  | BSF_CONSTRUCTOR
  2687.                  | BSF_WEAK)) != 0
  2688.           || bfd_is_und_section (bfd_get_section (sym))
  2689.           || bfd_is_com_section (bfd_get_section (sym))
  2690.           || bfd_is_ind_section (bfd_get_section (sym)))
  2691.         {
  2692.           /* sym->udata may have been set by
  2693.          generic_link_add_symbol_list.  */
  2694.           if (sym->udata.p != NULL)
  2695.         h = (struct bfd_link_hash_entry *) sym->udata.p;
  2696.           else if (bfd_is_und_section (bfd_get_section (sym)))
  2697.         h = bfd_wrapped_link_hash_lookup (output_bfd, info,
  2698.                           bfd_asymbol_name (sym),
  2699.                           false, false, true);
  2700.           else
  2701.         h = bfd_link_hash_lookup (info->hash,
  2702.                       bfd_asymbol_name (sym),
  2703.                       false, false, true);
  2704.           if (h != NULL)
  2705.         set_symbol_from_hash (sym, h);
  2706.         }
  2707.     }      
  2708.     }
  2709.  
  2710.   /* Get and relocate the section contents.  */
  2711.   contents = ((bfd_byte *)
  2712.           bfd_malloc (bfd_section_size (input_bfd, input_section)));
  2713.   if (contents == NULL && bfd_section_size (input_bfd, input_section) != 0)
  2714.     goto error_return;
  2715.   new_contents = (bfd_get_relocated_section_contents
  2716.           (output_bfd, info, link_order, contents, info->relocateable,
  2717.            _bfd_generic_link_get_symbols (input_bfd)));
  2718.   if (!new_contents)
  2719.     goto error_return;
  2720.  
  2721.   /* Output the section contents.  */
  2722.   if (! bfd_set_section_contents (output_bfd, output_section,
  2723.                   (PTR) new_contents,
  2724.                   link_order->offset, link_order->size))
  2725.     goto error_return;
  2726.  
  2727.   if (contents != NULL)
  2728.     free (contents);
  2729.   return true;
  2730.  
  2731.  error_return:
  2732.   if (contents != NULL)
  2733.     free (contents);
  2734.   return false;
  2735. }
  2736.  
  2737. /* A little routine to count the number of relocs in a link_order
  2738.    list.  */
  2739.  
  2740. unsigned int
  2741. _bfd_count_link_order_relocs (link_order)
  2742.      struct bfd_link_order *link_order;
  2743. {
  2744.   register unsigned int c;
  2745.   register struct bfd_link_order *l;
  2746.  
  2747.   c = 0;
  2748.   for (l = link_order; l != (struct bfd_link_order *) NULL; l = l->next)
  2749.     {
  2750.       if (l->type == bfd_section_reloc_link_order
  2751.       || l->type == bfd_symbol_reloc_link_order)
  2752.     ++c;
  2753.     }
  2754.  
  2755.   return c;
  2756. }
  2757.  
  2758. /*
  2759. FUNCTION
  2760.     bfd_link_split_section
  2761.  
  2762. SYNOPSIS
  2763.         boolean bfd_link_split_section(bfd *abfd, asection *sec);
  2764.  
  2765. DESCRIPTION
  2766.     Return nonzero if @var{sec} should be split during a
  2767.     reloceatable or final link.
  2768.  
  2769. .#define bfd_link_split_section(abfd, sec) \
  2770. .       BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
  2771. .
  2772.  
  2773. */
  2774.  
  2775.  
  2776.  
  2777. boolean
  2778. _bfd_generic_link_split_section (abfd, sec)
  2779.      bfd *abfd;
  2780.      asection *sec;
  2781. {
  2782.   return false;
  2783. }
  2784.