aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/Doc/library/logging.handlers.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/library/logging.handlers.rst')
-rw-r--r--Doc/library/logging.handlers.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index 8f3aa1dfdd0..d74ef73ee28 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