[Python-checkins] r71106 - python/trunk/Doc/library/logging.rst

vinay.sajip python-checkins at python.org
Fri Apr 3 23:58:17 CEST 2009

Author: vinay.sajip
Date: Fri Apr  3 23:58:16 2009
New Revision: 71106

Clarified warning about logging use from asynchronous signal handlers.


Modified: python/trunk/Doc/library/logging.rst
--- python/trunk/Doc/library/logging.rst	(original)
+++ python/trunk/Doc/library/logging.rst	Fri Apr  3 23:58:16 2009
@@ -2351,9 +2351,10 @@
 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.

More information about the Python-checkins mailing list