| 1 |
TDB_File |
| 2 |
======== |
| 3 |
|
| 4 |
This module provides bindings to Andrew Tridgell's "Trivial Database" |
| 5 |
library (libtdb). TDB is a simple database similar to gdbm, but allows |
| 6 |
multiple simultaneous readers and writers. |
| 7 |
|
| 8 |
TDB_File provides a simple tie() interface, similar to DB_File and |
| 9 |
friends; and an object-oriented interface, which provides access to |
| 10 |
all of the functions in the tdb library. |
| 11 |
|
| 12 |
Currently the hash function (if your TDB version supports it at all) |
| 13 |
is set globally, so the last hash function to be set will be used for |
| 14 |
all TDB_File objects that specify hash functions. Other than this |
| 15 |
limitation (in the TDB C API), all functionality provided by the TDB C |
| 16 |
interface should be available. |
| 17 |
|
| 18 |
INSTALLATION |
| 19 |
|
| 20 |
To install this module type the following: |
| 21 |
|
| 22 |
perl Makefile.PL (see note) |
| 23 |
make |
| 24 |
make test |
| 25 |
make install |
| 26 |
|
| 27 |
NB: Some versions (Debian) of libtdb have changed API, without |
| 28 |
changing version numbers or giving any C macros for code to |
| 29 |
automatically adapt :( Makefile.PL tries to detect the differences I |
| 30 |
know of, please file bugs for any new issues you encounter. You can |
| 31 |
also force particular compatibility options on the Makefile.PL command |
| 32 |
line, eg 'perl Makefile.PL hash_func=1' - see the source. |
| 33 |
|
| 34 |
DEPENDENCIES |
| 35 |
|
| 36 |
This module requires the TDB library, available from: |
| 37 |
|
| 38 |
http://tdb.sourceforge.net/ |
| 39 |
|
| 40 |
TDB_File was developed using libtdb 1.0.6 -- 3 different versions of |
| 41 |
1.0.6 in fact.. |
| 42 |
|
| 43 |
COPYRIGHT AND LICENCE |
| 44 |
|
| 45 |
This program is free software; you can redistribute it and/or modify |
| 46 |
it under the terms of the GNU General Public License as published by |
| 47 |
the Free Software Foundation; either version 2 of the License, or |
| 48 |
(at your option) any later version. |
| 49 |
|
| 50 |
This program is distributed in the hope that it will be useful, |
| 51 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 52 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 53 |
GNU General Public License for more details. |
| 54 |
|
| 55 |
You should have received a copy of the GNU General Public License |
| 56 |
along with this program; if not, write to the Free Software |
| 57 |
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 58 |
|
| 59 |
Copyright (C) 2002, 2005, 2007 Angus Lees <gus@inodes.org> |
