Next: , Previous: SubSection, Up: Pseudo Ops   [Contents][Index]


7.94 .sym_meta_info symbol, kind, value

Use the .sym_meta_info directive to add a symbol meta-information entry for the specified symbol.

Symbol meta-information entries are stored in a special section .symtab_meta. Symbol meta-information is an ELF extension, see the binutils documentation for more detailed information.

Only the BFD linker can currently make use of symbol meta-information to retain or set the location of symbols.

Accepted values of kind are:

SMK_RETAIN

A symbol marked with SMK_RETAIN will be retained at link time even if garbage collection (enabled with -gc-sections) would remove the section containing the symbol. value is 1 if the symbol is to be retained, or 0 otherwise.

SMK_LOCATION

SMK_LOCATION indicates that the VMA of symbol should be set to value, if possible. Currently only the input section containing the symbol definition can be placed at a specific address, so for best results the desired symbol should be within its own input section.

value must be an integer which is a valid address on the target system. Both decimal and hexadecimal values are accepted.