12.2 HIDE steering file command
Makes defined global symbols in the symbol table anonymous.
is a string, optionally including wildcard characters, that matches zero or more defined global symbols. If
does not match any defined global symbol, the linker ignores the command. You cannot hide undefined symbols.
You can use
SHOW to make certain global symbols anonymous in an output image
or partially linked object. Hiding symbols in an object file or library can be useful as a
means of protecting intellectual property, as shown in the following example:
; steer.txt ; Hides all global symbols HIDE * ; Shows all symbols beginning with â€™os_â€™ SHOW os_*
This example produces a partially linked object with all global symbols
hidden, except those beginning with
Link this example with the command:
armlink --partial input_object.o --edit steer.txt --o partial_object.o
You can link the resulting partial object with other objects, provided they
do not contain references to the hidden symbols. When symbols are hidden in the output
SHOW commands in subsequent link steps have no
effect on them. The hidden references are removed from the output symbol table.