The CLINK pragma can be applied to a code or data symbol. It causes a .clink directive to be generated into the section that contains the definition of the symbol. The .clink directive tells the linker that a section is eligible for removal during conditional linking. Thus, if the section is not referenced by any other section in the application being compiled and linked, it will not be included in the resulting output file.
The syntax of the pragma in C is:
#pragma CLINK (symbol ) |
The syntax of the pragma in C++ is:
#pragma CLINK |
The RETAIN pragma has the opposite effect of the CLINK pragma. See Section 7.9.31 for more details.