Mercurial > hg > index.cgi
diff docs/manual.docbook.sgml @ 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.docbook.sgml Sat Aug 11 15:18:58 2012 -0600 +++ b/docs/manual.docbook.sgml Sat Aug 11 23:29:57 2012 -0600 @@ -1984,6 +1984,30 @@ <variablelist> <varlistentry> +<term>sectopt <parameter>section</parameter> padafter <parameter>byte,...</parameter></term> +<listitem> + +<para> + +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. + +</para> + +<para> + +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. + +</para> + +</listitem> + +<varlistentry> <term>define basesympat <parameter>string</parameter></term> <listitem> @@ -1996,6 +2020,18 @@ section have been collapsed together. </para> + +<para> + +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. + +</para> + + <para> If the pattern resolves to the same string for multiple sections, the results are undefined. @@ -2015,6 +2051,18 @@ collapsed together. </para> + +<para> + +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. + +</para> + + <para> If the pattern resolves to the same string for multiple sections, the results are undefined.