Mercurial > hg > index.cgi
diff docs/manual/manual.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 | 0bc1c88fe776 |
line wrap: on
line diff
--- a/docs/manual/manual.html Sat Aug 11 15:18:58 2012 -0600 +++ b/docs/manual/manual.html Sat Aug 11 23:29:57 2012 -0600 @@ -198,14 +198,14 @@ ></DT ><DT >4.4. <A -HREF="#AEN843" +HREF="#AEN852" >Format Specific Linking Notes</A ></DT ><DD ><DL ><DT >4.4.1. <A -HREF="#AEN846" +HREF="#AEN855" >OS9 Modules</A ></DT ></DL @@ -214,14 +214,14 @@ ></DD ><DT >5. <A -HREF="#AEN858" +HREF="#AEN867" >Libraries and LWAR</A ></DT ><DD ><DL ><DT >5.1. <A -HREF="#AEN862" +HREF="#AEN871" >Command Line Options</A ></DT ></DL @@ -243,12 +243,12 @@ ></DT ><DT >6-1. <A -HREF="#AEN945" +HREF="#AEN954" >Object File Term Types</A ></DT ><DT >6-2. <A -HREF="#AEN975" +HREF="#AEN984" >Object File Operator Numbers</A ></DT ></DL @@ -2520,6 +2520,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 @@ -2535,6 +2555,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 @@ -2554,6 +2580,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 @@ -2635,7 +2667,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN843" +NAME="AEN852" >4.4. Format Specific Linking Notes</A ></H2 ><P @@ -2648,7 +2680,7 @@ ><HR><H3 CLASS="SECTION" ><A -NAME="AEN846" +NAME="AEN855" >4.4.1. OS9 Modules</A ></H3 ><P @@ -2724,7 +2756,7 @@ CLASS="CHAPTER" ><HR><H1 ><A -NAME="AEN858" +NAME="AEN867" ></A >Chapter 5. Libraries and LWAR</H1 ><P @@ -2743,7 +2775,7 @@ ><HR><H2 CLASS="SECTION" ><A -NAME="AEN862" +NAME="AEN871" >5.1. Command Line Options</A ></H2 ><P @@ -2944,7 +2976,7 @@ ><DIV CLASS="TABLE" ><A -NAME="AEN945" +NAME="AEN954" ></A ><P ><B @@ -3016,7 +3048,7 @@ ><DIV CLASS="TABLE" ><A -NAME="AEN975" +NAME="AEN984" ></A ><P ><B