RealView™ Compilation Tools for BREW Linker and Utilities Guide 4.3.2. Steering file commands

4.3.2. Steering file commands

The following steering file commands enable you to rename, hide, and show symbols in the symbol table.

RENAME

The RENAME command renames defined and undefined global symbol names.

Syntax

RENAME pattern {AS replacement_pattern} [ ,pattern AS replacement_pattern] *

where:

pattern

Is a string, optionally including wildcard characters, that matches zero or more global symbols. If pattern does not match any global symbol, the linker ignores the command. The operand can match both defined and undefined symbols.

replacement_pattern

Is a string, optionally including wild card characters, to which the symbol is to be renamed. Wild cards must have a corresponding wild card in pattern. The characters matched by the pattern wild card are substituted for the replacement_pattern wildcard.

For example, for a symbol named func1:

RENAME f* AS my_f*

renames func1 to my_func1.

Usage

You cannot rename a symbol to a symbol name that already exists, even if the target symbol name is being renamed itself. Only one wildcard character (either * or ?) is permitted in RENAME.

armlink processes the steering file before doing any replacements. You cannot, therefore, use RENAME A AS B on line 1 and then RENAME B AS A on line 2.

HIDE

The HIDE 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.

SHOW

The SHOW command makes global symbols visible that were previously hidden with the HIDE command. This command is useful if you want to un-hide a specific symbol that has been hidden using a HIDE command with a wild card.

Syntax

SHOW pattern [ ,pattern] *

where:

pattern: Is a string, optionally including wildcard characters, that matches zero or more global symbols. If pattern does not match any global symbol, the linker ignores the command.

Copyright © 2002 ARM Limited. All rights reserved.	ARM DUI 0212A
Non-Confidential
PDF version