metasploit-framework/lib/metasm/tests/ia32.rb

#    This file is part of Metasm, the Ruby assembly manipulation suite
#    Copyright (C) 2006-2009 Yoann GUILLOT
#
#    Licence is LGPL, see LICENCE in the top-level directory


require 'test/unit'
require 'metasm'

class TestIa32 < Test::Unit::TestCase
	@@cpu32 = Metasm::Ia32.new
	@@cpu16 = Metasm::Ia32.new(16)
	def assemble(src, cpu=@@cpu32)
		Metasm::Shellcode.assemble(cpu, src).encode_string
	end

	def assert_equal(a, b) super(b, a) end

	def test_basic
		assert_equal(assemble("nop"), "\x90")
		assert_equal(assemble("push eax"), "\x50")
		assert_equal(assemble("push 2"), "\x6a\x02")
		assert_equal(assemble("push 142"), "\x68\x8e\0\0\0")
	end

	def test_sz
		assert_equal(assemble("dec eax"), "\x48")
		assert_equal(assemble("dec ax"), "\x66\x48")
		assert_equal(assemble("dec al"), "\xfe\xc8")
		assert_equal(assemble("arpl [edi+70h], bp"), "cop")
	end

	def test_16
		assert_equal(assemble("push 142", @@cpu16), "\x68\x8e\0")
		assert_equal(assemble("code16 push 142", @@cpu16), "\x68\x8e\0")
		assert_equal(assemble("code16 push 142"), "\x68\x8e\0")
		assert_equal(assemble("push.i16 142"), "\x66\x68\x8e\0")
		assert_equal(assemble("mov eax, 42"), "\xb8\x2a\0\0\0")
		assert_equal(assemble("code16 mov ax, 42"), "\xb8\x2a\0")
	end

	def test_jmp
		assert_equal(assemble("jmp $"), "\xeb\xfe")
		assert_equal(assemble("jmp.i32 $"), "\xe9\xfb\xff\xff\xff")
	end

	def test_opsz
		assert_equal(assemble("cbw"), "\x66\x98")
		assert_equal(assemble("cwde"), "\x98")

		assert_equal(assemble("cbw", @@cpu16), "\x98")
		assert_equal(assemble("cwde", @@cpu16), "\x66\x98")

		assert_equal(assemble("cmpxchg8b [eax]"), "\x0f\xc7\x08")
		assert_equal(assemble("cmpxchg8b [bx]", @@cpu16), "\x66\x0f\xc7\x0f")
	end

	def test_mrmsz
		assert_equal(assemble("mov [eax], ebx"), "\x89\x18")
		assert_equal(assemble("mov [eax], bl"), "\x88\x18")
		assert_equal(assemble("mov ebx, [eax]"), "\x8b\x18")
		assert_equal(assemble("mov bl, [eax]"), "\x8a\x18")
		assert_equal(assemble("mov bl, [bx]"), "\x67\x8a\x1f")
		assert_equal(assemble("mov bl, [bx]", @@cpu16), "\x8a\x1f")
		assert_equal(assemble("code16 mov bl, [bx]"), "\x8a\x1f")
		assert_equal(assemble("mov bl, [0]"), "\x8a\x1d\0\0\0\0")
		assert_equal(assemble("mov.a16 bl, [0]"), "\x67\x8a\x1e\0\0")
	end

	def test_err
		assert_raise(Metasm::ParseError) { assemble("add eax") }
		assert_raise(Metasm::ParseError) { assemble("add add, ebx") }
		assert_raise(Metasm::ParseError) { assemble("add 42, ebx") }
		assert_raise(Metasm::ParseError) { assemble("add [bx+ax]") }
	end

	def test_C
		src = "int bla(void) { volatile int i=0; return ++i; }"
		assert_equal(Metasm::Shellcode.compile_c(@@cpu32, src).encode_string,
				["5589E583EC04C745FC00000000FF45FC8B45FC89EC5DC3"].pack('H*'))
	end

	def disassemble(bin, cpu=@@cpu32)
		Metasm::Shellcode.disassemble(cpu, bin)
	end

	def test_dasm
		d = disassemble("\x90")
		assert_equal(d.decoded[0].class, Metasm::DecodedInstruction)
		assert_equal(d.decoded[0].opcode.name, "nop")

		assert_equal(disassemble("\x66\x0f\xc7\x08").decoded[0], nil)
		assert_equal(disassemble("\x0f\xc7\x08").decoded[0].opcode.name, "cmpxchg8b")
	end

	def test_pfx
		assert_equal(assemble("nop"), "\x90")
		assert_equal(assemble("pause"), "\xf3\x90")
		assert_equal(disassemble("\x90").decoded.values.first.opcode.name, "nop")
		assert_equal(disassemble("\xf3\x90").decoded.values.first.opcode.name, "pause")
	end

	def test_avx
		assert_equal(disassemble("\xc4\xc3\x75\x42\xc2\x03").decoded[0].instruction.to_s, "vmpsadbw ymm0, ymm1, ymm2, 3")
		assert_equal(assemble("vmpsadbw ymm0, ymm1, ymm2, 3"), "\xc4\xc3\x75\x42\xc2\x03")
		assert_equal(assemble("vpblendvb xmm1, xmm2, xmm3, xmm4"), "\xc4\xc3\x69\x4c\xcb\x40")
		assert_equal(assemble("vgatherdpd xmm1, qword ptr [edx+xmm1], xmm2"), "\xc4\xc2\xe9\x92\x0c\x0a")
		assert_equal(disassemble("\xc4\xc2\xe9\x92\x0c\x0a").decoded[0].instruction.to_s, "vgatherdpd xmm1, qword ptr [edx+xmm1], xmm2")
	end
end