Linker User GuidePreface Overview of the Linker Linking Models Supported by armlink Image Structure and Generation Linker Optimization Features Getting Image Details Accessing and Managing Symbols with armlink Scatter-loading Features Scatter File Syntax Linker Command-line Options Linker Steering File Command Reference EXPORT steering file command HIDE steering file command IMPORT steering file command RENAME steering file command REQUIRE steering file command RESOLVE steering file command SHOW steering file command Via File Syntax
RENAME steering file command
10.4 RENAME steering file command
Renames defined and undefined global symbol names.
You cannot rename a symbol to a global symbol name that already exists, even if the target symbol name is being renamed itself.
You cannot rename a symbol to the same name as another symbol. For example, you cannot do the following:
RENAME foo1 AS bar RENAME foo2 AS bar Error: L6281E: Cannot rename both foo2 and foo1 to bar.
Renames only take effect at the end of the link step. Therefore, renaming a symbol does not remove its original name. For example, given an image containing the symbols
RENAME func1 AS func2 RENAME func2 AS func3 Error: L6282E: Cannot rename func1 to func2 as a global symbol of that name exists
Only one wildcard character (either
Given an image containing the symbols
; invalid, func2 already exists RENAME func1 AS func2 ; valid RENAME func3 AS b2 ; invalid, func3 still exists because the link step is not yet complete RENAME func2 AS func3
of your data.