unicorn net

Unicorn.Net

Pengikatan/pembungkus WIP .NET yang sedikit lebih bagus untuk mesin Unicorn.

CATATAN

API sangat rentan terhadap perubahan saat ini.

Contoh

Berikut adalah contoh cara menggunakannya. Ini juga merupakan contoh yang sama dengan dokumentasi resmi yang tersedia di sini tetapi dalam C# dan menggunakan Unicorn.Net.

 using ( var emulator = new X86Emulator ( X86Mode . b32 ) )
{
    ulong addr = 0x1000000 ;
    byte [ ] x86code =
    {
        0x41 , // INC ECX
        0x4a  // DEC EDX
    } ;

    var ecx = 0x1234 ;
    var edx = 0x7890 ;

    // Map 2mb of memory.
    emulator . Memory . Map ( addr , 2 * 1024 * 1024 , MemoryPermissions . All ) ;

    emulator . Registers . ECX = ecx ;
    emulator . Registers . EDX = edx ;

    emulator . Memory . Write ( addr , x86code , x86code . Length ) ;

    emulator . Start ( addr , addr + ( ulong ) x86code . Length ) ;

    Console . WriteLine ( emulator . Registers . ECX ) ;
    Console . WriteLine ( emulator . Registers . EDX ) ;
} 

Register

Membaca dan menulis ke register.

CATATAN

Saat ini tidak ada cara untuk menulis ke register menggunakan ID register, namun hal ini dapat berubah.

 // Assume emulator is an instance of the X86Emulator type.

// Reading from registers.
var val = emulator . Registers . ECX ;
// Writing to registers.
emulator . Registers . ECX = 0x10 ; 

Ingatan

Memetakan, membuka peta, membaca, menulis, dan mengubah izin memori.

 var addr = 0x100000 ;
// Getting memory regions.
var regions = emulator . Memory . Regions ;
// Getting memory page size.
var pageSize = emulator . Memory . PageSize ;

// Mapping memory.
emulator . Memory . Map ( addr , 2 * 1024 , 2 * 1024 , MemoryPermissions . All ) ;
// Unmapping memory.
emulator . Memory . Unmap ( addr + ( 4 * 1024 ) , 4 * 1024 ) ;
// Changing memory permissions.
emulator . Memory . Protect ( addr + ( 4 * 1024 ) , 4 * 1024 , MemoryPermissions . Read ) ;

// Code to write to memory.
var code = new byte [ ]
{
    0x41 , // INC ECX
    0x4a  // DEC EDX
}

// Buffer thats going to be the storage for data read from memory.
var buffer = new byte [ 2 ] ;

// Writing to memory.
emulator . Memory . Write ( code , 0 , code . Length ) ;
// Reading to memory.
emulator . Memory . Read ( buffer , 0 , buffer . Length ) ; 

Mengaitkan

Saat ini hooking masih dalam pengerjaan dan dapat berubah.

 // Adding a memory read hook.
emulator . Hooks . Memory . Add ( MemoryHookType . Read , ( emu , type , address , size , val , userData ) => {
    Console . WriteLine ( " stuff was read from memory." ) ;
} , addr , addr + ( ulong ) code . Length , null ) ; 

Konteks

Menangkap dan memulihkan konteks.

 // emulator.Context will create a new Context object
// which you will to dispose afterwards. Hence the `using` statement.

// Capturing the context.
using ( var ctx = emulator . Context )
{
    .. .
    
    // To restore the context simply do this.
    emulator . Context = ctx ;
} 

Ikatan Mentah

Unicorn.Net juga menyediakan beberapa binding mentah melalui kelas Bindings .

 var bindings = new Bindings ( ) ;
bindings . Open ( .. . ) ;
bindings . MemMap ( .. . ) ;
.. .

TODO

Daftar hal-hal yang perlu dilaksanakan atau yang telah dilaksanakan.

• Emulator

  • uc_emu_start
  • uc_emu_stop
  • uc_query

• Konteks

  • uc_context_alloc
  • uc_context_save
  • uc_context_restore

• Register

  • uc_reg_read
  • uc_reg_write

• Ingatan

  • uc_mem_write
  • uc_mem_read
  • uc_mem_protect
  • uc_mem_regions
  • uc_mem_map
  • uc_mem_unmap

• Mengaitkan

  • uc_hook_add
  • uc_hook_del

• Lengkungan

  • x86
  • lengan
  • lengan64
  • m68k
  • mips
  • perdebatan

• Ikatan sebenarnya

Perizinan

Unicorn.Net dilisensikan di bawah Lisensi MIT yang permisif.