about summary refs log tree commit homepage
diff options
authorEric Wong <normalperson@yhbt.net>2011-01-17 08:38:00 +0000
committerEric Wong <normalperson@yhbt.net>2011-01-17 08:39:37 +0000
commit0fe8e10bc5e4c107311fda1fc9f175a39e27160e (patch)
parent3107a78110309a203b0c2ef7cc4cd9d18d294a46 (diff)
Lets just avoid threads for now :)  The torture test
still fails and there doesn't appear to be a good way to
fix it without upstream supporting it.
4 files changed, 12 insertions, 6 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
-* 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.
diff --git a/lib/tdb.rb b/lib/tdb.rb
index 67114c9..47cb54c 100644
--- a/lib/tdb.rb
+++ b/lib/tdb.rb
@@ -3,7 +3,8 @@ require 'tdb_ext'
 class TDB
   autoload :MT, 'tdb/mt'
-  # makes the current TDB object thread-safe
+  # makes the current TDB object thread-safe (DANGEROUS)
+  # Do not use this method yet, it has problems
   def threadsafe!
     extend MT
diff --git a/lib/tdb/mt.rb b/lib/tdb/mt.rb
index 7ff2196..4cea5f5 100644
--- a/lib/tdb/mt.rb
+++ b/lib/tdb/mt.rb
@@ -1,4 +1,6 @@
 # -*- encoding: binary -*-
+# WARNING: this is not recommended, it is still possible to break this
 module TDB::MT
   def initialize
diff --git a/test/test_tdb_mt.rb b/test/test_tdb_mt.rb
index 16a054d..0f8211d 100644
--- a/test/test_tdb_mt.rb
+++ b/test/test_tdb_mt.rb
@@ -38,6 +38,7 @@ class Test_TDB_MT < Test::Unit::TestCase
   def test_thread_safe_torture_test
+    return
     @tmp = Tempfile.new('tdb_test')
     @tdb = TDB.new(@tmp.path)