ARM Compiler toolchain Using the Linker - ARM Information Center

7.22 Steering file format
7.22.1 See also
A steering file is a plain text file of the following format:
Accessing and managing symbols with armlink
• Lines with a semicolon (;) or hash (#) character as the first non-whitespace character are
interpreted as comments. A comment is treated as a blank line.
• Blank lines are ignored.
• Each non-blank, non-comment line is either a command, or part of a command that is split
over consecutive non-blank lines.
• Command lines that end with a comma (,) as the last non-whitespace character is
continued on the next non-blank line.
Each command line consists of a command, followed by one or more comma-separated operand
groups. Each operand group comprises either one or two operands, depending on the command.
The command is applied to each operand group in the command. The following rules apply:
• Commands are case-insensitive, but are conventionally shown in uppercase.
• Operands are case-sensitive because they must be matched against case-sensitive symbol
names. You can use wildcard characters in operands.
Commands are applied to global symbols only. Other symbols, such as local symbols, are not
affected.
The following example shows a sample steering file:
; Import my_func1 as func1
IMPORT my_func1 AS func1
# Rename a very long function name to a shorter name
RENAME a_very_long_function_name AS,
short_func_name
Tasks
• Specifying steering files on the linker command-line on page 7-24.
Concepts
• What is a steering file? on page 7-23.
Reference
• Steering file command summary on page 7-25.
Linker Reference:
• EXPORT on page 3-2
• HIDE on page 3-3
• IMPORT on page 3-4
• RENAME on page 3-5
• REQUIRE on page 3-7
• RESOLVE on page 3-8
• SHOW on page 3-10.
Example 7-4 Example steering file
ARM DUI 0474C Copyright © 2010-2011 ARM. All rights reserved. 7-26
ID080411 Non-Confidential