Enables and disables API section sorting. API sections are the sections that are called the most within a region.
In large region mode the API sections are extracted from the region and then inserted closest to the hotspots of the calling sections. This minimises the number of veneers generated.
The default is
--no_api. The linker automatically switches to
--api if at least one execution region contains more code than the
smallest inter-section branch. The smallest inter-section branch depends on the code in the
region and the target processor:
- Execution region contains only A64 instructions.
- Execution region contains only A32 instructions.
- Execution region contains 32-bit T32 instructions.
- Execution region contains only 16-bit T32 instructions.