Metadata-Version: 2.1
Name: zebracorn
Version: 0.0.1
Summary: A Unicorn CPU emulator fork customized for the zelos binary emulator.
Home-page: https://github.com/zeropointdynamics/zebracorn
Author: Zeropoint Dynamics
Author-email: zelos@zeropointdynamics.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Topic :: Security
Classifier: Topic :: System :: Emulators
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires: ctypes
Provides: zebracorn
Description-Content-Type: text/markdown

Zebracorn
==============

Zebracorn is a lightweight, multi-platform, multi-architecture CPU emulator framework
based on a fork of [Unicorn](http://www.unicorn-engine.org).

The API is identical to Unicorn, but Zebracorn offers a few additional features:

- Hooks:
  - RDTSC instruction
  - Block Translation
  - Callback after N blocks executed
- Execution Info:
  - Block count executed
  - Instruction count executed
- Instruction Meta:
  - Tiny Code Generator (TCG) representation of each instruction
- Unicorn AFL integration

These APIs are only supported through the Python bindings.


The Zebracorn engine is primarily made available to support functionality in the [zelos binary emulator](https://github.com/zeropointdynamics/zelos).

Installation
------------

Zebracorn is distributed as a python `pip` package. Other bindings are not supported. To install the python package:

```bash
$ pip install zebracorn
```

Python packages are available for Windows, Linux and MacOS.

License
-------

Unicorn and Qemu are released under the [GPL license](COPYING).


