258
Section 3: Assembler
TI
-
89 / TI
-
92 Plus Sierra C Assembler Reference Manual
Not for Distribution
Beta Version February 2, 2001
SECTION — Begin / Resume a Data-type Section
Syntax
SECTION[.S]
name
[,
address
]
Description
name
Specifies the section. It is a symbol whose name can be up to
eight characters in length. The first character of the name can be
a numerical character (0–9). If the section name begins with a
numerical character, the assembler will prefix it with a period ( . ).
Section names 9, 13, and 14, however, are handled differently;
they designate the sections
.text
,
.data
, and
.bss
, respectively.
address
Specifies the base or continuation address of the section. It is an
absolute expression that cannot contain any forward, external, or
undefined references.
The
SECTION
directive begins a data-type section with name
name
. If
address
is
specified, the section is absolute and begins at that address; otherwise, the
section is relocatable.
If the specified section already exists, it is resumed either at its current location
(i.e., the value of its location counter) or at the specified address
address
. An
absolute section can be restarted at any address beyond its current location; any
space that is created is filled with the current fill value (see
OPT FILLVAL
).
Relocatable sections cannot be resumed with an address specification.
The
.S
qualifier is used to indicate that any symbols defined in the section can be
referenced with the absolute short addressing mode (i.e., the section will reside
in the top or bottom 32K of memory).
This directive is a synonym for the
DSECTION
directive.