PyQBDI 0.9.0__cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl → 0.11.0__cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl

{PyQBDI-0.9.0.dist-info → PyQBDI-0.11.0.dist-info}/LICENSE.txt

@@ -210,7 +210,7 @@ QBDI source code is under the Apache License v2.0
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2017 - 2022 Quarkslab
+   Copyright 2017 - 2024 Quarkslab
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{PyQBDI-0.9.0.dist-info → PyQBDI-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyQBDI
-Version: 0.9.0
+Version: 0.11.0
 Summary: Python binding for QBDI
 Author: Nicolas Surbayrole
 Author-email: qbdi@quarkslab.com
@@ -8,7 +8,6 @@ License: apache2
 Project-URL: Documentation, https://qbdi.readthedocs.io/
 Project-URL: Source, https://github.com/QBDI/QBDI
 Project-URL: Homepage, https://qbdi.quarkslab.com/
-Platform: UNKNOWN
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: Microsoft :: Windows
@@ -18,6 +17,8 @@ Classifier: Programming Language :: C++
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Security
 Classifier: Topic :: Software Development :: Debuggers
 Requires-Python: >=3.8
@@ -31,9 +32,6 @@ Introduction
     :target: https://qbdi.readthedocs.io/en/stable/?badge=stable
     :alt: Documentation Status
 
-.. image:: https://ci.appveyor.com/api/projects/status/s2qvpu8k8yiau647/branch/master?svg=true
-    :target: https://ci.appveyor.com/project/QBDI/qbdi/branch/master
-
 .. image:: https://img.shields.io/github/v/release/QBDI/QBDI
     :target: https://github.com/QBDI/QBDI/releases
 
@@ -73,11 +71,11 @@ CPU       Operating Systems                Execution                  Memory Acc
 =======   ==============================   ========================   =================================
 x86-64    Android, Linux, macOS, Windows   :green:`Supported`         :green:`Supported`
 x86       Android, Linux, macOS, Windows   :green:`Supported`         :green:`Supported`
-ARM       Linux, Android, iOS              :orange:`Planned (*)`      :orange:`Planned (*)`
-AArch64   Android, Linux, macOS            :orange:`Supported (*)`    :orange:`Supported (*)`
+ARM       Android, Linux                   :yellow:`Supported (*)`    :yellow:`Supported (*)`
+AArch64   Android, Linux, macOS            :yellow:`Supported (*)`    :yellow:`Supported (*)`
 =======   ==============================   ========================   =================================
 
-\* The ARM and AArch64 instruction sets are supported for internal use at the moment.
+\* The ARM and AArch64 instruction sets are supported but in early support.
 
 Installation
 ============
@@ -85,7 +83,7 @@ Installation
 Python API (PyQBDI)
 +++++++++++++++++++
 
-PyQBDI is available through PyPI. The wheel package can be either `downloaded <https://pypi.org/project/PyQBDI/#files>`_ or installed with the following command:
+PyQBDI is available through PyPI. The wheel package can be either `downloaded <https://pypi.org/project/PyQBDI/#files>`__ or installed with the following command:
 
     pip install PyQBDI
 
@@ -98,8 +96,20 @@ There is no strict development timeline or scheduled release plan for the QBDI p
 All the new features and fixes are merged onto the ``dev-next`` branch.
 Devel packages can be downloaded in the artefacts of:
 
-- `Appveyor <https://ci.appveyor.com/project/QBDI/qbdi/branch/dev-next>`_ for Windows packages PyQBDI
-- `Github Actions PyQBDI Linux <https://github.com/QBDI/QBDI/actions?query=workflow%3A%22PyQBDI+Linux+package%22+branch%3Adev-next>`_ for Linux PyQBDI
-- `Github Actions PyQBDI OSX <https://github.com/QBDI/QBDI/actions?query=workflow%3A%22PyQBDI+OSX+package%22+branch%3Adev-next>`_ for OSX PyQBDI
+- `Github Actions <https://github.com/QBDI/QBDI/actions/workflows/python_linux.yml?query=branch%3Adev-next>`__ for Linux PyQBDI
+- `Github Actions <https://github.com/QBDI/QBDI/actions/workflows/python_osx.yml?query=branch%3Adev-next>`__ for OSX PyQBDI
+- `Github Actions <https://github.com/QBDI/QBDI/actions/workflows/python_windows.yml?query=branch%3Adev-next>`__ for windows PyQBDI
+
+Compilation
+===========
+
+The PyQDBI library (apart from the wheel package) can be built by solely passing the **'-DQBDI_TOOLS_PYQBDI=ON'** option to the CMake build system.
+
+However, if you want to build the wheel package, you can run these commands::
 
+    git clone https://github.com/QBDI/QBDI.git
+    python -m pip install --upgrade pip
+    python -m pip install setuptools wheel build
+    python -m build -w
 
+A 32-bit version of Python is mandatory for the X86 architecture whereas a 64-bit one is required for the X86-64 architecture.

PyQBDI-0.11.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pyqbdipreloadlib.cpython-38-i386-linux-gnu.so,sha256=k4FREZUODHcQPZ7W3V0xSxhKE_q-v1lbdySH2iwH-Lc,9294076
+pyqbdipreload.py,sha256=FkavEnds5DCFPnNLoHJ0LJtXVTjSRaWyYJRkcsjPFLc,3505
+pyqbdi.cpython-38-i386-linux-gnu.so,sha256=3pb1isEcyUYcQsk2knifrWLXKuvg0yRl6MgQv5UuWwU,9265340
+PyQBDI-0.11.0.dist-info/WHEEL,sha256=Wk1k0AK4EC5m6NvsCYdxoQpCcEMiN-4zP759f5x-81A,144
+PyQBDI-0.11.0.dist-info/LICENSE.txt,sha256=J-slihDKKorAhYuNFzflMLU8JARSPYV9wfMZIHWr0qE,12462
+PyQBDI-0.11.0.dist-info/top_level.txt,sha256=vaVfPcyi2OkulsN7QdaZiIKzq2GbFV2q24OujHZlbRc,7
+PyQBDI-0.11.0.dist-info/RECORD,,
+PyQBDI-0.11.0.dist-info/METADATA,sha256=fPm09oSNOR_cjMiaHya5YeXOOp4O0L1k7UfPLRKjG-0,5210

{PyQBDI-0.9.0.dist-info → PyQBDI-0.11.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: false
 Tag: cp38-cp38-manylinux_2_17_i686
 Tag: cp38-cp38-manylinux2014_i686

pyqbdipreload.py

@@ -2,7 +2,7 @@
 
 # This file is part of pyQBDI (python binding for QBDI).
 #
-# Copyright 2017 - 2022 Quarkslab
+# Copyright 2017 - 2024 Quarkslab
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -39,9 +39,20 @@ def run():
     args = [args.target] + args.args
     environ = os.environ.copy()
 
+    preloadlib = os.path.join(
+            os.path.dirname(pyqbdi.__file__),
+            os.path.basename(pyqbdi.__file__).replace("pyqbdi", "pyqbdipreloadlib"))
+
+    if not os.path.isfile(preloadlib):
+        print("Cannot found pyqbdi preload library : {}".format(preloadlib))
+        exit(1)
+
     # add LD_PRELOAD or DYLD_INSERT_LIBRARIES
     if platform.system() == 'Darwin':
-        environ["DYLD_INSERT_LIBRARIES"] = pyqbdi.__file__
+
+        environ["DYLD_INSERT_LIBRARIES"] = preloadlib
+        environ["DYLD_LIBRARY_PATH"] = os.path.join(sys.base_prefix, 'lib')
+        environ["DYLD_BIND_AT_LAUNCH"] = "1"
     elif platform.system() == 'Linux':
         libpythonname = "python{}.{}".format(sys.version_info.major, sys.version_info.minor)
         libpython = ctypesutil.find_library(libpythonname)
@@ -52,7 +63,7 @@ def run():
                 print("PyQBDI in PRELOAD mode need lib{}.so".format(libpythonname))
                 exit(1)
 
-        environ["LD_PRELOAD"] = os.pathsep.join([libpython, pyqbdi.__file__])
+        environ["LD_PRELOAD"] = os.pathsep.join([libpython, preloadlib])
         environ["LD_BIND_NOW"] = "1"
     else:
         print("PyQBDI in PRELOAD mode is not supported on this platform")

PyQBDI-0.9.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-pyqbdipreload.py,sha256=iiVSNVrMsamcrh4qeyqdOcQvq8Z_0pH6XQ-ClNwuk0o,3097
-pyqbdi.so,sha256=ME1r9Yy4lxy0mp8oAxqvbxuFj-_F3cyIEDJifKn4trc,7945572
-PyQBDI-0.9.0.dist-info/LICENSE.txt,sha256=RxnKsM7R7MaVz9UWUER49NvjREyGe5VORuEMkehjhhM,12462
-PyQBDI-0.9.0.dist-info/METADATA,sha256=t5CNKncAHD5bnjD0KuInfA1ch6LDDZiYKM3PWUDQuh0,4772
-PyQBDI-0.9.0.dist-info/top_level.txt,sha256=vaVfPcyi2OkulsN7QdaZiIKzq2GbFV2q24OujHZlbRc,7
-PyQBDI-0.9.0.dist-info/RECORD,,
-PyQBDI-0.9.0.dist-info/WHEEL,sha256=GwReX849BnoQWv-HcSXUs0whc-31BkC6U2K6sSoRQvA,144