Class Index

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!



These caveats will be addressed upstream in TDB2


The original tdb library from the main site is required. Debian users can just apt-get install tdb-dev. Non-Debian users: building against upstream tdb 1.2.2 and 1.2.7 are known to be broken, so installing tdb from the latest git is recommended.

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 download site and run setup.rb after unpacking it:

You may also install it via RubyGems on

gem install tdb

If you have a tdb installation in a non-standard prefix, you will have to use:

gem install tdb -- --with-tdb-dir=$PFX

Or if you have a non-standard prefix that linkers normally do not search:

gem install tdb -- --with-tdb-dir=$PFX --with-dldflags=-Wl,-rpath=$PFX/lib

You can get the latest source via git from the following locations (these versions may not be stable):

git:// (mirror)

You may browse the code from the web and download the latest snapshot tarballs here:

See the HACKING guide on how to contribute and build prerelease gems from git.


All feedback (bug reports, user/development dicussion, patches, pull requests) go to the mailing list.

For the latest on tdb releases, you may check our NEWS page (and subscribe to our Atom feed).

Originally generated with the Darkfish Rdoc Generator 2, modified by wrongdoc.

We love to hear from you!
Email patches (with git send-email), pull requests, questions, bug reports, suggestions, etc. to us publically at
To subscribe, just send any email to, and respond to the automated confirmation message.
Do not waste bandwidth with HTML, HTML mail will not be read.
Quote only parts you're responding to and do not top post.
For sensitive topics, email us privately at