Texas Instruments TMS320C54x, User Manual

Page: 244 / 469

The SECTIONS Directive
7-32
7.8 The SECTIONS Directive
The SECTIONS directive:
-
Describes how input sections are combined into output sections
-
Defines output sections in the executable program
-
Specifies where output sections are placed in memory (in relation to each
other and to the entire memory space)
-
Permits renaming of output sections
Refer to Section 2.4, How the Linker Handles Sections, on page 2-12 for
details on how the linker handles sections. Refer to Section 2.5, Relocation,
on page 2-15 for information on the relocation of sections. Refer to subsection
2.3.4,
Subsections, on page 2-8 for information on defining subsections;
subsections allow you to manipulate sections with greater precision.
7.8.1 Default Configuration
If you do not specify a SECTIONS directive, the linker uses a default algorithm
for combining and allocating the sections. Section 7.12,
Default Allocation
Algorithm, on page 7-53 describes this algorithm in detail.
7.8.2 SECTIONS Directive Syntax
The SECTIONS directive is specified in a command file by the word
SECTIONS (uppercase), followed by a list of output section specifications
enclosed in braces.
The general syntax for the SECTIONS directive is:
SECTIONS
{
name : [property, property, property,...]
name : [property, property, property,...]
name : [property, property, property,...]
}