Linker Reference Guide

Syntax of a load region description

ARM Compiler toolchain v5.02 for µVision Linker Reference

Home > Formal syntax of the scatter file > Syntax of a load region description

Syntax of a load region description

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

load_region_description ::=
  load_region_name  (base_address  | ("+" offset)) [attribute_list] [max_size]
       "{"
          execution_region_description+ 
       "}"

where:

load_region_name: Names the load 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 satisfy the alignment constraints of the load region.
+offset: Describes a base address that is offset bytes beyond the end of the preceding load region. The value of offset must be zero modulo four. If this is the first load region, then +offset means that the base address begins offset bytes from zero.
If you use +offset, then the load region might inherit certain attributes from a previous load region.
attribute_list: The attributes that specify the properties of the load region contents.
max_size: Specifies the maximum size of the load region. This is the size of the load region before any decompression or zero initialization take place. If the optional max_size value is specified, armlink generates an error if the region has more than max_size bytes allocated to it.
execution_region_description: Specifies the execution region name, address, and contents.

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 a load region description

Syntax of a load region description

Note

See also

Products

Development Tools

Hardware & Collateral

Downloads

Support

Contact

Important information