About this book

ARM® Compiler armlink User Guide provides user information for the ARM linker, armlink. It describes the basic linker functionality, image structure, BPABI and SysV support, GNU ld script support, how to access image symbols, and how to use scatter files.

Using this book

This book is organized into the following chapters:

Chapter 1 Overview of the Linker

Gives an overview of the ARM linker, armlink.

Chapter 2 Linking Models Supported by armlink

Describes the linking models supported by the ARM linker, armlink.

Chapter 3 Image Structure and Generation

Describes the image structure and the functionality available in the ARM linker, armlink, to generate images.

Chapter 4 Linker Optimization Features

Describes the optimization features available in the ARM linker, armlink.

Chapter 5 Getting Image Details

Describes how to get image details from the ARM linker, armlink.

Chapter 6 Accessing and Managing Symbols with armlink

Describes how to access and manage symbols with the ARM linker, armlink.

Chapter 7 Scatter-loading Features

Describes the scatter-loading features and how you use scatter files with the ARM linker, armlink, to create complex images.

Chapter 8 Scatter File Syntax

Describes the format of scatter files.

Chapter 9 GNU ld Script Support in armlink

Describes the GNU ld script support in the ARM linker, armlink.

Chapter 10 BPABI and SysV Shared Libraries and Executables

Describes how the ARM® linker, armlink, supports the Base Platform Application Binary Interface (BPABI) and System V (SysV) shared libraries and executables.

Chapter 11 Features of the Base Platform Linking Model

Describes features of the Base Platform linking model supported by the ARM® linker, armlink.

Chapter 12 Linker Command-line Options

Describes the command-line options supported by the ARM linker, armlink.

Chapter 13 Linker Steering File Command Reference

Describes the steering file commands supported by the ARM linker, armlink.

Chapter 14 Via File Syntax

Describes the syntax of via files accepted by armlink.

Appendix A armlink Document Revisions

Describes the technical changes that have been made to the armlink User Guide.


The ARM Glossary is a list of terms used in ARM documentation, together with definitions for those terms. The ARM Glossary does not contain terms that are industry standard unless the ARM meaning differs from the generally accepted meaning.

See the ARM Glossary for more information.

Typographic conventions

Introduces special terminology, denotes cross-references, and citations.
Highlights interface elements, such as menu names. Denotes signal names. Also used for terms in descriptive lists, where appropriate.
Denotes text that you can enter at the keyboard, such as commands, file and program names, and source code.
Denotes a permitted abbreviation for a command or option. You can enter the underlined text instead of the full command or option name.
monospace italic
Denotes arguments to monospace text where the argument is to be replaced by a specific value.
monospace bold
Denotes language keywords when used outside example code.
Encloses replaceable terms for assembler syntax where they appear in code or code fragments. For example:
MRC p15, 0, <Rd>, <CRn>, <CRm>, <Opcode_2>
Used in body text for a few terms that have specific technical meanings, that are defined in the ARM glossary. For example, IMPLEMENTATION DEFINED, IMPLEMENTATION SPECIFIC, UNKNOWN, and UNPREDICTABLE.


Feedback on this product

If you have any comments or suggestions about this product, contact your supplier and give:

  • The product name.
  • The product revision or version.
  • An explanation with as much information as you can provide. Include symptoms and diagnostic procedures if appropriate.
Feedback on content

If you have comments on content then send an e-mail to errata@arm.com. Give:

  • The title ARM® Compiler armlink User Guide .
  • The number ARM DUI0474M.
  • If applicable, the page number(s) to which your comments refer.
  • A concise explanation of your comments.

ARM also welcomes general suggestions for additions and improvements.


ARM tests the PDF only in Adobe Acrobat and Acrobat Reader, and cannot guarantee the quality of the represented document when used with any other PDF reader.

Other information

Non-ConfidentialPDF file icon PDF versionARM DUI0474M
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.