|
|||
| Products Download Events Support Videos | |||
Technical Support
On-Line Manuals
Linker Reference Guide
Conventions and feedback
Linker command-line options
--any_contingency
--any_placement=algorithm
--any_sort_order=order
--api, --no_api
--arm_only
--autoat, --no_autoat
--be8
--be32
--bestdebug, --no_bestdebug
--branchnop, --no_branchnop
--callgraph, --no_callgraph
--callgraph_file=filename
--callgraph_output=fmt
--cgfile=type
--cgsymbol=type
--cgundefined=type
--combreloc, --no_combreloc
--comment_section, --no_comment_section
--compress_debug, --no_compress_debug
--cppinit, --no_cppinit
--cpu=list
--cpu=name
--crosser_veneershare, --no_crosser_veneershare
--datacompressor=opt
--debug, --no_debug
--diag_error=tag[,tag,...]
--diag_remark=tag[,tag,...]
--diag_style=arm|ide|gnu
--diag_suppress=tag[,tag,...]
--diag_warning=tag[,tag,...]
--eager_load_debug, --no_eager_load_debug
--edit=file_list
--emit_debug_overlay_relocs
--emit_debug_overlay_section
--emit_non_debug_relocs
--emit_relocs
--entry=location
--errors=filename
--exceptions, --no_exceptions
--exceptions_tables=action
--feedback=filename
--feedback_image=option
--feedback_type=type
--filtercomment, --no_filtercomment
--fini=symbol
--first=section_id
--force_explicit_attr
--fpu=list
--fpu=name
--help
--info=topic[,topic,...]
--info_lib_prefix=opt
--init=symbol
--inline, --no_inline
--inlineveneer, --no_inlineveneer
input-file-list
--keep=section_id
--keep_protected_symbols
--largeregions, --no_largeregions
--last=section_id
--ldpartial
--legacyalign, --no_legacyalign
--libpath=pathlist
--library_type=lib
--licretry
--list=filename
--list_mapping_symbols, --no_list_mapping_symbols
--load_addr_map_info, --no_load_addr_map_info
--locals, --no_locals
--ltcg
--mangled, --unmangled
--map, --no_map
--match=crossmangled
--max_veneer_passes=value
--max_visibility=type
--merge, --no_merge
--muldefweak, --no_muldefweak
--output=filename
--override_visibility
--pad=num
--paged
--pagesize=pagesize
--partial
--piveneer, --no_piveneer
--predefine="string"
--reduce_paths, --no_reduce_paths
--ref_cpp_init, --no_ref_cpp_init
--reloc
--remarks
--remove, --no_remove
--ro_base=address
--ropi
--rosplit
--rw_base=address
--rwpi
--scanlib, --no_scanlib
--scatter=filename
--section_index_display=type
--show_cmdline
--show_full_path
--show_parent_lib
--show_sec_idx
--sort=algorithm
--split
--startup=symbol, --no_startup
--strict
--strict_enum_size, --no_strict_enum_size
--strict_flags, --no_strict_flags
--strict_ph, --no_strict_ph
--strict_relocations, --no_strict_relocations
--strict_symbols, --no_strict_symbols
--strict_visibility, --no_strict_visibility
--strict_wchar_size, --no_strict_wchar_size
--symbols, --no_symbols
--symdefs=filename
--tailreorder, --no_tailreorder
--thumb2_library, --no_thumb2_library
--tiebreaker=option
--undefined=symbol
--undefined_and_export=symbol
--unresolved=symbol
--use_definition_visibility
--userlibpath=pathlist
--veneerinject,--no_veneerinject
--veneer_inject_type=type
--veneer_pool_size=size
--veneershare, --no_veneershare
--verbose
--version_number
--vfemode=mode
--via=filename
--vsn
--xref, --no_xref
--xrefdbg, --no_xrefdbg
--xref{from|to}=object(section)
--zi_base=address
Linker steering file command reference
Formal syntax of the scatter file
Linker Reference Guide
--largeregions, --no_largeregions
| |||
| Home > Linker command-line options > --largeregions, --no_largeregions | |||
This option controls the sorting order of sections in large execution regions to minimize the distance between sections that call each other.
UsageIf the execution region contains more code than the range of a branch instruction then the linker switches to large region mode. In this mode the linker sorts according to the approximated average call depth of each section in ascending order. The linker might also place distribute veneers amongst the code sections to minimize the number of veneers.
Note
Large region mode can result in large changes to the layout of an image even when small changes are made to the input.
To disable large region mode and revert to lexical order,
use --no_largeregions. Section placement is then
predictable and image comparisons are more predictable. However
some branches might not reach the target causing the link step to
fail. If this happens you must place code/data sections explicitly
using an appropriate scatter file or write your own veneer.
Large region support enables:
average call depth sorting,
--sort=AvgCallDepthAPI sorting,
--apiveneer injection,
--veneerinject.
The following command lines are equivalent:
armlink --largeregions --no_api --no_veneerinject --sort=Lexical armlink --no_largeregions
The default is --no_largeregions. The linker
automatically switches to --largeregions 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:
- 32Mb
Execution region contains only ARM.
- 16Mb
Execution region contains Thumb, 32-bit Thumb is supported.
- 4Mb
Execution region contains Thumb, no 32-bit Thumb support.
| Copyright © 2008, 2011-2012 ARM. All rights reserved. | ARM DUI 0458C |
| Non-Confidential | ID062912 |
 PDF version | |
| Home > Linker command-line options > --largeregions, --no_largeregions |
ProductsDevelopment Tools |
Hardware & Collateral |
Downloads |
Support |
Contact |
|
 |
|||
