Update bindings for Capstone 4.0.x

[aquynh]

So far, we have around 20 bindings for Capstone 3.x, but after updating to v4.0 (see https://github.com/aquynh/capstone/releases/tag/4.0), except Python binding, most become broken due to some changes in cs_insn structure.

Besides that, v4 added few architectures and some more APIs, that most bindings are missing now.

Finally, v4 added instructions & stuff for most architectures, but that would be handled if you are using https://github.com/aquynh/capstone/blob/master/bindings/const_generator.py.

To be sure, you can diff include/capstone/*.h between v3.0.5 & v4.0, and see the details.

Below is summary of what is broken, and new features that bindings should update to support.

Broken

---

[ x86 ]

• cs_x86 added new fields: xop_cc & encoding, eflags/fpu_flags
• cs_x86.disp type changed from int32_t to int64_t

[ mips ]

• add mode CS_MODE_MIPS2

[ PowerPC ]

• change cs_ppc_op.imm type from int32_t to int64_t.

[ Sparc ]

• change cs_sparc_op.imm type from int32_t to int64_t.

New features

---

• new APIs: cs_regs_access(). see http://www.capstone-engine.org/op_access.html
• new options for cs_option(): CS_OPT_MNEMONIC & CS_OPT_UNSIGNED & CS_OPT_SYNTAX_MASM.
• add 4 new architectures: EVM, M68K, M680X & TMS320C64x.
• add new group types: CS_GRP_PRIVILEGE & CS_GRP_BRANCH_RELATIVE.
• add new error types: CS_ERR_X86_MASM.
• new instructions for most architectures.

Good bindings for Capstone 4.0.x

---

Here is the list of bindings that fully support Capstone 4.0.x.

• Python (maintain in source code tree)
• .NET
• D

[aquynh]

cc @bnagy, @radare, @parasyte, @zer0mem, @Dax89, @capstone-rust, @9ee1, @kevemueller, @ibabushkin, @collarchoke, @beatcracker, @FuzzySecurity, @firodj, @bohlender, @williballenthin, @jingtaozf, @cagyirey, @Stievie, @t00sh

[9ee1]

I've been working on updating Capstone.NET to support Capstone 4, along with some general improvements to Capstone.NET's codebase. I am hoping to release by the end of the week. I'll post here to let you know once I do.

[bohlender]

I've updated the D bindings to the v4.0 API. Not all of the new architectures are supported yet, but will be once I've slimmed down the template usage in the codebase.

[disconnect3d]

Not sure if this is proper issue to post this in but since there is a 4.0.1 version can you release Python bindings for it on PyPi?

[aquynh]

yes i pinged @rhelmot, who is the lord in charge of Pypi package, on v4.0.1 release. lets wait for her reply.

[aquynh]

Pypi package for v4.0.1 is out now. thank you, @rhelmot!

[disconnect3d]

Thanks a lot for this 🍷 !

However, I found one minor bug:

root@618558d983a5:/t# python -c 'import capstone; print(capstone.__version__)'
4.0.0
root@618558d983a5:/t# python -c 'import pkg_resources; print(pkg_resources.get_distribution("capstone").version)'
4.0.1

So the version in setup.py is correct (it is fetched from pkgconfig.mk (https://github.com/aquynh/capstone/blob/4.0.1/bindings/python/setup.py#L30-L57) but the __version__ attribute set in the capstone/__init__.py is incorrect:
https://github.com/aquynh/capstone/blob/4.0.1/bindings/python/capstone/__init__.py#L130-L139

Maybe it should be set via pkg_resources.get_distribution("capstone").version? Afair this would require setuptools to be installed but it's probably not a big deal?

[aquynh]

sorry that i forgot to bump Python version up: f52532a

[aquynh]

@disconnect3d sounds reasonable, please send pull req