about summary refs log tree commit homepage
path: root/README
blob: b729ac67556fb8cea96d3d02da4ae79e16056139 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
= 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.html]
  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
{download site}[http://bogomips.org/ruby-tdb/files/] 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

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://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).