Copyright © 2001 ARM Limited. All rights reserved.
ARM DUI 0151A
ARM
®
Developer Suite
Version 1.2
Linker and Utilities Guide
ii Copyright © 2001 ARM Limited. All rights reserved. ARM DUI 0151A
ARM Developer Suite
Linker and Utilities Guide
Copyright © 2001 ARM Limited. All rights reserved.
Release Information
Proprietary Notice
Words and logos marked with
®
or
™
are registered trademarks or trademarks owned by ARM Limited. Other
brands and names mentioned herein may be the trademarks of their respective owners.
Neither the whole nor any part of the information contained in, or the product described in, this document
may be adapted or reproduced in any material form except with the prior written permission of the copyright
holder.
The product described in this document is subject to continuous developments and improvements. All
particulars of the product and its use contained in this document are given by ARM in good faith. However,
all warranties implied or expressed, including but not limited to implied warranties of merchantability, or
fitness for purpose, are excluded.
This document is intended only to assist the reader in the use of the product. ARM Limited shall not be liable
for any loss or damage arising from the use of any information in this document, or any error or omission in
such information, or any incorrect use of the product.
Change History
Date Issue Change
November 2001 A ADS Release 1.2
ARM DUI 0151A Copyright © 2001 ARM Limited. All rights reserved. iii
Contents
ARM Developer Suite Linker and Utilities Guide
Preface
About this book .............................................................................................. vi
Feedback ....................................................................................................... ix
Chapter 1 Introduction
1.1 About the linker and utilities ........................................................................ 1-2
Chapter 2 The armlink Command Syntax
2.1 About armlink .............................................................................................. 2-2
2.2 armlink command syntax ............................................................................ 2-8
Chapter 3 Using the Basic Linker Functionality
3.1 Specifying the image structure .................................................................... 3-2
3.2 Section placement ...................................................................................... 3-8
3.3 Optimizations and modifications ............................................................... 3-12
3.4 Using command-line options to create simple images .............................. 3-14
Chapter 4 Accessing Image Symbols
4.1 Accessing linker-defined symbols ............................................................... 4-2
4.2 Accessing symbols in another image .......................................................... 4-5
4.3 Hiding and renaming global symbols .......................................................... 4-9
4.4 Using $Super$$ and $Sub$$ to overide symbol definitions ...................... 4-12
Contents
iv Copyright © 2001 ARM Limited. All rights reserved. ARM DUI 0151A
Chapter 5 Using Scatter-loading description files
5.1 About scatter-loading .................................................................................. 5-2
5.2 The formal syntax of the scatter-loading description file ............................ 5-7
5.3 Examples of specifying region and section addresses ............................. 5-22
5.4 Equivalent scatter-loading descriptions for simple images ....................... 5-28
Chapter 6 Creating and Using libraries
6.1 About libraries ............................................................................................. 6-2
6.2 Library searching, selection, and scanning ................................................ 6-3
6.3 The ARM librarian ....................................................................................... 6-6
Chapter 7 Using fromELF
7.1 About fromELF ........................................................................................... 7-2
7.2 fromELF command-line options .................................................................. 7-3
7.3 Examples of fromELF usage .................................................................... 7-10
Chapter 8 Using the ARM Profiler
8.1 About the ARM profiler ............................................................................... 8-2
8.2 Profiler command-line options .................................................................... 8-3
8.3 Sample output ............................................................................................ 8-4
Glossary