Texas Instruments TMS320C54x, User Manual

Page: 117 / 469

.clink
Conditionally Leave Section Out of COFF Output
4-34
Syntax
.clink [ ”section name“]
Description The .clink directive sets up conditional linking for a section by setting the
STYP_CLINK flag in the type field for
section name. The .clink directive can
be applied to initialized or uninitialized sections.
If .clink is used without a section name, it applies to the current initialized sec-
tion. If .clink is applied to an uninitialized section, the section name is required.
The section name is significant to 200 characters and must be enclosed in
double quotes. A section name can contain a subsection name in the form of
section name:subsection name.
The STYP_CLINK flag tells the linker to leave the section out of the final COFF
output of the linker if there are no references found to any symbol in the sec-
tion.
A section in which the entry point of a C program is defined cannot be marked
as a conditionally linked section.
Example In this example, the Vars and Counts sections are set for conditional linking.
1 000000 .sect ”Vars”
2 ; Vars section is conditionally linked
3 .clink
4
5 000000 001A X: .word 01Ah
6 000001 001A Y: .word 01Ah
7 000002 001A Z: .word 01Ah
8 000000 .sect ”Counts”
9 ; Counts section is conditionally linked
10 .clink
11
12 000000 001A Xcount: .word 01Ah
13 000001 001A Ycount: .word 01Ah
14 000002 001A Zcount: .word 01Ah
15 ; By default, .text is unconditionally linked
16 000000 .text
17 ; Reference to symbol X cause the Vars section
18 ; to be linked into the COFF output
19 000000 E800 LD #0, A
20 000001 8000+ STL A, X