86 lines
3.4 KiB
Plaintext
86 lines
3.4 KiB
Plaintext
|
Metadata-Version: 2.1
|
||
|
|
Name: capstone
|
||
|
|
Version: 5.0.1
|
||
|
|
Summary: Capstone disassembly engine
|
||
|
|
Home-page: https://www.capstone-engine.org
|
||
|
|
Author: Nguyen Anh Quynh
|
||
|
|
Author-email: aquynh@gmail.com
|
||
|
|
License: UNKNOWN
|
||
|
|
Platform: UNKNOWN
|
||
|
|
Classifier: License :: OSI Approved :: BSD License
|
||
|
|
Classifier: Programming Language :: Python :: 2
|
||
|
|
Classifier: Programming Language :: Python :: 2.7
|
||
|
|
Classifier: Programming Language :: Python :: 3
|
||
|
|
Provides: capstone
|
||
|
|
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
|
||
|
|
Description-Content-Type: text/markdown
|
||
|
|
License-File: LICENSE.TXT
|
||
|
|
|
||
|
|
To install Capstone, you should run `pip install capstone`.
|
||
|
|
|
||
|
|
If you would like to build Capstone with just the source distribution, without
|
||
|
|
pip, just run `python setup.py install` in the folder with setup.py in it.
|
||
|
|
|
||
|
|
In order to use this source distribution, you will need an environment that can
|
||
|
|
compile C code. On Linux, this is usually easy, but on Windows, this involves
|
||
|
|
installing Visual Studio and using the "Developer Command Prompt" to perform the
|
||
|
|
installation. See BUILDING.txt for more information.
|
||
|
|
|
||
|
|
By default, attempting to install the python bindings will trigger a build of
|
||
|
|
the capstone native core. If this is undesirable for whatever reason, for
|
||
|
|
instance, you already have a globally installed copy of libcapstone, you may
|
||
|
|
inhibit the build by setting the environment variable LIBCAPSTONE_PATH. The
|
||
|
|
exact value is not checked, just setting it will inhibit the build. During
|
||
|
|
execution, this variable may be set to the path of a directory containing a
|
||
|
|
specific version of libcapstone you would like to use.
|
||
|
|
|
||
|
|
If you don't want to build your own copy of Capstone, you can use a precompiled
|
||
|
|
binary distribution from PyPI. Saying `pip install capstone` should
|
||
|
|
automatically obtain an appropriate copy for your system. If it does not, please
|
||
|
|
open an issue at https://github.com/aquynh/capstone and tag @rhelmot - she
|
||
|
|
will fix this, probably!
|
||
|
|
|
||
|
|
--------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
Capstone is a disassembly framework with the target of becoming the ultimate
|
||
|
|
disasm engine for binary analysis and reversing in the security community.
|
||
|
|
|
||
|
|
Created by Nguyen Anh Quynh, then developed and maintained by a small community,
|
||
|
|
Capstone offers some unparalleled features:
|
||
|
|
|
||
|
|
- Support multiple hardware architectures: ARM, ARM64 (ARMv8), Mips, PPC, Sparc,
|
||
|
|
SystemZ, XCore and X86 (including X86_64).
|
||
|
|
|
||
|
|
- Having clean/simple/lightweight/intuitive architecture-neutral API.
|
||
|
|
|
||
|
|
- Provide details on disassembled instruction (called “decomposer” by others).
|
||
|
|
|
||
|
|
- Provide semantics of the disassembled instruction, such as list of implicit
|
||
|
|
registers read & written.
|
||
|
|
|
||
|
|
- Implemented in pure C language, with lightweight wrappers for C++, C#, Go,
|
||
|
|
Java, NodeJS, Ocaml, Python, Ruby & Vala ready (available in main code,
|
||
|
|
or provided externally by the community).
|
||
|
|
|
||
|
|
- Native support for all popular platforms: Windows, Mac OSX, iOS, Android,
|
||
|
|
Linux, *BSD, Solaris, etc.
|
||
|
|
|
||
|
|
- Thread-safe by design.
|
||
|
|
|
||
|
|
- Special support for embedding into firmware or OS kernel.
|
||
|
|
|
||
|
|
- High performance & suitable for malware analysis (capable of handling various
|
||
|
|
X86 malware tricks).
|
||
|
|
|
||
|
|
- Distributed under the open source BSD license.
|
||
|
|
|
||
|
|
Further information is available at http://www.capstone-engine.org
|
||
|
|
|
||
|
|
|
||
|
|
[License]
|
||
|
|
|
||
|
|
This project is released under the BSD license. If you redistribute the binary
|
||
|
|
or source code of Capstone, please attach file LICENSE.TXT with your products.
|
||
|
|
|
||
|
|
|