From 353a85f99ca954c220be61454af6c93258d4fd80 Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Fri, 3 Apr 2009 21:58:16 +0000 Subject: [PATCH] Clarified warning about logging use from asynchronous signal handlers. --- Doc/library/logging.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 2a21d28b6e..b5553934c6 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -2351,9 +2351,10 @@ needing to be done by its clients. It achieves this though using threading locks; there is one lock to serialize access to the module's shared data, and each handler also creates a lock to serialize access to its underlying I/O. -Note that in Linux/Unix environments, threading APIs may not be usable in -asynchronous signal handlers. This may mean that you cannot use logging from -within asynchronous signal handlers; please check your OS documentation. +If you are implementing asynchronous signal handlers using the :mod:`signal` +module, you may not be able to use logging from within such handlers. This is +because lock implementations in the :mod:`threading` module are not always +re-entrant, and so cannot be invoked from such signal handlers. Configuration ------------- -- 2.50.1