13.2 HIDE steering file command

Makes defined global symbols in the symbol table anonymous.

Syntax

HIDE pattern[,pattern]

where:

pattern

is a string, optionally including wildcard characters, that matches zero or more defined global symbols. If pattern does not match any defined global symbol, the linker ignores the command. You cannot hide undefined symbols.

Usage

You can use HIDE and 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 os_.

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 object, SHOW commands in subsequent link steps have no effect on them. The hidden references are removed from the output symbol table.

Non-ConfidentialPDF file icon PDF versionARM DUI0474M
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.