unicorn

History

Ahmed Samy 02e6c14e12 x86: add MSR API via reg API (#755 ) Writing / reading to model specific registers should be as easy as calling a function, it's a bit stupid to write shell code and run them just to write/read to a MSR, and even worse, you need more than just a shellcode to read... So, add a special register ID called UC_X86_REG_MSR, which should be passed to uc_reg_write()/uc_reg_read() as the register ID, and then a data structure which is uc_x86_msr (12 bytes), as the value (always), where: Byte Value Size 0 MSR ID 4 4 MSR val 8		2017-02-24 21:37:19 +08:00
..
prebuilt	Allow dlls to be copied out of prebuilt directory	2016-11-17 20:59:39 -08:00
unicorn	x86: add MSR API via reg API (#755 )	2017-02-24 21:37:19 +08: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	make cleanup	2016-11-06 16:27:24 -08:00
sample_arm.py	python: correct a comment on sample_arm.py	2016-11-19 16:51:08 +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	Update .travis.yml	2016-11-11 07:45:06 -08:00
setup.cfg	Fixes to make python distribution for windows work	2016-11-05 09:18:50 -07:00
setup.py	update Windows DLL dependency	2017-01-22 00:39:21 +08:00
shellcode.py	Update .travis.yml	2016-11-11 07:45:06 -08:00

README.TXT

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.