source3/include/util_tdb.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    tdb utility functions
   4    Copyright (C) Andrew Tridgell 1999
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef __TDBUTIL_H__
  21 #define __TDBUTIL_H__
  22
  23 #include "tdb.h"
  24
  25 #include "talloc.h" /* for tdb_wrap_open() */
  26 #include "../libcli/util/ntstatus.h" /* for map_nt_error_from_tdb() */
  27
  28 struct tdb_wrap {
  29         struct tdb_context *tdb;
  30         const char *name;
  31         struct tdb_wrap *next, *prev;
  32 };
  33
  34 struct tdb_validation_status {
  35         bool tdb_error;
  36         bool bad_freelist;
  37         bool bad_entry;
  38         bool unknown_key;
  39         bool success;
  40 };
  41
  42 typedef int (*tdb_validate_data_func)(TDB_CONTEXT *the_tdb, TDB_DATA kbuf, TDB_DATA dbuf, void *state);
  43
  44 TDB_DATA make_tdb_data(const uint8_t *dptr, size_t dsize);
  45 TDB_DATA string_tdb_data(const char *string);
  46 TDB_DATA string_term_tdb_data(const char *string);
  47
  48 int tdb_chainlock_with_timeout( struct tdb_context *tdb, TDB_DATA key,
  49                                 unsigned int timeout);
  50 int tdb_lock_bystring(struct tdb_context *tdb, const char *keyval);
  51 int tdb_lock_bystring_with_timeout(struct tdb_context *tdb, const char *keyval,
  52                                    int timeout);
  53 void tdb_unlock_bystring(struct tdb_context *tdb, const char *keyval);
  54 int tdb_read_lock_bystring_with_timeout(TDB_CONTEXT *tdb, const char *keyval,
  55                                         unsigned int timeout);
  56 void tdb_read_unlock_bystring(struct tdb_context *tdb, const char *keyval);
  57
  58 int32_t tdb_fetch_int32_byblob(struct tdb_context *tdb, TDB_DATA key);
  59 int32_t tdb_fetch_int32(struct tdb_context *tdb, const char *keystr);
  60 bool tdb_store_uint32_byblob(struct tdb_context *tdb, TDB_DATA key, uint32_t value);
  61 bool tdb_store_uint32(struct tdb_context *tdb, const char *keystr, uint32_t value);
  62 int tdb_store_int32_byblob(struct tdb_context *tdb, TDB_DATA key, int32_t v);
  63 int tdb_store_int32(struct tdb_context *tdb, const char *keystr, int32_t v);
  64 bool tdb_fetch_uint32_byblob(struct tdb_context *tdb, TDB_DATA key, uint32_t *value);
  65 bool tdb_fetch_uint32(struct tdb_context *tdb, const char *keystr, uint32_t *value);
  66 int32_t tdb_change_int32_atomic(struct tdb_context *tdb, const char *keystr, int32_t *oldval, int32_t change_val);
  67 bool tdb_change_uint32_atomic(struct tdb_context *tdb, const char *keystr,
  68                               uint32_t *oldval, uint32_t change_val);
  69
  70 int tdb_store_bystring(struct tdb_context *tdb, const char *keystr, TDB_DATA data, int flags);
  71 int tdb_trans_store_bystring(TDB_CONTEXT *tdb, const char *keystr,
  72                              TDB_DATA data, int flags);
  73 TDB_DATA tdb_fetch_bystring(struct tdb_context *tdb, const char *keystr);
  74 int tdb_delete_bystring(struct tdb_context *tdb, const char *keystr);
  75 int tdb_trans_store(struct tdb_context *tdb, TDB_DATA key, TDB_DATA dbuf,
  76                     int flag);
  77 int tdb_trans_delete(struct tdb_context *tdb, TDB_DATA key);
  78
  79 int tdb_unpack(const uint8 *buf, int bufsize, const char *fmt, ...);
  80 size_t tdb_pack(uint8 *buf, int bufsize, const char *fmt, ...);
  81 bool tdb_pack_append(TALLOC_CTX *mem_ctx, uint8 **buf, size_t *len,
  82                      const char *fmt, ...);
  83
  84 struct tdb_context *tdb_open_log(const char *name, int hash_size,
  85                                  int tdb_flags, int open_flags, mode_t mode);
  86
  87 struct tdb_wrap *tdb_wrap_open(TALLOC_CTX *mem_ctx,
  88                                const char *name, int hash_size, int tdb_flags,
  89                                int open_flags, mode_t mode);
  90
  91 NTSTATUS map_nt_error_from_tdb(enum TDB_ERROR err);
  92
  93 int tdb_validate(struct tdb_context *tdb, tdb_validate_data_func validate_fn);
  94 int tdb_validate_open(const char *tdb_path, tdb_validate_data_func validate_fn);
  95 int tdb_validate_and_backup(const char *tdb_path,
  96                             tdb_validate_data_func validate_fn);
  97
  98 #endif /* __TDBUTIL_H__ */