Section 3: Assembler
133
TI
-
89 / TI
-
92 Plus Sierra C Assembler Reference Manual
Not for Distribution
Beta Version February 2, 2001
-A
Alert the user that the following error messages are from the
assembler. The message, “Assembler Errors,” is printed before the
first error message. The message separates compiler messages
from assembler messages when the compiler and assembler are
invoked sequentially.
-c
Generate object files that are fully compatible with the AT&T UNIX
System V COFF specification. When the
-c
flag is not specified, the
.text, .data, and .bss sections begin at relative address zero; comm
variables include alignment information; and relocation
displacements are not required to fit in their associated relocation
holes. This flag is incompatible with the
-6
flag.
-C
Cause symbols that are declared .extern / XREF but not otherwise
referenced in the file not to be entered into the symbol table. In the
absence of the
-C
flag, .extern / XREF symbols always appear in
the symbol table possibly causing unnecessary modules to be pulled
in from a library file. The
-C
flag basically causes .extern / XREF
symbols to behave the same as extern symbols in the C language.
-d
symbol [= value]
Define a local symbol
symbol
with value
value
. If
value
is
omitted, the symbol is assigned a value of 1.
-D
symbol [= value]
Define a global symbol
symbol
with value
value
. If
value
is
omitted, the symbol is assigned a value of 1.
-e
Disable the .echo directive. (asm68)
-E
Require that undefined labels be declared external (see .xref
directive). Failure to do so will result in an error. By default,
undefined labels are assumed to be external. (asm68k) Assume
that undefined labels are external. By default, undefined labels must
be declared external (see XREF directive). If the .opt directive (not
OPT) is specified (as it would be in compiler generated assembly
code), the asm68k assembler emulates the asm68 assembler as it
pertains to undefined labels
undefined symbols are assumed to
be external and the
-E
flag necessitates that undefined labels be
declared external.
-g
file . . .
Group multiple source files. When specified, the
-g
flag must be the
last option on the command line; all files that follow are
concatenated to produce a single source file. Output file names are
based on the name of the first file that is specified.
-h
file
Select the source file for relocation hole compression. The
-h
flag is
used during the first assembly pass. The name of the object file and
the command line flags with which it is created are recorded in the
hole compression input file
file
. This file, which by convention has
a .hci extension, is used by link68.