PyQBDI 0.11.0__cp39-cp39-linux_armv7l.whl → 0.12.0__cp39-cp39-linux_armv7l.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,8 @@
+pyqbdi.cpython-39-arm-linux-gnueabihf.so,sha256=O8FCtcdz93Ibca2ZONKA8C-9vSp4aZoSbhaOIwaI6h0,4726664
+pyqbdipreload.py,sha256=Ohb0H9EOEoXauU-Lhg7dNRcM7u6UjM3CnAMPukB5SeE,5654
+pyqbdipreloadlib.cpython-39-arm-linux-gnueabihf.so,sha256=G1lh0oZPQVB2Gg9IfdSl2eSvJZM7bNiU_q-VoW4CyF0,4726732
+pyqbdi-0.12.0.dist-info/licenses/LICENSE.txt,sha256=3I98YIJxiVsPtSQvFhiKYOYja3ODSp3wQMn02feOsv0,12462
+pyqbdi-0.12.0.dist-info/METADATA,sha256=7E6rpDI3_3SujADxmWCWD1Pyzb0YdwdVpWSgSp7AYo8,4888
+pyqbdi-0.12.0.dist-info/WHEEL,sha256=UPXN4hnAS1PQfJ3PwDg9p6DDLpUJ5CaAsK1FlGxIu_c,102
+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: cp39-cp39-linux_armv7l
 

{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

@@ -2,7 +2,7 @@
 
 # This file is part of pyQBDI (python binding for QBDI).
 #
-# 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.
@@ -16,13 +16,74 @@
 # 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():
 
@@ -36,16 +97,11 @@ def run():
 
     script = args.script
     binary = args.target
-    args = [args.target] + args.args
+    execargs = [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)
+    preloadlib = get_preloadlib()
+    binarypath = find_binary(environ, binary)
 
     # add LD_PRELOAD or DYLD_INSERT_LIBRARIES
     if platform.system() == 'Darwin':
@@ -54,17 +110,32 @@ def run():
         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)
+        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)
+            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)
@@ -76,28 +147,14 @@ def run():
     else:
         environ["PYQBDI_TOOL"] = script
 
-    ## 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:
-        # absolute or relative path
-        binarypath = binary
+    if platform.system() == 'Windows':
+        proc = subprocess.run(execargs, env=environ)
+        exit(proc.returncode)
     else:
-        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):
-        print("Cannot find binary {}".format(binary))
+        os.execve(binarypath, execargs, environ)
+        print("Fail execve")
         exit(1)
 
-    os.execve(binarypath, args, environ)
-
-    print("Fail execve")
-    exit(1)
 
 if __name__ == "__main__":
     run()

PyQBDI-0.11.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-pyqbdi.cpython-39-arm-linux-gnueabihf.so,sha256=7opHebxqo90SFnR4buQObfPkKWEjvB7EHO5OQz282k8,4187184
-pyqbdipreload.py,sha256=FkavEnds5DCFPnNLoHJ0LJtXVTjSRaWyYJRkcsjPFLc,3505
-pyqbdipreloadlib.cpython-39-arm-linux-gnueabihf.so,sha256=9BiOCH6c4R5Y4OoQZ1ZVUPU2fnSu1jYpA4Cpg_b_68A,4207736
-PyQBDI-0.11.0.dist-info/LICENSE.txt,sha256=J-slihDKKorAhYuNFzflMLU8JARSPYV9wfMZIHWr0qE,12462
-PyQBDI-0.11.0.dist-info/METADATA,sha256=fPm09oSNOR_cjMiaHya5YeXOOp4O0L1k7UfPLRKjG-0,5210
-PyQBDI-0.11.0.dist-info/WHEEL,sha256=DDolwiQn121HN6IXBPJD3kTznJAcgQu95S3CPKZi5QU,103
-PyQBDI-0.11.0.dist-info/top_level.txt,sha256=vaVfPcyi2OkulsN7QdaZiIKzq2GbFV2q24OujHZlbRc,7
-PyQBDI-0.11.0.dist-info/RECORD,,