Steering file format

ARM Compiler toolchain v5.02 for µVision Using the Linker

Home > Accessing and managing symbols with armlink > Steering file format

Steering file format

A steering file is a plain text file of the following format:

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:

Example 6. Example 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

Steering file format

See also