aarch64 1.0.0

data/test/dsl_test.rb

@@ -0,0 +1,11 @@
+require "helper"
+
+class DSLTest < AArch64::Test
+  def test_dsl_has_methods
+    assert_bytes [0x9f,0x08,0x25,0xab] do |asm|
+      asm.pretty do
+        asm.cmn      x4, w5, uxtb(2)
+      end
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,51 @@
+require "aarch64"
+require "minitest/autorun"
+require "hatstone"
+require "stringio"
+
+module AArch64
+  class Test < Minitest::Test
+    def disasm code
+      hs = Hatstone.new(Hatstone::ARCH_ARM64, Hatstone::MODE_ARM)
+      hs.disasm(code, 0x0)
+    end
+
+    def f str
+      str.split(" ").map { |x| x.to_i(16) }
+    end
+
+    def assert_bytes bytes
+      asm = Assembler.new
+      yield asm
+      jit_buffer = StringIO.new
+      asm.write_to jit_buffer
+      if false
+        actual_bin = sprintf("%032b", jit_buffer.string.unpack1("L<")).gsub(/([01]{4})/, '\1_').sub(/_$/, '')
+        expected_bin = sprintf("%032b", bytes.pack("C4").unpack1("L<")).gsub(/([01]{4})/, '\1_').sub(/_$/, '')
+        assert_equal expected_bin, actual_bin
+      end
+      assert_equal bytes, jit_buffer.string.bytes
+    end
+
+    def assert_insn binary, asm:
+      insns = disasm(binary)
+      assert_equal 1, insns.length
+      insn = insns.first
+      assert_equal asm, [insn.mnemonic, insn.op_str].reject(&:empty?).join(" ")
+    end
+
+    def assert_one_insn asm_str
+      asm = self.asm
+
+      if block_given?
+        asm = Assembler.new
+        yield asm
+      end
+
+      jit_buffer = StringIO.new
+      asm.write_to jit_buffer
+
+      assert_insn(jit_buffer.string, asm: asm_str)
+    end
+  end
+end

data/test/not_supported_yet_test.rb

@@ -0,0 +1,55 @@
+require "helper"
+
+class NotSupportedYetTest < AArch64::Test
+  def setup
+    skip "These aren't supported by clang"
+  end
+
+  def test_SETGP
+    # SETGE  [<Xd>]!, <Xn>!, <Xs>
+    # SETGM  [<Xd>]!, <Xn>!, <Xs>
+    # SETGP  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETGPN
+    # SETGEN  [<Xd>]!, <Xn>!, <Xs>
+    # SETGMN  [<Xd>]!, <Xn>!, <Xs>
+    # SETGPN  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETGPT
+    # SETGET  [<Xd>]!, <Xn>!, <Xs>
+    # SETGMT  [<Xd>]!, <Xn>!, <Xs>
+    # SETGPT  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETGPTN
+    # SETGETN  [<Xd>]!, <Xn>!, <Xs>
+    # SETGMTN  [<Xd>]!, <Xn>!, <Xs>
+    # SETGPTN  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETP
+    # SETE  [<Xd>]!, <Xn>!, <Xs>
+    # SETM  [<Xd>]!, <Xn>!, <Xs>
+    # SETP  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETPN
+    # SETEN  [<Xd>]!, <Xn>!, <Xs>
+    # SETMN  [<Xd>]!, <Xn>!, <Xs>
+    # SETPN  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETPT
+    # SETET  [<Xd>]!, <Xn>!, <Xs>
+    # SETMT  [<Xd>]!, <Xn>!, <Xs>
+    # SETPT  [<Xd>]!, <Xn>!, <Xs>
+  end
+
+  def test_SETPTN
+    # SETETN  [<Xd>]!, <Xn>!, <Xs>
+    # SETMTN  [<Xd>]!, <Xn>!, <Xs>
+    # SETPTN  [<Xd>]!, <Xn>!, <Xs>
+  end
+end

metadata

@@ -0,0 +1,382 @@
+--- !ruby/object:Gem::Specification
+name: aarch64
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Aaron Patterson
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-04-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hatstone
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: jit_buffer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Tired of writing Ruby in Ruby? Now you can write ARM64 assembly in Ruby!
+email: tenderlove@ruby-lang.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- aarch64.gemspec
+- bin/build_instructions.rb
+- lib/aarch64.rb
+- lib/aarch64/instructions.rb
+- lib/aarch64/instructions/adc.rb
+- lib/aarch64/instructions/adcs.rb
+- lib/aarch64/instructions/add_addsub_ext.rb
+- lib/aarch64/instructions/add_addsub_imm.rb
+- lib/aarch64/instructions/add_addsub_shift.rb
+- lib/aarch64/instructions/addg.rb
+- lib/aarch64/instructions/adds_addsub_ext.rb
+- lib/aarch64/instructions/adds_addsub_imm.rb
+- lib/aarch64/instructions/adds_addsub_shift.rb
+- lib/aarch64/instructions/adr.rb
+- lib/aarch64/instructions/adrp.rb
+- lib/aarch64/instructions/and_log_imm.rb
+- lib/aarch64/instructions/and_log_shift.rb
+- lib/aarch64/instructions/ands_log_imm.rb
+- lib/aarch64/instructions/ands_log_shift.rb
+- lib/aarch64/instructions/asrv.rb
+- lib/aarch64/instructions/autda.rb
+- lib/aarch64/instructions/autdb.rb
+- lib/aarch64/instructions/autia.rb
+- lib/aarch64/instructions/autib.rb
+- lib/aarch64/instructions/axflag.rb
+- lib/aarch64/instructions/b_cond.rb
+- lib/aarch64/instructions/b_uncond.rb
+- lib/aarch64/instructions/bc_cond.rb
+- lib/aarch64/instructions/bfm.rb
+- lib/aarch64/instructions/bic_log_shift.rb
+- lib/aarch64/instructions/bics.rb
+- lib/aarch64/instructions/bl.rb
+- lib/aarch64/instructions/blr.rb
+- lib/aarch64/instructions/blra.rb
+- lib/aarch64/instructions/br.rb
+- lib/aarch64/instructions/bra.rb
+- lib/aarch64/instructions/brk.rb
+- lib/aarch64/instructions/bti.rb
+- lib/aarch64/instructions/cas.rb
+- lib/aarch64/instructions/casb.rb
+- lib/aarch64/instructions/cash.rb
+- lib/aarch64/instructions/casp.rb
+- lib/aarch64/instructions/cbnz.rb
+- lib/aarch64/instructions/cbz.rb
+- lib/aarch64/instructions/ccmn_imm.rb
+- lib/aarch64/instructions/ccmn_reg.rb
+- lib/aarch64/instructions/ccmp_imm.rb
+- lib/aarch64/instructions/ccmp_reg.rb
+- lib/aarch64/instructions/cfinv.rb
+- lib/aarch64/instructions/clrex.rb
+- lib/aarch64/instructions/cls_int.rb
+- lib/aarch64/instructions/clz_int.rb
+- lib/aarch64/instructions/crc32.rb
+- lib/aarch64/instructions/crc32c.rb
+- lib/aarch64/instructions/csdb.rb
+- lib/aarch64/instructions/csel.rb
+- lib/aarch64/instructions/csinc.rb
+- lib/aarch64/instructions/csinv.rb
+- lib/aarch64/instructions/csneg.rb
+- lib/aarch64/instructions/dcps.rb
+- lib/aarch64/instructions/dgh.rb
+- lib/aarch64/instructions/dmb.rb
+- lib/aarch64/instructions/drps.rb
+- lib/aarch64/instructions/dsb.rb
+- lib/aarch64/instructions/eon.rb
+- lib/aarch64/instructions/eor_log_imm.rb
+- lib/aarch64/instructions/eor_log_shift.rb
+- lib/aarch64/instructions/eret.rb
+- lib/aarch64/instructions/ereta.rb
+- lib/aarch64/instructions/esb.rb
+- lib/aarch64/instructions/extr.rb
+- lib/aarch64/instructions/gmi.rb
+- lib/aarch64/instructions/hint.rb
+- lib/aarch64/instructions/hlt.rb
+- lib/aarch64/instructions/hvc.rb
+- lib/aarch64/instructions/irg.rb
+- lib/aarch64/instructions/isb.rb
+- lib/aarch64/instructions/ld64b.rb
+- lib/aarch64/instructions/ldadd.rb
+- lib/aarch64/instructions/ldaddb.rb
+- lib/aarch64/instructions/ldaddh.rb
+- lib/aarch64/instructions/ldapr.rb
+- lib/aarch64/instructions/ldaprb.rb
+- lib/aarch64/instructions/ldaprh.rb
+- lib/aarch64/instructions/ldapur_gen.rb
+- lib/aarch64/instructions/ldar.rb
+- lib/aarch64/instructions/ldaxp.rb
+- lib/aarch64/instructions/ldaxr.rb
+- lib/aarch64/instructions/ldclr.rb
+- lib/aarch64/instructions/ldclrb.rb
+- lib/aarch64/instructions/ldeor.rb
+- lib/aarch64/instructions/ldg.rb
+- lib/aarch64/instructions/ldgm.rb
+- lib/aarch64/instructions/ldlar.rb
+- lib/aarch64/instructions/ldnp_gen.rb
+- lib/aarch64/instructions/ldp_gen.rb
+- lib/aarch64/instructions/ldpsw.rb
+- lib/aarch64/instructions/ldr_imm_gen.rb
+- lib/aarch64/instructions/ldr_imm_unsigned.rb
+- lib/aarch64/instructions/ldr_lit_gen.rb
+- lib/aarch64/instructions/ldr_reg_gen.rb
+- lib/aarch64/instructions/ldra.rb
+- lib/aarch64/instructions/ldrb_imm.rb
+- lib/aarch64/instructions/ldrb_reg.rb
+- lib/aarch64/instructions/ldrb_unsigned.rb
+- lib/aarch64/instructions/ldrh_imm.rb
+- lib/aarch64/instructions/ldrh_reg.rb
+- lib/aarch64/instructions/ldrh_unsigned.rb
+- lib/aarch64/instructions/ldrsb_imm.rb
+- lib/aarch64/instructions/ldrsb_reg.rb
+- lib/aarch64/instructions/ldrsb_unsigned.rb
+- lib/aarch64/instructions/ldrsh_imm.rb
+- lib/aarch64/instructions/ldrsh_reg.rb
+- lib/aarch64/instructions/ldrsh_unsigned.rb
+- lib/aarch64/instructions/ldrsw_imm.rb
+- lib/aarch64/instructions/ldrsw_lit.rb
+- lib/aarch64/instructions/ldrsw_reg.rb
+- lib/aarch64/instructions/ldrsw_unsigned.rb
+- lib/aarch64/instructions/ldset.rb
+- lib/aarch64/instructions/ldsetb.rb
+- lib/aarch64/instructions/ldseth.rb
+- lib/aarch64/instructions/ldsmax.rb
+- lib/aarch64/instructions/ldsmaxb.rb
+- lib/aarch64/instructions/ldsmaxh.rb
+- lib/aarch64/instructions/ldsmin.rb
+- lib/aarch64/instructions/ldsminb.rb
+- lib/aarch64/instructions/ldsminh.rb
+- lib/aarch64/instructions/ldtr.rb
+- lib/aarch64/instructions/ldtrb.rb
+- lib/aarch64/instructions/ldtrh.rb
+- lib/aarch64/instructions/ldtrsb.rb
+- lib/aarch64/instructions/ldtrsh.rb
+- lib/aarch64/instructions/ldtrsw.rb
+- lib/aarch64/instructions/ldumax.rb
+- lib/aarch64/instructions/ldumaxb.rb
+- lib/aarch64/instructions/ldumaxh.rb
+- lib/aarch64/instructions/ldumin.rb
+- lib/aarch64/instructions/lduminb.rb
+- lib/aarch64/instructions/lduminh.rb
+- lib/aarch64/instructions/ldur_gen.rb
+- lib/aarch64/instructions/ldursb.rb
+- lib/aarch64/instructions/ldursh.rb
+- lib/aarch64/instructions/ldursw.rb
+- lib/aarch64/instructions/ldxp.rb
+- lib/aarch64/instructions/ldxr.rb
+- lib/aarch64/instructions/lslv.rb
+- lib/aarch64/instructions/lsrv.rb
+- lib/aarch64/instructions/madd.rb
+- lib/aarch64/instructions/movk.rb
+- lib/aarch64/instructions/movn.rb
+- lib/aarch64/instructions/movz.rb
+- lib/aarch64/instructions/mrs.rb
+- lib/aarch64/instructions/msr_imm.rb
+- lib/aarch64/instructions/msr_reg.rb
+- lib/aarch64/instructions/msub.rb
+- lib/aarch64/instructions/nop.rb
+- lib/aarch64/instructions/orn_log_shift.rb
+- lib/aarch64/instructions/orr_log_imm.rb
+- lib/aarch64/instructions/orr_log_shift.rb
+- lib/aarch64/instructions/pacda.rb
+- lib/aarch64/instructions/pacdb.rb
+- lib/aarch64/instructions/pacga.rb
+- lib/aarch64/instructions/pacia.rb
+- lib/aarch64/instructions/pacia2.rb
+- lib/aarch64/instructions/pacib.rb
+- lib/aarch64/instructions/prfm_imm.rb
+- lib/aarch64/instructions/prfm_lit.rb
+- lib/aarch64/instructions/prfm_reg.rb
+- lib/aarch64/instructions/prfum.rb
+- lib/aarch64/instructions/psb.rb
+- lib/aarch64/instructions/rbit_int.rb
+- lib/aarch64/instructions/ret.rb
+- lib/aarch64/instructions/reta.rb
+- lib/aarch64/instructions/rev.rb
+- lib/aarch64/instructions/rmif.rb
+- lib/aarch64/instructions/rorv.rb
+- lib/aarch64/instructions/sb.rb
+- lib/aarch64/instructions/sbc.rb
+- lib/aarch64/instructions/sbcs.rb
+- lib/aarch64/instructions/sbfm.rb
+- lib/aarch64/instructions/sdiv.rb
+- lib/aarch64/instructions/setf.rb
+- lib/aarch64/instructions/setgp.rb
+- lib/aarch64/instructions/setgpn.rb
+- lib/aarch64/instructions/setgpt.rb
+- lib/aarch64/instructions/setgptn.rb
+- lib/aarch64/instructions/setp.rb
+- lib/aarch64/instructions/setpn.rb
+- lib/aarch64/instructions/setpt.rb
+- lib/aarch64/instructions/setptn.rb
+- lib/aarch64/instructions/sev.rb
+- lib/aarch64/instructions/sevl.rb
+- lib/aarch64/instructions/smaddl.rb
+- lib/aarch64/instructions/smc.rb
+- lib/aarch64/instructions/smsubl.rb
+- lib/aarch64/instructions/smulh.rb
+- lib/aarch64/instructions/st2g.rb
+- lib/aarch64/instructions/st64b.rb
+- lib/aarch64/instructions/st64bv.rb
+- lib/aarch64/instructions/st64bv0.rb
+- lib/aarch64/instructions/stg.rb
+- lib/aarch64/instructions/stgm.rb
+- lib/aarch64/instructions/stgp.rb
+- lib/aarch64/instructions/stllr.rb
+- lib/aarch64/instructions/stllrb.rb
+- lib/aarch64/instructions/stllrh.rb
+- lib/aarch64/instructions/stlr.rb
+- lib/aarch64/instructions/stlrb.rb
+- lib/aarch64/instructions/stlrh.rb
+- lib/aarch64/instructions/stlur_gen.rb
+- lib/aarch64/instructions/stlxp.rb
+- lib/aarch64/instructions/stlxr.rb
+- lib/aarch64/instructions/stlxrb.rb
+- lib/aarch64/instructions/stlxrh.rb
+- lib/aarch64/instructions/stnp_gen.rb
+- lib/aarch64/instructions/stp_gen.rb
+- lib/aarch64/instructions/str_imm_gen.rb
+- lib/aarch64/instructions/str_imm_unsigned.rb
+- lib/aarch64/instructions/str_reg_gen.rb
+- lib/aarch64/instructions/strb_imm.rb
+- lib/aarch64/instructions/strb_imm_unsigned.rb
+- lib/aarch64/instructions/strb_reg.rb
+- lib/aarch64/instructions/strh_imm.rb
+- lib/aarch64/instructions/strh_imm_unsigned.rb
+- lib/aarch64/instructions/strh_reg.rb
+- lib/aarch64/instructions/sttr.rb
+- lib/aarch64/instructions/stur_gen.rb
+- lib/aarch64/instructions/stxp.rb
+- lib/aarch64/instructions/stxr.rb
+- lib/aarch64/instructions/stxrb.rb
+- lib/aarch64/instructions/stxrh.rb
+- lib/aarch64/instructions/stz2g.rb
+- lib/aarch64/instructions/stzg.rb
+- lib/aarch64/instructions/stzgm.rb
+- lib/aarch64/instructions/sub_addsub_ext.rb
+- lib/aarch64/instructions/sub_addsub_imm.rb
+- lib/aarch64/instructions/sub_addsub_shift.rb
+- lib/aarch64/instructions/subg.rb
+- lib/aarch64/instructions/subp.rb
+- lib/aarch64/instructions/subps.rb
+- lib/aarch64/instructions/subs_addsub_ext.rb
+- lib/aarch64/instructions/subs_addsub_imm.rb
+- lib/aarch64/instructions/subs_addsub_shift.rb
+- lib/aarch64/instructions/svc.rb
+- lib/aarch64/instructions/swp.rb
+- lib/aarch64/instructions/swpb.rb
+- lib/aarch64/instructions/swph.rb
+- lib/aarch64/instructions/sys.rb
+- lib/aarch64/instructions/sysl.rb
+- lib/aarch64/instructions/tbnz.rb
+- lib/aarch64/instructions/tbz.rb
+- lib/aarch64/instructions/tsb.rb
+- lib/aarch64/instructions/ubfm.rb
+- lib/aarch64/instructions/udf_perm_undef.rb
+- lib/aarch64/instructions/udiv.rb
+- lib/aarch64/instructions/umaddl.rb
+- lib/aarch64/instructions/umsubl.rb
+- lib/aarch64/instructions/umulh.rb
+- lib/aarch64/instructions/wfe.rb
+- lib/aarch64/instructions/wfet.rb
+- lib/aarch64/instructions/wfi.rb
+- lib/aarch64/instructions/wfit.rb
+- lib/aarch64/instructions/xaflag.rb
+- lib/aarch64/instructions/xpac.rb
+- lib/aarch64/instructions/xpaclri.rb
+- lib/aarch64/instructions/yield.rb
+- lib/aarch64/system_registers/mrs_msr_64.rb
+- lib/aarch64/utils.rb
+- lib/aarch64/version.rb
+- test/all_adds_test.rb
+- test/base_instructions_test.rb
+- test/dsl_test.rb
+- test/helper.rb
+- test/not_supported_yet_test.rb
+homepage: https://github.com/tenderlove/aarch64
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.0.dev
+signing_key:
+specification_version: 4
+summary: Write ARM64 assembly in Ruby!
+test_files:
+- test/all_adds_test.rb
+- test/base_instructions_test.rb
+- test/dsl_test.rb
+- test/helper.rb
+- test/not_supported_yet_test.rb