LWTools: docs/manual/x807.html annotate

annotate docs/manual/x807.html @ 260:c5b1dd523ac4

Make default build use -O3 Because it yields such an impressive speedup, make the default build use -O3 instead of -g. If you need the debugging stuff, you can set CFLAGS=-g before building.

author	William Astle <lost@l-w.ca>
date	Mon, 04 Feb 2013 20:35:47 -0700
parents	155799f6cfa5
children	c4853a54b4a1

rev	line source
254 155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	2 <HTML
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	3 ><HEAD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	4 ><TITLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	5 >Linking Scripts</TITLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	6 ><META
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	7 NAME="GENERATOR"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	9 REL="HOME"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	10 TITLE="LW Tool Chain"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	11 HREF="index.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	12 REL="UP"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	13 TITLE="LWLINK"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	14 HREF="c693.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	15 REL="PREVIOUS"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	16 TITLE="Linker Operation"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	17 HREF="x793.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	18 REL="NEXT"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	19 TITLE="Format Specific Linking Notes"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	20 HREF="x864.html"></HEAD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	21 ><BODY
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	22 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	23 BGCOLOR="#FFFFFF"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	24 TEXT="#000000"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	25 LINK="#0000FF"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	26 VLINK="#840084"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	27 ALINK="#0000FF"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	28 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	29 CLASS="NAVHEADER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	30 ><TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	31 SUMMARY="Header navigation table"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	32 WIDTH="100%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	33 BORDER="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	34 CELLPADDING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	35 CELLSPACING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	36 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	37 ><TH
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	38 COLSPAN="3"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	39 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	40 >LW Tool Chain</TH
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	41 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	42 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	43 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	44 WIDTH="10%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	45 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	46 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	47 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	48 HREF="x793.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	49 ACCESSKEY="P"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	50 >Prev</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	51 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	52 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	53 WIDTH="80%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	54 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	55 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	56 >Chapter 4. LWLINK</TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	57 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	58 WIDTH="10%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	59 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	60 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	61 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	62 HREF="x864.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	63 ACCESSKEY="N"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	64 >Next</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	65 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	66 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	67 ></TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	68 ><HR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	69 ALIGN="LEFT"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	70 WIDTH="100%"></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	71 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	72 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	73 ><H1
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	74 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	75 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	76 NAME="AEN807"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	77 >4.3. Linking Scripts</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	78 ></H1
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	79 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	80 >A linker script is used to instruct the linker about how to assemble the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	81 various sections into a completed binary. It consists of a series of
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	82 directives which are considered in the order they are encountered.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	83 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	84 >The sections will appear in the resulting binary in the order they are
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	85 specified in the script file. If a referenced section is not found, the linker will behave as though the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	86 section did exist but had a zero size, no relocations, and no exports.
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	87 A section should only be referenced once. Any subsequent references will have
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	88 an undefined effect.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	89 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	90 >All numbers are in linking scripts are specified in hexadecimal. All directives
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	91 are case sensitive although the hexadecimal numbers are not.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	92 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	93 >A section name can be specified as a "*", then any section not
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	94 already matched by the script will be matched. The "*" can be followed
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	95 by a comma and a flag to narrow the section down slightly, also.
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	96 If the flag is "!bss", then any section that is not flagged as a bss section
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	97 will be matched. If the flag is "bss", then any section that is flagged as
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	98 bss will be matched.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	99 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	100 >The following directives are understood in a linker script.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	101 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	102 ></P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	103 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	104 CLASS="VARIABLELIST"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	105 ><DL
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	106 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	107 >sectopt <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	108 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	109 >section</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	110 > padafter <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	111 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	112 >byte,...</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	113 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	114 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	115 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	116 > This will cause the linker to append the specified list of byte values
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	117 (specified in hexadecimal separated by commas) to the end of the named
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	118 section. This is done once all instances of the specified section are
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	119 collected together. This has no effect if the specified section does not
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	120 appear anywhere in any of the objects specified for linking. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	121 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	122 > If code depends on the presence of this padding somewhere, it is sufficient
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	123 to include an empty section of the specified name in the object that depends
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	124 on it. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	125 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	126 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	127 >define basesympat <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	128 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	129 >string</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	130 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	131 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	132 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	133 > This causes the linker to define a symbol for the ultimate base address of
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	134 each section using the pattern specified by <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	135 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	136 >string</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	137 >.
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	138 In the string, %s can appear exactly once and will be replaced with the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	139 section name. The base address is calculated after all instances of each
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	140 section have been collapsed together. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	141 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	142 > It should be noted that if none of the objects to be linked contains a
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	143 particular section name, there will be no base symbol defined for it, even
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	144 if it is listed explicitly in the link script. If code depends on the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	145 presence of these symbols, it is sufficient to include an empty section of
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	146 the specified name in the object that depends on it. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	147 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	148 > If the pattern resolves to the same string for multiple
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	149 sections, the results are undefined. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	150 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	151 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	152 >define lensympat <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	153 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	154 >string</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	155 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	156 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	157 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	158 > This causes the linker to define a symbol for the ultimate length of each
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	159 section using the pattern specified by <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	160 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	161 >string</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	162 >. In
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	163 the string, %s can appear exactly once and will be replaced with the section
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	164 name. The length is calculated after all instances of a section have been
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	165 collapsed together. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	166 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	167 > It should be noted that if none of the objects to be linked contains a
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	168 particular section name, there will be no length symbol defined for it, even
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	169 if it is listed explicitly in the link script. If code depends on the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	170 presence of these symbols, it is sufficient to include an empty section of
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	171 the specified name in the object that depends on it. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	172 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	173 >If the pattern resolves to the same string for multiple
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	174 sections, the results are undefined. </P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	175 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	176 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	177 >section <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	178 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	179 >name</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	180 > load <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	181 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	182 >addr</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	183 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	184 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	185 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	186 > This causes the section <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	187 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	188 >name</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	189 > to load at
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	190 <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	191 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	192 >addr</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	193 >. For the raw target, only one "load at" entry is
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	194 allowed for non-bss sections and it must be the first one. For raw targets,
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	195 it affects the addresses the linker assigns to symbols but has no other
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	196 affect on the output. bss sections may all have separate load addresses but
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	197 since they will not appear in the binary anyway, this is okay.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	198 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	199 >For the decb target, each "load" entry will cause a new "block" to be
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	200 output to the binary which will contain the load address. It is legal for
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	201 sections to overlap in this manner - the linker assumes the loader will sort
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	202 everything out.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	203 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	204 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	205 >section <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	206 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	207 >name</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	208 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	209 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	210 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	211 > This will cause the section <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	212 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	213 >name</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	214 > to load after the previously listed
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	215 section.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	216 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	217 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	218 >entry <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	219 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	220 >addr or sym</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	221 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	222 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	223 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	224 >This will cause the execution address (entry point) to be the address
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	225 specified (in hex) or the specified symbol name. The symbol name must
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	226 match a symbol that is exported by one of the object files being linked.
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	227 This has no effect for targets that do not encode the entry point into the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	228 resulting file. If not specified, the entry point is assumed to be address 0
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	229 which is probably not what you want. The default link scripts for targets
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	230 that support this directive automatically starts at the beginning of the
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	231 first section (usually "init" or "code") that is emitted in the binary.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	232 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	233 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	234 >pad <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	235 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	236 >size</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	237 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	238 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	239 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	240 >This will cause the output file to be padded with NUL bytes to be exactly
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	241 <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	242 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	243 >size</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	244 > bytes in length. This only makes sense for a raw target.</P
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	245 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	246 ></DL
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	247 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	248 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	249 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	250 CLASS="NAVFOOTER"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	251 ><HR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	252 ALIGN="LEFT"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	253 WIDTH="100%"><TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	254 SUMMARY="Footer navigation table"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	255 WIDTH="100%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	256 BORDER="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	257 CELLPADDING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	258 CELLSPACING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	259 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	260 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	261 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	262 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	263 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	264 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	265 HREF="x793.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	266 ACCESSKEY="P"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	267 >Prev</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	268 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	269 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	270 WIDTH="34%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	271 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	272 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	273 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	274 HREF="index.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	275 ACCESSKEY="H"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	276 >Home</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	277 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	278 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	279 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	280 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	281 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	282 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	283 HREF="x864.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	284 ACCESSKEY="N"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	285 >Next</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	286 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	287 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	288 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	289 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	290 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	291 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	292 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	293 >Linker Operation</TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	294 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	295 WIDTH="34%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	296 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	297 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	298 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	299 HREF="c693.html"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	300 ACCESSKEY="U"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	301 >Up</A
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	302 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	303 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	304 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	305 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	306 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	307 >Format Specific Linking Notes</TD
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	308 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	309 ></TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	310 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	311 ></BODY
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	312 ></HTML
155799f6cfa5 Add documentation for the FILL pseudo operation William Astle <lost@l-w.ca> parents: diff changeset	313 >

Mercurial > hg > index.cgi

annotate docs/manual/x807.html @ 260:c5b1dd523ac4