starf1ame / arm2gas

Migrate legacy ARM syntax assembly to GNU syntax (GAS)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

arm2gas

LICENSE

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

[*] 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

About

Migrate legacy ARM syntax assembly to GNU syntax (GAS)

License:GNU General Public License v3.0


Languages

Language:Perl 100.0%