You copied the Doc URL to your clipboard.

The initial entry point for an image

There can be only one initial entry point for an image, otherwise the linker produces a warning.

The initial entry point must meet the following conditions:

  • The image entry point must always lie within an execution region.

  • The execution region must not overlay another execution region, and must be a root execution region. That is, where the load address is the same as the execution address.

If you do not use the --entry option to specify the initial entry point then:

  • If the input objects contain only one entry point set by the ENTRY directive, the linker uses that entry point as the initial entry point for the image.

  • The linker generates an image that does not contain an initial entry point when either:

    • More than one entry point has been specified by using the ENTRY directive.

    • No entry point has been specified by using the ENTRY directive.

For embedded applications with ROM at zero use --entry 0x0, or optionally 0xFFFF0000 for CPUs that are using high vectors.

Related concepts

Related reference

Related information

Was this page helpful? Yes No