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

--autoat, --no_autoat

--bestdebug, --no_bestdebug

--branchnop, --no_branchnop

--callgraph, --no_callgraph

--callgraph_file=filename

--callgraph_output=fmt

--cgsymbol=type

--cgundefined=type

--combreloc, --no_combreloc

--comment_section, --no_comment_section

--compress_debug, --no_compress_debug

--cppinit, --no_cppinit

--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

--entry=location

--errors=filename

--exceptions, --no_exceptions

--exceptions_tables=action

--feedback=filename

--feedback_image=option

--feedback_type=type

--filtercomment, --no_filtercomment

--first=section_id

--force_explicit_attr

--info=topic[,topic,...]

--info_lib_prefix=opt

--inline, --no_inline

--inlineveneer, --no_inlineveneer

input-file-list

--keep=section_id

--keep_protected_symbols

--largeregions, --no_largeregions

--last=section_id

--legacyalign, --no_legacyalign

--libpath=pathlist

--library_type=lib

--list=filename

--list_mapping_symbols, --no_list_mapping_symbols

--load_addr_map_info, --no_load_addr_map_info

--locals, --no_locals

--mangled, --unmangled

--map, --no_map

--match=crossmangled

--max_veneer_passes=value

--max_visibility=type

--merge, --no_merge

--muldefweak, --no_muldefweak

--output=filename

--override_visibility

--pagesize=pagesize

--piveneer, --no_piveneer

--predefine="string"

--reduce_paths, --no_reduce_paths

--ref_cpp_init, --no_ref_cpp_init

--remove, --no_remove

--ro_base=address

--rw_base=address

--scanlib, --no_scanlib

--scatter=filename

--section_index_display=type

--show_full_path

--show_parent_lib

--sort=algorithm

--startup=symbol, --no_startup

--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

--version_number

--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

--first=section_id

ARM Compiler toolchain v5.02 for µVision Linker Reference

Home > Linker command-line options > --first=section_id

`--first=section_id`

This option places the selected input section first in its execution region. This can, for example, place the section containing the vector table first in the image.

Syntax

--first=section_id

Where section_id is one of the following:

symbol: Selects the section that defines symbol. You must not specify a symbol that has more than one definition, because only one section can be placed first. For example: --first=reset
object(section): Selects section from object. There must be no space between object and the following open parenthesis. For example: --first=init.o(init)
object: Selects the single input section in object. If you use this short form and there is more than one input section, the linker generates an error message. For example: --first=init.o

Usage

The --first option cannot be used with --scatter. Instead, use the +FIRST attribute in a scatter file.

See also

Concepts

Using the Linker:

Reference

Copyright © 2008, 2011-2012 ARM. All rights reserved.	ARM DUI 0458C
Non-Confidential	ID062912
PDF version

Home > Linker command-line options > --first=section_id

Contact Us | Site Feedback | Terms of Use | Privacy Policy

Copyright © 2013 ARM Ltd and ARM Germany GmbH. All rights reserved.

Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.