unicorn/bindings/python
Benno Fünfstück b0b5f8442d python: Fix exception in finalizer at exit (#873)
Sometimes, the finalizer for an `UcRef` runs so late that the members of the
module have already been set to `None`. We need to make sure that we don't
depend on anything in the module, or we risk getting a Exception when we try
to access the `release_handle` method of `None` (`Uc`).
2017-09-15 22:21:25 +07:00
..
prebuilt Allow dlls to be copied out of prebuilt directory 2016-11-17 20:59:39 -08:00
unicorn python: Fix exception in finalizer at exit (#873) 2017-09-15 22:21:25 +07:00
Makefile Minor tweaks to python setup process; update gitignore 2016-09-12 14:06:50 -07:00
MANIFEST.in Basically, make python builds work as expected 2016-09-12 14:06:20 -07:00
README.TXT Basically, make python builds work as expected 2016-09-12 14:06:20 -07:00
sample_all.sh fix file perms 2015-08-28 21:05:38 -07:00
sample_arm64.py Fix Python 3 samples (#836) 2017-05-15 09:11:22 +08:00
sample_arm64eb.py Fix Python 3 samples (#836) 2017-05-15 09:11:22 +08:00
sample_arm.py Add support for ARM application flags - APSR register (#776) 2017-03-09 22:28:03 +08:00
sample_armeb.py update armeb & arm64eb samples 2017-04-25 12:55:26 +08:00
sample_m68k.py make cleanup 2016-11-06 16:27:24 -08:00
sample_mips.py make cleanup 2016-11-06 16:27:24 -08:00
sample_network_auditing.py Get Python samples running on Python 3 2016-07-29 00:28:43 -07:00
sample_sparc.py make cleanup 2016-11-06 16:27:24 -08:00
sample_x86.py Fix Python 3 samples (#836) 2017-05-15 09:11:22 +08:00
setup.cfg Fixes to make python distribution for windows work 2016-11-05 09:18:50 -07:00
setup.py Don't error during sdist if config-host.mak doesn't exist (#846) 2017-05-31 11:36:33 +08:00
shellcode.py Fix Python 3 samples (#836) 2017-05-15 09:11:22 +08:00

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

1. Installing on Linux:

	$ sudo python setup.py install

	This will build the core C library, package it with the python bindings, 
	and install it to your system.


2. Installing 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 Unicorn download page and paste it in the path:

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


3. Sample code

	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.