Mercurial > hg > index.cgi

comparison docs/manual/x29.html @ 153:83b7b4ce3bbd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added prebuilt manual to repository to avoid failures to include it during releases
author lost@l-w.ca
date Sat, 27 Aug 2011 00:23:19 -0600
parents
children
comparison
equal deleted inserted replaced
152:a26b045c4e18 153:83b7b4ce3bbd
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 >OS9 Modules</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="c18.html"><LINK
15 REL="PREVIOUS"
16 TITLE="DECB Binaries"
17 HREF="x24.html"><LINK
18 REL="NEXT"
19 TITLE="Object Files"
20 HREF="x37.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="x24.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="x37.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="AEN29"
77 >2.3. OS9 Modules</A
78 ></H1
79 ><P
80 >&#13;Since version 2.5, LWASM is able to generate OS9 modules. The syntax is
81 basically the same as for other assemblers. A module starts with the MOD
82 directive and ends with the EMOD directive. The OS9 directive is provided
83 as a shortcut for writing system calls.&#13;</P
84 ><P
85 >&#13;LWASM does NOT provide an OS9Defs file. You must provide your own. Also note
86 that the common practice of using "ifp1" around the inclusion of the OS9Defs
87 file is discouraged as it is pointless and can lead to unintentional
88 problems and phasing errors. Because LWASM reads each file exactly once,
89 there is no benefit to restricting the inclusion to the first assembly pass.&#13;</P
90 ><P
91 >&#13;As of version 4.5, LWASM also implements the standard data/code address
92 streams for OS9 modules. That means that between MOD and EMOD, any RMB,
93 RMD, RMQ, or equivalent directives will move the data address ahead and
94 leave the code address unmodified. Outside of an actual module, both the
95 code and data addresses are moved ahead equally. That last bit is critical
96 to understand because it means any directives that follow an EMOD directive
97 may have different results than other assemblers.&#13;</P
98 ><P
99 >&#13;Additionally, within a module body, the ORG directive sets only the data
100 address, not the code address. However, outside a module body, ORG sets both
101 addresses.&#13;</P
102 ><P
103 >Both code and data addresses are reset to 0 by the MOD directive.</P
104 ><P
105 >&#13;As of version 4.5, LWLINK also supports creation of OS9 modules.&#13;</P
106 ></DIV
107 ><DIV
108 CLASS="NAVFOOTER"
109 ><HR
110 ALIGN="LEFT"
111 WIDTH="100%"><TABLE
112 SUMMARY="Footer navigation table"
113 WIDTH="100%"
114 BORDER="0"
115 CELLPADDING="0"
116 CELLSPACING="0"
117 ><TR
118 ><TD
119 WIDTH="33%"
120 ALIGN="left"
121 VALIGN="top"
122 ><A
123 HREF="x24.html"
124 ACCESSKEY="P"
125 >Prev</A
126 ></TD
127 ><TD
128 WIDTH="34%"
129 ALIGN="center"
130 VALIGN="top"
131 ><A
132 HREF="index.html"
133 ACCESSKEY="H"
134 >Home</A
135 ></TD
136 ><TD
137 WIDTH="33%"
138 ALIGN="right"
139 VALIGN="top"
140 ><A
141 HREF="x37.html"
142 ACCESSKEY="N"
143 >Next</A
144 ></TD
145 ></TR
146 ><TR
147 ><TD
148 WIDTH="33%"
149 ALIGN="left"
150 VALIGN="top"
151 >DECB Binaries</TD
152 ><TD
153 WIDTH="34%"
154 ALIGN="center"
155 VALIGN="top"
156 ><A
157 HREF="c18.html"
158 ACCESSKEY="U"
159 >Up</A
160 ></TD
161 ><TD
162 WIDTH="33%"
163 ALIGN="right"
164 VALIGN="top"
165 >Object Files</TD
166 ></TR
167 ></TABLE
168 ></DIV
169 ></BODY
170 ></HTML
171 >