Mercurial > hg > index.cgi

annotate docs/manual/c887.html @ 179:606123758641

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added --sysroot support to lwlink and the ld wrapper script
author lost@l-w.ca
date Thu, 15 Sep 2011 17:08:16 -0600
parents 1e0a0e6cd918
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
168
1e0a0e6cd918 Documentation updates
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">
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
2 <HTML
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
3 ><HEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
4 ><TITLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
5 >Object Files</TITLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
6 ><META
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
7 NAME="GENERATOR"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
9 REL="HOME"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
10 TITLE="LW Tool Chain"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
11 HREF="index.html"><LINK
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
12 REL="PREVIOUS"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
13 TITLE="Libraries and LWAR"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
14 HREF="c825.html"></HEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
15 ><BODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
16 CLASS="CHAPTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
17 BGCOLOR="#FFFFFF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
18 TEXT="#000000"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
19 LINK="#0000FF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
20 VLINK="#840084"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
21 ALINK="#0000FF"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
22 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
23 CLASS="NAVHEADER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
24 ><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
25 SUMMARY="Header navigation table"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
26 WIDTH="100%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
27 BORDER="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
28 CELLPADDING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
29 CELLSPACING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
30 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
31 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
32 COLSPAN="3"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
33 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
34 >LW Tool Chain</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
35 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
36 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
37 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
38 WIDTH="10%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
39 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
40 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
41 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
42 HREF="c825.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
43 ACCESSKEY="P"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
44 >Prev</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
45 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
46 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
47 WIDTH="80%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
48 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
49 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
50 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
51 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
52 WIDTH="10%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
53 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
54 VALIGN="bottom"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
55 >&nbsp;</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
56 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
57 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
58 ><HR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
59 ALIGN="LEFT"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
60 WIDTH="100%"></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
61 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
62 CLASS="CHAPTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
63 ><H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
64 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
65 NAME="OBJCHAP"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
66 ></A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
67 >Chapter 6. Object Files</H1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
68 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
69 >LWTOOLS uses a proprietary object file format. It is proprietary in the sense
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
70 that it is specific to LWTOOLS, not that it is a hidden format. It would be
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
71 hard to keep it hidden in an open source tool chain anyway. This chapter
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
72 documents the object file format.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
73 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
74 >An object file consists of a series of sections each of which contains a
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
75 list of exported symbols, a list of incomplete references, and a list of
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
76 "local" symbols which may be used in calculating incomplete references. Each
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
77 section will obviously also contain the object code.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
78 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
79 >Exported symbols must be completely resolved to an address within the
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
80 section it is exported from. That is, an exported symbol must be a constant
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
81 rather than defined in terms of other symbols.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
82 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
83 >Each object file starts with a magic number and version number. The magic
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
84 number is the string "LWOBJ16" for this 16 bit object file format. The only
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
85 defined version number is currently 0. Thus, the first 8 bytes of the object
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
86 file are <FONT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
87 COLOR="RED"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
88 >4C574F424A313600</FONT
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
89 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
90 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
91 >Each section has the following items in order:</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
92 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
93 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
94 ><UL
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
95 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
96 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
97 >section name</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
98 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
99 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
100 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
101 >flags</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
102 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
103 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
104 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
105 >list of local symbols (and addresses within the section)</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
106 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
107 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
108 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
109 >list of exported symbols (and addresses within the section)</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
110 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
111 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
112 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
113 >list of incomplete references along with the expressions to calculate them</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
114 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
115 ><LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
116 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
117 >the actual object code (for non-BSS sections)</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
118 ></LI
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
119 ></UL
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
120 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
121 >The section starts with the name of the section with a NUL termination
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
122 followed by a series of flag bytes terminated by NUL. There are only two
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
123 flag bytes defined. A NUL (0) indicates no more flags and a value of 1
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
124 indicates the section is a BSS section. For a BSS section, no actual
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
125 code is included in the object file.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
126 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
127 >Either a NULL section name or end of file indicate the presence of no more
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
128 sections.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
129 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
130 >Each entry in the exported and local symbols table consists of the symbol
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
131 (NUL terminated) followed by two bytes which contain the value in big endian
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
132 order. The end of a symbol table is indicated by a NULL symbol name.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
133 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
134 >Each entry in the incomplete references table consists of an expression
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
135 followed by a 16 bit offset where the reference goes. Expressions are
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
136 defined as a series of terms up to an "end of expression" term. Each term
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
137 consists of a single byte which identifies the type of term (see below)
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
138 followed by any data required by the term. Then end of the list is flagged
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
139 by a NULL expression (only an end of expression term).</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
140 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
141 CLASS="TABLE"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
142 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
143 NAME="AEN912"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
144 ></A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
145 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
146 ><B
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
147 >Table 6-1. Object File Term Types</B
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
148 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
149 ><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
150 BORDER="1"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
151 FRAME="border"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
152 CLASS="CALSTABLE"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
153 ><COL><COL><THEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
154 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
155 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
156 >TERMTYPE</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
157 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
158 >Meaning</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
159 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
160 ></THEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
161 ><TBODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
162 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
163 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
164 >00</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
165 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
166 >end of expression</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
167 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
168 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
169 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
170 >01</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
171 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
172 >integer (16 bit in big endian order follows)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
173 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
174 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
175 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
176 >02</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
177 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
178 > external symbol reference (NUL terminated symbol name follows)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
179 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
180 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
181 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
182 >03</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
183 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
184 >local symbol reference (NUL terminated symbol name follows)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
185 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
186 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
187 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
188 >04</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
189 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
190 >operator (1 byte operator number)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
191 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
192 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
193 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
194 >05</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
195 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
196 >section base address reference</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
197 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
198 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
199 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
200 >FF</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
201 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
202 >This term will set flags for the expression. Each one of these terms will set a single flag. All of them should be specified first in an expression. If they are not, the behaviour is undefined. The byte following is the flag. Flag 01 indicates an 8 bit relocation. Flag 02 indicates a zero-width relocation (see the EXTDEP pseudo op in LWASM).</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
203 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
204 ></TBODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
205 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
206 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
207 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
208 >External references are resolved using other object files while local
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
209 references are resolved using the local symbol table(s) from this file. This
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
210 allows local symbols that are not exported to have the same names as
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
211 exported symbols or external references.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
212 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
213 CLASS="TABLE"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
214 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
215 NAME="AEN942"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
216 ></A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
217 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
218 ><B
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
219 >Table 6-2. Object File Operator Numbers</B
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
220 ></P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
221 ><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
222 BORDER="1"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
223 FRAME="border"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
224 CLASS="CALSTABLE"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
225 ><COL><COL><THEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
226 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
227 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
228 >Number</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
229 ><TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
230 >Operator</TH
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
231 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
232 ></THEAD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
233 ><TBODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
234 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
235 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
236 >01</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
237 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
238 >addition (+)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
239 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
240 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
241 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
242 >02</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
243 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
244 >subtraction (-)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
245 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
246 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
247 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
248 >03</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
249 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
250 >multiplication (*)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
251 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
252 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
253 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
254 >04</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
255 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
256 >division (/)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
257 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
258 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
259 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
260 >05</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
261 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
262 >modulus (%)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
263 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
264 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
265 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
266 >06</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
267 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
268 >integer division (\) (same as division)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
269 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
270 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
271 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
272 >07</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
273 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
274 >bitwise and</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
275 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
276 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
277 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
278 >08</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
279 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
280 >bitwise or</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
281 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
282 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
283 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
284 >09</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
285 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
286 >bitwise xor</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
287 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
288 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
289 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
290 >0A</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
291 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
292 >boolean and</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
293 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
294 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
295 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
296 >0B</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
297 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
298 >boolean or</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
299 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
300 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
301 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
302 >0C</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
303 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
304 >unary negation, 2's complement (-)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
305 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
306 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
307 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
308 >0D</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
309 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
310 >unary 1's complement (^)</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
311 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
312 ></TBODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
313 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
314 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
315 ><P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
316 >An expression is represented in a postfix manner with both operands for
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
317 binary operators preceding the operator and the single operand for unary
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
318 operators preceding the operator.</P
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
319 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
320 ><DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
321 CLASS="NAVFOOTER"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
322 ><HR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
323 ALIGN="LEFT"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
324 WIDTH="100%"><TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
325 SUMMARY="Footer navigation table"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
326 WIDTH="100%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
327 BORDER="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
328 CELLPADDING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
329 CELLSPACING="0"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
330 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
331 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
332 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
333 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
334 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
335 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
336 HREF="c825.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
337 ACCESSKEY="P"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
338 >Prev</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
339 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
340 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
341 WIDTH="34%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
342 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
343 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
344 ><A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
345 HREF="index.html"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
346 ACCESSKEY="H"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
347 >Home</A
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
348 ></TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
349 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
350 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
351 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
352 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
353 >&nbsp;</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
354 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
355 ><TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
356 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
357 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
358 ALIGN="left"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
359 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
360 >Libraries and LWAR</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
361 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
362 WIDTH="34%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
363 ALIGN="center"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
364 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
365 >&nbsp;</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
366 ><TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
367 WIDTH="33%"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
368 ALIGN="right"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
369 VALIGN="top"
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
370 >&nbsp;</TD
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
371 ></TR
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
372 ></TABLE
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
373 ></DIV
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
374 ></BODY
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
375 ></HTML
1e0a0e6cd918 Documentation updates
lost@l-w.ca
parents:
diff changeset
376 >