Section 3: Assembler
137
TI
-
89 / TI
-
92 Plus Sierra C Assembler Reference Manual
Not for Distribution
Beta Version February 2, 2001
INCLUDE68
variable can be used to specify multiple directories by assigning it a
semicolon-separated list of paths. The
SIERRA
variable is typically set to the
directory under which the Sierra Systems software has been installed. When a
source file is included, the assembler will attempt to locate it in (or, relative to) the
following directories in the specified order:
1. The current directory.
2. Directories specified with the
-I
command line flag.
3. Directories specified by the environment.
The directories specified by the environment are determined in the following
manner. If the
INCLUDE68
variable is defined, the paths it specifies are used;
otherwise, the environment search path is the
SIERRA\include
subdirectory.
3.2.5. Invocation Examples
The following examples demonstrate how to invoke the assemblers. The
assembler
asm68
is used in the examples. Path names are specified using
MS-DOS syntax.
asm68 -o ..\obj\driver.o -I..\incl driver.s -W
This example assembles the file driver.s. The sibling directory
incl
has been
specified as a location to search for included files. The object file, as well as the
listing file driver.lst, is created in the sibling directory
obj
. Warning messages
have been suppressed with the
-W
flag.
In the following example, the assembly source is read from the standard input
stream,
stdin
:
asm68 -l -T (or, asm68 -lT)
The object file is named
asm68.o
, while the listing file has been suppressed with
the
-l
flag. The
-T
flag directs the assembler to create a transcript file with the
name
asm68.trn
.
3.3. Assembly Language
Assembly languages provide an efficient means of developing and maintaining
machine-level programs. This section describes the format of assembly language
source files, as well as the major concepts necessary to write them.