4.1.2. Region-related symbols

Region-related symbols are generated when armlink creates an image. Table 4.1 shows the symbols that armlink generates for every execution region present in the image.

The linker uses region_name values of:

For every execution region containing a ZI output section, armlink generates additional symbols containing $$ZI$$.

Table 4.1. Region-related linker symbols

SymbolDescription
Load$$region_name$$BaseLoad address of the region.
Image$$region_name$$BaseExecution address of the region.
Image$$region_name$$LengthExecution region length in bytes (multiple of 4).
Image$$region_name$$LimitAddress of the byte beyond the end of the execution region.
Image$$region_name$$ZI$$BaseExecution address of the ZI output section in this region.
Image$$region_name$$ZI$$LengthLength of the ZI output section in bytes (multiple of 4).
Image$$region_name$$ZI$$LimitAddress of the byte beyond the end of the ZI output section in the execution region.

Note

  • The ZI output sections of an image are not created statically, but are automatically created dynamically at run-time. Therefore there is no load address symbol for ZI output sections.

  • It is recommended that you use region-related symbols in preference to section-related symbols.

Copyright © 2002 ARM Limited. All rights reserved.ARM DUI 0212A
Non-Confidential