First cut at DUPFIXED support

[openldap] / libraries / libmdb / mdb.h

diff --git a/libraries/libmdb/mdb.h b/libraries/libmdb/mdb.h
index c7841c434ce748cc34ce4bad69e324e22eed6427..5e679c55cee8212526d88a8c359becbaae44a73e 100644 (file)
--- a/libraries/libmdb/mdb.h
+++ b/libraries/libmdb/mdb.h
@@ -32,6 +32,18 @@
 
 #include <sys/types.h>
 
+#define MDB_VERSION_MAJOR      0
+#define MDB_VERSION_MINOR      8
+#define MDB_VERSION_PATCH      0
+#define MDB_VERINT(a,b,c)      (((a) << 24) | ((b) << 16) | (c))
+#define MDB_VERSION_FULL       \
+       MDB_VERINT(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH)
+#define MDB_VERSION_DATE       "August 11, 2011"
+#define MDB_VERSTR(a,b,c,d)    "MDB " #a "." #b "." #c ": (" #d ")"
+#define MDB_VERFOO(a,b,c,d)    MDB_VERSTR(a,b,c,d)
+#define        MDB_VERSION_STRING      \
+       MDB_VERFOO(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH,MDB_VERSION_DATE)
+
 struct MDB_cursor;
 struct MDB_txn;
 struct MDB_env;
@@ -43,33 +55,50 @@ typedef struct MDB_env MDB_env;
 typedef unsigned int   MDB_dbi;
 
 typedef struct MDB_val {
-       void            *mv_data;
        size_t           mv_size;
+       void            *mv_data;
 } MDB_val;
 
 typedef int  (MDB_cmp_func)(const MDB_val *a, const MDB_val *b);
 typedef void (MDB_rel_func)(void *ptr, void *oldptr);
 
-#define MDB_NOOVERWRITE         1
+#define MDB_NOOVERWRITE        0x10
+#define MDB_NODUPDATA  0x20
+#define MDB_DEL_DUP            0x40
 
 typedef enum MDB_cursor_op {           /* cursor operations */
-       MDB_SET,                                /* position at key, or fail */
-       MDB_SET_RANGE,                  /* position at given key */
        MDB_FIRST,
-       MDB_NEXT,
+       MDB_GET_BOTH,                   /* position at key/data */
+       MDB_GET_BOTH_RANGE,             /* position at key, nearest data */
+       MDB_GET_MULTIPLE,               /* only for MDB_DUPFIXED */
        MDB_LAST,
+       MDB_NEXT,
+       MDB_NEXT_DUP,
+       MDB_NEXT_MULTIPLE,              /* only for MDB_DUPFIXED */
+       MDB_NEXT_NODUP,
        MDB_PREV,
-       MDB_GET_BOTH,                   /* position at key/data */
-       MDB_GET_BOTH_RANGE              /* position at key, nearest data */
+       MDB_PREV_DUP,
+       MDB_PREV_NODUP,
+       MDB_SET,                                /* position at key, or fail */
+       MDB_SET_RANGE                   /* position at given key */
 } MDB_cursor_op;
 
 /* return codes */
-#define MDB_FAIL               -1
+/* BerkeleyDB uses -30800 to -30999, we'll go under them */
 #define MDB_SUCCESS     0
+#define MDB_KEYEXIST   (-30799)                /* key/data pair already exists */
+#define MDB_NOTFOUND   (-30798)                /* key/data pair not found (EOF) */
+#define MDB_PAGE_NOTFOUND      (-30797)        /* Requested page not found */
+#define MDB_CORRUPTED  (-30796)                /* Located page was wrong type */
+#define MDB_PANIC              (-30795)                /* Update of meta page failed, probably I/O error */
+#define MDB_VERSION_MISMATCH   (-30794)        /* Environment version mismatch */
 
 /* DB flags */
 #define MDB_REVERSEKEY 0x02            /* use reverse string keys */
 #define MDB_DUPSORT            0x04            /* use sorted duplicates */
+#define MDB_INTEGERKEY 0x08            /* numeric keys in native byte order */
+#define MDB_DUPFIXED   0x10            /* sorted dup items have fixed size */
+#define MDB_INTEGERDUP 0x20            /* numeric dups in native byte order */
 
 /* environment flags */
 #define MDB_FIXEDMAP   0x01            /* mmap at a fixed address */
@@ -88,17 +117,20 @@ typedef struct MDB_stat {
        unsigned long   ms_entries;
 } MDB_stat;
 
-int  mdbenv_create(MDB_env **env);
-int  mdbenv_open(MDB_env *env, const char *path, unsigned int flags, mode_t mode);
-int  mdbenv_stat(MDB_env *env, MDB_stat *stat);
-void mdbenv_close(MDB_env *env);
-int  mdbenv_get_flags(MDB_env *env, unsigned int *flags);
-int  mdbenv_get_path(MDB_env *env, const char **path);
-int  mdbenv_set_mapsize(MDB_env *env, size_t size);
-int  mdbenv_set_maxreaders(MDB_env *env, int readers);
-int  mdbenv_get_maxreaders(MDB_env *env, int *readers);
-int  mdbenv_set_maxdbs(MDB_env *env, int dbs);
-int  mdbenv_sync(MDB_env *env);
+char *mdb_version(int *major, int *minor, int *patch);
+char *mdb_strerror(int err);
+int  mdb_env_create(MDB_env **env);
+int  mdb_env_open(MDB_env *env, const char *path, unsigned int flags, mode_t mode);
+int  mdb_env_stat(MDB_env *env, MDB_stat *stat);
+int  mdb_env_sync(MDB_env *env, int force);
+void mdb_env_close(MDB_env *env);
+int  mdb_env_set_flags(MDB_env *env, unsigned int flags, int onoff);
+int  mdb_env_get_flags(MDB_env *env, unsigned int *flags);
+int  mdb_env_get_path(MDB_env *env, const char **path);
+int  mdb_env_set_mapsize(MDB_env *env, size_t size);
+int  mdb_env_set_maxreaders(MDB_env *env, int readers);
+int  mdb_env_get_maxreaders(MDB_env *env, int *readers);
+int  mdb_env_set_maxdbs(MDB_env *env, int dbs);
 
 int  mdb_txn_begin(MDB_env *env, int rdonly, MDB_txn **txn);
 int  mdb_txn_commit(MDB_txn *txn);
@@ -115,12 +147,14 @@ int  mdb_set_relfunc(MDB_txn *txn, MDB_dbi dbi, MDB_rel_func *rel);
 int  mdb_get(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data);
 int  mdb_put(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data,
                            unsigned int flags);
-int  mdb_del(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data);
+int  mdb_del(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data,
+                           unsigned int flags);
 
 int  mdb_cursor_open(MDB_txn *txn, MDB_dbi dbi, MDB_cursor **cursor);
 void mdb_cursor_close(MDB_cursor *cursor);
 int  mdb_cursor_get(MDB_cursor *cursor, MDB_val *key, MDB_val *data,
                            MDB_cursor_op op);
+int  mdb_cursor_count(MDB_cursor *cursor, unsigned long *countp);
 
 int  mdb_cmp(MDB_txn *txn, MDB_dbi dbi, const MDB_val *a, const MDB_val *b);