3.8 Weak references and definitions ...................................... ...................................... 3-58
3.9 How the linker performs library searching, selection, and scanning ........................ 3-60
3.10 How the linker searches for the Arm
®
standard libraries .................... .................... 3-61
3.11 Specifying user libraries when linking ...................................................................... 3-62
3.12 How the linker resolves references .................................... .................................... 3-63
3.13 The strict family of linker options ...................................... ...................................... 3-64
Chapter 4 Linker Optimization Features
4.1 Elimination of common debug sections ................................. ................................. 4-66
4.2 Elimination of common groups or sections .............................................................. 4-67
4.3 Elimination of unused sections ................................................................................ 4-68
4.4 Optimization with RW data compression ................................ ................................ 4-69
4.5 Function inlining with the linker ................................................................................ 4-72
4.6 Factors that influence function inlining .................................................................... 4-73
4.7 About branches that optimize to a NOP .................................................................. 4-75
4.8 Linker reordering of tail calling sections .................................................................. 4-76
4.9 Restrictions on reordering of tail calling sections .................................................... 4-77
4.10 Linker merging of comment sections ................................... ................................... 4-78
4.11 Merging identical constants .......................................... .......................................... 4-79
Chapter 5 Getting Image Details
5.1 Options for getting information about linker-generated files .................................... 5-82
5.2 Identifying the source of some link errors ................................................................ 5-83
5.3 Example of using the --info linker option ................................ ................................ 5-84
5.4 How to find where a symbol is placed when linking ................................................ 5-86
Chapter 6 Accessing and Managing Symbols with armlink
6.1 About mapping symbols .......................................................................................... 6-88
6.2 Linker-defined symbols ............................................................................................ 6-89
6.3 Region-related symbols ............................................. ............................................. 6-90
6.4 Section-related symbols .......................................................................................... 6-95
6.5 Access symbols in another image ..................................... ..................................... 6-97
6.6 Edit the symbol tables with a steering file .............................................................. 6-100
6.7 Use of $Super$$ and $Sub$$ to patch symbol definitions .................................... 6-103
Chapter 7 Scatter-loading Features
7.1 The scatter-loading mechanism ............................................................................ 7-105
7.2 Root region and the initial entry point .................................. .................................. 7-111
7.3 Example of how to explicitly place a named section with scatter-loading ...... ...... 7-126
7.4 Placement of unassigned sections ........................................................................ 7-128
7.5 Placing veneers with a scatter file .................................... .................................... 7-140
7.6 Placement of CMSE veneer sections for a Secure image .................. .................. 7-141
7.7 Reserving an empty block of memory ................................. ................................. 7-143
7.8 Placement of Arm
®
C and C++ library code ............................. ............................. 7-145
7.9 Aligning regions to page boundaries .................................. .................................. 7-148
7.10 Aligning execution regions and input sections ........................... ........................... 7-150
7.11 Preprocessing a scatter file ......................................... ......................................... 7-151
7.12 Example of using expression evaluation in a scatter file to avoid padding ............ 7-153
7.13 Equivalent scatter-loading descriptions for simple images .................................... 7-154
7.14 How the linker resolves multiple matches when processing scatter files .............. 7-161
7.15 How the linker resolves path names when processing scatter files ...................... 7-163
DUI0803I Copyright © 2014–2017 Arm Limited (or its affiliates). All rights reserved. 5
Non-Confidential
