tdb_store

Langue: en

Version: 293166 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

tdb_store - store a record in a tdb database.

SYNOPSIS

 #include <tdb.h>
 
 int tdb_store(TDB_CONTEXT *tdb, TDB_DATA key, TDB_DATA record, int flag);
 
 
 

DESCRIPTION

Store a lump of data pointed to by record in the tdb database under the index pointed to by key. The TDB_DATA structure used by both key and record is defined as:
 typedef struct {
         char *dptr;
         size_t dsize;
 } TDB_DATA;
 

The flag determines the way that tdb_store behaves and can be any one of the following values.

TDB_REPLACE
Insert a record creating a new one or overwriting an existing one.
TDB_INSERT
Insert a new entry but refuse to overwrite an existing entry.
TDB_MODIFY
Replace an existing record with a new one. This will fail if, a record does not already exist.

RETURN VALUE

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

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)