Keil Logo

Technical Support

On-Line Manuals

Linker User Guide

Preface Overview of the Linker Linking Models Supported by armlink Image Structure and Generation Linker Optimization Features Getting Image Details Accessing and Managing Symbols with armlink Scatter-loading Features Scatter File Syntax BNF notation used in scatter-loading description s Syntax of a scatter file Load region descriptions Components of a load region description Syntax of a load region description Load region attributes Inheritance rules for load region address attribut Inheritance rules for the RELOC address attribute Considerations when using a relative address +offs Execution region descriptions Components of an execution region description Syntax of an execution region description Execution region attributes Inheritance rules for execution region address att Considerations when using a relative address +offs Input section descriptions Components of an input section description Syntax of an input section description Examples of module and input section specification Expression evaluation in scatter files Expression usage in scatter files Expression rules in scatter files Execution address built-in functions for use in sc ScatterAssert function and load address related fu Symbol related function in a scatter file AlignExpr(expr, align) function GetPageSize() function SizeOfHeaders() function Example of aligning a base address in execution sp Scatter files containing relative base address loa Linker Command-line Options Linker Steering File Command Reference Via File Syntax

Execution region attributes

8.4.3 Execution region attributes

An execution region has attributes that allow you to control where parts of your image are loaded in the target memory at runtime.

The execution region attributes are:
ABSOLUTE
The content is placed at a fixed address that does not change after linking. A base designator specifies the execution address of the region.
ALIGN alignment
Increase the alignment constraint for the execution region from 4 to alignment. alignment must be a positive power of 2. If the execution region has a base_address, then the address must be alignment aligned. If the execution region has a +offset, then the linker aligns the calculated base address of the region to an alignment boundary.

Note

ALIGN on an execution region causes both the load address and execution address to be aligned. This alignment can result in padding being added to the ELF file. To align only the execution address, use the AlignExpr expression on the base address.
ALIGNALL value
Increases the alignment of sections within the execution region.
The value must be a positive power of 2 and must be greater than or equal to 4.
ANY_SIZE max_size
Specifies the maximum size within the execution region that armlink can fill with unassigned sections. You can use a simple expression to specify the max_size. That is, you cannot use functions such as ImageLimit().

Note

Specifying ANY_SIZE overrides any effects that --any_contingency has on the region.
Be aware of the following restrictions when using this keyword:
  • max_size must be less than or equal to the region size.
  • You can use ANY_SIZE on a region without a .ANY selector but armlink ignores it.
EMPTY [–]length
Reserves an empty block of memory of a given size in the execution region, typically used by a heap or stack. No section can be placed in a region with the EMPTY attribute.
length represents a stack that grows down in memory. If the length is given as a negative value, the base_address is taken to be the end address of the region.
FILL value
Creates a linker generated region containing a value. If you specify FILL, you must give a value, for example: FILL 0xFFFFFFFF. The FILL attribute replaces the following combination: EMPTY ZEROPAD PADVALUE.
In certain situations, such as a simulation, filling a region with a value is preferable to spending a long time in a zeroing loop.
FIXED
Fixed address. The linker attempts to make the execution address equal the load address. If it succeeds, then the region is a root region. If it does not succeed, then the linker produces an error.

Note

The linker inserts padding with this attribute.
NOCOMPRESS
RW data compression is enabled by default. The NOCOMPRESS keyword enables you to specify that RW data in an execution region must not be compressed in the final image.
OVERLAY
Use for sections with overlaying address ranges. If consecutive execution regions have the same +offset, then they are given the same base address.
The content is placed at a fixed address that does not change after linking. The content might overlap with other regions designated as OVERLAY regions.
PADVALUE value
Defines the value to use for padding. If you specify PADVALUE, you must give a value, for example:
EXEC 0x10000 PADVALUE 0xFFFFFFFF EMPTY ZEROPAD 0x2000
This example creates a region of size 0x2000 full of 0xFFFFFFFF.
PADVALUE must be a word in size. PADVALUE attributes on load regions are ignored.
PI
This region contains only position independent sections. The content does not depend on any fixed address and might be moved after linking without any extra processing.

Note

This attribute is not supported if an image contains execute-only sections.
SORTTYPE algorithm
Specifies the sorting algorithm for the execution region, for example:
ER1 +0 SORTTYPE CallTree

Note

This attribute overrides any sorting algorithm that you specify with the --sort command-line option.
UNINIT
Use to create execution regions containing uninitialized data or memory-mapped I/O.

Note

ARM® Compiler does not support systems with ECC or parity protection where the memory is not initialized.
ZEROPAD
Zero-initialized sections are written in the ELF file as a block of zeros and, therefore, do not have to be zero-filled at runtime.
This attribute sets the load length of a ZI output section to Image$$region_name$$ZI$$Length.
Only root execution regions can be zero-initialized using the ZEROPAD attribute. Using the ZEROPAD attribute with a non-root execution region generates a warning and the attribute is ignored.
In certain situations, such as a simulation, filling a region with a value is preferable to spending a long time in a zeroing loop.
Non-ConfidentialPDF file icon PDF versionARM DUI0377H
Copyright © 2007, 2008, 2011, 2012, 2014-2016 ARM. All rights reserved. 
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.