visus
/
toolchain-gcc-arm-embedded
Segui 1
Vota 0
Forka 0
Codice Problemi 0 Pull Requests 0 Rilasci 0 Wiki Attività
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commit
1 Ramo (Branch)
Ramo (Branch): main
Rami (Branch) Tag
${ item.name }
Crea branch ${ searchTerm }
da 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/ld.html/Orphan-Sections.html

105 lines
4.6KB
Originale Permalink Blame Cronologia 

  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 GNU linker LD

  4. (GNU Arm Embedded Toolchain 10-2020-q4-major)

  5. version 2.35.1.

  6. 

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

  8. 

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

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

  11. or any later version published by the Free Software Foundation;

  12. with no Invariant Sections, with no Front-Cover Texts, and with no

  13. Back-Cover Texts.  A copy of the license is included in the

  14. section entitled "GNU Free Documentation License". -->

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

  16. <head>

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

  18. <title>Orphan Sections (LD)</title>

  19. 

  20. <meta name="description" content="Orphan Sections (LD)">

  21. <meta name="keywords" content="Orphan Sections (LD)">

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

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

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

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

  26. <link href="LD-Index.html#LD-Index" rel="index" title="LD Index">

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

  28. <link href="Expressions.html#Expressions" rel="up" title="Expressions">

  29. <link href="Location-Counter.html#Location-Counter" rel="next" title="Location Counter">

  30. <link href="Symbols.html#Symbols" rel="prev" title="Symbols">

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

  32. <!--

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

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

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

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

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

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

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

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

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

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

  43. kbd {font-style: oblique}

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

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

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

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

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

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

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

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

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

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

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

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

  56. -->

  57. </style>

  58. 

  59. 

  60. </head>

  61. 

  62. <body lang="en">

  63. <a name="Orphan-Sections"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="Location-Counter.html#Location-Counter" accesskey="n" rel="next">Location Counter</a>, Previous: <a href="Symbols.html#Symbols" accesskey="p" rel="prev">Symbols</a>, Up: <a href="Expressions.html#Expressions" accesskey="u" rel="up">Expressions</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LD-Index.html#LD-Index" title="Index" rel="index">Index</a>]</p>

  67. </div>

  68. <hr>

  69. <a name="Orphan-Sections-1"></a>

  70. <h4 class="subsection">3.10.4 Orphan Sections</h4>

  71. <a name="index-orphan"></a>

  72. <p>Orphan sections are sections present in the input files which

  73. are not explicitly placed into the output file by the linker

  74. script.  The linker will still copy these sections into the

  75. output file by either finding, or creating a suitable output section

  76. in which to place the orphaned input section.

  77. </p>

  78. <p>If the name of an orphaned input section exactly matches the name of

  79. an existing output section, then the orphaned input section will be

  80. placed at the end of that output section.

  81. </p>

  82. <p>If there is no output section with a matching name then new output

  83. sections will be created.  Each new output section will have the same

  84. name as the orphan section placed within it.  If there are multiple

  85. orphan sections with the same name, these will all be combined into

  86. one new output section.

  87. </p>

  88. <p>If new output sections are created to hold orphaned input sections,

  89. then the linker must decide where to place these new output sections

  90. in relation to existing output sections.  On most modern targets, the

  91. linker attempts to place orphan sections after sections of the same

  92. attribute, such as code vs data, loadable vs non-loadable, etc.  If no

  93. sections with matching attributes are found, or your target lacks this

  94. support, the orphan section is placed at the end of the file.

  95. </p>

  96. <p>The command-line options &lsquo;<samp>--orphan-handling</samp>&rsquo; and &lsquo;<samp>--unique</samp>&rsquo;

  97. (see <a href="Options.html#Options">Command-line Options</a>) can be used to control which

  98. output sections an orphan is placed in.

  99. </p>

  100. 

  101. 

  102. 

  103. </body>

  104. </html>