This file credits all the contributors of Keystone Engine (keystone-engine.org).

Beta testers (in no particular order)

=====================================

Mike Guidry

Eloi Vanderbeken

Tim "diff" Strazzere

Matt Graeber

Edgar Barbosa

Loi Anh Tuan

Sascha Schirra

hugsy

Alexander Tereshkin

Sébastien Duquette

Sergi Alvarez, aka pancake (author of radare)

Richo Healey

Remco Verhoef (honeytrap.io)

Duncan Ogilvie

Bruce Dang

Dan Caselden

Jaime Peñalba

Daniel Collin

Vitaly Osipov

Dang Hoang Vu

Paul Rascagneres

postmodern

Fotis Loukos

Peter Geissler

Ingmar Steen (CED)

Matteo Favaro

Julien Legras

Anton Kochkov

Francisco Alonso

rdmz

practicalswift

Jurriaan Bremer

Contributors (in no particular order)

=====================================

Ingmar Steen: NodeJS binding.

Sascha Schirra: Ruby binding.

Remco Verhoef: Go & Rust bindings.

Adrian Herrera: Haskell binding.

practicalswift: Various cool bugs found by fuzzing.

Aziem Chawdhary: OCaml binding.

This file details the changelog of Keystone.

---------------------------------

Version 0.9.1: July 27th, 2016

[ Core & tool ]

- Fix a segfault in kstool (on missing assembly input).

- kstool now allows to specify instruction address.

- Build Mac libraries in universal format by default.

- Add "lib32" option to cross-compile to 32-bit *nix (on 64-bit system).

- Add "lib_only" option to only build libraries (skip kstool).

- New bindings: Haskell & OCaml.

[ X86 ]

- Fix instructions: LJMP, LCALL, CDQE, SHR, SHL, SAR, SAL, LOOP, LOOPE, LOOPNE

- Better handling a lot of tricky input caught by assert() before.

- Better support for Nasm syntax.

[ Arm ]

- Fix BLX instruction.

[ Python binding ]

- Better Python3 support.

- Expose @stat_count in KsError class when ks_asm() returns with error.

See sample code in bindings/python/sample_asm_count.py

[ Go binding ]

- Fix Go binding for 32-bit

----------------------------------

Version 0.9: May 31th, 2016

- Initial public release.

FOSS License Exception

What is the FOSS License Exception?

This is based on the Oracle's Free and Open Source Software ("FOSS")

License Exception.

The Free and Open Source Software ("FOSS") License Exception allows

developers of FOSS applications to include Keystone Libraries with their

FOSS applications. This exception permits distribution of Keystone libraries

with a developer's FOSS applications licensed under the terms of another

FOSS license listed below, even though such other FOSS license may be

incompatible with the GPL.

The following terms and conditions describe the circumstances under which

Oracle's FOSS License Exception applies.

FOSS License Exception Terms and Conditions

1. Definitions. "Derivative Work" means a derivative work, as defined

under applicable copyright law, formed entirely from the Program and

one or more FOSS Applications.

"FOSS Application" means a free and open source software application

distributed subject to a license listed in the section below titled

"FOSS License List."

"FOSS Notice" means a notice put in a copy of Keystone Libraries

stating that such copy of Keystone Libraries may be distributed under

FOSS License Exception.

"Independent Work" means portions of the Derivative Work that are not

derived from the Program and can reasonably be considered independent

and separate works.

"Program" means a copy of Keystone Libraries that contains

a FOSS Notice.

2. A FOSS application developer ("you" or "your") may distribute a

Derivative Work provided that you and the Derivative Work meet all of

the following conditions:

a. You obey the GPL in all respects for the Program and all portions

(including modifications) of the Program included in the

Derivative Work (provided that this condition does not apply to

Independent Works);

b. The Derivative Work does not include any work licensed under the

GPL other than the Program;

c. You distribute Independent Works subject to a license listed in

the section below titled "FOSS License List";

d. You distribute Independent Works in object code or executable

form with the complete corresponding machine-readable source code

on the same medium and under the same FOSS license applying to

the object code or executable forms;

e. All works that are aggregated with the Program or the Derivative

Work on a medium or volume of storage are not derivative works of

the Program, Derivative Work or FOSS Application, and must

reasonably be considered independent and separate works.

3. Keystone's authors reserves all rights not expressly granted in these

terms and conditions. If all of the above conditions are not met, then

this FOSS License Exception does not apply to you/your Derivative Work.

FOSS License List

+------------------------------------------------------------------------+

|License Name |Version(s)/Copyright Date|

|----------------------------------------------+-------------------------|

|Academic Free License |2.0 |

|----------------------------------------------+-------------------------|

|Apache Software License |1.0/1.1/2.0 |

|----------------------------------------------+-------------------------|

|Apple Public Source License |2.0 |

|----------------------------------------------+-------------------------|

|Artistic license |From Perl 5.8.0 |

|----------------------------------------------+-------------------------|

|BSD license |"July 22 1999" |

|----------------------------------------------+-------------------------|

|Common Development and Distribution License |1.0 |

|(CDDL) | |

|----------------------------------------------+-------------------------|

|Common Public License |1.0 |

|----------------------------------------------+-------------------------|

|Eclipse Public License |1.0 |

|----------------------------------------------+-------------------------|

|European Union Public License (EUPL)¹ |1.1 |

|----------------------------------------------+-------------------------|

|GNU Affero General Public License (AGPL) |3.0 |

|----------------------------------------------+-------------------------|

|GNU Library or "Lesser" General Public License|2.0/2.1/3.0 |

|(LGPL) | |

|----------------------------------------------+-------------------------|

|GNU General Public License (GPL) |3.0 |

|----------------------------------------------+-------------------------|

|IBM Public License |1.0 |

|----------------------------------------------+-------------------------|

|Jabber Open Source License |1.0 |

|----------------------------------------------+-------------------------|

|MIT License (As listed in file |- |

|MIT-License.txt) | |

|----------------------------------------------+-------------------------|

|Mozilla Public License (MPL) |1.0/1.1 |

|----------------------------------------------+-------------------------|

|Open Software License |2.0 |

|----------------------------------------------+-------------------------|

|OpenSSL license (with original SSLeay license)|"2003" ("1998") |

|----------------------------------------------+-------------------------|

|PHP License |3.0/3.01 |

|----------------------------------------------+-------------------------|

|Python license (CNRI Python License) |- |

|----------------------------------------------+-------------------------|

|Python Software Foundation License |2.1.1 |

|----------------------------------------------+-------------------------|

|Sleepycat License |"1999" |

|----------------------------------------------+-------------------------|

|University of Illinois/NCSA Open Source |- |

|License | |

|----------------------------------------------+-------------------------|

|W3C License |"2001" |

|----------------------------------------------+-------------------------|

|X11 License |"2001" |

|----------------------------------------------+-------------------------|

|Zlib/libpng License |- |

|----------------------------------------------+-------------------------|

|Zope Public License |2.0 |

+------------------------------------------------------------------------+

¹) When an Independent Work is licensed under a "Compatible License"

pursuant to the EUPL, the Compatible License rather than the EUPL is the

applicable license for purposes of these FOSS License Exception Terms and

Conditions.

The commercial license of Keystone allows you to use Keystone libraries & tools

in commercial products.

- The Keystone commercial license is perpetual and royalty-free.

- You have the right to distribute the binary and modifications of Keystone.

- No source code redistribution is allowed in any way.

Contact keystone.engine@gmail.com for further information.

Keystone Engine

[](https://travis-ci.org/keystone-engine/keystone)

[](https://semaphoreci.com/aquynh/keystone)

[](https://ci.appveyor.com/project/aquynh/keystone)

Keystone is a lightweight multi-platform, multi-architecture assembler framework.

It offers some unparalleled features:

- Multi-architecture, with support for Arm, Arm64 (AArch64/Armv8), Hexagon, Mips, PowerPC, Sparc, SystemZ & X86 (include 16/32/64bit).

- Clean/simple/lightweight/intuitive architecture-neutral API.

- Implemented in C/C++ languages, with bindings for Python, NodeJS, Ruby, Go, Rust, Haskell & OCaml available.

- Native support for Windows & \*nix (with Mac OSX, Linux, *BSD & Solaris confirmed).

- Thread-safe by design.

- Open source - with a dual license.

Keystone is based on LLVM, but it goes much further with [a lot more to offer](/docs/beyond_llvm.md).

Further information is available at http://www.keystone-engine.org

License

Keystone is available under a dual license:

- Version 2 of the GNU General Public License (GPLv2). (I.e. Without the "any later version" clause.).

License information can be found in the [COPYING file](COPYING) and the [EXCEPTIONS-CLIENT file](EXCEPTIONS-CLIENT).

This combination allows almost all of open source projects to use Keystone without conflicts.

- For commercial usage in production environments, contact the authors of Keystone to buy a royalty-free license.

See [LICENSE-COM.TXT](LICENSE-COM.TXT) for more information.

Compilation & Docs

See [COMPILE.md](docs/COMPILE.md) file for how to compile and install Keystone.

More documentation is available in [docs/README.md](docs/README.md).

Contact

[Contact us](http://www.keystone-engine.org/contact/) via mailing list, email or twitter for any questions.

Contribute

Keystone is impossible without generous support from [our sponsors](/SPONSORS.TXT). We cannot thank them enough!

[CREDITS.TXT](CREDITS.TXT) records other important contributors of our project.

If you want to contribute, please pick up something from our [Github issues](https://github.com/keystone-engine/keystone/issues).

We also maintain a list of more challenged problems in a [TODO list](https://github.com/keystone-engine/keystone/wiki/TODO).

Version 0.9.1 works quite well for all architectures, but is known to not be able

to deal with some malformed craft input. In such a case, Keystone usually exits

with some error messages. Report if you experience this issue, so we can fix

that in the next release.

See details of open bugs at https://github.com/keystone-engine/keystone/issues

This file lists all the sponsors of Keystone Engine.

Thanks a lot for your great support!

----------------------------------------------------

Mike Guidry

Synacktiv Digital Security (www.synacktiv.com)

Tim "diff" Strazzere

Veris Group (www.verisgroup.com)

#ifndef KEYSTONE_ARM_H

#define KEYSTONE_ARM_H

#ifdef __cplusplus

extern "C" {

#include "keystone.h"

typedef enum ks_err_asm_arm {

KS_ERR_ASM_ARM_INVALIDOPERAND = KS_ERR_ASM_ARCH,

KS_ERR_ASM_ARM_MISSINGFEATURE,

KS_ERR_ASM_ARM_MNEMONICFAIL,

} ks_err_asm_arm;

#ifdef __cplusplus

}