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)

Samba                                             Aug 16, 2000                                      TDB_STORE(3)