The LWTOOLS assembler is called LWASM. This chapter documents the various features of the assembler. It is not, however, a tutorial on 6x09 assembly language programming.
The binary for LWASM is called "lwasm". Note that the binary is in lower case. lwasm takes the following command line arguments.
--6309
, -3
This will cause the assembler to accept the additional instructions available on the 6309 processor. This is the default mode; this option is provided for completeness and to override preset command arguments.
--6809
, -9
This will cause the assembler to reject instructions that are only available on the 6309 processor.
--decb
, -b
Select the DECB output format target. Equivalent to --format=decb
.
--format=type
, -f type
Select the output format. Valid values are obj
for the
object file target, decb
for the DECB LOADM format,
os9
for creating OS9 modules, and raw
for
a raw binary.
--list[=file]
, -l[file]
Cause LWASM to generate a listing. If file
is specified,
the listing will go to that file. Otherwise it will go to the standard output
stream. By default, no listing is generated.
--obj
Select the proprietary object file format as the output target.
--output=FILE
, -o FILE
This option specifies the name of the output file. If not specified, the
default is a.out
.
--pragma=pragma
, -p pragma
Specify assembler pragmas. Multiple pragmas are separated by commas. The pragmas accepted are the same as for the PRAGMA assembler directive described below.
--raw
, -r
Select raw binary as the output target.
--includedir=path
, -I path
Add path
to the end of the include path.
--help
, -?
Present a help screen describing the command line options.
--usage
Provide a summary of the command line options.
--version
, -V
Display the software version.
--debug
, -d
Increase the debugging level. Only really useful to people hacking on the LWASM source code itself.