Mercurial > hg > index.cgi

comparison docs/manual/c45.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 2cc599f1bebf
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 >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="x37.html"><LINK
15 REL="NEXT"
16 TITLE="Dialects"
17 HREF="x163.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="x37.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="x163.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="AEN45"
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="AEN48"
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. Unless <CODE
185 CLASS="OPTION"
186 >--symbols</CODE
187 >
188 is specified, the list will not include the symbol table.</P
189 ></DD
190 ><DT
191 ><CODE
192 CLASS="OPTION"
193 >--symbols</CODE
194 >, <CODE
195 CLASS="OPTION"
196 >-s</CODE
197 ></DT
198 ><DD
199 ><P
200 >Causes LWASM to generate a list of symbols when generating a listing.
201 It has no effect unless a listing is being generated.</P
202 ></DD
203 ><DT
204 ><CODE
205 CLASS="OPTION"
206 >--obj</CODE
207 ></DT
208 ><DD
209 ><P
210 >Select the proprietary object file format as the output target.</P
211 ></DD
212 ><DT
213 ><CODE
214 CLASS="OPTION"
215 >--output=FILE</CODE
216 >, <CODE
217 CLASS="OPTION"
218 >-o FILE</CODE
219 ></DT
220 ><DD
221 ><P
222 >This option specifies the name of the output file. If not specified, the
223 default is <CODE
224 CLASS="OPTION"
225 >a.out</CODE
226 >.</P
227 ></DD
228 ><DT
229 ><CODE
230 CLASS="OPTION"
231 >--pragma=pragma</CODE
232 >, <CODE
233 CLASS="OPTION"
234 >-p pragma</CODE
235 ></DT
236 ><DD
237 ><P
238 >Specify assembler pragmas. Multiple pragmas are separated by commas. The
239 pragmas accepted are the same as for the PRAGMA assembler directive described
240 below.</P
241 ></DD
242 ><DT
243 ><CODE
244 CLASS="OPTION"
245 >--raw</CODE
246 >, <CODE
247 CLASS="OPTION"
248 >-r</CODE
249 ></DT
250 ><DD
251 ><P
252 >Select raw binary as the output target.</P
253 ></DD
254 ><DT
255 ><CODE
256 CLASS="OPTION"
257 >--includedir=path</CODE
258 >, <CODE
259 CLASS="OPTION"
260 >-I path</CODE
261 ></DT
262 ><DD
263 ><P
264 >Add <CODE
265 CLASS="OPTION"
266 >path</CODE
267 > to the end of the include path.</P
268 ></DD
269 ><DT
270 ><CODE
271 CLASS="OPTION"
272 >--help</CODE
273 >, <CODE
274 CLASS="OPTION"
275 >-?</CODE
276 ></DT
277 ><DD
278 ><P
279 >Present a help screen describing the command line options.</P
280 ></DD
281 ><DT
282 ><CODE
283 CLASS="OPTION"
284 >--usage</CODE
285 ></DT
286 ><DD
287 ><P
288 >Provide a summary of the command line options.</P
289 ></DD
290 ><DT
291 ><CODE
292 CLASS="OPTION"
293 >--version</CODE
294 >, <CODE
295 CLASS="OPTION"
296 >-V</CODE
297 ></DT
298 ><DD
299 ><P
300 >Display the software version.</P
301 ></DD
302 ><DT
303 ><CODE
304 CLASS="OPTION"
305 >--debug</CODE
306 >, <CODE
307 CLASS="OPTION"
308 >-d</CODE
309 ></DT
310 ><DD
311 ><P
312 >Increase the debugging level. Only really useful to people hacking on the
313 LWASM source code itself.</P
314 ></DD
315 ></DL
316 ></DIV
317 ></DIV
318 ></DIV
319 ><DIV
320 CLASS="NAVFOOTER"
321 ><HR
322 ALIGN="LEFT"
323 WIDTH="100%"><TABLE
324 SUMMARY="Footer navigation table"
325 WIDTH="100%"
326 BORDER="0"
327 CELLPADDING="0"
328 CELLSPACING="0"
329 ><TR
330 ><TD
331 WIDTH="33%"
332 ALIGN="left"
333 VALIGN="top"
334 ><A
335 HREF="x37.html"
336 ACCESSKEY="P"
337 >Prev</A
338 ></TD
339 ><TD
340 WIDTH="34%"
341 ALIGN="center"
342 VALIGN="top"
343 ><A
344 HREF="index.html"
345 ACCESSKEY="H"
346 >Home</A
347 ></TD
348 ><TD
349 WIDTH="33%"
350 ALIGN="right"
351 VALIGN="top"
352 ><A
353 HREF="x163.html"
354 ACCESSKEY="N"
355 >Next</A
356 ></TD
357 ></TR
358 ><TR
359 ><TD
360 WIDTH="33%"
361 ALIGN="left"
362 VALIGN="top"
363 >Object Files</TD
364 ><TD
365 WIDTH="34%"
366 ALIGN="center"
367 VALIGN="top"
368 >&nbsp;</TD
369 ><TD
370 WIDTH="33%"
371 ALIGN="right"
372 VALIGN="top"
373 >Dialects</TD
374 ></TR
375 ></TABLE
376 ></DIV
377 ></BODY
378 ></HTML
379 >