diff docs/manual.docbook.sgml @ 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 7da0452512b2
children ce1fdc8d6568
line wrap: on
line diff
--- a/docs/manual.docbook.sgml	Thu Jul 19 13:17:30 2012 -0600
+++ b/docs/manual.docbook.sgml	Fri Aug 10 23:47:56 2012 -0600
@@ -1982,6 +1982,46 @@
 
 <para>The following directives are understood in a linker script.</para>
 <variablelist>
+
+<varlistentry>
+<term>define basesympat <parameter>string</parameter></term>
+<listitem>
+
+<para>
+
+This causes the linker to define a symbol for the ultimate base address of
+each section using the pattern specified by <parameter>string</parameter>. 
+In the string, %s can appear exactly once and will be replaced with the
+section name.  The base address is calculated after all instances of each
+section have been collapsed together.
+
+</para>
+<para>  If the pattern resolves to the same string for multiple
+sections, the results are undefined.
+
+</para>
+</listitem>
+
+<varlistentry>
+<term>define lensympat <parameter>string</parameter></term>
+<listitem>
+
+<para>
+
+This causes the linker to define a symbol for the ultimate length of each
+section using the pattern specified by <parameter>string</parameter>.  In
+the string, %s can appear exactly once and will be replaced with the section
+name.  The length is calculated after all instances of a section have been
+collapsed together.
+
+</para>
+<para>
+If the pattern resolves to the same string for multiple
+sections, the results are undefined.
+
+</para>
+</listitem>
+
 <varlistentry>
 <term>section <parameter>name</parameter> load <parameter>addr</parameter></term>
 <listitem><para>