| <html lang="en"> |
| <head> |
| <title>Untitled</title> |
| <meta http-equiv="Content-Type" content="text/html"> |
| <meta name="description" content="Untitled"> |
| <meta name="generator" content="makeinfo 4.13"> |
| <link title="Top" rel="start" href="#Top"> |
| <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> |
| <!-- |
| This file documents the GNU linker LD |
| (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10)) |
| version 2.33.1. |
| |
| Copyright (C) 1991-2019 Free Software Foundation, Inc. |
| |
| Permission is granted to copy, distribute and/or modify this document |
| under the terms of the GNU Free Documentation License, Version 1.3 |
| or any later version published by the Free Software Foundation; |
| with no Invariant Sections, with no Front-Cover Texts, and with no |
| Back-Cover Texts. A copy of the license is included in the |
| section entitled "GNU Free Documentation License".--> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <style type="text/css"><!-- |
| pre.display { font-family:inherit } |
| pre.format { font-family:inherit } |
| pre.smalldisplay { font-family:inherit; font-size:smaller } |
| pre.smallformat { font-family:inherit; font-size:smaller } |
| pre.smallexample { font-size:smaller } |
| pre.smalllisp { font-size:smaller } |
| span.sc { font-variant:small-caps } |
| span.roman { font-family:serif; font-weight:normal; } |
| span.sansserif { font-family:sans-serif; font-weight:normal; } |
| --></style> |
| </head> |
| <body> |
| <div class="contents"> |
| <h2>Table of Contents</h2> |
| <ul> |
| <li><a name="toc_Top" href="index.html#Top">LD</a> |
| <li><a name="toc_Overview" href="Overview.html#Overview">1 Overview</a> |
| <li><a name="toc_Invocation" href="Invocation.html#Invocation">2 Invocation</a> |
| <ul> |
| <li><a href="Options.html#Options">2.1 Command-line Options</a> |
| <ul> |
| <li><a href="Options.html#Options">2.1.1 Options Specific to i386 PE Targets</a> |
| <li><a href="Options.html#Options">2.1.2 Options specific to C6X uClinux targets</a> |
| <li><a href="Options.html#Options">2.1.3 Options specific to C-SKY targets</a> |
| <li><a href="Options.html#Options">2.1.4 Options specific to Motorola 68HC11 and 68HC12 targets</a> |
| <li><a href="Options.html#Options">2.1.5 Options specific to Motorola 68K target</a> |
| <li><a href="Options.html#Options">2.1.6 Options specific to MIPS targets</a> |
| </li></ul> |
| <li><a href="Environment.html#Environment">2.2 Environment Variables</a> |
| </li></ul> |
| <li><a name="toc_Scripts" href="Scripts.html#Scripts">3 Linker Scripts</a> |
| <ul> |
| <li><a href="Basic-Script-Concepts.html#Basic-Script-Concepts">3.1 Basic Linker Script Concepts</a> |
| <li><a href="Script-Format.html#Script-Format">3.2 Linker Script Format</a> |
| <li><a href="Simple-Example.html#Simple-Example">3.3 Simple Linker Script Example</a> |
| <li><a href="Simple-Commands.html#Simple-Commands">3.4 Simple Linker Script Commands</a> |
| <ul> |
| <li><a href="Entry-Point.html#Entry-Point">3.4.1 Setting the Entry Point</a> |
| <li><a href="File-Commands.html#File-Commands">3.4.2 Commands Dealing with Files</a> |
| <li><a href="Format-Commands.html#Format-Commands">3.4.3 Commands Dealing with Object File Formats</a> |
| <li><a href="REGION_005fALIAS.html#REGION_005fALIAS">3.4.4 Assign alias names to memory regions</a> |
| <li><a href="Miscellaneous-Commands.html#Miscellaneous-Commands">3.4.5 Other Linker Script Commands</a> |
| </li></ul> |
| <li><a href="Assignments.html#Assignments">3.5 Assigning Values to Symbols</a> |
| <ul> |
| <li><a href="Simple-Assignments.html#Simple-Assignments">3.5.1 Simple Assignments</a> |
| <li><a href="HIDDEN.html#HIDDEN">3.5.2 HIDDEN</a> |
| <li><a href="PROVIDE.html#PROVIDE">3.5.3 PROVIDE</a> |
| <li><a href="PROVIDE_005fHIDDEN.html#PROVIDE_005fHIDDEN">3.5.4 PROVIDE_HIDDEN</a> |
| <li><a href="Source-Code-Reference.html#Source-Code-Reference">3.5.5 Source Code Reference</a> |
| </li></ul> |
| <li><a href="SECTIONS.html#SECTIONS">3.6 SECTIONS Command</a> |
| <ul> |
| <li><a href="Output-Section-Description.html#Output-Section-Description">3.6.1 Output Section Description</a> |
| <li><a href="Output-Section-Name.html#Output-Section-Name">3.6.2 Output Section Name</a> |
| <li><a href="Output-Section-Address.html#Output-Section-Address">3.6.3 Output Section Address</a> |
| <li><a href="Input-Section.html#Input-Section">3.6.4 Input Section Description</a> |
| <ul> |
| <li><a href="Input-Section-Basics.html#Input-Section-Basics">3.6.4.1 Input Section Basics</a> |
| <li><a href="Input-Section-Wildcards.html#Input-Section-Wildcards">3.6.4.2 Input Section Wildcard Patterns</a> |
| <li><a href="Input-Section-Common.html#Input-Section-Common">3.6.4.3 Input Section for Common Symbols</a> |
| <li><a href="Input-Section-Keep.html#Input-Section-Keep">3.6.4.4 Input Section and Garbage Collection</a> |
| <li><a href="Input-Section-Example.html#Input-Section-Example">3.6.4.5 Input Section Example</a> |
| </li></ul> |
| <li><a href="Output-Section-Data.html#Output-Section-Data">3.6.5 Output Section Data</a> |
| <li><a href="Output-Section-Keywords.html#Output-Section-Keywords">3.6.6 Output Section Keywords</a> |
| <li><a href="Output-Section-Discarding.html#Output-Section-Discarding">3.6.7 Output Section Discarding</a> |
| <li><a href="Output-Section-Attributes.html#Output-Section-Attributes">3.6.8 Output Section Attributes</a> |
| <ul> |
| <li><a href="Output-Section-Type.html#Output-Section-Type">3.6.8.1 Output Section Type</a> |
| <li><a href="Output-Section-LMA.html#Output-Section-LMA">3.6.8.2 Output Section LMA</a> |
| <li><a href="Forced-Output-Alignment.html#Forced-Output-Alignment">3.6.8.3 Forced Output Alignment</a> |
| <li><a href="Forced-Input-Alignment.html#Forced-Input-Alignment">3.6.8.4 Forced Input Alignment</a> |
| <li><a href="Output-Section-Constraint.html#Output-Section-Constraint">3.6.8.5 Output Section Constraint</a> |
| <li><a href="Output-Section-Region.html#Output-Section-Region">3.6.8.6 Output Section Region</a> |
| <li><a href="Output-Section-Phdr.html#Output-Section-Phdr">3.6.8.7 Output Section Phdr</a> |
| <li><a href="Output-Section-Fill.html#Output-Section-Fill">3.6.8.8 Output Section Fill</a> |
| </li></ul> |
| <li><a href="Overlay-Description.html#Overlay-Description">3.6.9 Overlay Description</a> |
| </li></ul> |
| <li><a href="MEMORY.html#MEMORY">3.7 MEMORY Command</a> |
| <li><a href="PHDRS.html#PHDRS">3.8 PHDRS Command</a> |
| <li><a href="VERSION.html#VERSION">3.9 VERSION Command</a> |
| <li><a href="Expressions.html#Expressions">3.10 Expressions in Linker Scripts</a> |
| <ul> |
| <li><a href="Constants.html#Constants">3.10.1 Constants</a> |
| <li><a href="Symbolic-Constants.html#Symbolic-Constants">3.10.2 Symbolic Constants</a> |
| <li><a href="Symbols.html#Symbols">3.10.3 Symbol Names</a> |
| <li><a href="Orphan-Sections.html#Orphan-Sections">3.10.4 Orphan Sections</a> |
| <li><a href="Location-Counter.html#Location-Counter">3.10.5 The Location Counter</a> |
| <li><a href="Operators.html#Operators">3.10.6 Operators</a> |
| <li><a href="Evaluation.html#Evaluation">3.10.7 Evaluation</a> |
| <li><a href="Expression-Section.html#Expression-Section">3.10.8 The Section of an Expression</a> |
| <li><a href="Builtin-Functions.html#Builtin-Functions">3.10.9 Builtin Functions</a> |
| </li></ul> |
| <li><a href="Implicit-Linker-Scripts.html#Implicit-Linker-Scripts">3.11 Implicit Linker Scripts</a> |
| </li></ul> |
| <li><a name="toc_Machine-Dependent" href="Machine-Dependent.html#Machine-Dependent">4 Machine Dependent Features</a> |
| <ul> |
| <li><a href="H8_002f300.html#H8_002f300">4.1 <samp><span class="command">ld</span></samp> and the H8/300</a> |
| <li><a href="M68HC11_002f68HC12.html#M68HC11_002f68HC12">4.2 <samp><span class="command">ld</span></samp> and the Motorola 68HC11 and 68HC12 families</a> |
| <ul> |
| <li><a href="M68HC11_002f68HC12.html#M68HC11_002f68HC12">4.2.1 Linker Relaxation</a> |
| <li><a href="M68HC11_002f68HC12.html#M68HC11_002f68HC12">4.2.2 Trampoline Generation</a> |
| </li></ul> |
| <li><a href="ARM.html#ARM">4.3 <samp><span class="command">ld</span></samp> and the ARM family</a> |
| <li><a href="HPPA-ELF32.html#HPPA-ELF32">4.4 <samp><span class="command">ld</span></samp> and HPPA 32-bit ELF Support</a> |
| <li><a href="M68K.html#M68K">4.5 <samp><span class="command">ld</span></samp> and the Motorola 68K family</a> |
| <li><a href="MIPS.html#MIPS">4.6 <samp><span class="command">ld</span></samp> and the MIPS family</a> |
| <li><a href="MMIX.html#MMIX">4.7 <code>ld</code> and MMIX</a> |
| <li><a href="MSP430.html#MSP430">4.8 <code>ld</code> and MSP430</a> |
| <li><a href="NDS32.html#NDS32">4.9 <code>ld</code> and NDS32</a> |
| <li><a href="Nios-II.html#Nios-II">4.10 <samp><span class="command">ld</span></samp> and the Altera Nios II</a> |
| <li><a href="PowerPC-ELF32.html#PowerPC-ELF32">4.11 <samp><span class="command">ld</span></samp> and PowerPC 32-bit ELF Support</a> |
| <li><a href="PowerPC64-ELF64.html#PowerPC64-ELF64">4.12 <samp><span class="command">ld</span></samp> and PowerPC64 64-bit ELF Support</a> |
| <li><a href="S_002f390-ELF.html#S_002f390-ELF">4.13 <samp><span class="command">ld</span></samp> and S/390 ELF Support</a> |
| <li><a href="SPU-ELF.html#SPU-ELF">4.14 <samp><span class="command">ld</span></samp> and SPU ELF Support</a> |
| <li><a href="TI-COFF.html#TI-COFF">4.15 <samp><span class="command">ld</span></samp>'s Support for Various TI COFF Versions</a> |
| <li><a href="WIN32.html#WIN32">4.16 <samp><span class="command">ld</span></samp> and WIN32 (cygwin/mingw)</a> |
| <li><a href="Xtensa.html#Xtensa">4.17 <code>ld</code> and Xtensa Processors</a> |
| </li></ul> |
| <li><a name="toc_BFD" href="BFD.html#BFD">5 BFD</a> |
| <ul> |
| <li><a href="BFD-outline.html#BFD-outline">5.1 How It Works: An Outline of BFD</a> |
| <ul> |
| <li><a href="BFD-information-loss.html#BFD-information-loss">5.1.1 Information Loss</a> |
| <li><a href="Canonical-format.html#Canonical-format">5.1.2 The BFD canonical object-file format</a> |
| </li></ul> |
| </li></ul> |
| <li><a name="toc_Reporting-Bugs" href="Reporting-Bugs.html#Reporting-Bugs">6 Reporting Bugs</a> |
| <ul> |
| <li><a href="Bug-Criteria.html#Bug-Criteria">6.1 Have You Found a Bug?</a> |
| <li><a href="Bug-Reporting.html#Bug-Reporting">6.2 How to Report Bugs</a> |
| </li></ul> |
| <li><a name="toc_MRI" href="MRI.html#MRI">Appendix A MRI Compatible Script Files</a> |
| <li><a name="toc_GNU-Free-Documentation-License" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">Appendix B GNU Free Documentation License</a> |
| <li><a name="toc_LD-Index" href="LD-Index.html#LD-Index">LD Index</a> |
| </li></ul> |
| </div> |
| |
| |
| |
| <!-- FIXME: Talk about importance of *order* of args, cmds to linker! --> |
| <div class="node"> |
| <a name="Top"></a> |
| <p> |
| Next: <a rel="next" accesskey="n" href="Overview.html#Overview">Overview</a>, |
| Up: <a rel="up" accesskey="u" href="../index.html#dir">(dir)</a> |
| <hr> |
| </div> |
| |
| <h2 class="unnumbered">LD</h2> |
| |
| <p>This file documents the <span class="sc">gnu</span> linker ld |
| (GNU Toolchain for the A-profile Architecture 9.2-2019.12 (arm-9.10)) |
| version 2.33.1. |
| |
| <p>This document is distributed under the terms of the GNU Free |
| Documentation License version 1.3. A copy of the license is included |
| in the section entitled “GNU Free Documentation License”. |
| |
| <ul class="menu"> |
| <li><a accesskey="1" href="Overview.html#Overview">Overview</a>: Overview |
| <li><a accesskey="2" href="Invocation.html#Invocation">Invocation</a>: Invocation |
| <li><a accesskey="3" href="Scripts.html#Scripts">Scripts</a>: Linker Scripts |
| |
| <li><a accesskey="4" href="Machine-Dependent.html#Machine-Dependent">Machine Dependent</a>: Machine Dependent Features |
| |
| <li><a accesskey="5" href="BFD.html#BFD">BFD</a>: BFD |
| <!-- Following blank line required for remaining bug in makeinfo conds/menus --> |
| |
| <li><a accesskey="6" href="Reporting-Bugs.html#Reporting-Bugs">Reporting Bugs</a>: Reporting Bugs |
| <li><a accesskey="7" href="MRI.html#MRI">MRI</a>: MRI Compatible Script Files |
| <li><a accesskey="8" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>: GNU Free Documentation License |
| <li><a accesskey="9" href="LD-Index.html#LD-Index">LD Index</a>: LD Index |
| </ul> |
| |
| </body></html> |
| |
