comparison docs/manual/x795.html @ 234:d389adbcc4ab

Added section base and length symbols to lwlink Added the ability for a link script to define section base and section length symbols when linking. These symbols are searched for when an external reference is resolved before looking up any symbols in the various objects being linked. Also documented the new link script directives and added such directives to all default link scripts.
author William Astle <lost@l-w.ca>
date Fri, 10 Aug 2012 23:47:56 -0600
parents 2cc599f1bebf
children ce1fdc8d6568
comparison
equal deleted inserted replaced
233:7887a48b74df 234:d389adbcc4ab
15 REL="PREVIOUS" 15 REL="PREVIOUS"
16 TITLE="Linker Operation" 16 TITLE="Linker Operation"
17 HREF="x781.html"><LINK 17 HREF="x781.html"><LINK
18 REL="NEXT" 18 REL="NEXT"
19 TITLE="Format Specific Linking Notes" 19 TITLE="Format Specific Linking Notes"
20 HREF="x829.html"></HEAD 20 HREF="x843.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="x829.html" 62 HREF="x843.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
101 ><P 101 ><P
102 ></P 102 ></P
103 ><DIV 103 ><DIV
104 CLASS="VARIABLELIST" 104 CLASS="VARIABLELIST"
105 ><DL 105 ><DL
106 ><DT
107 >define basesympat <CODE
108 CLASS="PARAMETER"
109 >string</CODE
110 ></DT
111 ><DD
112 ><P
113 >&#13;This causes the linker to define a symbol for the ultimate base address of
114 each section using the pattern specified by <CODE
115 CLASS="PARAMETER"
116 >string</CODE
117 >.
118 In the string, %s can appear exactly once and will be replaced with the
119 section name. The base address is calculated after all instances of each
120 section have been collapsed together.&#13;</P
121 ><P
122 > If the pattern resolves to the same string for multiple
123 sections, the results are undefined.&#13;</P
124 ></DD
125 ><DT
126 >define lensympat <CODE
127 CLASS="PARAMETER"
128 >string</CODE
129 ></DT
130 ><DD
131 ><P
132 >&#13;This causes the linker to define a symbol for the ultimate length of each
133 section using the pattern specified by <CODE
134 CLASS="PARAMETER"
135 >string</CODE
136 >. In
137 the string, %s can appear exactly once and will be replaced with the section
138 name. The length is calculated after all instances of a section have been
139 collapsed together.&#13;</P
140 ><P
141 >If the pattern resolves to the same string for multiple
142 sections, the results are undefined.&#13;</P
143 ></DD
106 ><DT 144 ><DT
107 >section <CODE 145 >section <CODE
108 CLASS="PARAMETER" 146 CLASS="PARAMETER"
109 >name</CODE 147 >name</CODE
110 > load <CODE 148 > load <CODE
208 ><TD 246 ><TD
209 WIDTH="33%" 247 WIDTH="33%"
210 ALIGN="right" 248 ALIGN="right"
211 VALIGN="top" 249 VALIGN="top"
212 ><A 250 ><A
213 HREF="x829.html" 251 HREF="x843.html"
214 ACCESSKEY="N" 252 ACCESSKEY="N"
215 >Next</A 253 >Next</A
216 ></TD 254 ></TD
217 ></TR 255 ></TR
218 ><TR 256 ><TR