|
||
| Products Download Events Support Videos | ||
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
About mapping symbols
Linker-defined symbols
Region-related symbols
Types of region-related symbols
Image$$ execution region symbols
Load$$ execution region symbols
Load$$LR$$ load region symbols
Region name values when not scatter-loading
Linker defined symbols and scatter files
Methods of importing linker-defined symbols in C a
Methods of importing linker-defined symbols in ARM
Section-related symbols
Types of section-related symbols
Image symbols
Input section symbols
Access symbols in another image
Creating a symdefs file
Outputting a subset of the global symbols
Reading a symdefs file
Symdefs file format
Edit the symbol tables with a steering file
Specifying steering files on the linker command-li
Steering file command summary
Steering file format
Hide and rename global symbols with a steering fil
Use of $Super$$ and $Sub$$ to patch symbol definit
Scatter-loading Features
Scatter File Syntax
Linker Command-line Options
Linker Steering File Command Reference
Via File Syntax
Image symbols
| Non-Confidential |  PDF version | ARM DUI0377H | ||
| ||||
| Home > Accessing and Managing Symbols with armlink > Section-related symbols > Image symbols | ||||
6.4.2 Image symbols
Image symbols are generated by the linker when you do not use scatter-loading to create a simple image.
The following table shows the image symbols:
Table 6-4 Image symbols
| Symbol | Section type | Description |
|---|---|---|
Image$$RO$$Base |
Output | Address of the start of the RO
output section.
|
Image$$RO$$Limit |
Output | Address of the first byte beyond the end of the RO output section. |
Image$$RW$$Base |
Output | Address of the start of the RW output section. |
Image$$RW$$Limit |
Output | Address of the byte beyond the end of the ZI output section. (The choice of the end of the ZI region rather than the end of the RW region is to maintain compatibility with legacy code.) |
Image$$ZI$$Base |
Output | Address of the start of the ZI output section. |
Image$$ZI$$Limit |
Output | Address of the byte beyond the end of the ZI output section. |
Note
- ARM® recommends that you use region-related symbols in preference to section-related symbols.
- The ZI output sections of an image are not created statically, but are automatically created dynamically at runtime.
- There are no load address symbols for RO, RW, and ZI output sections.
If you are using a scatter file, the image symbols are undefined. If your
code accesses any of these symbols, you must treat them as a weak reference.
The standard implementation of
__user_setup_stackheap() uses the value in Image$$ZI$$Limit. Therefore, if you are using a scatter file you must manually
place the stack and heap. You can do this either:- In a scatter file using one of the following methods:
- Define separate stack and heap regions called
ARM_LIB_STACKandARM_LIB_HEAP. - Define a combined region containing both stack and heap called
ARM_LIB_STACKHEAP.
- Define separate stack and heap regions called
- By re-implementing
__user_setup_stackheap()to set the heap and stack boundaries.
Related tasks
Related reference
| Non-Confidential | PDF version | ARM DUI0377H |
| Copyright © 2007, 2008, 2011, 2012, 2014-2016 ARM. All rights reserved. |
| Home > Accessing and Managing Symbols with armlink > Section-related symbols > Image symbols |
ProductsDevelopment Tools |
Hardware & Collateral |
Downloads |
Support |
Contact |
 |
||||