134
Section 3: Assembler
TI
-
89 / TI
-
92 Plus Sierra C Assembler Reference Manual
Not for Distribution
Beta Version February 2, 2001
-H
file
Perform relocation hole compression on the source file. The
-H
flag
is used during the second assembly pass. The information in the
hole compression output file
file
, which is created by
link68
, is
used to determine which relocation holes can be compressed. No
other command line arguments are used during this pass.
-i
file
Include the contents of the file
file
at the current location in the
command line. The
-i
flag cannot be used inside an included file;
however, multiple occurrences of this flag can appear on the
command line.
-I
path
Add the path
path
to the search list used to locate included files
(see
.include / INCLUDE
directive). Directories specified with the
-I
flag are searched after the current directory has been searched
and before the standard include directories (see section
3.2.4 Environment Variables
).
-k
Remove (kill) the object file if any errors are detected.
-K
Do not generate an object file.
-l
Do not generate a listing file.
-L
Generate line number information to allow source-level debugging of
assembler source. When the
-L
flag is specified, all debugging
directives, except for the
.type / TYPE
directive, are ignored (see
sections
3.6.6 Asm68 Debugging Directives
and
3.7.6 Asm68k
Debugging Directives
). The
.type / TYPE
directive can be used to
specify type information for any label.
-n
Do not put line numbers in the listing file.
-o
file
Set the name of the output object file to
file
. If the
-o
flag is not
specified, the object file has a
.o
extension and the base name is
derived from the name of the source file (see section
3.2.3 File
Name Conventions
).
-O
[
address
]
Set the default section to be an absolute, text-type section with base
address
address
. If
address
is omitted, the value zero is used.
If the
-O
flag is not specified, the default section is
.text
.
-OPT
option
[,
option
] . . .
Set assembler options. The
-OPT
flag allows assembler options to
be specified on the command line (see
.opt / OPT
directive).
-p
[
length
]
Set the page length used in the listing file to
length
. If
length
is
omitted or is zero, pagination is disabled; otherwise, the length must
be at least 10. The default page length is 65 lines.
-q
Do not require sections to begin on quad boundaries, and do not
pad sections to quad boundaries. The
-q
flag is provided to allow
the generation of code that can be patched into linked executable
files; it should not be used otherwise.
-Q
Do not print the Sierra Systems copyright banner.