visus
/
toolchain-gcc-arm-embedded
Obserwuj 1
Polub 0
Forkuj 0
Kod Zgłoszenia 0 Oczekujące zmiany 0 Wydania 0 Wiki Aktywność
Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.
2 Commity
1 Gałąź
Gałąź: main
Gałęzie Tagi
${ item.name }
Utwórz gałąź ${ searchTerm }
z 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/bfd.html/Adding-symbols-from-an-arch...

133 lines
6.6KB
Czysty Bezpośredni odnośnik Wina Historia 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- This file documents the BFD library.

  4. 

  5. Copyright (C) 1991-2020 Free Software Foundation, Inc.

  6. 

  7. Permission is granted to copy, distribute and/or modify this document

  8. under the terms of the GNU Free Documentation License, Version 1.3 or

  9. any later version published by the Free Software Foundation; with the

  10. Invariant Sections being "GNU General Public License" and "Funding

  11. Free Software", the Front-Cover texts being (a) (see below), and with

  12. the Back-Cover Texts being (b) (see below).  A copy of the license is

  13. included in the section entitled "GNU Free Documentation License".

  14. 

  15. (a) The FSF's Front-Cover Text is:

  16. 

  17. A GNU Manual

  18. 

  19. (b) The FSF's Back-Cover Text is:

  20. 

  21. You have freedom to copy and modify this GNU Manual, like GNU

  22.      software.  Copies published by the Free Software Foundation raise

  23.      funds for GNU development. -->

  24. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  25. <head>

  26. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  27. <title>Adding symbols from an archive (Untitled Document)</title>

  28. 

  29. <meta name="description" content="Adding symbols from an archive (Untitled Document)">

  30. <meta name="keywords" content="Adding symbols from an archive (Untitled Document)">

  31. <meta name="resource-type" content="document">

  32. <meta name="distribution" content="global">

  33. <meta name="Generator" content="makeinfo">

  34. <link href="index.html#Top" rel="start" title="Top">

  35. <link href="BFD-Index.html#BFD-Index" rel="index" title="BFD Index">

  36. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  37. <link href="Adding-Symbols-to-the-Hash-Table.html#Adding-Symbols-to-the-Hash-Table" rel="up" title="Adding Symbols to the Hash Table">

  38. <link href="Performing-the-Final-Link.html#Performing-the-Final-Link" rel="next" title="Performing the Final Link">

  39. <link href="Adding-symbols-from-an-object-file.html#Adding-symbols-from-an-object-file" rel="prev" title="Adding symbols from an object file">

  40. <style type="text/css">

  41. <!--

  42. a.summary-letter {text-decoration: none}

  43. blockquote.indentedblock {margin-right: 0em}

  44. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  45. blockquote.smallquotation {font-size: smaller}

  46. div.display {margin-left: 3.2em}

  47. div.example {margin-left: 3.2em}

  48. div.lisp {margin-left: 3.2em}

  49. div.smalldisplay {margin-left: 3.2em}

  50. div.smallexample {margin-left: 3.2em}

  51. div.smalllisp {margin-left: 3.2em}

  52. kbd {font-style: oblique}

  53. pre.display {font-family: inherit}

  54. pre.format {font-family: inherit}

  55. pre.menu-comment {font-family: serif}

  56. pre.menu-preformatted {font-family: serif}

  57. pre.smalldisplay {font-family: inherit; font-size: smaller}

  58. pre.smallexample {font-size: smaller}

  59. pre.smallformat {font-family: inherit; font-size: smaller}

  60. pre.smalllisp {font-size: smaller}

  61. span.nolinebreak {white-space: nowrap}

  62. span.roman {font-family: initial; font-weight: normal}

  63. span.sansserif {font-family: sans-serif; font-weight: normal}

  64. ul.no-bullet {list-style: none}

  65. -->

  66. </style>

  67. 

  68. 

  69. </head>

  70. 

  71. <body lang="en">

  72. <a name="Adding-symbols-from-an-archive"></a>

  73. <div class="header">

  74. <p>

  75. Previous: <a href="Adding-symbols-from-an-object-file.html#Adding-symbols-from-an-object-file" accesskey="p" rel="prev">Adding symbols from an object file</a>, Up: <a href="Adding-Symbols-to-the-Hash-Table.html#Adding-Symbols-to-the-Hash-Table" accesskey="u" rel="up">Adding Symbols to the Hash Table</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p>

  76. </div>

  77. <hr>

  78. <a name="Adding-symbols-from-an-archive-1"></a>

  79. <h4 class="subsubsection">2.17.2.3 Adding symbols from an archive</h4>

  80. <p>When the <code>_bfd_link_add_symbols</code> routine is passed an

  81. archive, it must look through the symbols defined by the

  82. archive and decide which elements of the archive should be

  83. included in the link.  For each such element it must call the

  84. <code>add_archive_element</code> linker callback, and it must add the

  85. symbols from the object file to the linker hash table.  (The

  86. callback may in fact indicate that a replacement BFD should be

  87. used, in which case the symbols from that BFD should be added

  88. to the linker hash table instead.)

  89. </p>

  90. <a name="index-_005fbfd_005fgeneric_005flink_005fadd_005farchive_005fsymbols"></a>

  91. <p>In most cases the work of looking through the symbols in the

  92. archive should be done by the

  93. <code>_bfd_generic_link_add_archive_symbols</code> function.

  94. <code>_bfd_generic_link_add_archive_symbols</code> is passed a function

  95. to call to make the final decision about adding an archive

  96. element to the link and to do the actual work of adding the

  97. symbols to the linker hash table.  If the element is to

  98. be included, the <code>add_archive_element</code> linker callback

  99. routine must be called with the element as an argument, and

  100. the element&rsquo;s symbols must be added to the linker hash table

  101. just as though the element had itself been passed to the

  102. <code>_bfd_link_add_symbols</code> function.

  103. </p>

  104. <p>When the a.out <code>_bfd_link_add_symbols</code> function receives an

  105. archive, it calls <code>_bfd_generic_link_add_archive_symbols</code>

  106. passing <code>aout_link_check_archive_element</code> as the function

  107. argument. <code>aout_link_check_archive_element</code> calls

  108. <code>aout_link_check_ar_symbols</code>.  If the latter decides to add

  109. the element (an element is only added if it provides a real,

  110. non-common, definition for a previously undefined or common

  111. symbol) it calls the <code>add_archive_element</code> callback and then

  112. <code>aout_link_check_archive_element</code> calls

  113. <code>aout_link_add_symbols</code> to actually add the symbols to the

  114. linker hash table - possibly those of a substitute BFD, if the

  115. <code>add_archive_element</code> callback avails itself of that option.

  116. </p>

  117. <p>The ECOFF back end is unusual in that it does not normally

  118. call <code>_bfd_generic_link_add_archive_symbols</code>, because ECOFF

  119. archives already contain a hash table of symbols.  The ECOFF

  120. back end searches the archive itself to avoid the overhead of

  121. creating a new hash table.

  122. </p>

  123. <hr>

  124. <div class="header">

  125. <p>

  126. Previous: <a href="Adding-symbols-from-an-object-file.html#Adding-symbols-from-an-object-file" accesskey="p" rel="prev">Adding symbols from an object file</a>, Up: <a href="Adding-Symbols-to-the-Hash-Table.html#Adding-Symbols-to-the-Hash-Table" accesskey="u" rel="up">Adding Symbols to the Hash Table</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p>

  127. </div>

  128. 

  129. 

  130. 

  131. </body>

  132. </html>