Mercurial > hg > index.cgi

annotate docs/manual/x946.html @ 563:8c6c3363e18e

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