git.sur5r.net Git - openldap/blob - servers/slapd/back-mdb/mdb.h

   1 /* mdb.h - memory-mapped database library header file */
   2 /*
   3  * Copyright 2011 Howard Chu, Symas Corp.
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted only as authorized by the OpenLDAP
   8  * Public License.
   9  *
  10  * A copy of this license is available in the file LICENSE in the
  11  * top-level directory of the distribution or, alternatively, at
  12  * <http://www.OpenLDAP.org/license.html>.
  13  *
  14  * This code is derived from btree.c written by Martin Hedenfalk.
  15  *
  16  * Copyright (c) 2009, 2010 Martin Hedenfalk <martin@bzero.se>
  17  *
  18  * Permission to use, copy, modify, and distribute this software for any
  19  * purpose with or without fee is hereby granted, provided that the above
  20  * copyright notice and this permission notice appear in all copies.
  21  *
  22  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  23  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  24  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  25  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  26  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  27  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  28  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  29  */
  30 #ifndef _MDB_H_
  31 #define _MDB_H_
  32
  33 #include <sys/types.h>
  34
  35 #define MDB_VERSION_MAJOR       0
  36 #define MDB_VERSION_MINOR       8
  37 #define MDB_VERSION_PATCH       0
  38 #define MDB_VERINT(a,b,c)       ((a << 24) | (b << 16) | c)
  39 #define MDB_VERSION_FULL        \
  40         MDB_VERINT(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH)
  41 #define MDB_VERSION_DATE        "August 11, 2011"
  42 #define MDB_VERSTR(a,b,c,d)     "MDB " #a "." #b "." #c "(" #d ")"
  43 #define MDB_VERSION_STRING      \
  44         MDB_VERSTR(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH,MDB_VERSION_DATE)
  45
  46 struct MDB_cursor;
  47 struct MDB_txn;
  48 struct MDB_env;
  49
  50 typedef struct MDB_cursor MDB_cursor;
  51 typedef struct MDB_txn MDB_txn;
  52 typedef struct MDB_env MDB_env;
  53
  54 typedef unsigned int    MDB_dbi;
  55
  56 typedef struct MDB_val {
  57         size_t           mv_size;
  58         void            *mv_data;
  59 } MDB_val;
  60
  61 typedef int  (MDB_cmp_func)(const MDB_val *a, const MDB_val *b);
  62 typedef void (MDB_rel_func)(void *ptr, void *oldptr);
  63
  64 #define MDB_NOOVERWRITE 0x10
  65 #define MDB_NODUPDATA   0x20
  66 #define MDB_DEL_DUP             0x40
  67
  68 typedef enum MDB_cursor_op {            /* cursor operations */
  69         MDB_FIRST,
  70         MDB_GET_BOTH,                   /* position at key/data */
  71         MDB_GET_BOTH_RANGE,             /* position at key, nearest data */
  72         MDB_LAST,
  73         MDB_NEXT,
  74         MDB_NEXT_DUP,
  75         MDB_NEXT_NODUP,
  76         MDB_PREV,
  77         MDB_PREV_DUP,
  78         MDB_PREV_NODUP,
  79         MDB_SET,                                /* position at key, or fail */
  80         MDB_SET_RANGE                   /* position at given key */
  81 } MDB_cursor_op;
  82
  83 /* return codes */
  84 #define MDB_SUCCESS      0
  85 #define MDB_FAIL                -1
  86 #define MDB_KEYEXIST    -2
  87 #define MDB_NOTFOUND    -3
  88 #define MDB_VERSION_MISMATCH    -4
  89
  90 /* DB flags */
  91 #define MDB_REVERSEKEY  0x02            /* use reverse string keys */
  92 #define MDB_DUPSORT             0x04            /* use sorted duplicates */
  93 #define MDB_INTEGERKEY  0x08            /* numeric keys in native byte order */
  94
  95 /* environment flags */
  96 #define MDB_FIXEDMAP    0x01            /* mmap at a fixed address */
  97 #define MDB_NOSYNC              0x10000         /* don't fsync after commit */
  98 #define MDB_RDONLY              0x20000         /* read only */
  99
 100 /* DB or env flags */
 101 #define MDB_CREATE              0x40000         /* create if not present */
 102
 103 typedef struct MDB_stat {
 104         unsigned int    ms_psize;
 105         unsigned int    ms_depth;
 106         unsigned long   ms_branch_pages;
 107         unsigned long   ms_leaf_pages;
 108         unsigned long   ms_overflow_pages;
 109         unsigned long   ms_entries;
 110 } MDB_stat;
 111
 112 char *mdb_version(int *major, int *minor, int *patch);
 113 int  mdb_env_create(MDB_env **env);
 114 int  mdb_env_open(MDB_env *env, const char *path, unsigned int flags, mode_t mode);
 115 int  mdb_env_stat(MDB_env *env, MDB_stat *stat);
 116 int  mdb_env_sync(MDB_env *env, int force);
 117 void mdb_env_close(MDB_env *env);
 118 int  mdb_env_get_flags(MDB_env *env, unsigned int *flags);
 119 int  mdb_env_get_path(MDB_env *env, const char **path);
 120 int  mdb_env_set_mapsize(MDB_env *env, size_t size);
 121 int  mdb_env_set_maxreaders(MDB_env *env, int readers);
 122 int  mdb_env_get_maxreaders(MDB_env *env, int *readers);
 123 int  mdb_env_set_maxdbs(MDB_env *env, int dbs);
 124
 125 int  mdb_txn_begin(MDB_env *env, int rdonly, MDB_txn **txn);
 126 int  mdb_txn_commit(MDB_txn *txn);
 127 void mdb_txn_abort(MDB_txn *txn);
 128
 129 int  mdb_open(MDB_txn *txn, const char *name, unsigned int flags, MDB_dbi *dbi);
 130 int  mdb_stat(MDB_txn *txn, MDB_dbi dbi, MDB_stat *stat);
 131 void mdb_close(MDB_txn *txn, MDB_dbi dbi);
 132
 133 int  mdb_set_compare(MDB_txn *txn, MDB_dbi dbi, MDB_cmp_func *cmp);
 134 int  mdb_set_dupsort(MDB_txn *txn, MDB_dbi dbi, MDB_cmp_func *cmp);
 135 int  mdb_set_relfunc(MDB_txn *txn, MDB_dbi dbi, MDB_rel_func *rel);
 136
 137 int  mdb_get(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data);
 138 int  mdb_put(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data,
 139                             unsigned int flags);
 140 int  mdb_del(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data,
 141                             unsigned int flags);
 142
 143 int  mdb_cursor_open(MDB_txn *txn, MDB_dbi dbi, MDB_cursor **cursor);
 144 void mdb_cursor_close(MDB_cursor *cursor);
 145 int  mdb_cursor_get(MDB_cursor *cursor, MDB_val *key, MDB_val *data,
 146                             MDB_cursor_op op);
 147 int  mdb_cursor_count(MDB_cursor *cursor, unsigned long *countp);
 148
 149 int  mdb_cmp(MDB_txn *txn, MDB_dbi dbi, const MDB_val *a, const MDB_val *b);
 150
 151 #endif /* _MDB_H_ */