unicorn

History

Ilya Leoshkevich 28c4c665f0 Add "holes" to where the removed x86 registers used to be A number of x86 registers were removed for #1440, causing a change in numbering for many other registers. This is causing inconveniences at the moment, e.g. it's not possible to use the Unicorn2 shared library as a drop-in replacement for the Unicorn1 one. Restore the old numbering. Fixes #1492.		2022-03-22 11:31:58 +01:00
..
unicorn	Add "holes" to where the removed x86 registers used to be	2022-03-22 11:31:58 +01:00
Makefile	Fix gen_const	2021-10-26 13:10:59 +02:00
README.md	add Go README and sample.go	2015-10-13 19:41:55 -07:00
sample.go	Go bindings: fix HookAdd in sample	2016-04-07 12:09:26 -07:00

README.md

To download/update the Unicorn Go bindings, run:

go get -u github.com/unicorn-engine/unicorn/bindings/go

A very basic usage example follows

(Does not handle most errors for brevity. Please see sample.go for a more hygenic example):

package main

import (
    "fmt"
    uc "github.com/unicorn-engine/unicorn/bindings/go/unicorn"
)

func main() {
    mu, _ := uc.NewUnicorn(uc.ARCH_X86, uc.MODE_32)
    // mov eax, 1234
    code := []byte{184, 210, 4, 0, 0}
    mu.MemMap(0x1000, 0x1000)
    mu.MemWrite(0x1000, code)
    if err := mu.Start(0x1000, 0x1000+uint64(len(code))); err != nil {
        panic(err)
    }
    eax, _ := mu.RegRead(uc.X86_REG_EAX)
    fmt.Printf("EAX is now: %d\n", eax)
}

An example program exercising far more Unicorn functionality and error handling can be found in sample.go.