1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- This file documents the GNU linker LD 4(GNU Toolchain for the A-profile Architecture 10.3-2021.07 (arm-10.29)) 5version 2.36.1. 6 7Copyright (C) 1991-2021 Free Software Foundation, Inc. 8 9Permission is granted to copy, distribute and/or modify this document 10under the terms of the GNU Free Documentation License, Version 1.3 11or any later version published by the Free Software Foundation; 12with no Invariant Sections, with no Front-Cover Texts, and with no 13Back-Cover Texts. A copy of the license is included in the 14section entitled "GNU Free Documentation License". --> 15<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 16<head> 17<title>LD: Entry Point</title> 18 19<meta name="description" content="LD: Entry Point"> 20<meta name="keywords" content="LD: Entry Point"> 21<meta name="resource-type" content="document"> 22<meta name="distribution" content="global"> 23<meta name="Generator" content="makeinfo"> 24<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 25<link href="index.html#Top" rel="start" title="Top"> 26<link href="LD-Index.html#LD-Index" rel="index" title="LD Index"> 27<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 28<link href="Simple-Commands.html#Simple-Commands" rel="up" title="Simple Commands"> 29<link href="File-Commands.html#File-Commands" rel="next" title="File Commands"> 30<link href="Simple-Commands.html#Simple-Commands" rel="previous" title="Simple Commands"> 31<style type="text/css"> 32<!-- 33a.summary-letter {text-decoration: none} 34blockquote.smallquotation {font-size: smaller} 35div.display {margin-left: 3.2em} 36div.example {margin-left: 3.2em} 37div.indentedblock {margin-left: 3.2em} 38div.lisp {margin-left: 3.2em} 39div.smalldisplay {margin-left: 3.2em} 40div.smallexample {margin-left: 3.2em} 41div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 42div.smalllisp {margin-left: 3.2em} 43kbd {font-style:oblique} 44pre.display {font-family: inherit} 45pre.format {font-family: inherit} 46pre.menu-comment {font-family: serif} 47pre.menu-preformatted {font-family: serif} 48pre.smalldisplay {font-family: inherit; font-size: smaller} 49pre.smallexample {font-size: smaller} 50pre.smallformat {font-family: inherit; font-size: smaller} 51pre.smalllisp {font-size: smaller} 52span.nocodebreak {white-space:nowrap} 53span.nolinebreak {white-space:nowrap} 54span.roman {font-family:serif; font-weight:normal} 55span.sansserif {font-family:sans-serif; font-weight:normal} 56ul.no-bullet {list-style: none} 57--> 58</style> 59 60 61</head> 62 63<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 64<a name="Entry-Point"></a> 65<div class="header"> 66<p> 67Next: <a href="File-Commands.html#File-Commands" accesskey="n" rel="next">File Commands</a>, Up: <a href="Simple-Commands.html#Simple-Commands" accesskey="u" rel="up">Simple Commands</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LD-Index.html#LD-Index" title="Index" rel="index">Index</a>]</p> 68</div> 69<hr> 70<a name="Setting-the-Entry-Point"></a> 71<h4 class="subsection">3.4.1 Setting the Entry Point</h4> 72<a name="index-ENTRY_0028symbol_0029"></a> 73<a name="index-start-of-execution"></a> 74<a name="index-first-instruction"></a> 75<a name="index-entry-point"></a> 76<p>The first instruction to execute in a program is called the <em>entry 77point</em>. You can use the <code>ENTRY</code> linker script command to set the 78entry point. The argument is a symbol name: 79</p><div class="smallexample"> 80<pre class="smallexample">ENTRY(<var>symbol</var>) 81</pre></div> 82 83<p>There are several ways to set the entry point. The linker will set the 84entry point by trying each of the following methods in order, and 85stopping when one of them succeeds: 86</p><ul> 87<li> the ‘<samp>-e</samp>’ <var>entry</var> command-line option; 88</li><li> the <code>ENTRY(<var>symbol</var>)</code> command in a linker script; 89</li><li> the value of a target-specific symbol, if it is defined; For many 90targets this is <code>start</code>, but PE- and BeOS-based systems for example 91check a list of possible entry symbols, matching the first one found. 92</li><li> the address of the first byte of the ‘<samp>.text</samp>’ section, if present; 93</li><li> The address <code>0</code>. 94</li></ul> 95 96 97 98 99</body> 100</html> 101