162 #include <sys/types.h> 193 #define MDB_VERSION_MAJOR 0 195 #define MDB_VERSION_MINOR 9 197 #define MDB_VERSION_PATCH 18 200 #define MDB_VERINT(a,b,c) (((a) << 24) | ((b) << 16) | (c)) 203 #define MDB_VERSION_FULL \ 204 MDB_VERINT(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH) 207 #define MDB_VERSION_DATE "February 5, 2016" 210 #define MDB_VERSTR(a,b,c,d) "LMDB " #a "." #b "." #c ": (" d ")" 213 #define MDB_VERFOO(a,b,c,d) MDB_VERSTR(a,b,c,d) 216 #define MDB_VERSION_STRING \ 217 MDB_VERFOO(MDB_VERSION_MAJOR,MDB_VERSION_MINOR,MDB_VERSION_PATCH,MDB_VERSION_DATE) 279 #define MDB_FIXEDMAP 0x01 281 #define MDB_NOSUBDIR 0x4000 283 #define MDB_NOSYNC 0x10000 285 #define MDB_RDONLY 0x20000 287 #define MDB_NOMETASYNC 0x40000 289 #define MDB_WRITEMAP 0x80000 291 #define MDB_MAPASYNC 0x100000 293 #define MDB_NOTLS 0x200000 295 #define MDB_NOLOCK 0x400000 297 #define MDB_NORDAHEAD 0x800000 299 #define MDB_NOMEMINIT 0x1000000 306 #define MDB_REVERSEKEY 0x02 308 #define MDB_DUPSORT 0x04 311 #define MDB_INTEGERKEY 0x08 313 #define MDB_DUPFIXED 0x10 315 #define MDB_INTEGERDUP 0x20 317 #define MDB_REVERSEDUP 0x40 319 #define MDB_CREATE 0x40000 326 #define MDB_NOOVERWRITE 0x10 331 #define MDB_NODUPDATA 0x20 333 #define MDB_CURRENT 0x40 337 #define MDB_RESERVE 0x10000 339 #define MDB_APPEND 0x20000 341 #define MDB_APPENDDUP 0x40000 343 #define MDB_MULTIPLE 0x80000 352 #define MDB_CP_COMPACT 0x01 395 #define MDB_SUCCESS 0 397 #define MDB_KEYEXIST (-30799) 399 #define MDB_NOTFOUND (-30798) 401 #define MDB_PAGE_NOTFOUND (-30797) 403 #define MDB_CORRUPTED (-30796) 405 #define MDB_PANIC (-30795) 407 #define MDB_VERSION_MISMATCH (-30794) 409 #define MDB_INVALID (-30793) 411 #define MDB_MAP_FULL (-30792) 413 #define MDB_DBS_FULL (-30791) 415 #define MDB_READERS_FULL (-30790) 417 #define MDB_TLS_FULL (-30789) 419 #define MDB_TXN_FULL (-30788) 421 #define MDB_CURSOR_FULL (-30787) 423 #define MDB_PAGE_FULL (-30786) 425 #define MDB_MAP_RESIZED (-30785) 434 #define MDB_INCOMPATIBLE (-30784) 436 #define MDB_BAD_RSLOT (-30783) 438 #define MDB_BAD_TXN (-30782) 440 #define MDB_BAD_VALSIZE (-30781) 442 #define MDB_BAD_DBI (-30780) 444 #define MDB_LAST_ERRCODE MDB_BAD_DBI 475 char *
mdb_version(
int *major,
int *minor,
int *patch);
1043 #define mdb_open(txn,name,flags,dbi) mdb_dbi_open(txn,name,flags,dbi) 1045 #define mdb_close(env,dbi) mdb_dbi_close(env,dbi) 1324 unsigned int flags);
1494 unsigned int flags);
Statistics for a database in the environment.
Definition: lmdb.h:448
int mdb_set_relfunc(MDB_txn *txn, MDB_dbi dbi, MDB_rel_func *rel)
Set a relocation function for a MDB_FIXEDMAP database.
Definition: mdb.c:9802
size_t me_mapsize
Definition: lmdb.h:461
void mdb_cursor_close(MDB_cursor *cursor)
Close a cursor handle.
Definition: mdb.c:7472
int mdb_env_set_assert(MDB_env *env, MDB_assert_func *func)
Definition: mdb.c:9381
int mdb_del(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data)
Delete items from a database.
Definition: mdb.c:8263
int mdb_env_set_mapsize(MDB_env *env, size_t size)
Set the size of the memory map to use for this environment.
Definition: mdb.c:3963
int mdb_dbi_open(MDB_txn *txn, const char *name, unsigned int flags, MDB_dbi *dbi)
Open a database in the environment.
Definition: mdb.c:9485
char * mdb_version(int *major, int *minor, int *patch)
Return the LMDB library version information.
Definition: mdb.c:1380
int( MDB_cmp_func)(const MDB_val *a, const MDB_val *b)
A callback function used to compare two keys in a database.
Definition: lmdb.h:257
size_t ms_entries
Definition: lmdb.h:455
int mdb_cursor_count(MDB_cursor *cursor, size_t *countp)
Return count of duplicates for current key.
Definition: mdb.c:7440
int mdb_txn_commit(MDB_txn *txn)
Commit all the operations of a transaction into the database.
Definition: mdb.c:3354
int mdb_cursor_put(MDB_cursor *cursor, MDB_val *key, MDB_val *data, unsigned int flags)
Store by cursor.
Definition: mdb.c:6290
int mdb_stat(MDB_txn *txn, MDB_dbi dbi, MDB_stat *stat)
Retrieve statistics for a database.
Definition: mdb.c:9601
void mdb_dbi_close(MDB_env *env, MDB_dbi dbi)
Close a database handle. Normally unnecessary. Use with care:
Definition: mdb.c:9618
size_t ms_overflow_pages
Definition: lmdb.h:454
void * mdb_env_get_userctx(MDB_env *env)
Get the application information associated with the MDB_env.
Definition: mdb.c:9375
int mdb_env_get_maxreaders(MDB_env *env, unsigned int *readers)
Get the maximum number of threads/reader slots for the environment.
Definition: mdb.c:4015
size_t mv_size
Definition: lmdb.h:252
MDB_txn * mdb_cursor_txn(MDB_cursor *cursor)
Return the cursor's transaction handle.
Definition: mdb.c:7487
int mdb_set_dupsort(MDB_txn *txn, MDB_dbi dbi, MDB_cmp_func *cmp)
Set a custom data comparison function for a MDB_DUPSORT database.
Definition: mdb.c:9793
unsigned int ms_psize
Definition: lmdb.h:449
Opaque structure for a transaction handle.
Definition: mdb.c:1037
int mdb_env_info(MDB_env *env, MDB_envinfo *stat)
Return information about the LMDB environment.
Definition: mdb.c:9444
Opaque structure for navigating through a database.
Definition: mdb.c:1136
int mdb_env_set_maxdbs(MDB_env *env, MDB_dbi dbs)
Set the maximum number of named databases for the environment.
Definition: mdb.c:3997
int mdb_env_get_maxkeysize(MDB_env *env)
Get the maximum size of keys and MDB_DUPSORT data we can write.
Definition: mdb.c:9821
MDB_env * mdb_txn_env(MDB_txn *txn)
Returns the transaction's MDB_env.
Definition: mdb.c:2867
Information about the environment.
Definition: lmdb.h:459
void * mv_data
Definition: lmdb.h:253
void MDB_assert_func(MDB_env *env, const char *msg)
A callback function for most LMDB assert() failures, called before printing the message and aborting...
Definition: lmdb.h:915
void * me_mapaddr
Definition: lmdb.h:460
int mdb_cmp(MDB_txn *txn, MDB_dbi dbi, const MDB_val *a, const MDB_val *b)
Compare two data items according to a particular database.
Definition: mdb.c:1685
MDB_dbi mdb_cursor_dbi(MDB_cursor *cursor)
Return the cursor's database handle.
Definition: mdb.c:7494
int mdb_reader_list(MDB_env *env, MDB_msg_func *func, void *ctx)
Dump the entries in the reader lock table.
Definition: mdb.c:9827
size_t ms_branch_pages
Definition: lmdb.h:452
int mdb_env_copyfd(MDB_env *env, mdb_filehandle_t fd)
Copy an LMDB environment to the specified file descriptor.
int mdb_env_get_path(MDB_env *env, const char **path)
Return the path that was used in mdb_env_open().
Definition: mdb.c:9392
int mdb_env_get_flags(MDB_env *env, unsigned int *flags)
Get environment flags.
Definition: mdb.c:9356
int mdb_drop(MDB_txn *txn, MDB_dbi dbi, int del)
Empty or delete+close a database.
Definition: mdb.c:9733
int mdb_env_copyfd2(MDB_env *env, mdb_filehandle_t fd, unsigned int flags)
Copy an LMDB environment to the specified file descriptor, with options.
unsigned int me_maxreaders
Definition: lmdb.h:464
size_t ms_leaf_pages
Definition: lmdb.h:453
int mdb_env_open(MDB_env *env, const char *path, unsigned int flags, mdb_mode_t mode)
Open an environment handle.
Definition: mdb.c:4693
int mdb_env_copy(MDB_env *env, const char *path)
Copy an LMDB environment to the specified path.
Definition: mdb.c:9338
void( MDB_rel_func)(MDB_val *item, void *oldptr, void *newptr, void *relctx)
A callback function used to relocate a position-dependent data item in a fixed-address database...
Definition: lmdb.h:273
void mdb_txn_reset(MDB_txn *txn)
Reset a read-only transaction.
Definition: mdb.c:2985
int mdb_dbi_flags(MDB_txn *txn, MDB_dbi dbi, unsigned int *flags)
Retrieve the DB flags for a database handle.
Definition: mdb.c:9634
int mdb_set_relctx(MDB_txn *txn, MDB_dbi dbi, void *ctx)
Set a context pointer for a MDB_FIXEDMAP database's relocation function.
Definition: mdb.c:9811
size_t me_last_pgno
Definition: lmdb.h:462
int mdb_txn_renew(MDB_txn *txn)
Renew a read-only transaction.
Definition: mdb.c:2749
int mdb_reader_check(MDB_env *env, int *dead)
Check for stale entries in the reader lock table.
Definition: mdb.c:9905
int mdb_dcmp(MDB_txn *txn, MDB_dbi dbi, const MDB_val *a, const MDB_val *b)
Compare two data items according to a particular database.
Definition: mdb.c:1691
int mdb_cursor_renew(MDB_txn *txn, MDB_cursor *cursor)
Renew a cursor handle.
Definition: mdb.c:7423
int mdb_set_compare(MDB_txn *txn, MDB_dbi dbi, MDB_cmp_func *cmp)
Set a custom key comparison function for a database.
Definition: mdb.c:9784
Generic structure used for passing keys and data in and out of the database.
Definition: lmdb.h:251
unsigned int MDB_dbi
A handle for an individual database in the DB environment.
Definition: lmdb.h:235
int mdb_env_sync(MDB_env *env, int force)
Flush the data buffers to disk.
Definition: mdb.c:2450
size_t me_last_txnid
Definition: lmdb.h:463
int mdb_filehandle_t
Definition: lmdb.h:182
int mdb_env_get_fd(MDB_env *env, mdb_filehandle_t *fd)
Return the filedescriptor for the given environment.
Definition: mdb.c:9402
size_t mdb_txn_id(MDB_txn *txn)
Return the transaction's ID.
Definition: mdb.c:2874
int mdb_txn_begin(MDB_env *env, MDB_txn *parent, unsigned int flags, MDB_txn **txn)
Create a transaction for use with the environment.
Definition: mdb.c:2766
MDB_cursor_op
Cursor Get operations.
Definition: lmdb.h:360
int mdb_cursor_get(MDB_cursor *cursor, MDB_val *key, MDB_val *data, MDB_cursor_op op)
Retrieve by cursor.
Definition: mdb.c:6086
int mdb_env_create(MDB_env **env)
Create an LMDB environment handle.
Definition: mdb.c:3854
unsigned int me_numreaders
Definition: lmdb.h:465
void mdb_txn_abort(MDB_txn *txn)
Abandon all the operations of the transaction instead of saving them.
Definition: mdb.c:2998
mode_t mdb_mode_t
Definition: lmdb.h:172
Opaque structure for a database environment.
Definition: mdb.c:1194
int mdb_env_stat(MDB_env *env, MDB_stat *stat)
Return statistics about the LMDB environment.
Definition: mdb.c:9431
char * mdb_strerror(int err)
Return a string describing a given error code.
Definition: mdb.c:1413
int mdb_env_set_maxreaders(MDB_env *env, unsigned int readers)
Set the maximum number of threads/reader slots for the environment.
Definition: mdb.c:4006
int mdb_env_set_flags(MDB_env *env, unsigned int flags, int onoff)
Set environment flags.
Definition: mdb.c:9344
int mdb_env_set_userctx(MDB_env *env, void *ctx)
Set application information associated with the MDB_env.
Definition: mdb.c:9366
int mdb_cursor_del(MDB_cursor *cursor, unsigned int flags)
Delete current key/data pair.
Definition: mdb.c:6820
int mdb_env_copy2(MDB_env *env, const char *path, unsigned int flags)
Copy an LMDB environment to the specified path, with options.
Definition: mdb.c:9271
int mdb_get(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data)
Get items from a database.
Definition: mdb.c:5558
unsigned int ms_depth
Definition: lmdb.h:451
int( MDB_msg_func)(const char *msg, void *ctx)
A callback function used to print a message from the library.
Definition: lmdb.h:1559
int mdb_put(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data, unsigned int flags)
Store items into a database.
Definition: mdb.c:8752
void mdb_env_close(MDB_env *env)
Close the environment and release the memory map.
Definition: mdb.c:4946
int mdb_cursor_open(MDB_txn *txn, MDB_dbi dbi, MDB_cursor **cursor)
Create a cursor handle.
Definition: mdb.c:7389