comparison docs/manual/x54.html @ 324:b30091890d62

Add documentation of the new hex output formats. Thanks to text contributed by Tom LeMense, the manual now includes documentation of the hex formats he contributed. This also includes some updated text on the ORG directive. Only minor editorial changes vary the text from Tom's original.
author William Astle <lost@l-w.ca>
date Tue, 04 Mar 2014 23:10:13 -0700
parents
children 507f442dc71e
comparison
equal deleted inserted replaced
323:ba9a0434b115 324:b30091890d62
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Object Files</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="LW Tool Chain"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="Output Formats"
14 HREF="c21.html"><LINK
15 REL="PREVIOUS"
16 TITLE="OS9 Modules"
17 HREF="x46.html"><LINK
18 REL="NEXT"
19 TITLE="LWASM"
20 HREF="c62.html"></HEAD
21 ><BODY
22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >LW Tool Chain</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="x46.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 2. Output Formats</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="c62.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECTION"
73 ><H1
74 CLASS="SECTION"
75 ><A
76 NAME="AEN54"
77 >2.7. Object Files</A
78 ></H1
79 ><P
80 >LWASM supports generating a proprietary object file format which is
81 described in <A
82 HREF="c970.html"
83 >Chapter 6</A
84 >. LWLINK is then used to link these
85 object files into a final binary in any of LWLINK's supported binary
86 formats.</P
87 ><P
88 >Object files also support the concept of sections which are not valid
89 for other output types. This allows related code from each object file
90 linked to be collapsed together in the final binary.</P
91 ><P
92 >Object files are very flexible in that they allow references that are not
93 known at assembly time to be resolved at link time. However, because the
94 addresses of such references are not known at assembly time, there is no way
95 for the assembler to deduce that an eight bit addressing mode is possible.
96 That means the assember will default to using sixteen bit addressing
97 whenever an external or cross-section reference is used.</P
98 ><P
99 >As of LWASM 2.4, it is possible to force direct page addressing for an
100 external reference. Care must be taken to ensure the resulting addresses
101 are really in the direct page since the linker does not know what the direct
102 page is supposed to be and does not emit errors for byte overflows.</P
103 ><P
104 >It is also possible to use external references in an eight bit immediate
105 mode instruction. In this case, only the low order eight bits will be used.
106 Again, no byte overflows will be flagged.</P
107 ></DIV
108 ><DIV
109 CLASS="NAVFOOTER"
110 ><HR
111 ALIGN="LEFT"
112 WIDTH="100%"><TABLE
113 SUMMARY="Footer navigation table"
114 WIDTH="100%"
115 BORDER="0"
116 CELLPADDING="0"
117 CELLSPACING="0"
118 ><TR
119 ><TD
120 WIDTH="33%"
121 ALIGN="left"
122 VALIGN="top"
123 ><A
124 HREF="x46.html"
125 ACCESSKEY="P"
126 >Prev</A
127 ></TD
128 ><TD
129 WIDTH="34%"
130 ALIGN="center"
131 VALIGN="top"
132 ><A
133 HREF="index.html"
134 ACCESSKEY="H"
135 >Home</A
136 ></TD
137 ><TD
138 WIDTH="33%"
139 ALIGN="right"
140 VALIGN="top"
141 ><A
142 HREF="c62.html"
143 ACCESSKEY="N"
144 >Next</A
145 ></TD
146 ></TR
147 ><TR
148 ><TD
149 WIDTH="33%"
150 ALIGN="left"
151 VALIGN="top"
152 >OS9 Modules</TD
153 ><TD
154 WIDTH="34%"
155 ALIGN="center"
156 VALIGN="top"
157 ><A
158 HREF="c21.html"
159 ACCESSKEY="U"
160 >Up</A
161 ></TD
162 ><TD
163 WIDTH="33%"
164 ALIGN="right"
165 VALIGN="top"
166 >LWASM</TD
167 ></TR
168 ></TABLE
169 ></DIV
170 ></BODY
171 ></HTML
172 >