87 lines
		
	
	
	
		
			4.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
		
		
			
		
	
	
			87 lines
		
	
	
	
		
			4.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| 
								 | 
							
								<html lang="en">
							 | 
						||
| 
								 | 
							
								<head>
							 | 
						||
| 
								 | 
							
								<title>Scripts - Untitled</title>
							 | 
						||
| 
								 | 
							
								<meta http-equiv="Content-Type" content="text/html">
							 | 
						||
| 
								 | 
							
								<meta name="description" content="Untitled">
							 | 
						||
| 
								 | 
							
								<meta name="generator" content="makeinfo 4.7">
							 | 
						||
| 
								 | 
							
								<link title="Top" rel="start" href="index.html#Top">
							 | 
						||
| 
								 | 
							
								<link rel="prev" href="Invocation.html#Invocation" title="Invocation">
							 | 
						||
| 
								 | 
							
								<link rel="next" href="Machine-Dependent.html#Machine-Dependent" title="Machine Dependent">
							 | 
						||
| 
								 | 
							
								<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
							 | 
						||
| 
								 | 
							
								<!--
							 | 
						||
| 
								 | 
							
								This file documents the GNU linker LD
							 | 
						||
| 
								 | 
							
								(GNU Binutils)
							 | 
						||
| 
								 | 
							
								version 2.19.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
							 | 
						||
| 
								 | 
							
								2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Permission is granted to copy, distribute and/or modify this document
							 | 
						||
| 
								 | 
							
								under the terms of the GNU Free Documentation License, Version 1.1
							 | 
						||
| 
								 | 
							
								or any later version published by the Free Software Foundation;
							 | 
						||
| 
								 | 
							
								with no Invariant Sections, with no Front-Cover Texts, and with no
							 | 
						||
| 
								 | 
							
								Back-Cover Texts.  A copy of the license is included in the
							 | 
						||
| 
								 | 
							
								section entitled ``GNU Free Documentation License''.-->
							 | 
						||
| 
								 | 
							
								<meta http-equiv="Content-Style-Type" content="text/css">
							 | 
						||
| 
								 | 
							
								<style type="text/css"><!--
							 | 
						||
| 
								 | 
							
								  pre.display { font-family:inherit }
							 | 
						||
| 
								 | 
							
								  pre.format  { font-family:inherit }
							 | 
						||
| 
								 | 
							
								  pre.smalldisplay { font-family:inherit; font-size:smaller }
							 | 
						||
| 
								 | 
							
								  pre.smallformat  { font-family:inherit; font-size:smaller }
							 | 
						||
| 
								 | 
							
								  pre.smallexample { font-size:smaller }
							 | 
						||
| 
								 | 
							
								  pre.smalllisp    { font-size:smaller }
							 | 
						||
| 
								 | 
							
								  span.sc { font-variant:small-caps }
							 | 
						||
| 
								 | 
							
								  span.roman { font-family: serif; font-weight: normal; } 
							 | 
						||
| 
								 | 
							
								--></style>
							 | 
						||
| 
								 | 
							
								</head>
							 | 
						||
| 
								 | 
							
								<body>
							 | 
						||
| 
								 | 
							
								<div class="node">
							 | 
						||
| 
								 | 
							
								<p>
							 | 
						||
| 
								 | 
							
								<a name="Scripts"></a>Next: <a rel="next" accesskey="n" href="Machine-Dependent.html#Machine-Dependent">Machine Dependent</a>,
							 | 
						||
| 
								 | 
							
								Previous: <a rel="previous" accesskey="p" href="Invocation.html#Invocation">Invocation</a>,
							 | 
						||
| 
								 | 
							
								Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
							 | 
						||
| 
								 | 
							
								<hr><br>
							 | 
						||
| 
								 | 
							
								</div>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<h2 class="chapter">3 Linker Scripts</h2>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<p><a name="index-scripts-307"></a><a name="index-linker-scripts-308"></a><a name="index-command-files-309"></a>Every link is controlled by a <dfn>linker script</dfn>.  This script is
							 | 
						||
| 
								 | 
							
								written in the linker command language.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   <p>The main purpose of the linker script is to describe how the sections in
							 | 
						||
| 
								 | 
							
								the input files should be mapped into the output file, and to control
							 | 
						||
| 
								 | 
							
								the memory layout of the output file.  Most linker scripts do nothing
							 | 
						||
| 
								 | 
							
								more than this.  However, when necessary, the linker script can also
							 | 
						||
| 
								 | 
							
								direct the linker to perform many other operations, using the commands
							 | 
						||
| 
								 | 
							
								described below.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   <p>The linker always uses a linker script.  If you do not supply one
							 | 
						||
| 
								 | 
							
								yourself, the linker will use a default script that is compiled into the
							 | 
						||
| 
								 | 
							
								linker executable.  You can use the <span class="samp">--verbose</span> command line option
							 | 
						||
| 
								 | 
							
								to display the default linker script.  Certain command line options,
							 | 
						||
| 
								 | 
							
								such as <span class="samp">-r</span> or <span class="samp">-N</span>, will affect the default linker script.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   <p>You may supply your own linker script by using the <span class="samp">-T</span> command
							 | 
						||
| 
								 | 
							
								line option.  When you do this, your linker script will replace the
							 | 
						||
| 
								 | 
							
								default linker script.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   <p>You may also use linker scripts implicitly by naming them as input files
							 | 
						||
| 
								 | 
							
								to the linker, as though they were files to be linked.  See <a href="Implicit-Linker-Scripts.html#Implicit-Linker-Scripts">Implicit Linker Scripts</a>.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								<ul class="menu">
							 | 
						||
| 
								 | 
							
								<li><a accesskey="1" href="Basic-Script-Concepts.html#Basic-Script-Concepts">Basic Script Concepts</a>: 	Basic Linker Script Concepts
							 | 
						||
| 
								 | 
							
								<li><a accesskey="2" href="Script-Format.html#Script-Format">Script Format</a>: 		Linker Script Format
							 | 
						||
| 
								 | 
							
								<li><a accesskey="3" href="Simple-Example.html#Simple-Example">Simple Example</a>: 		Simple Linker Script Example
							 | 
						||
| 
								 | 
							
								<li><a accesskey="4" href="Simple-Commands.html#Simple-Commands">Simple Commands</a>: 		Simple Linker Script Commands
							 | 
						||
| 
								 | 
							
								<li><a accesskey="5" href="Assignments.html#Assignments">Assignments</a>: 			Assigning Values to Symbols
							 | 
						||
| 
								 | 
							
								<li><a accesskey="6" href="SECTIONS.html#SECTIONS">SECTIONS</a>: 			SECTIONS Command
							 | 
						||
| 
								 | 
							
								<li><a accesskey="7" href="MEMORY.html#MEMORY">MEMORY</a>: 			MEMORY Command
							 | 
						||
| 
								 | 
							
								<li><a accesskey="8" href="PHDRS.html#PHDRS">PHDRS</a>: 			PHDRS Command
							 | 
						||
| 
								 | 
							
								<li><a accesskey="9" href="VERSION.html#VERSION">VERSION</a>: 			VERSION Command
							 | 
						||
| 
								 | 
							
								<li><a href="Expressions.html#Expressions">Expressions</a>: 			Expressions in Linker Scripts
							 | 
						||
| 
								 | 
							
								<li><a href="Implicit-Linker-Scripts.html#Implicit-Linker-Scripts">Implicit Linker Scripts</a>: 	Implicit Linker Scripts
							 | 
						||
| 
								 | 
							
								</ul>
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   </body></html>
							 | 
						||
| 
								 | 
							
								
							 |