comparison docs/manual/x807.html @ 316:c4853a54b4a1

Documented new "high" option for link scripts.
author William Astle <lost@l-w.ca>
date Wed, 27 Nov 2013 16:08:02 -0700
parents 155799f6cfa5
children
comparison
equal deleted inserted replaced
315:fcd103148aa6 316:c4853a54b4a1
15 REL="PREVIOUS" 15 REL="PREVIOUS"
16 TITLE="Linker Operation" 16 TITLE="Linker Operation"
17 HREF="x793.html"><LINK 17 HREF="x793.html"><LINK
18 REL="NEXT" 18 REL="NEXT"
19 TITLE="Format Specific Linking Notes" 19 TITLE="Format Specific Linking Notes"
20 HREF="x864.html"></HEAD 20 HREF="x873.html"></HEAD
21 ><BODY 21 ><BODY
22 CLASS="SECTION" 22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF" 23 BGCOLOR="#FFFFFF"
24 TEXT="#000000" 24 TEXT="#000000"
25 LINK="#0000FF" 25 LINK="#0000FF"
57 ><TD 57 ><TD
58 WIDTH="10%" 58 WIDTH="10%"
59 ALIGN="right" 59 ALIGN="right"
60 VALIGN="bottom" 60 VALIGN="bottom"
61 ><A 61 ><A
62 HREF="x864.html" 62 HREF="x873.html"
63 ACCESSKEY="N" 63 ACCESSKEY="N"
64 >Next</A 64 >Next</A
65 ></TD 65 ></TD
66 ></TR 66 ></TR
67 ></TABLE 67 ></TABLE
198 ><P 198 ><P
199 >For the decb target, each "load" entry will cause a new "block" to be 199 >For the decb target, each "load" entry will cause a new "block" to be
200 output to the binary which will contain the load address. It is legal for 200 output to the binary which will contain the load address. It is legal for
201 sections to overlap in this manner - the linker assumes the loader will sort 201 sections to overlap in this manner - the linker assumes the loader will sort
202 everything out.</P 202 everything out.</P
203 ></DD
204 ><DT
205 >section <CODE
206 CLASS="PARAMETER"
207 >name</CODE
208 > high <CODE
209 CLASS="PARAMETER"
210 >addr</CODE
211 ></DT
212 ><DD
213 ><P
214 >&#13;This causes the section <CODE
215 CLASS="PARAMETER"
216 >name</CODE
217 > to load with its end
218 address just below <CODE
219 CLASS="PARAMETER"
220 >addr</CODE
221 >. Subsequent sections are
222 loaded at progressively lower addresses. This may lead to inefficient file
223 encoding for some targets. As of this writing, it will also almost
224 certainly do the wrong thing for a raw target.&#13;</P
225 ><P
226 >&#13;This is useful for aligning a block of code with high memory. As an
227 example, if the total size of a section is $100 bytes and a high address of
228 $FE00 is specified, the section will actually load at $FD00.&#13;</P
203 ></DD 229 ></DD
204 ><DT 230 ><DT
205 >section <CODE 231 >section <CODE
206 CLASS="PARAMETER" 232 CLASS="PARAMETER"
207 >name</CODE 233 >name</CODE
278 ><TD 304 ><TD
279 WIDTH="33%" 305 WIDTH="33%"
280 ALIGN="right" 306 ALIGN="right"
281 VALIGN="top" 307 VALIGN="top"
282 ><A 308 ><A
283 HREF="x864.html" 309 HREF="x873.html"
284 ACCESSKEY="N" 310 ACCESSKEY="N"
285 >Next</A 311 >Next</A
286 ></TD 312 ></TD
287 ></TR 313 ></TR
288 ><TR 314 ><TR