Mercurial > hg-old > index.cgi

comparison doc/manual/c43.html @ 272:d5392bb5da3c 2.5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added generated files
author lost
date Sun, 16 Aug 2009 17:16:49 +0000
parents
children
comparison
equal deleted inserted replaced
271:3b793ba7a6c6 272:d5392bb5da3c
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="x144.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="x144.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 ></DD
137 ><DT
138 ><CODE
139 CLASS="OPTION"
140 >--format=type</CODE
141 >, <CODE
142 CLASS="OPTION"
143 >-f type</CODE
144 ></DT
145 ><DD
146 ><P
147 >Select the output format. Valid values are <CODE
148 CLASS="OPTION"
149 >obj</CODE
150 > for the
151 object file target, <CODE
152 CLASS="OPTION"
153 >decb</CODE
154 > for the DECB LOADM format,
155 <CODE
156 CLASS="OPTION"
157 >os9</CODE
158 > for creating OS9 modules, and <CODE
159 CLASS="OPTION"
160 >raw</CODE
161 > for
162 a raw binary.</P
163 ></DD
164 ><DT
165 ><CODE
166 CLASS="OPTION"
167 >--list[=file]</CODE
168 >, <CODE
169 CLASS="OPTION"
170 >-l[file]</CODE
171 ></DT
172 ><DD
173 ><P
174 >Cause LWASM to generate a listing. If <CODE
175 CLASS="OPTION"
176 >file</CODE
177 > is specified,
178 the listing will go to that file. Otherwise it will go to the standard output
179 stream. By default, no listing is generated.</P
180 ></DD
181 ><DT
182 ><CODE
183 CLASS="OPTION"
184 >--obj</CODE
185 ></DT
186 ><DD
187 ><P
188 >Select the proprietary object file format as the output target.</P
189 ></DD
190 ><DT
191 ><CODE
192 CLASS="OPTION"
193 >--output=FILE</CODE
194 >, <CODE
195 CLASS="OPTION"
196 >-o FILE</CODE
197 ></DT
198 ><DD
199 ><P
200 >This option specifies the name of the output file. If not specified, the
201 default is <CODE
202 CLASS="OPTION"
203 >a.out</CODE
204 >.</P
205 ></DD
206 ><DT
207 ><CODE
208 CLASS="OPTION"
209 >--pragma=pragma</CODE
210 >, <CODE
211 CLASS="OPTION"
212 >-p pragma</CODE
213 ></DT
214 ><DD
215 ><P
216 >Specify assembler pragmas. Multiple pragmas are separated by commas. The
217 pragmas accepted are the same as for the PRAGMA assembler directive described
218 below.</P
219 ></DD
220 ><DT
221 ><CODE
222 CLASS="OPTION"
223 >--raw</CODE
224 >, <CODE
225 CLASS="OPTION"
226 >-r</CODE
227 ></DT
228 ><DD
229 ><P
230 >Select raw binary as the output target.</P
231 ></DD
232 ><DT
233 ><CODE
234 CLASS="OPTION"
235 >--help</CODE
236 >, <CODE
237 CLASS="OPTION"
238 >-?</CODE
239 ></DT
240 ><DD
241 ><P
242 >Present a help screen describing the command line options.</P
243 ></DD
244 ><DT
245 ><CODE
246 CLASS="OPTION"
247 >--usage</CODE
248 ></DT
249 ><DD
250 ><P
251 >Provide a summary of the command line options.</P
252 ></DD
253 ><DT
254 ><CODE
255 CLASS="OPTION"
256 >--version</CODE
257 >, <CODE
258 CLASS="OPTION"
259 >-V</CODE
260 ></DT
261 ><DD
262 ><P
263 >Display the software version.</P
264 ></DD
265 ><DT
266 ><CODE
267 CLASS="OPTION"
268 >--debug</CODE
269 >, <CODE
270 CLASS="OPTION"
271 >-d</CODE
272 ></DT
273 ><DD
274 ><P
275 >Increase the debugging level. Only really useful to people hacking on the
276 LWASM source code itself.</P
277 ></DD
278 ></DL
279 ></DIV
280 ></DIV
281 ></DIV
282 ><DIV
283 CLASS="NAVFOOTER"
284 ><HR
285 ALIGN="LEFT"
286 WIDTH="100%"><TABLE
287 SUMMARY="Footer navigation table"
288 WIDTH="100%"
289 BORDER="0"
290 CELLPADDING="0"
291 CELLSPACING="0"
292 ><TR
293 ><TD
294 WIDTH="33%"
295 ALIGN="left"
296 VALIGN="top"
297 ><A
298 HREF="x35.html"
299 ACCESSKEY="P"
300 >Prev</A
301 ></TD
302 ><TD
303 WIDTH="34%"
304 ALIGN="center"
305 VALIGN="top"
306 ><A
307 HREF="index.html"
308 ACCESSKEY="H"
309 >Home</A
310 ></TD
311 ><TD
312 WIDTH="33%"
313 ALIGN="right"
314 VALIGN="top"
315 ><A
316 HREF="x144.html"
317 ACCESSKEY="N"
318 >Next</A
319 ></TD
320 ></TR
321 ><TR
322 ><TD
323 WIDTH="33%"
324 ALIGN="left"
325 VALIGN="top"
326 >Object Files</TD
327 ><TD
328 WIDTH="34%"
329 ALIGN="center"
330 VALIGN="top"
331 >&nbsp;</TD
332 ><TD
333 WIDTH="33%"
334 ALIGN="right"
335 VALIGN="top"
336 >Dialects</TD
337 ></TR
338 ></TABLE
339 ></DIV
340 ></BODY
341 ></HTML
342 >