https://github.com/python/cpython/commit/8752b0815b1a0b684247c6b443142453c963070e
commit: 8752b0815b1a0b684247c6b443142453c963070e
branch: 3.14
author: Miss Islington (bot) <[email protected]>
committer: vsajip <[email protected]>
date: 2025-06-26T15:25:36+01:00
summary:

[3.14] gh-91555: add warning to docs about possibility of deadlock/infinite 
recursion (GH-135954) (GH-135988)

(cherry picked from commit a4625d597f9fc2d083fbb9c22d3ffcec73b2061a)

files:
M Doc/library/logging.handlers.rst

diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index 8f3aa1dfdd0cde..d74ef73ee28497 100644
--- a/Doc/library/logging.handlers.rst
+++ b/Doc/library/logging.handlers.rst
@@ -1059,6 +1059,15 @@ possible, while any potentially slow operations (such as 
sending an email via
    .. note:: If you are using :mod:`multiprocessing`, you should avoid using
       :class:`~queue.SimpleQueue` and instead use 
:class:`multiprocessing.Queue`.
 
+   .. warning::
+
+      The :mod:`multiprocessing` module uses an internal logger created and
+      accessed via :meth:`~multiprocessing.get_logger`.
+      :class:`multiprocessing.Queue` will log ``DEBUG`` level messages upon
+      items being queued. If those log messages are processed by a
+      :class:`QueueHandler` using the same :class:`multiprocessing.Queue` 
instance,
+      it will cause a deadlock or infinite recursion.
+
    .. method:: emit(record)
 
       Enqueues the result of preparing the LogRecord. Should an exception

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to