Table of Contents

1. Overview
2. Invocation

2.1 Command Line Options

2.1.1 Options specific to i386 PE targets

2.2 Environment Variables

3. Linker Scripts

3.1 Basic Linker Script Concepts
3.2 Linker Script Format
3.3 Simple Linker Script Example
3.4 Simple Linker Script Commands

3.4.1 Setting the entry point
3.4.2 Commands dealing with files
3.4.3 Commands dealing with object file formats
3.4.4 Other linker script commands

3.5 Assigning Values to Symbols

3.5.1 Simple Assignments
3.5.2 PROVIDE

3.6 SECTIONS command

3.6.1 Output section description
3.6.2 Output section name
3.6.3 Output section address
3.6.4 Input section description

3.6.4.1 Input section basics
3.6.4.2 Input section wildcard patterns
3.6.4.3 Input section for common symbols
3.6.4.4 Input section and garbage collection
3.6.4.5 Input section example

3.6.5 Output section data
3.6.6 Output section keywords
3.6.7 Output section discarding
3.6.8 Output section attributes

3.6.8.1 Output section type
3.6.8.2 Output section LMA
3.6.8.3 Output section region
3.6.8.4 Output section phdr
3.6.8.5 Output section fill

3.6.9 Overlay description

3.7 MEMORY command
3.8 PHDRS Command
3.9 VERSION Command
3.10 Expressions in Linker Scripts

3.10.1 Constants
3.10.2 Symbol Names
3.10.3 The Location Counter
3.10.4 Operators
3.10.5 Evaluation
3.10.6 The Section of an Expression
3.10.7 Builtin Functions

3.11 Implicit Linker Scripts

4. Machine Dependent Features

4.1 ld and the H8/300
4.2 ld and the Intel 960 family
4.3 ld's support for interworking between ARM and Thumb code

5. BFD

5.1 How it works: an outline of BFD

5.1.1 Information Loss
5.1.2 The BFD canonical object-file format

6. Reporting Bugs

6.1 Have you found a bug?
6.2 How to report bugs

A. MRI Compatible Script Files
Index