diff --git a/test/unit/test_x86.c b/test/unit/test_x86.c index a56e332e..d40e2902 100644 --- a/test/unit/test_x86.c +++ b/test/unit/test_x86.c @@ -1,9 +1,5 @@ -#include -#include -#include +#include "unicorn_test.h" #include -#include -#include // callback for tracing basic blocks static void hook_block(uc_engine *uc, uint64_t address, uint32_t size, void *user_data) @@ -25,12 +21,6 @@ static void hook_code(uc_engine *uc, uint64_t address, uint32_t size, void *user // uc_emu_stop(uc); } -static void uc_assert_success(uc_err err) -{ - assert_int_equal(err, 0); - // uc_strerror(err) -} - static void test_i386(void **state) { uc_engine *uc; @@ -91,9 +81,577 @@ static void test_i386(void **state) uc_close(uc); } +static void test_i386_jump(void **state) +{ + uc_engine *uc; + uc_err err; + uc_hook trace1, trace2; + + const uint8_t code[] = "\xeb\x02\x90\x90\x90\x90\x90\x90"; // jmp 4; nop; nop; nop; nop; nop; nop + const uint64_t address = 0x1000000; + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)-1); + uc_assert_success(err); + + // tracing 1 basic block with customized callback + err = uc_hook_add(uc, &trace1, UC_HOOK_BLOCK, hook_block, NULL, (uint64_t)address, (uint64_t)address); + uc_assert_success(err); + + // tracing 1 instruction at address + err = uc_hook_add(uc, &trace2, UC_HOOK_CODE, hook_code, NULL, (uint64_t)address, (uint64_t)address); + uc_assert_success(err); + + // emulate machine code in infinite time + err = uc_emu_start(uc, address, address+sizeof(code)-1, 0, 0); + uc_assert_success(err); + + err = uc_close(uc); + uc_assert_success(err); +} + +/******************************************************************************/ + +// callback for IN instruction (X86). +// this returns the data read from the port +static uint32_t hook_in(uc_engine *uc, uint32_t port, int size, void *user_data) +{ + uint32_t eip; + + uc_reg_read(uc, UC_X86_REG_EIP, &eip); + + printf("--- reading from port 0x%x, size: %u, address: 0x%x\n", port, size, eip); + + switch(size) { + default: + return 0; // should never reach this + case 1: + // read 1 byte to AL + return 0xf1; + case 2: + // read 2 byte to AX + return 0xf2; + case 4: + // read 4 byte to EAX + return 0xf4; + } +} + +// callback for OUT instruction (X86). +static void hook_out(uc_engine *uc, uint32_t port, int size, uint32_t value, void *user_data) +{ + uint32_t tmp; + uint32_t eip; + + uc_reg_read(uc, UC_X86_REG_EIP, &eip); + + printf("--- writing to port 0x%x, size: %u, value: 0x%x, address: 0x%x\n", port, size, value, eip); + + // TODO: confirm that value is indeed the value of AL/AX/EAX + switch(size) { + default: + return; // should never reach this + case 1: + uc_reg_read(uc, UC_X86_REG_AL, &tmp); + break; + case 2: + uc_reg_read(uc, UC_X86_REG_AX, &tmp); + break; + case 4: + uc_reg_read(uc, UC_X86_REG_EAX, &tmp); + break; + } + + printf("--- register value = 0x%x\n", tmp); +} + +static void test_i386_inout(void **state) +{ + uc_engine *uc; + uc_err err; + uc_hook trace1, trace2, trace3, trace4; + + int r_eax = 0x1234; // EAX register + int r_ecx = 0x6789; // ECX register + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0x41, // inc ecx + 0xE4, 0x3F, // in al, 0x3F + 0x4A, // dec edx + 0xE6, 0x46, // out 0x46, al + 0x43, // inc ebx + }; + + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // initialize machine registers + err = uc_reg_write(uc, UC_X86_REG_EAX, &r_eax); + uc_assert_success(err); + err = uc_reg_write(uc, UC_X86_REG_ECX, &r_ecx); + uc_assert_success(err); + + // tracing all basic blocks with customized callback + err = uc_hook_add(uc, &trace1, UC_HOOK_BLOCK, hook_block, NULL, (uint64_t)1, (uint64_t)0); + uc_assert_success(err); + + // tracing all instructions + err = uc_hook_add(uc, &trace2, UC_HOOK_CODE, hook_code, NULL, (uint64_t)1, (uint64_t)0); + uc_assert_success(err); + + // uc IN instruction + err = uc_hook_add(uc, &trace3, UC_HOOK_INSN, hook_in, NULL, UC_X86_INS_IN); + uc_assert_success(err); + + // uc OUT instruction + err = uc_hook_add(uc, &trace4, UC_HOOK_INSN, hook_out, NULL, UC_X86_INS_OUT); + uc_assert_success(err); + + // emulate machine code in infinite time + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_success(err); + + uc_reg_read(uc, UC_X86_REG_EAX, &r_eax); + uc_reg_read(uc, UC_X86_REG_ECX, &r_ecx); + printf(">>> EAX = 0x%x\n", r_eax); + printf(">>> ECX = 0x%x\n", r_ecx); + // TODO: Assert on the register values here + + uc_assert_success(uc_close(uc)); +} + +/******************************************************************************/ + +// emulate code that loop forever +static void test_i386_loop(void **state) +{ + uc_engine *uc; + uc_err err; + + int r_ecx = 0x1234; // ECX register + int r_edx = 0x7890; // EDX register + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0x41, // inc ecx + 0x4a, // dec edx + 0xEB, 0xFE, // jmp $ + }; + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // initialize machine registers + err = uc_reg_write(uc, UC_X86_REG_ECX, &r_ecx); + uc_assert_success(err); + err = uc_reg_write(uc, UC_X86_REG_EDX, &r_edx); + uc_assert_success(err); + + // emulate machine code in 2 seconds, so we can quit even + // if the code loops + err = uc_emu_start(uc, address, address+sizeof(code), 2*UC_SECOND_SCALE, 0); + uc_assert_success(err); + + // verify register values + uc_assert_success(uc_reg_read(uc, UC_X86_REG_ECX, &r_ecx)); + uc_assert_success(uc_reg_read(uc, UC_X86_REG_EDX, &r_edx)); + + assert_int_equal(r_ecx, 0x1235); + assert_int_equal(r_edx, 0x788F); + + uc_assert_success(uc_close(uc)); +} + +/******************************************************************************/ + +// emulate code that reads invalid memory +static void test_i386_invalid_mem_read(void **state) +{ + uc_engine *uc; + uc_err err; + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0x88, 0x0D, 0xAA, 0xAA, 0xAA, 0xAA, // mov ecx, [0xAAAAAAAA] + }; + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // emulate machine code in infinite time + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_err(UC_ERR_MEM_READ, err); // TODO: Currently returns MEM_WRITE + + + uc_assert_success(uc_close(uc)); +} + +// emulate code that writes invalid memory +static void test_i386_invalid_mem_write(void **state) +{ + uc_engine *uc; + uc_err err; + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0x89, 0x0D, 0xAA, 0xAA, 0xAA, 0xAA, // mov [0xAAAAAAAA], ecx + }; + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // emulate machine code in infinite time + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_err(UC_ERR_MEM_WRITE, err); + + + uc_assert_success(uc_close(uc)); +} + +// emulate code that jumps to invalid memory +static void test_i386_jump_invalid(void **state) +{ + uc_engine *uc; + uc_err err; + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0xE9, 0xE9, 0xEE, 0xEE, 0xEE, // jmp 0xEEEEEEEE + }; + + // Initialize emulator in X86-32bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_32, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // emulate machine code in infinite time + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_err(UC_ERR_CODE_INVALID, err); + + + uc_assert_success(uc_close(uc)); +} + + +/******************************************************************************/ + +static void hook_mem64(uc_engine *uc, uc_mem_type type, + uint64_t address, int size, int64_t value, void *user_data) +{ + switch(type) { + default: break; + case UC_MEM_READ: + printf(">>> Memory is being READ at 0x%"PRIx64 ", data size = %u\n", + address, size); + break; + case UC_MEM_WRITE: + printf(">>> Memory is being WRITE at 0x%"PRIx64 ", data size = %u, data value = 0x%"PRIx64 "\n", + address, size, value); + break; + } +} + +// callback for tracing instruction +static void hook_code64(uc_engine *uc, uint64_t address, uint32_t size, void *user_data) +{ + uint64_t rip; + + uc_reg_read(uc, UC_X86_REG_RIP, &rip); + printf(">>> Tracing instruction at 0x%"PRIx64 ", instruction size = 0x%x\n", address, size); + printf(">>> RIP is 0x%"PRIx64 "\n", rip); + + // Uncomment below code to stop the emulation using uc_emu_stop() + // if (address == 0x1000009) + // uc_emu_stop(uc); +} + +static void test_x86_64(void **state) +{ + uc_engine *uc; + uc_err err; + uc_hook trace1, trace2, trace3, trace4; + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = "\x41\xBC\x3B\xB0\x28\x2A\x49\x0F\xC9\x90\x4D\x0F\xAD\xCF\x49\x87\xFD\x90\x48\x81\xD2\x8A\xCE\x77\x35\x48\xF7\xD9\x4D\x29\xF4\x49\x81\xC9\xF6\x8A\xC6\x53\x4D\x87\xED\x48\x0F\xAD\xD2\x49\xF7\xD4\x48\xF7\xE1\x4D\x19\xC5\x4D\x89\xC5\x48\xF7\xD6\x41\xB8\x4F\x8D\x6B\x59\x4D\x87\xD0\x68\x6A\x1E\x09\x3C\x59"; + + int64_t rax = 0x71f3029efd49d41d; + int64_t rbx = 0xd87b45277f133ddb; + int64_t rcx = 0xab40d1ffd8afc461; + int64_t rdx = 0x919317b4a733f01; + int64_t rsi = 0x4c24e753a17ea358; + int64_t rdi = 0xe509a57d2571ce96; + int64_t r8 = 0xea5b108cc2b9ab1f; + int64_t r9 = 0x19ec097c8eb618c1; + int64_t r10 = 0xec45774f00c5f682; + int64_t r11 = 0xe17e9dbec8c074aa; + int64_t r12 = 0x80f86a8dc0f6d457; + int64_t r13 = 0x48288ca5671c5492; + int64_t r14 = 0x595f72f6e4017f6e; + int64_t r15 = 0x1efd97aea331cccc; + + int64_t rsp = address + 0x200000; + + + // Initialize emulator in X86-64bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_64, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // initialize machine registers + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RSP, &rsp)); + + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RAX, &rax)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RBX, &rbx)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RCX, &rcx)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RDX, &rdx)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RSI, &rsi)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RDI, &rdi)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R8, &r8)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R9, &r9)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R10, &r10)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R11, &r11)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R12, &r12)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R13, &r13)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R14, &r14)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_R15, &r15)); + + // tracing all basic blocks with customized callback + err = uc_hook_add(uc, &trace1, UC_HOOK_BLOCK, hook_block, NULL, (uint64_t)1, (uint64_t)0); + uc_assert_success(err); + + // tracing all instructions in the range [address, address+20] + err = uc_hook_add(uc, &trace2, UC_HOOK_CODE, hook_code64, NULL, (uint64_t)address, (uint64_t)(address+20)); + uc_assert_success(err); + + // tracing all memory WRITE access (with @begin > @end) + err = uc_hook_add(uc, &trace3, UC_HOOK_MEM_WRITE, hook_mem64, NULL, (uint64_t)1, (uint64_t)0); + uc_assert_success(err); + + // tracing all memory READ access (with @begin > @end) + err = uc_hook_add(uc, &trace4, UC_HOOK_MEM_READ, hook_mem64, NULL, (uint64_t)1, (uint64_t)0); + uc_assert_success(err); + + // emulate machine code in infinite time (last param = 0), or when + // finishing all the code. + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_success(err); + + // Read registers + uc_reg_read(uc, UC_X86_REG_RAX, &rax); + uc_reg_read(uc, UC_X86_REG_RBX, &rbx); + uc_reg_read(uc, UC_X86_REG_RCX, &rcx); + uc_reg_read(uc, UC_X86_REG_RDX, &rdx); + uc_reg_read(uc, UC_X86_REG_RSI, &rsi); + uc_reg_read(uc, UC_X86_REG_RDI, &rdi); + uc_reg_read(uc, UC_X86_REG_R8, &r8); + uc_reg_read(uc, UC_X86_REG_R9, &r9); + uc_reg_read(uc, UC_X86_REG_R10, &r10); + uc_reg_read(uc, UC_X86_REG_R11, &r11); + uc_reg_read(uc, UC_X86_REG_R12, &r12); + uc_reg_read(uc, UC_X86_REG_R13, &r13); + uc_reg_read(uc, UC_X86_REG_R14, &r14); + uc_reg_read(uc, UC_X86_REG_R15, &r15); + + printf(">>> RAX = 0x%" PRIx64 "\n", rax); + printf(">>> RBX = 0x%" PRIx64 "\n", rbx); + printf(">>> RCX = 0x%" PRIx64 "\n", rcx); + printf(">>> RDX = 0x%" PRIx64 "\n", rdx); + printf(">>> RSI = 0x%" PRIx64 "\n", rsi); + printf(">>> RDI = 0x%" PRIx64 "\n", rdi); + printf(">>> R8 = 0x%" PRIx64 "\n", r8); + printf(">>> R9 = 0x%" PRIx64 "\n", r9); + printf(">>> R10 = 0x%" PRIx64 "\n", r10); + printf(">>> R11 = 0x%" PRIx64 "\n", r11); + printf(">>> R12 = 0x%" PRIx64 "\n", r12); + printf(">>> R13 = 0x%" PRIx64 "\n", r13); + printf(">>> R14 = 0x%" PRIx64 "\n", r14); + printf(">>> R15 = 0x%" PRIx64 "\n", r15); + + uc_assert_success(uc_close(uc)); +} + +/******************************************************************************/ + +// callback for SYSCALL instruction (X86). +static void hook_syscall(uc_engine *uc, void *user_data) +{ + uint64_t rax; + + uc_assert_success(uc_reg_read(uc, UC_X86_REG_RAX, &rax)); + assert_int_equal(0x100, rax); + + rax = 0x200; + uc_assert_success(uc_reg_write(uc, UC_X86_REG_RAX, &rax)); +} + +static void test_x86_64_syscall(void **state) +{ + uc_engine *uc; + uc_hook trace1; + uc_err err; + + static const uint64_t address = 0x1000000; + static const uint8_t code[] = { + 0x0F, 0x05, // SYSCALL + }; + + int64_t rax = 0x100; + + // Initialize emulator in X86-64bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_64, &uc); + uc_assert_success(err); + + // map 2MB memory for this emulation + err = uc_mem_map(uc, address, 2 * 1024 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // hook interrupts for syscall + err = uc_hook_add(uc, &trace1, UC_HOOK_INSN, hook_syscall, NULL, UC_X86_INS_SYSCALL); + uc_assert_success(err); + + // initialize machine registers + err = uc_reg_write(uc, UC_X86_REG_RAX, &rax); + uc_assert_success(err); + + // emulate machine code in infinite time (last param = 0), or when + // finishing all the code. + err = uc_emu_start(uc, address, address + sizeof(code), 0, 0); + uc_assert_success(err); + + // verify register values + uc_assert_success(uc_reg_read(uc, UC_X86_REG_RAX, &rax)); + assert_int_equal(0x200, rax); + + uc_assert_success(uc_close(uc)); +} + +/******************************************************************************/ + +static void test_x86_16(void **state) +{ + uc_engine *uc; + uc_err err; + uint8_t tmp; + + static const uint64_t address = 0; + static const uint8_t code[] = { + 0x00, 0x00, // add byte ptr [bx + si], al + }; + + int32_t eax = 7; + int32_t ebx = 5; + int32_t esi = 6; + + // Initialize emulator in X86-16bit mode + err = uc_open(UC_ARCH_X86, UC_MODE_16, &uc); + uc_assert_success(err); + + // map 8KB memory for this emulation + err = uc_mem_map(uc, address, 8 * 1024, UC_PROT_ALL); + uc_assert_success(err); + + // write machine code to be emulated to memory + err = uc_mem_write(uc, address, code, sizeof(code)); + uc_assert_success(err); + + // initialize machine registers + uc_assert_success(uc_reg_write(uc, UC_X86_REG_EAX, &eax)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_EBX, &ebx)); + uc_assert_success(uc_reg_write(uc, UC_X86_REG_ESI, &esi)); + + // emulate machine code in infinite time (last param = 0), or when + // finishing all the code. + err = uc_emu_start(uc, address, address+sizeof(code), 0, 0); + uc_assert_success(err); + + // read from memory + uc_assert_success(uc_mem_read(uc, 11, &tmp, 1)); + assert_int_equal(7, tmp); + + uc_assert_success(uc_close(uc)); +} + +/******************************************************************************/ + int main(void) { const struct CMUnitTest tests[] = { cmocka_unit_test(test_i386), + cmocka_unit_test(test_i386_jump), + cmocka_unit_test(test_i386_inout), + cmocka_unit_test(test_i386_loop), + cmocka_unit_test(test_i386_invalid_mem_read), + cmocka_unit_test(test_i386_invalid_mem_write), + cmocka_unit_test(test_i386_jump_invalid), + + // TODO: Infinite loop, then segfault + //cmocka_unit_test(test_x86_64), + cmocka_unit_test(test_x86_64_syscall), + + cmocka_unit_test(test_x86_16), }; return cmocka_run_group_tests(tests, NULL, NULL); }