Mercurial > hg-old > index.cgi

comparison doc/manual/c43.html @ 398:7987ee447833 3.0-beta1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added generated files for release
author lost@l-w.ca
date Fri, 23 Jul 2010 17:18:52 -0600
parents
children
comparison
equal deleted inserted replaced
397:09fe7c40a082 398:7987ee447833
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 >LWASM</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="PREVIOUS"
13 TITLE="Object Files"
14 HREF="x35.html"><LINK
15 REL="NEXT"
16 TITLE="Dialects"
17 HREF="x153.html"></HEAD
18 ><BODY
19 CLASS="CHAPTER"
20 BGCOLOR="#FFFFFF"
21 TEXT="#000000"
22 LINK="#0000FF"
23 VLINK="#840084"
24 ALINK="#0000FF"
25 ><DIV
26 CLASS="NAVHEADER"
27 ><TABLE
28 SUMMARY="Header navigation table"
29 WIDTH="100%"
30 BORDER="0"
31 CELLPADDING="0"
32 CELLSPACING="0"
33 ><TR
34 ><TH
35 COLSPAN="3"
36 ALIGN="center"
37 >LW Tool Chain</TH
38 ></TR
39 ><TR
40 ><TD
41 WIDTH="10%"
42 ALIGN="left"
43 VALIGN="bottom"
44 ><A
45 HREF="x35.html"
46 ACCESSKEY="P"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="x153.html"
60 ACCESSKEY="N"
61 >Next</A
62 ></TD
63 ></TR
64 ></TABLE
65 ><HR
66 ALIGN="LEFT"
67 WIDTH="100%"></DIV
68 ><DIV
69 CLASS="CHAPTER"
70 ><H1
71 ><A
72 NAME="AEN43"
73 ></A
74 >Chapter 3. LWASM</H1
75 ><P
76 >The LWTOOLS assembler is called LWASM. This chapter documents the various
77 features of the assembler. It is not, however, a tutorial on 6x09 assembly
78 language programming.</P
79 ><DIV
80 CLASS="SECTION"
81 ><H1
82 CLASS="SECTION"
83 ><A
84 NAME="AEN46"
85 >3.1. Command Line Options</A
86 ></H1
87 ><P
88 >The binary for LWASM is called "lwasm". Note that the binary is in lower
89 case. lwasm takes the following command line arguments.</P
90 ><P
91 ></P
92 ><DIV
93 CLASS="VARIABLELIST"
94 ><DL
95 ><DT
96 ><CODE
97 CLASS="OPTION"
98 >--6309</CODE
99 >, <CODE
100 CLASS="OPTION"
101 >-3</CODE
102 ></DT
103 ><DD
104 ><P
105 >This will cause the assembler to accept the additional instructions available
106 on the 6309 processor. This is the default mode; this option is provided for
107 completeness and to override preset command arguments.</P
108 ></DD
109 ><DT
110 ><CODE
111 CLASS="OPTION"
112 >--6809</CODE
113 >, <CODE
114 CLASS="OPTION"
115 >-9</CODE
116 ></DT
117 ><DD
118 ><P
119 >This will cause the assembler to reject instructions that are only available
120 on the 6309 processor.</P
121 ></DD
122 ><DT
123 ><CODE
124 CLASS="OPTION"
125 >--decb</CODE
126 >, <CODE
127 CLASS="OPTION"
128 >-b</CODE
129 ></DT
130 ><DD
131 ><P
132 >Select the DECB output format target. Equivalent to <CODE
133 CLASS="OPTION"
134 >--format=decb</CODE
135 >.</P
136 ><P
137 >While this is the default output format currently, it is not safe to rely
138 on that fact. Future versions may have different defaults. It is also trivial
139 to modify the source code to change the default. Thus, it is recommended to specify
140 this option if you need DECB output.</P
141 ></DD
142 ><DT
143 ><CODE
144 CLASS="OPTION"
145 >--format=type</CODE
146 >, <CODE
147 CLASS="OPTION"
148 >-f type</CODE
149 ></DT
150 ><DD
151 ><P
152 >Select the output format. Valid values are <CODE
153 CLASS="OPTION"
154 >obj</CODE
155 > for the
156 object file target, <CODE
157 CLASS="OPTION"
158 >decb</CODE
159 > for the DECB LOADM format,
160 <CODE
161 CLASS="OPTION"
162 >os9</CODE
163 > for creating OS9 modules, and <CODE
164 CLASS="OPTION"
165 >raw</CODE
166 > for
167 a raw binary.</P
168 ></DD
169 ><DT
170 ><CODE
171 CLASS="OPTION"
172 >--list[=file]</CODE
173 >, <CODE
174 CLASS="OPTION"
175 >-l[file]</CODE
176 ></DT
177 ><DD
178 ><P
179 >Cause LWASM to generate a listing. If <CODE
180 CLASS="OPTION"
181 >file</CODE
182 > is specified,
183 the listing will go to that file. Otherwise it will go to the standard output
184 stream. By default, no listing is generated.</P
185 ></DD
186 ><DT
187 ><CODE
188 CLASS="OPTION"
189 >--obj</CODE
190 ></DT
191 ><DD
192 ><P
193 >Select the proprietary object file format as the output target.</P
194 ></DD
195 ><DT
196 ><CODE
197 CLASS="OPTION"
198 >--output=FILE</CODE
199 >, <CODE
200 CLASS="OPTION"
201 >-o FILE</CODE
202 ></DT
203 ><DD
204 ><P
205 >This option specifies the name of the output file. If not specified, the
206 default is <CODE
207 CLASS="OPTION"
208 >a.out</CODE
209 >.</P
210 ></DD
211 ><DT
212 ><CODE
213 CLASS="OPTION"
214 >--pragma=pragma</CODE
215 >, <CODE
216 CLASS="OPTION"
217 >-p pragma</CODE
218 ></DT
219 ><DD
220 ><P
221 >Specify assembler pragmas. Multiple pragmas are separated by commas. The
222 pragmas accepted are the same as for the PRAGMA assembler directive described
223 below.</P
224 ></DD
225 ><DT
226 ><CODE
227 CLASS="OPTION"
228 >--raw</CODE
229 >, <CODE
230 CLASS="OPTION"
231 >-r</CODE
232 ></DT
233 ><DD
234 ><P
235 >Select raw binary as the output target.</P
236 ></DD
237 ><DT
238 ><CODE
239 CLASS="OPTION"
240 >--includedir=path</CODE
241 >, <CODE
242 CLASS="OPTION"
243 >-I path</CODE
244 ></DT
245 ><DD
246 ><P
247 >Add <CODE
248 CLASS="OPTION"
249 >path</CODE
250 > to the end of the include path.</P
251 ></DD
252 ><DT
253 ><CODE
254 CLASS="OPTION"
255 >--help</CODE
256 >, <CODE
257 CLASS="OPTION"
258 >-?</CODE
259 ></DT
260 ><DD
261 ><P
262 >Present a help screen describing the command line options.</P
263 ></DD
264 ><DT
265 ><CODE
266 CLASS="OPTION"
267 >--usage</CODE
268 ></DT
269 ><DD
270 ><P
271 >Provide a summary of the command line options.</P
272 ></DD
273 ><DT
274 ><CODE
275 CLASS="OPTION"
276 >--version</CODE
277 >, <CODE
278 CLASS="OPTION"
279 >-V</CODE
280 ></DT
281 ><DD
282 ><P
283 >Display the software version.</P
284 ></DD
285 ><DT
286 ><CODE
287 CLASS="OPTION"
288 >--debug</CODE
289 >, <CODE
290 CLASS="OPTION"
291 >-d</CODE
292 ></DT
293 ><DD
294 ><P
295 >Increase the debugging level. Only really useful to people hacking on the
296 LWASM source code itself.</P
297 ></DD
298 ></DL
299 ></DIV
300 ></DIV
301 ></DIV
302 ><DIV
303 CLASS="NAVFOOTER"
304 ><HR
305 ALIGN="LEFT"
306 WIDTH="100%"><TABLE
307 SUMMARY="Footer navigation table"
308 WIDTH="100%"
309 BORDER="0"
310 CELLPADDING="0"
311 CELLSPACING="0"
312 ><TR
313 ><TD
314 WIDTH="33%"
315 ALIGN="left"
316 VALIGN="top"
317 ><A
318 HREF="x35.html"
319 ACCESSKEY="P"
320 >Prev</A
321 ></TD
322 ><TD
323 WIDTH="34%"
324 ALIGN="center"
325 VALIGN="top"
326 ><A
327 HREF="index.html"
328 ACCESSKEY="H"
329 >Home</A
330 ></TD
331 ><TD
332 WIDTH="33%"
333 ALIGN="right"
334 VALIGN="top"
335 ><A
336 HREF="x153.html"
337 ACCESSKEY="N"
338 >Next</A
339 ></TD
340 ></TR
341 ><TR
342 ><TD
343 WIDTH="33%"
344 ALIGN="left"
345 VALIGN="top"
346 >Object Files</TD
347 ><TD
348 WIDTH="34%"
349 ALIGN="center"
350 VALIGN="top"
351 >&nbsp;</TD
352 ><TD
353 WIDTH="33%"
354 ALIGN="right"
355 VALIGN="top"
356 >Dialects</TD
357 ></TR
358 ></TABLE
359 ></DIV
360 ></BODY
361 ></HTML
362 >