From 4810feb156269e8ccd242c58642a9cff1286cbcd Mon Sep 17 00:00:00 2001
From: Arjit Singh Grover <143692910+Koolvansh07@users.noreply.github.com>
Date: Tue, 24 Feb 2026 17:46:58 +0530
Subject: [PATCH] gh-143304: Fix ctypes.CDLL to honor handle parameter on POSIX
 systems (GH-143318)

The handle parameter was being ignored in the POSIX implementation
of CDLL._load_library(), causing it to always call _dlopen() even
when a valid handle was provided. This was a regression introduced
in recent refactoring.
(cherry picked from commit 27ded243485670fa836c9bb421e37a6ef16eca8e)

Co-authored-by: Arjit Singh Grover <143692910+Koolvansh07@users.noreply.github.com>
---
 Lib/ctypes/__init__.py                                    | 2 ++
 Lib/test/test_ctypes/test_loading.py                      | 8 ++++++++
 .../2026-01-01-05-26-00.gh-issue-143304.Kv7x9Q.rst        | 1 +
 3 files changed, 11 insertions(+)
 create mode 100644 Misc/NEWS.d/next/Library/2026-01-01-05-26-00.gh-issue-143304.Kv7x9Q.rst

diff --git a/Lib/ctypes/__init__.py b/Lib/ctypes/__init__.py
index 04ec0270148e0e..7223fc499773aa 100644
--- a/Lib/ctypes/__init__.py
+++ b/Lib/ctypes/__init__.py
@@ -470,6 +470,8 @@ def _load_library(self, name, mode, handle, winmode):
                 if name and name.endswith(")") and ".a(" in name:
                     mode |= _os.RTLD_MEMBER | _os.RTLD_NOW
             self._name = name
+            if handle is not None:
+                return handle
             return _dlopen(name, mode)
 
     def __repr__(self):
diff --git a/Lib/test/test_ctypes/test_loading.py b/Lib/test/test_ctypes/test_loading.py
index 3b8332fbb30928..343f6a07c0a32c 100644
--- a/Lib/test/test_ctypes/test_loading.py
+++ b/Lib/test/test_ctypes/test_loading.py
@@ -106,6 +106,14 @@ def test_load_without_name_and_with_handle(self):
         lib = ctypes.WinDLL(name=None, handle=handle)
         self.assertIs(handle, lib._handle)
 
+    @unittest.skipIf(os.name == "nt", 'POSIX-specific test')
+    @unittest.skipIf(libc_name is None, 'could not find libc')
+    def test_load_without_name_and_with_handle_posix(self):
+        lib1 = CDLL(libc_name)
+        handle = lib1._handle
+        lib2 = CDLL(name=None, handle=handle)
+        self.assertIs(lib2._handle, handle)
+
     @unittest.skipUnless(os.name == "nt", 'Windows-specific test')
     def test_1703286_A(self):
         # On winXP 64-bit, advapi32 loads at an address that does
diff --git a/Misc/NEWS.d/next/Library/2026-01-01-05-26-00.gh-issue-143304.Kv7x9Q.rst b/Misc/NEWS.d/next/Library/2026-01-01-05-26-00.gh-issue-143304.Kv7x9Q.rst
new file mode 100644
index 00000000000000..826b2e9a126d36
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2026-01-01-05-26-00.gh-issue-143304.Kv7x9Q.rst
@@ -0,0 +1 @@
+Fix :class:`ctypes.CDLL` to honor the ``handle`` parameter on POSIX systems.