Linker Reference Guide

Syntax of an execution region description

ARM Compiler toolchain v5.02 for µVision Linker Reference

Home > Formal syntax of the scatter file > Syntax of an execution region description

Syntax of an execution region description

The syntax of an execution region description, in Backus-Naur Form (BNF), is:

execution_region_description ::= 

  exec_region_name (base_address | "+" offset) [attribute_list] [max_size | length]
        "{" 
            input_section_description* 
        "}"

where:

exec_region_name: Names the execution region. You can use a quoted name. The name is case-sensitive only if you use any region-related linker-defined symbols.
base_address: Specifies the address where objects in the region are to be linked. base_address must be word-aligned.
Note
Using ALIGN on an execution region causes both the load address and execution address to be aligned.
+offset: Describes a base address that is offset bytes beyond the end of the preceding execution region. The value of offset must be zero modulo four.
If this is the first execution region in the load region then +offset means that the base address begins offset bytes after the base of the containing load region.
If you use +offset, then the execution region might inherit certain attributes from the parent load region, or from a previous execution region within the same load region.
attribute_list: The attributes that specify the properties of the execution region contents.
max_size: For an execution region marked EMPTY or FILL the max_size value is interpreted as the length of the region. Otherwise the max_size value is interpreted as the maximum size of the execution region.
[-]length: Can only be used with EMPTY to represent 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.
input_section_description: Specifies the content of the input sections.

Note

The Backus-Naur Form (BNF) definitions contain additional line returns and spaces to improve readability. They are not required in the scatter-loading definition and are ignored if present in the file.

Linker Reference Guide

Syntax of an execution region description

Syntax of an execution region description

Note

Note

See also

Products

Development Tools

Hardware & Collateral

Downloads

Support

Buy

Important information