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 ARM.
Execution region contains Thumb code and the processor supports Thumb-2 technology.
Execution region contains Thumb code and the processor does not support Thumb-2 technology.