lib/dbwrap/dbwrap_private.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Database interface wrapper around tdb - private header
   4
   5    Copyright (C) Volker Lendecke 2005-2007
   6    Copyright (C) Gregor Beck 2011
   7    Copyright (C) Michael Adam 2011
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21 */
  22
  23 #ifndef __DBWRAP_PRIVATE_H__
  24 #define __DBWRAP_PRIVATE_H__
  25
  26 struct tevent_context;
  27 struct tevent_req;
  28
  29 struct db_record {
  30         struct db_context *db;
  31         TDB_DATA key, value;
  32         NTSTATUS (*storev)(struct db_record *rec, const TDB_DATA *dbufs,
  33                            int num_dbufs, int flag);
  34         NTSTATUS (*delete_rec)(struct db_record *rec);
  35         void *private_data;
  36 };
  37
  38 struct db_context {
  39         struct db_record *(*fetch_locked)(struct db_context *db,
  40                                           TALLOC_CTX *mem_ctx,
  41                                           TDB_DATA key);
  42         struct db_record *(*try_fetch_locked)(struct db_context *db,
  43                                               TALLOC_CTX *mem_ctx,
  44                                               TDB_DATA key);
  45         int (*traverse)(struct db_context *db,
  46                         int (*f)(struct db_record *rec,
  47                                  void *private_data),
  48                         void *private_data);
  49         int (*traverse_read)(struct db_context *db,
  50                              int (*f)(struct db_record *rec,
  51                                       void *private_data),
  52                              void *private_data);
  53         int (*get_seqnum)(struct db_context *db);
  54         int (*transaction_start)(struct db_context *db);
  55         NTSTATUS (*transaction_start_nonblock)(struct db_context *db);
  56         int (*transaction_commit)(struct db_context *db);
  57         int (*transaction_cancel)(struct db_context *db);
  58         NTSTATUS (*parse_record)(struct db_context *db, TDB_DATA key,
  59                                  void (*parser)(TDB_DATA key, TDB_DATA data,
  60                                                 void *private_data),
  61                                  void *private_data);
  62         struct tevent_req *(*parse_record_send)(
  63                 TALLOC_CTX *mem_ctx,
  64                 struct tevent_context *ev,
  65                 struct db_context *db,
  66                 TDB_DATA key,
  67                 void (*parser)(TDB_DATA key, TDB_DATA data, void *private_data),
  68                 void *private_data,
  69                 enum dbwrap_req_state *req_state);
  70         NTSTATUS (*parse_record_recv)(struct tevent_req *req);
  71         NTSTATUS (*do_locked)(struct db_context *db, TDB_DATA key,
  72                               void (*fn)(struct db_record *rec,
  73                                          void *private_data),
  74                               void *private_data);
  75         int (*exists)(struct db_context *db,TDB_DATA key);
  76         int (*wipe)(struct db_context *db);
  77         int (*check)(struct db_context *db);
  78         size_t (*id)(struct db_context *db, uint8_t *id, size_t idlen);
  79
  80         const char *name;
  81         void *private_data;
  82         enum dbwrap_lock_order lock_order;
  83         bool persistent;
  84 };
  85
  86 #define DBWRAP_LOCK_ORDER_MIN DBWRAP_LOCK_ORDER_1
  87 #define DBWRAP_LOCK_ORDER_MAX DBWRAP_LOCK_ORDER_3
  88
  89 #define DBWRAP_LOCK_ORDER_VALID(order) \
  90         (((order) >= DBWRAP_LOCK_ORDER_MIN) && \
  91          ((order) <= DBWRAP_LOCK_ORDER_MAX))
  92
  93 #endif /* __DBWRAP_PRIVATE_H__ */
  94