Mercurial > hg > index.cgi
annotate docs/manual/x942.html @ 558:7fb2047ccdee
Flag version number to indicate ongoing development
author | William Astle <lost@l-w.ca> |
---|---|
date | Fri, 08 Sep 2023 00:35:43 -0600 |
parents | 543b5d1341d2 |
children |
rev | line source |
---|---|
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
2 <HTML |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
3 ><HEAD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
4 ><TITLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
5 >Linking Scripts</TITLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
6 ><META |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
7 NAME="GENERATOR" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
9 REL="HOME" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
10 TITLE="LW Tool Chain" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
11 HREF="index.html"><LINK |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
12 REL="UP" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
13 TITLE="LWLINK" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
14 HREF="c828.html"><LINK |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
15 REL="PREVIOUS" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
16 TITLE="Linker Operation" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
17 HREF="x928.html"><LINK |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
18 REL="NEXT" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
19 TITLE="Format Specific Linking Notes" |
533
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
20 HREF="x1009.html"></HEAD |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
21 ><BODY |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
22 CLASS="SECTION" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
23 BGCOLOR="#FFFFFF" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
24 TEXT="#000000" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
25 LINK="#0000FF" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
26 VLINK="#840084" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
27 ALINK="#0000FF" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
28 ><DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
29 CLASS="NAVHEADER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
30 ><TABLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
31 SUMMARY="Header navigation table" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
32 WIDTH="100%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
33 BORDER="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
34 CELLPADDING="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
35 CELLSPACING="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
36 ><TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
37 ><TH |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
38 COLSPAN="3" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
39 ALIGN="center" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
40 >LW Tool Chain</TH |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
41 ></TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
42 ><TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
43 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
44 WIDTH="10%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
45 ALIGN="left" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
46 VALIGN="bottom" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
47 ><A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
48 HREF="x928.html" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
49 ACCESSKEY="P" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
50 >Prev</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
51 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
52 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
53 WIDTH="80%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
54 ALIGN="center" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
55 VALIGN="bottom" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
56 >Chapter 4. LWLINK</TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
57 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
58 WIDTH="10%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
59 ALIGN="right" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
60 VALIGN="bottom" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
61 ><A |
533
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
62 HREF="x1009.html" |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
63 ACCESSKEY="N" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
64 >Next</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
65 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
66 ></TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
67 ></TABLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
68 ><HR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
69 ALIGN="LEFT" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
70 WIDTH="100%"></DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
71 ><DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
72 CLASS="SECTION" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
73 ><H1 |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
74 CLASS="SECTION" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
75 ><A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
76 NAME="AEN942" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
77 >4.3. Linking Scripts</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
78 ></H1 |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
79 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
80 >A linker script is used to instruct the linker about how to assemble the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
81 various sections into a completed binary. It consists of a series of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
82 directives which are considered in the order they are encountered.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
83 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
84 >The sections will appear in the resulting binary in the order they are |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
85 specified in the script file. If a referenced section is not found, the linker will behave as though the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
86 section did exist but had a zero size, no relocations, and no exports. |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
87 A section should only be referenced once. Any subsequent references will have |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
88 an undefined effect.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
89 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
90 >All numbers are in linking scripts are specified in hexadecimal. All directives |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
91 are case sensitive although the hexadecimal numbers are not.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
92 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
93 >A section name can be specified as a "*", then any section not |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
94 already matched by the script will be matched. The "*" can be followed |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
95 by a comma and a flag to narrow the section down slightly, also. |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
96 If the flag is "!bss", then any section that is not flagged as a bss section |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
97 will be matched. If the flag is "bss", then any section that is flagged as |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
98 bss will be matched.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
99 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
100 >The following directives are understood in a linker script.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
101 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
102 ></P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
103 ><DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
104 CLASS="VARIABLELIST" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
105 ><DL |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
106 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
107 >sectopt <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
108 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
109 >section</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
110 > padafter <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
111 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
112 >byte,...</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
113 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
114 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
115 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
116 > This will cause the linker to append the specified list of byte values |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
117 (specified in hexadecimal separated by commas) to the end of the named |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
118 section. This is done once all instances of the specified section are |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
119 collected together. This has no effect if the specified section does not |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
120 appear anywhere in any of the objects specified for linking. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
121 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
122 > If code depends on the presence of this padding somewhere, it is sufficient |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
123 to include an empty section of the specified name in the object that depends |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
124 on it. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
125 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
126 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
127 >define basesympat <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
128 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
129 >string</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
130 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
131 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
132 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
133 > This causes the linker to define a symbol for the ultimate base address of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
134 each section using the pattern specified by <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
135 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
136 >string</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
137 >. |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
138 In the string, %s can appear exactly once and will be replaced with the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
139 section name. The base address is calculated after all instances of each |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
140 section have been collapsed together. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
141 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
142 > It should be noted that if none of the objects to be linked contains a |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
143 particular section name, there will be no base symbol defined for it, even |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
144 if it is listed explicitly in the link script. If code depends on the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
145 presence of these symbols, it is sufficient to include an empty section of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
146 the specified name in the object that depends on it. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
147 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
148 > If the pattern resolves to the same string for multiple |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
149 sections, the results are undefined. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
150 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
151 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
152 >define lensympat <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
153 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
154 >string</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
155 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
156 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
157 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
158 > This causes the linker to define a symbol for the ultimate length of each |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
159 section using the pattern specified by <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
160 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
161 >string</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
162 >. In |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
163 the string, %s can appear exactly once and will be replaced with the section |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
164 name. The length is calculated after all instances of a section have been |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
165 collapsed together. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
166 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
167 > It should be noted that if none of the objects to be linked contains a |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
168 particular section name, there will be no length symbol defined for it, even |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
169 if it is listed explicitly in the link script. If code depends on the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
170 presence of these symbols, it is sufficient to include an empty section of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
171 the specified name in the object that depends on it. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
172 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
173 >If the pattern resolves to the same string for multiple |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
174 sections, the results are undefined. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
175 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
176 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
177 >section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
178 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
179 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
180 > load <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
181 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
182 >addr</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
183 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
184 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
185 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
186 > This causes the section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
187 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
188 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
189 > to load at |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
190 <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
191 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
192 >addr</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
193 >. For the raw target, only one "load at" entry is |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
194 allowed for non-bss sections and it must be the first one. For raw targets, |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
195 it affects the addresses the linker assigns to symbols but has no other |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
196 affect on the output. bss sections may all have separate load addresses but |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
197 since they will not appear in the binary anyway, this is okay.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
198 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
199 >For the decb target, each "load" entry will cause a new "block" to be |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
200 output to the binary which will contain the load address. It is legal for |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
201 sections to overlap in this manner - the linker assumes the loader will sort |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
202 everything out.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
203 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
204 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
205 >section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
206 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
207 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
208 > high <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
209 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
210 >addr</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
211 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
212 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
213 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
214 > This causes the section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
215 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
216 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
217 > to load with its end |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
218 address just below <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
219 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
220 >addr</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
221 >. Subsequent sections are |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
222 loaded at progressively lower addresses. This may lead to inefficient file |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
223 encoding for some targets. As of this writing, it will also almost |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
224 certainly do the wrong thing for a raw target. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
225 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
226 > This is useful for aligning a block of code with high memory. As an |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
227 example, if the total size of a section is $100 bytes and a high address of |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
228 $FE00 is specified, the section will actually load at $FD00. </P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
229 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
230 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
231 >section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
232 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
233 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
234 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
235 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
236 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
237 > This will cause the section <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
238 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
239 >name</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
240 > to load after the previously listed |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
241 section.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
242 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
243 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
244 >entry <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
245 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
246 >addr or sym</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
247 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
248 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
249 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
250 >This will cause the execution address (entry point) to be the address |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
251 specified (in hex) or the specified symbol name. The symbol name must |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
252 match a symbol that is exported by one of the object files being linked. |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
253 This has no effect for targets that do not encode the entry point into the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
254 resulting file. If not specified, the entry point is assumed to be address 0 |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
255 which is probably not what you want. The default link scripts for targets |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
256 that support this directive automatically starts at the beginning of the |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
257 first section (usually "init" or "code") that is emitted in the binary.</P |
533
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
258 ><P |
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
259 >Note that if you use a numeric value here, you will need to ensure |
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
260 it starts with a digit. That may mean adding a leading zero.</P |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
261 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
262 ><DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
263 >pad <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
264 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
265 >size</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
266 ></DT |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
267 ><DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
268 ><P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
269 >This will cause the output file to be padded with NUL bytes to be exactly |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
270 <CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
271 CLASS="PARAMETER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
272 >size</CODE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
273 > bytes in length. This only makes sense for a raw target.</P |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
274 ></DD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
275 ></DL |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
276 ></DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
277 ></DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
278 ><DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
279 CLASS="NAVFOOTER" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
280 ><HR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
281 ALIGN="LEFT" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
282 WIDTH="100%"><TABLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
283 SUMMARY="Footer navigation table" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
284 WIDTH="100%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
285 BORDER="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
286 CELLPADDING="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
287 CELLSPACING="0" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
288 ><TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
289 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
290 WIDTH="33%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
291 ALIGN="left" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
292 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
293 ><A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
294 HREF="x928.html" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
295 ACCESSKEY="P" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
296 >Prev</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
297 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
298 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
299 WIDTH="34%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
300 ALIGN="center" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
301 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
302 ><A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
303 HREF="index.html" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
304 ACCESSKEY="H" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
305 >Home</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
306 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
307 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
308 WIDTH="33%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
309 ALIGN="right" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
310 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
311 ><A |
533
543b5d1341d2
Add note to manual about numeric entry addresses in scripts
William Astle <lost@l-w.ca>
parents:
517
diff
changeset
|
312 HREF="x1009.html" |
517
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
313 ACCESSKEY="N" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
314 >Next</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
315 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
316 ></TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
317 ><TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
318 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
319 WIDTH="33%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
320 ALIGN="left" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
321 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
322 >Linker Operation</TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
323 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
324 WIDTH="34%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
325 ALIGN="center" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
326 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
327 ><A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
328 HREF="c828.html" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
329 ACCESSKEY="U" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
330 >Up</A |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
331 ></TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
332 ><TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
333 WIDTH="33%" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
334 ALIGN="right" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
335 VALIGN="top" |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
336 >Format Specific Linking Notes</TD |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
337 ></TR |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
338 ></TABLE |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
339 ></DIV |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
340 ></BODY |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
341 ></HTML |
1faf14de9d04
Update manual to correctly reflect forwardrefmax behaviour
William Astle <lost@l-w.ca>
parents:
diff
changeset
|
342 > |