Mercurial > hg > index.cgi
diff docs/manual/x795.html @ 236:ce1fdc8d6568
Added ability to add padding after a section when linking.
Added the ability for lwlink to automatically append padding bytes to the
end of a section (once the section instances are merged). This behaviour is
controlled by the link script. See the updated documentation for more
information.
| author | William Astle <lost@l-w.ca> |
|---|---|
| date | Sat, 11 Aug 2012 23:29:57 -0600 |
| parents | d389adbcc4ab |
| children |
line wrap: on
line diff
--- a/docs/manual/x795.html Sat Aug 11 15:18:58 2012 -0600 +++ b/docs/manual/x795.html Sat Aug 11 23:29:57 2012 -0600 @@ -17,7 +17,7 @@ HREF="x781.html"><LINK REL="NEXT" TITLE="Format Specific Linking Notes" -HREF="x843.html"></HEAD +HREF="x852.html"></HEAD ><BODY CLASS="SECTION" BGCOLOR="#FFFFFF" @@ -59,7 +59,7 @@ ALIGN="right" VALIGN="bottom" ><A -HREF="x843.html" +HREF="x852.html" ACCESSKEY="N" >Next</A ></TD @@ -104,6 +104,26 @@ CLASS="VARIABLELIST" ><DL ><DT +>sectopt <CODE +CLASS="PARAMETER" +>section</CODE +> padafter <CODE +CLASS="PARAMETER" +>byte,...</CODE +></DT +><DD +><P +> This will cause the linker to append the specified list of byte values +(specified in hexadecimal separated by commas) to the end of the named +section. This is done once all instances of the specified section are +collected together. This has no effect if the specified section does not +appear anywhere in any of the objects specified for linking. </P +><P +> If code depends on the presence of this padding somewhere, it is sufficient +to include an empty section of the specified name in the object that depends +on it. </P +></DD +><DT >define basesympat <CODE CLASS="PARAMETER" >string</CODE @@ -119,6 +139,12 @@ section name. The base address is calculated after all instances of each section have been collapsed together. </P ><P +> It should be noted that if none of the objects to be linked contains a +particular section name, there will be no base symbol defined for it, even +if it is listed explicitly in the link script. If code depends on the +presence of these symbols, it is sufficient to include an empty section of +the specified name in the object that depends on it. </P +><P > If the pattern resolves to the same string for multiple sections, the results are undefined. </P ></DD @@ -138,6 +164,12 @@ name. The length is calculated after all instances of a section have been collapsed together. </P ><P +> It should be noted that if none of the objects to be linked contains a +particular section name, there will be no length symbol defined for it, even +if it is listed explicitly in the link script. If code depends on the +presence of these symbols, it is sufficient to include an empty section of +the specified name in the object that depends on it. </P +><P >If the pattern resolves to the same string for multiple sections, the results are undefined. </P ></DD @@ -248,7 +280,7 @@ ALIGN="right" VALIGN="top" ><A -HREF="x843.html" +HREF="x852.html" ACCESSKEY="N" >Next</A ></TD