unicorn

History

Tim Strazzere a44b6e1efc Add OSX 10.11 dylib load fix El Capitan does not guaranteed that (DY)LD_LIBRARY_PATH will exist, so force one last check for the default install directory that the install script uses.		2015-10-16 17:07:53 -07:00
..
unicorn	Add OSX 10.11 dylib load fix	2015-10-16 17:07:53 -07:00
Makefile	import	2015-08-21 15:04:50 +08:00
MANIFEST.in	import	2015-08-21 15:04:50 +08:00
README.TXT	python: no installer & PyPI packages available yet	2015-10-15 23:51:31 +08:00
sample_all.sh	fix file perms	2015-08-28 21:05:38 -07:00
sample_arm64.py	fix file perms	2015-08-28 21:05:38 -07:00
sample_arm.py	fix file perms	2015-08-28 21:05:38 -07:00
sample_m68k.py	fix file perms	2015-08-28 21:05:38 -07:00
sample_mips.py	fix file perms	2015-08-28 21:05:38 -07:00
sample_network_auditing.py	fix file perms	2015-08-28 21:05:38 -07:00
sample_sparc.py	sparc: do not accept BIGENDIAN mode in samples. more sanity check should be done in the core	2015-09-11 14:02:27 +08:00
sample_x86.py	Fix typo in register name (Python sample)	2015-10-15 20:40:03 +02:00
setup.py	fix file perms	2015-08-28 21:05:38 -07:00
shellcode.py	fix file perms	2015-08-28 21:05:38 -07: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 done by:

        $ sudo ./make.sh install


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

		$ 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\