You copied the Doc URL to your clipboard.

Linker command-line options listed by group

Groupings of the linker command-line options.

Note

This topic includes descriptions of [BETA] features.
Options that control library files and paths
  • --libpath=pathlist.
  • --library=name.
  • --library_type=lib.
  • --scanlib, --no_scanlib.
  • --stdlib
  • --thumb2_library, --no_thumb2_library.
  • --userlibpath=pathlist.
Options that control the linking of object files
  • --match=crossmangled.
  • --strict.
  • --strict_ph, --no_strict_ph.
  • --strict_relocations, --no_strict_relocations.
  • --unresolved=symbol.
Options that control the output
  • --bare_metal_pie.
  • --base_platform.
  • --bpabi.
  • --combreloc, --no_combreloc.
  • --dll.
  • --output=filename.
  • --partial.
  • --pie.
  • --reloc.
Options to specify the image memory map
  • --fpic.
  • --predefine="string".
  • --ro_base=address.
  • [BETA] --ropi.
  • --rosplit.
  • --rw_base=address.
  • [BETA] --rwpi.
  • --scatter=filename.
  • --split.
  • --zi_base=address.

Note

Although --ropi and --rwpi are fully supported in armlink, they are [BETA] features in the context of the ARM® Compiler 6 RWPI feature.
Options that control debug information in an image
  • --bestdebug, --no_bestdebug.
  • --compress_debug, --no_compress_debug.
  • --debug, --no_debug.
  • --eager_load_debug, --no_eager_load_debug.
  • --emit_debug_overlay_relocs.
  • --emit_debug_overlay_section.
  • --emit_non_debug_relocs.
Options that control the content of an image
  • --any_contingency.
  • --any_placement=algorithm.
  • --any_sort_order=order.
  • --api, --no_api.
  • --arm_only.
  • --autoat, --no_autoat.
  • --blx_arm_thumb, --no_blx_arm_thumb.
  • --blx_thumb_arm, --no_blx_thumb_arm.
  • --branchnop, --no_branchnop.
  • --comment_section, --no_comment_section.
  • --cppinit, --no_cppinit.
  • --cpu=name.
  • --datacompressor=opt.
  • --edit=file_list.
  • --eh-frame-hdr.
  • --emit_relocs.
  • --entry=location.
  • --exceptions, --no_exceptions.
  • --export_all, --no_export_all.
  • --export_dynamic, --no_export_dynamic.
  • --filtercomment, --no_filtercomment.
  • --fini=symbol.
  • --first=section_id.
  • --force_explicit_attr.
  • --force_so_throw, --no_force_so_throw.
  • --fpu=name.
  • --gnu_linker_defined_syms.
  • [BETA] --import_cmse_lib_in=filename.
  • --init=symbol.
  • --inline, --no_inline.
  • --keep=section_id.
  • --keep_intermediate.
  • --largeregions, --no_largeregions.
  • --last=section_id.
  • --locals, --no_locals.
  • --lto, --no_lto.
  • --lto_keep_all_symbols, --no_lto_keep_all_symbols.
  • --lto_set_intermediate_filename.
  • --lto_set_relocation_model.
  • --max_visibility=type.
  • --merge, --no_merge.
  • --muldefweak, --no_muldefweak.
  • --override_visibility.
  • --pad=num.
  • --paged.
  • --pagesize=pagesize.
  • --pltgot=type.
  • --pltgot_opts=mode.
  • --privacy.
  • --ref_cpp_init, --no_ref_cpp_init.
  • --remove, --no_remove.
  • --sort=algorithm.
  • --startup=symbol, --no_startup.
  • --strict_flags, --no_strict_flags.
  • --symver_script=filename.
  • --symver_soname.
  • --tailreorder, --no_tailreorder.
  • --tiebreaker=option.
  • --undefined=symbol.
  • --undefined_and_export=symbol.
  • --use_definition_visibility.
  • --vfemode=mode.
Options that control veneer generation
  • --crosser_veneershare, --no_crosser_veneershare.
  • --inlineveneer, --no_inlineveneer.
  • --max_veneer_passes=value.
  • --piveneer, --no_piveneer.
  • --veneerinject,--no_veneerinject.
  • --veneer_inject_type=type.
  • --veneer_pool_size=size.
  • --veneershare, --no_veneershare.
Options that control the extraction and presentation of image information
  • --callgraph, --no_callgraph.
  • --callgraph_file=filename.
  • --callgraph_output=fmt.
  • --callgraph_subset=symbol[,symbol,…].
  • --cgfile=type.
  • --cgsymbol=type.
  • --cgundefined=type.
  • [BETA] --import_cmse_lib_out=filename.
  • --info=topic[,topic,...].
  • --info_lib_prefix=opt.
  • --list_mapping_symbols, --no_list_mapping_symbols.
  • --load_addr_map_info, --no_load_addr_map_info.
  • --mangled, --unmangled.
  • --map, --no_map.
  • --section_index_display=type.
  • --symbols, --no_symbols.
  • --symdefs=filename.
  • --xref, --no_xref.
  • --xrefdbg, --no_xrefdbg.
  • --xref{from|to}=object(section).

Note

With the exception of --callgraph and --callgraph_subset, the linker prints the information you request on the standard output stream, stdout, by default. You can redirect the information to a text file using the --list command-line option.
Options that control diagnostic messages
  • --diag_error=tag[,tag,…].
  • --diag_remark=tag[,tag,…].
  • --diag_style=arm|ide|gnu.
  • --diag_suppress=tag[,tag,…].
  • --diag_warning=tag[,tag,…].
  • --errors=filename.
  • --list=filename.
  • --remarks.
  • --show_full_path.
  • --show_parent_lib.
  • --show_sec_idx.
  • --strict_enum_size, --no_strict_enum_size.
  • --strict_symbols, --no_strict_symbols.
  • --strict_visibility, --no_strict_visibility.
  • --strict_wchar_size, --no_strict_wchar_size.
  • --verbose.
Options that control alignment in legacy images
  • --legacyalign, --no_legacyalign.
Miscellaneous options
  • --cpu=list.
  • --fpu=list.
  • --help.
  • input-file-list.
  • --show_cmdline.
  • --version_number.
  • --via=filename.
  • --vsn.
Was this page helpful? Yes No