Specifies the unique initial entry point of the image. Although an image can have multiple entry points, only one can be the initial entry point.
is one of the following:
A numerical value, for example:
Specifies an image entry point as the address of
, for example:
Specifies an image entry point as an
within a particular
, for example:
There must be no spaces within the argument to
--entry. The input section and object names are matched without case-sensitivity. You can use the following simplified notation:
object, if there is only one input section. armlink generates an error message if there is more than one code input section in
NoteIf the entry address of your image is in T32 state, then the least significant bit of the address must be set to 1. The linker does this automatically if you specify a symbol. For example, if the entry code starts at address
in T32 state you must use
The image can contain multiple entry points. Multiple entry points might be specified with
ENTRY directive in assembler source files. In such ases, a unique
initial entry point must be specified for an image, otherwise the error L6305E is generated.
The initial entry point specified with the
--entry option is stored in the
executable file header for use by the loader. There can be only one occurrence of this
option on the command line. A debugger typically uses this entry address to initialize the
Program Counter (PC) when an image is loaded. The
initial entry point must meet the following conditions:
The image entry point must lie within an execution region.
The execution region must be non-overlay, and must be a root execution region (load address == execution address).