diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 57 |
1 files changed, 57 insertions, 0 deletions
@@ -0,0 +1,57 @@ += tdb - Trivial Database bindings for Ruby + +TDB is much like other DBM implementations, except it allows concurrent +writer processes. TDB was initially developed for Samba, but is used by +other projects as well. These Ruby bindings allow Ruby apps to read and +write to the same databases used by Samba! + +== Features + +* Concurrent reader and writer processes may safely operate on the + same file. + +* Releases the GVL for slow disk operations under Ruby 1.9 + +* Includes several {hash functions}[link:Hash_Functions] + not included by upstream TDB. + +== Install + +The original tdb library from the main [site]{http://tdb.samba.org/} is +required. Debian users can just <code>apt-get install tdb-dev</code>. + +The library consists of a C extension so you'll need a C compiler +and Ruby development libraries/headers. + +You may download the tarball from our +{site}[http://bogomips.org/ruby-tdb/] and run setup.rb after unpacking +it: + + http://bogomips.org/ruby-tdb/files/ + +You may also install it via RubyGems on RubyGems.org: + + gem install tdb + +You can get the latest source via git from the following locations +(these versions may not be stable): + + git://git.bogomips.org/ruby-tdb.git + git://repo.or.cz/ruby-tdb.git (mirror) + +You may browse the code from the web and download the latest snapshot +tarballs here: + +* http://git.bogomips.org/cgit/ruby-tdb.git (cgit) +* http://repo.or.cz/w/ruby-tdb.git (gitweb) + +See the HACKING guide on how to contribute and build prerelease gems +from git. + +== Contact + +All feedback (bug reports, user/development dicussion, patches, pull +requests) go to the {mailing list}[mailto:ruby.tdb@librelist.org]. + +For the latest on tdb releases, you may check our NEWS page (and +subscribe to our Atom feed). |