about summary refs log tree commit homepage
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README12
1 files changed, 7 insertions, 5 deletions
diff --git a/README b/README
index 9a19e3c..b14a9a5 100644
--- a/README
+++ b/README
@@ -15,7 +15,7 @@ write to the same databases used by Samba!
   and child processes.
 
 * Releases the GVL for slow disk operations under Ruby 1.9 so
-  other threads can run (but not other TDB operations on the same file)
+  other threads can run (but not other TDB operations! see Caveats below)
 
 * Includes several {hash functions}[link:Hash_Functions.html]
   not included by upstream TDB.
@@ -25,10 +25,12 @@ write to the same databases used by Samba!
 These caveats will be addressed upstream in
 {TDB2}[http://mid.gmane.org/201008021002.47351.rusty@rustcorp.com.au]
 
-* NOT native thread-safe by default, you MUST initialize your TDB
-  objects with <code>:threadsafe => true</code> or call
-  TDB#threadsafe! on each TDB object if you run with threads
-  under Ruby 1.9 (but not 1.8).
+* NOT native thread-safe.  Don't try accessing TDB objects from
+  multiple threads at the same time.  This probably needs to be
+  fixed upstream since our attempts to make it work have failed.
+
+  However, TDB will allow other Ruby 1.9 threads to run doing non-TDB
+  things just fine.
 
 * Database size is limited to 4G, even on 64-bit systems.