unicorn

mirror of https://github.com/yuzu-emu/unicorn synced 2024-11-25 14:39:00 +00:00

History

Nguyen Anh Quynh a7a1dcc661 uc_hook_add(): add begin & end arguments for all hook types. also update Python binding after this change		2016-02-11 08:02:13 +08:00
..
unicorn	uc_hook_add(): add begin & end arguments for all hook types. also update Python binding after this change	2016-02-11 08:02:13 +08:00
Makefile
MANIFEST.in
README.TXT	python README.TXT: clarify working directories	2015-11-01 08:50:06 -05:00
sample_all.sh
sample_arm.py
sample_arm64.py
sample_m68k.py
sample_mips.py
sample_network_auditing.py	- Switch to 'in' which works in 2/3 instead of legacy '.has_key()'	2016-01-31 17:01:14 -04:00
sample_sparc.py	uc_mode fixes for bindings	2016-01-25 17:42:51 +11:00
sample_x86.py	uc_hook_add(): add begin & end arguments for all hook types. also update Python binding after this change	2016-02-11 08:02:13 +08:00
setup.py
shellcode.py	uc_hook_add(): add begin & end arguments for all hook types. also update Python binding after this change	2016-02-11 08:02:13 +08:00

README.TXT

This documentation explains how to install Python binding for Unicorn
from source.


0. Install the core engine as dependency

   Follow README in the root directory to compile & install the core.

   On *nix, this can simply be done by (project root directory):

        $ sudo ./make.sh install


1. To install pure Python binding on *nix, run the command below in the Python bindings directory:

		$ sudo make install

  To install Python3 binding package, run the command below:
  (Note: this requires python3 installed in your machine)

		$ sudo make install3



This directory contains some sample code to show how to use Unicorn API.

- sample_<arch>.py
  These code show how to access architecture-specific information for each
  architecture.

- shellcode.py
  This shows how to analyze a Linux shellcode.

- sample_network_auditing.py
  This shows how to analyze & interpret Linux shellcode.


2. To install Python binding on Windows:

	Run the following command in command prompt:

		C:\> C:\location_to_python\python.exe setup.py install

	Next, copy all the DLL files from the 'Core engine for Windows' package available
	on the same Unicorn download page and paste it in the path:

		C:\location_to_python\Lib\site-packages\unicorn\