Next: Symver, Previous: SubSection, Up: Pseudo Ops [Contents][Index]
.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.