PyQBDI 0.11.0__cp312-cp312-win_amd64.whl → 0.12.0__cp312-cp312-win_amd64.whl

{PyQBDI-0.11.0.dist-info → pyqbdi-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: PyQBDI
-Version: 0.11.0
+Version: 0.12.0
 Summary: Python binding for QBDI
 Author: Nicolas Surbayrole
 Author-email: qbdi@quarkslab.com
@@ -9,7 +9,6 @@ Project-URL: Documentation, https://qbdi.readthedocs.io/
 Project-URL: Source, https://github.com/QBDI/QBDI
 Project-URL: Homepage, https://qbdi.quarkslab.com/
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
@@ -19,11 +18,14 @@ 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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Security
 Classifier: Topic :: Software Development :: Debuggers
 Requires-Python: >=3.8
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Dynamic: license-file
 
 Introduction
 ============
@@ -66,16 +68,16 @@ Status
 .. role:: orange
 .. role:: red
 
-=======   ==============================   ========================   =================================
-CPU       Operating Systems                Execution                  Memory Access Information
-=======   ==============================   ========================   =================================
-x86-64    Android, Linux, macOS, Windows   :green:`Supported`         :green:`Supported`
-x86       Android, Linux, macOS, Windows   :green:`Supported`         :green:`Supported`
-ARM       Android, Linux                   :yellow:`Supported (*)`    :yellow:`Supported (*)`
-AArch64   Android, Linux, macOS            :yellow:`Supported (*)`    :yellow:`Supported (*)`
-=======   ==============================   ========================   =================================
+=======   ==============================   ==================   =========================
+CPU       Operating Systems                Execution            Memory Access Information
+=======   ==============================   ==================   =========================
+x86-64    Android, Linux, macOS, Windows   :green:`Supported`   :green:`Supported`
+x86       Android, Linux, macOS, Windows   :green:`Supported`   :green:`Supported`
+ARM       Android, Linux                   :green:`Supported`   :green:`Supported`
+AArch64   Android, Linux, macOS, IOs (*)   :green:`Supported`   :green:`Supported`
+=======   ==============================   ==================   =========================
 
-\* The ARM and AArch64 instruction sets are supported but in early support.
+\* IOs support is unstable and need a jailbroken device.
 
 Installation
 ============
@@ -94,11 +96,7 @@ Devel packages
 
 There is no strict development timeline or scheduled release plan for the QBDI project.
 All the new features and fixes are merged onto the ``dev-next`` branch.
-Devel packages can be downloaded in the artefacts of:
-
-- `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
+Devel packages can be downloaded in the artefacts of `Github Actions <https://github.com/QBDI/QBDI/actions/workflows/python.yml?query=branch%3Adev-next>`__.
 
 Compilation
 ===========

pyqbdi-0.12.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pyqbdi.pyd,sha256=Fhw8ho9B6Tbm0wWmh-aHJeDF58ZONYGXcsBaOiheUIA,7708672
+pyqbdiWinPreloader.exe,sha256=9OfKdE1CaoXP9acifytbdxCDYOPc4DahFh9rRyz43pI,13824
+pyqbdipreload.py,sha256=hANOaHha85XUt4Kub8f2lsKZhIErsfkKNAq4O6PZ3lA,5814
+pyqbdipreloadlib.cp312-win_amd64.pyd,sha256=4yBbMfj-1W5qCbtgzC_2GSEsAyJkB2ciD9YJSjvjkrU,7726080
+pyqbdi-0.12.0.dist-info/licenses/LICENSE.txt,sha256=gOUvR_mAOk85D4IBVtoFVh5kieG_u0_0yKXHcETHd34,12687
+pyqbdi-0.12.0.dist-info/METADATA,sha256=J9SOSAmd21QXZd2d3vWuClLYXIpsi4s852reWrW4qtc,5001
+pyqbdi-0.12.0.dist-info/WHEEL,sha256=8UP9x9puWI0P1V_d7K2oMTBqfeLNm21CTzZ_Ptr0NXU,101
+pyqbdi-0.12.0.dist-info/top_level.txt,sha256=vaVfPcyi2OkulsN7QdaZiIKzq2GbFV2q24OujHZlbRc,7
+pyqbdi-0.12.0.dist-info/RECORD,,

{PyQBDI-0.11.0.dist-info → pyqbdi-0.12.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: false
 Tag: cp312-cp312-win_amd64
 

{PyQBDI-0.11.0.dist-info → pyqbdi-0.12.0.dist-info/licenses}/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 - 2024 Quarkslab
+   Copyright 2017 - 2025 Quarkslab
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

pyqbdipreload.py

@@ -0,0 +1,160 @@
+#!/usr/bin/env python3
+
+# This file is part of pyQBDI (python binding for QBDI).
+#
+# Copyright 2017 - 2025 Quarkslab
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import platform
+import pyqbdi
+from ctypes import util as ctypesutil
+import sys
+import os
+import argparse
+import subprocess
+
+def get_preloadlib():
+    if platform.system() == 'Windows':
+        import importlib
+        # ['.py', '.pyw', '.pyc', '.cp310-win_amd64.pyd', '.pyd']
+        # find correct extension on windows like .cp310-win_amd64.pyd
+        for ext in importlib.machinery.all_suffixes():
+            preloadlib = os.path.join(
+                os.path.dirname(pyqbdi.__file__),
+                f"pyqbdipreloadlib{ext}")
+            if os.path.isfile(preloadlib):
+                return preloadlib
+    else:
+        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 find pyqbdi preload library : {}".format(preloadlib))
+        exit(1)
+    return preloadlib
+
+def find_binary(environ, binary, canFail=False):
+    # https://docs.python.org/3.8/library/os.html#os.execve:
+    # "execve will not use the PATH variable to locate the executable; path must contain an appropriate absolute or relative path."
+    # seach the binary path in PATH if needed
+    binarypath = None
+    if '/' in binary or '\\' in binary:
+        # absolute or relative path
+        binarypath = binary
+    else:
+        if os.path.isfile(binary):  # case for current dir on windows
+            return binary
+        if "PATH" in environ:
+            for p in environ["PATH"].split(os.pathsep):
+                if os.path.isfile(os.path.join(p, binary)):
+                    binarypath = os.path.join(p, binary)
+                    break
+
+    if not binarypath or not os.path.isfile(binarypath):
+        if canFail:
+            return None
+        print("Cannot find binary {} make sure its in your PATH env".format(binary))
+        exit(1)
+
+    return binarypath
+
+def find_windows_inject_binary(environ):
+
+    listPreloader = [
+            os.path.join(os.path.dirname(pyqbdi.__file__), "pyqbdiWinPreloader.exe"),
+            "QBDIWinPreloader.exe"]
+
+    for binary in listPreloader:
+        binarypath = find_binary(environ, binary, True)
+        if binarypath is not None:
+            return binarypath
+
+    print("Cannot find Windows injector binary (within {}), make sure one of them are available".format(listPreloader))
+    exit(1)
+
+
+def run():
+
+    parser = argparse.ArgumentParser()
+
+    parser.add_argument("script", type=str, help="PyQBDI script")
+    parser.add_argument("target", type=str, help="command to instrument")
+    parser.add_argument("args", type=str, help="command arguments", nargs='*')
+
+    args = parser.parse_args()
+
+    script = args.script
+    binary = args.target
+    execargs = [args.target] + args.args
+    environ = os.environ.copy()
+
+    preloadlib = get_preloadlib()
+    binarypath = find_binary(environ, binary)
+
+    # add LD_PRELOAD or DYLD_INSERT_LIBRARIES
+    if platform.system() == 'Darwin':
+
+        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)
+        if not libpython:
+            libpythonname = "python{}.{}{}".format(
+                sys.version_info.major, sys.version_info.minor, sys.abiflags)
+            libpython = ctypesutil.find_library(libpythonname)
+            if not libpython:
+                print("PyQBDI in PRELOAD mode need lib{}.so".format(libpythonname))
+                exit(1)
+
+        for s in [libpython, preloadlib]:
+            for c in [" ", ";", os.pathsep]:
+                if c in s:
+                    print(f"Error: found character '{c}' in {s}")
+                    print(f"PyQBDIPrelaod is based on ld.so, which didn't accept '{c}' in LD_PRELOAD.")
+                    print("Please check your installation to avoid ' ' and ';' in file path")
+                    exit(1)
+
+
+        environ["LD_PRELOAD"] = os.pathsep.join([libpython, preloadlib])
+        environ["LD_BIND_NOW"] = "1"
+    elif platform.system() == 'Windows':
+        targetbinary = binarypath
+        binarypath = find_windows_inject_binary(environ)
+        execargs = [binarypath, preloadlib, targetbinary] + execargs[1:]
+    else:
+        print("PyQBDI in PRELOAD mode is not supported on this platform")
+        exit(1)
+
+    # add PYQBDI_TOOL
+    if not os.path.isfile(script):
+        print("Cannot find {} script".format(script))
+        exit(1)
+    else:
+        environ["PYQBDI_TOOL"] = script
+
+    if platform.system() == 'Windows':
+        proc = subprocess.run(execargs, env=environ)
+        exit(proc.returncode)
+    else:
+        os.execve(binarypath, execargs, environ)
+        print("Fail execve")
+        exit(1)
+
+
+if __name__ == "__main__":
+    run()

PyQBDI-0.11.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-pyqbdi.pyd,sha256=cbZbap9c6-2q2GYOz3Nzs04FETX6TdQn1z1hYnR-SlY,6767104
-PyQBDI-0.11.0.dist-info/LICENSE.txt,sha256=c3MbxkvPUYAKDGu3vKCTHdPE6ehviH0FoB1M3bYTBwM,12687
-PyQBDI-0.11.0.dist-info/METADATA,sha256=Uf-zANEM6e2Sjka9sURk9AxV_ymjpG6ngJURpx1_eGk,5325
-PyQBDI-0.11.0.dist-info/WHEEL,sha256=fZWyj_84lK0cA-ZNCsdwhbJl0OTrpWkxInEn424qrSs,102
-PyQBDI-0.11.0.dist-info/top_level.txt,sha256=vaVfPcyi2OkulsN7QdaZiIKzq2GbFV2q24OujHZlbRc,7
-PyQBDI-0.11.0.dist-info/RECORD,,