tdb_chainlock(3) [centos man page]

TDB_CHAINLOCK(3)					     Linux Programmer's Manual						  TDB_CHAINLOCK(3)

NAME

       tdb_chainlock - lock a group of keys tdb_chainunlock - unlock a previously locked group of keys

SYNOPSIS

       #include <tdb.h>

       int tdb_chainlock(TDB_CONTEXT *tdb, TDB_DATA key);
       void tdb_chainunlock(TDB_CONTEXT *tdb, TDB_DATA key);

DESCRIPTION

       tdb_chainlock  is  a  low-level function used to lock a particular key (and a number of other keys) without any checking: any other process
       attempting to perform tdb operations on those keys will block until tdb_chainunlock is called.

NOTES

       It is the user's responsibility to ensure that they do not deadlock the database using these functions: something which is impossible using
       the other access functions.

RETURN VALUE

       A return value of 0 indicates success and -1 indicates failure.

AUTHORS

       Software: Andrew Tridgell <tridge@linuxcare.com> Man page: Rusty.

SEE ALSO

       gdbm(3), tdb(3), tdb_lockall(3).

Samba								   Oct 13, 2000 						  TDB_CHAINLOCK(3)

TDB_TRAVERSE(3) 					     Linux Programmer's Manual						   TDB_TRAVERSE(3)

NAME

       tdb_traverse - visit every element in a tdb database

SYNOPSIS

       #include <tdb.h>

       int tdb_traverse(TDB_CONTEXT *tdb,
	       int (*fn)(TDB_CONTEXT *,TDB_DATA,TDB_DATA,void *),
	       void *state);

DESCRIPTION

       tdb_traverse  is  the only sure way to visit all the items within a given database, tdb Because this function has intimate knowledge of the
       internals of the database, it is able to cope with writers touching the database at the same time it is trying to traverse it.

       If fn is supplied it will be called with the state parameter for each element in the database, as the forth argument. The First argument is
       the  database  tdb  the second is the key and the third is the data. If this function call returns anything but 0, the traversal will stop.
       Unlike in tdb_fetch() the programmer is not required to free either the pointer from either the key or data parameters that are passed into
       the function. The fn function should have the prototype:
	  int (*tdb_traverse_func)(TDB_CONTEXT *, TDB_DATA, TDB_DATA, void *);

       Calling tdb_traverse with a NULL fn parameter is the appropriate way to count the number of elements in the database.

RETURN VALUE

       The return value is the number of elements traversed or -1 if there was an error.

AUTHORS

       Software: Andrew Tridgell <tridge@linuxcare.com> and Luke Kenneth Casson Leighton Man page: Ben Woodard <ben@valinux.com>

SEE ALSO

       gdbm(3), tdb(3)

Samba								   Aug 16, 2000 						   TDB_TRAVERSE(3)