You copied the Doc URL to your clipboard.

Load$$ execution region symbols

The linker performs an extra address assignment and relocation pass for relocations that refer to load addresses after RW compression. This delayed relocation permits more information about load addresses to be used in linker-defined symbols.

Note

Load$$region_name symbols apply only to execution regions, and Load$$LR$$load_region_name symbols apply only to load regions.

The following table shows the symbols that the linker generates for every Load$$ execution region present in the image. All the symbols refer to execution addresses after the C library is initialized.

Table 5. Load$$ execution region symbols
SymbolDescription
Load$$region_name$$BaseLoad address of the region.
Load$$region_name$$LengthRegion length in bytes.
Load$$region_name$$LimitAddress of the byte beyond the end of the execution region.
Load$$region_name$$RO$$BaseAddress of the RO output section in this execution region.
Load$$region_name$$RO$$LengthLength of the RO output section in bytes.
Load$$region_name$$RO$$LimitAddress of the byte beyond the end of the RO output section in the execution region.
Load$$region_name$$RW$$BaseAddress of the RW output section in this execution region.
Load$$region_name$$RW$$LengthLength of the RW output section in bytes.
Load$$region_name$$RW$$LimitAddress of the byte beyond the end of the RW output section in the execution region.
Load$$region_name$$ZI$$BaseLoad address of the ZI output section in this execution region.
Load$$region_name$$ZI$$Length

Load length of the ZI output section in bytes.

The Load Length of ZI is zero unless region_name has the ZEROPAD scatter-loading keyword set. If ZEROPAD is set then:

Load Length = Image$$region_name$$ZI$$Length

Load$$region_name$$ZI$$LimitLoad address of the byte beyond the end of the ZI output section in the execution region.

All symbols in this table refer to load addresses before the C library is initialized. Be aware of the following:

  • The symbols are absolute because section-relative symbols can only have execution addresses.

  • The symbols take into account RW compression.

  • The symbols do not include ZI output section because it does not exist before the C library is initialized.

  • All relocations from RW compressed execution regions must be performed before compression, because the linker cannot resolve a delayed relocation on compressed data.

  • If the linker detects a relocation from an RW-compressed region to a linker-defined symbol that depends on RW compression, then the linker disables compression for that region.

  • Any zero bytes written to the file are visible. Therefore, the Limit and Length values must take into account the zero bytes written into the file.

Was this page helpful? Yes No