From: Gerhard Häring <gh@ghaering.de>
Date: Fri, 6 Aug 2010 06:13:25 +0000 (+0000)
Subject: Issue #3854: Documented using the sqlite3 module with multiple threads.
X-Git-Tag: v3.1.3rc1~387
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5d8cd24100bf2e6754e405aeafdc98086a7bc2df;p=thirdparty%2FPython%2Fcpython.git

Issue #3854: Documented using the sqlite3 module with multiple threads.
---

diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 668fc64cdd43..d542cbb4e206 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -840,3 +840,18 @@ exception, the transaction is rolled back; otherwise, the transaction is
 committed:
 
 .. literalinclude:: ../includes/sqlite3/ctx_manager.py
+
+
+Common issues
+-------------
+
+Multithreading
+^^^^^^^^^^^^^^
+
+Older SQLite versions had issues with sharing connections between threads.
+That's why the Python module disallows sharing connections and cursors between
+threads. If you still try to do so, you will get an exception at runtime.
+
+The only exception is calling the :meth:`~Connection.interrupt` method, which
+only makes sense to call from a different thread.
+