arm2gas

Migrate legacy ARM syntax assembly to GNU syntax (GAS)

Usage

arm2gas.pl [options] file1 [file2...]

Options

Switch	Descriptions
-c, --compatible	Keeps compatibility with armclang assembler
-h, --help	Show this help text
-i, --verbose	Show a message on every non-trivial convertions
-n, --no-comment	Discard all the comments in output
-o, --output=<file>	Specify the output filename
-r, --return-code	Print return code definitions
-s, --strict	Error on directives that have no equivalent counterparts
-v, --version	Show version info
-w, --no-warning	Suppress all warning messages
-x, --suffix=<string>	Suffix of the output filename [default: '.out']

Supported conversions

• Comments
• Labels*
• Numeric local labels
• Functions
• Sections
• Symbols with special characters
• Numeric literals
• Operators
• Aligment
• PC-relative addressing
• Directives: Conditional
• Directives: Data definition
• Directives: Instruction set
• Directives: Symbol definition
• Directives: Miscellaneous

[*] inline label is not supported yet.

Demo

Conversion result of demo.s (with option -i -c)

Command-line output:

$ ./arm2gas.pl -i -c test.s
WARN: test.s:6 -> test.s.out:6: Numeric local label with scope '2routA' is not supported in GAS, converting to '2'
WARN: test.s:7 -> test.s.out:7: Scope of numeric local label is not supported in GAS, removing ROUT directives
WARN: test.s:8 -> test.s.out:8: Numeric local label with scope '3routB' is not supported in GAS, converting to '3'
WARN: test.s:12 -> test.s.out:12: Can't specify label's search level 't' in GAS, dropping
WARN: test.s:13 -> test.s.out:13: Can't specify label's search level 'a' in GAS, dropping
WARN: test.s:14 -> test.s.out:14: Can't specify label's search level 't' in GAS, dropping
WARN: test.s:14 -> test.s.out:14: Can't specify label's scope 'routC' in GAS, dropping
WARN: test.s:23 -> test.s.out:25: Not all AREA attributes are supported, need a manual check
WARN: test.s:24 -> test.s.out:27: Not all AREA attributes are supported, need a manual check
WARN: test.s:27 -> test.s.out:30: Implicit shift is not supported in GAS, converting to explicit shift
WARN: test.s:28 -> test.s.out:32: Implicit shift is not supported in GAS, converting to explicit shift
INFO: test.s:29 -> test.s.out:34: Converting hexidecimal '&10AF' to '0x10AF'
INFO: test.s:30 -> test.s.out:35: Converting '2_11001010' to hexidecimal literal '0xCA'
INFO: test.s:31 -> test.s.out:36: Converting '-2_1101' to hexidecimal literal '-0x0D'
INFO: test.s:32 -> test.s.out:37: Converting '8_27' to hexidecimal literal '0x17'
WARN: test.s:46 -> test.s.out:51: Unsupported operator :ROR:, need a manual check
WARN: test.s:54 -> test.s.out:59: Conversion containing strings needs a manual check
WARN: test.s:55 -> test.s.out:60: Conversion containing strings needs a manual check
WARN: test.s:68 -> test.s.out:73: Conversion containing strings needs a manual check
WARN: test.s:75 -> test.s.out:80: Local variable 'var1' is not supported, using static declaration
WARN: test.s:76 -> test.s.out:81: Local variable 'var2' is not supported, using static declaration
WARN: test.s:81 -> test.s.out:88: Conversion containing strings needs a manual check

Cautions

By default (without --strict), for those directives that have no equivalent GNU format, arm2gas will try best to convert and generate warning information on the specific line. Therefore, a 'warning' does NOT necessarily mean no issue, please check the conversion result to ensure it works as expected.

Note that arm2gas assumes that the input file is in the correct syntax, otherwise, the conversion result is UNEXPECTED

TODO

• Macro
• Inline label