Mercurial > hg-old > index.cgi

comparison doc/manual/c35.html @ 285:9010796c6253 2.3 2.3.1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Generated manual for distribution
author lost
date Fri, 24 Apr 2009 22:36:09 +0000
parents
children
comparison
equal deleted inserted replaced
284:a175fa4a0a9a 285:9010796c6253
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="x29.html"><LINK
15 REL="NEXT"
16 TITLE="Dialects"
17 HREF="x121.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="x29.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="x121.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="AEN35"
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="AEN38"
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 >--decb</CODE
99 >, <CODE
100 CLASS="OPTION"
101 >-b</CODE
102 ></DT
103 ><DD
104 ><P
105 >Select the DECB output format target. Equivalent to <CODE
106 CLASS="OPTION"
107 >--format=decb</CODE
108 >.</P
109 ></DD
110 ><DT
111 ><CODE
112 CLASS="OPTION"
113 >--format=type</CODE
114 >, <CODE
115 CLASS="OPTION"
116 >-f type</CODE
117 ></DT
118 ><DD
119 ><P
120 >Select the output format. Valid values are <CODE
121 CLASS="OPTION"
122 >obj</CODE
123 > for the object
124 file target, <CODE
125 CLASS="OPTION"
126 >decb</CODE
127 > for the DECB LOADM format, and <CODE
128 CLASS="OPTION"
129 >raw</CODE
130 >
131 for a raw binary.</P
132 ></DD
133 ><DT
134 ><CODE
135 CLASS="OPTION"
136 >--list[=file]</CODE
137 >, <CODE
138 CLASS="OPTION"
139 >-l[file]</CODE
140 ></DT
141 ><DD
142 ><P
143 >Cause LWASM to generate a listing. If <CODE
144 CLASS="OPTION"
145 >file</CODE
146 > is specified,
147 the listing will go to that file. Otherwise it will go to the standard output
148 stream. By default, no listing is generated.</P
149 ></DD
150 ><DT
151 ><CODE
152 CLASS="OPTION"
153 >--obj</CODE
154 ></DT
155 ><DD
156 ><P
157 >Select the proprietary object file format as the output target.</P
158 ></DD
159 ><DT
160 ><CODE
161 CLASS="OPTION"
162 >--output=FILE</CODE
163 >, <CODE
164 CLASS="OPTION"
165 >-o FILE</CODE
166 ></DT
167 ><DD
168 ><P
169 >This option specifies the name of the output file. If not specified, the
170 default is <CODE
171 CLASS="OPTION"
172 >a.out</CODE
173 >.</P
174 ></DD
175 ><DT
176 ><CODE
177 CLASS="OPTION"
178 >--pragma=pragma</CODE
179 >, <CODE
180 CLASS="OPTION"
181 >-p pragma</CODE
182 ></DT
183 ><DD
184 ><P
185 >Specify assembler pragmas. Multiple pragmas are separated by commas. The
186 pragmas accepted are the same as for the PRAGMA assembler directive described
187 below.</P
188 ></DD
189 ><DT
190 ><CODE
191 CLASS="OPTION"
192 >--raw</CODE
193 >, <CODE
194 CLASS="OPTION"
195 >-r</CODE
196 ></DT
197 ><DD
198 ><P
199 >Select raw binary as the output target.</P
200 ></DD
201 ><DT
202 ><CODE
203 CLASS="OPTION"
204 >--help</CODE
205 >, <CODE
206 CLASS="OPTION"
207 >-?</CODE
208 ></DT
209 ><DD
210 ><P
211 >Present a help screen describing the command line options.</P
212 ></DD
213 ><DT
214 ><CODE
215 CLASS="OPTION"
216 >--usage</CODE
217 ></DT
218 ><DD
219 ><P
220 >Provide a summary of the command line options.</P
221 ></DD
222 ><DT
223 ><CODE
224 CLASS="OPTION"
225 >--version</CODE
226 >, <CODE
227 CLASS="OPTION"
228 >-V</CODE
229 ></DT
230 ><DD
231 ><P
232 >Display the software version.</P
233 ></DD
234 ><DT
235 ><CODE
236 CLASS="OPTION"
237 >--debug</CODE
238 >, <CODE
239 CLASS="OPTION"
240 >-d</CODE
241 ></DT
242 ><DD
243 ><P
244 >Increase the debugging level. Only really useful to people hacking on the
245 LWASM source code itself.</P
246 ></DD
247 ></DL
248 ></DIV
249 ></DIV
250 ></DIV
251 ><DIV
252 CLASS="NAVFOOTER"
253 ><HR
254 ALIGN="LEFT"
255 WIDTH="100%"><TABLE
256 SUMMARY="Footer navigation table"
257 WIDTH="100%"
258 BORDER="0"
259 CELLPADDING="0"
260 CELLSPACING="0"
261 ><TR
262 ><TD
263 WIDTH="33%"
264 ALIGN="left"
265 VALIGN="top"
266 ><A
267 HREF="x29.html"
268 ACCESSKEY="P"
269 >Prev</A
270 ></TD
271 ><TD
272 WIDTH="34%"
273 ALIGN="center"
274 VALIGN="top"
275 ><A
276 HREF="index.html"
277 ACCESSKEY="H"
278 >Home</A
279 ></TD
280 ><TD
281 WIDTH="33%"
282 ALIGN="right"
283 VALIGN="top"
284 ><A
285 HREF="x121.html"
286 ACCESSKEY="N"
287 >Next</A
288 ></TD
289 ></TR
290 ><TR
291 ><TD
292 WIDTH="33%"
293 ALIGN="left"
294 VALIGN="top"
295 >Object Files</TD
296 ><TD
297 WIDTH="34%"
298 ALIGN="center"
299 VALIGN="top"
300 >&nbsp;</TD
301 ><TD
302 WIDTH="33%"
303 ALIGN="right"
304 VALIGN="top"
305 >Dialects</TD
306 ></TR
307 ></TABLE
308 ></DIV
309 ></BODY
310 ></HTML
311 >