Build options

Macros
#define	MDBX_OSX_WANNA_DURABILITY   0
#define	MDBX_OSX_WANNA_SPEED   1
#define	MDBX_APPLE_SPEED_INSTEADOF_DURABILITY   MDBX_OSX_WANNA_DURABILITY
#define	MDBX_ENV_CHECKPID   1
#define	MDBX_TXN_CHECKOWNER   1
#define	MDBX_TRUST_RTC   1
#define	MDBX_ENABLE_REFUND   1
#define	MDBX_ENABLE_PROFGC   0
#define	MDBX_ENABLE_PGOP_STAT   1
#define	MDBX_USE_MINCORE   1
#define	MDBX_USE_MINCORE_CONFIG   "AUTO=" MDBX_STRINGIFY(MDBX_USE_MINCORE)
#define	MDBX_ENABLE_BIGFOOT   1
#define	MDBX_DISABLE_VALIDATION   0
#define	MDBX_PNL_PREALLOC_FOR_RADIXSORT   1
#define	MDBX_DPL_PREALLOC_FOR_RADIXSORT   1
#define	MDBX_AVOID_MSYNC   0
#define	MDBX_ENABLE_DBI_SPARSE   1
#define	MDBX_ENABLE_DBI_LOCKFREE   1
#define	MDBX_PNL_ASCENDING   0
#define	MDBX_WITHOUT_MSVC_CRT   0
#define	MDBX_ENVCOPY_WRITEBUF   1048576u
#define	MDBX_FORCE_ASSERTIONS   0
#define	MDBX_ASSUME_MALLOC_OVERHEAD   (sizeof(void *) * 2u)
#define	MDBX_HAVE_BUILTIN_CPU_SUPPORTS   0
#define	MDBX_LOCKING_WIN32FILES   -1
#define	MDBX_LOCKING_SYSV   5
#define	MDBX_LOCKING_POSIX1988   1988
#define	MDBX_LOCKING_POSIX2001   2001
#define	MDBX_LOCKING_POSIX2008   2008
#define	MDBX_LOCKING   MDBX_LOCKING_SYSV
#define	MDBX_USE_OFDLOCKS   0
#define	MDBX_USE_SENDFILE   0
#define	MDBX_USE_COPYFILERANGE   0
#define	MDBX_CPU_WRITEBACK_INCOHERENT   0
#define	MDBX_MMAP_INCOHERENT_FILE_WRITE   0
#define	MDBX_MMAP_INCOHERENT_CPU_CACHE   0
#define	MDBX_MMAP_NEEDS_JOLT   1
#define	MDBX_MMAP_NEEDS_JOLT_CONFIG   "AUTO=" MDBX_STRINGIFY(MDBX_MMAP_NEEDS_JOLT)
#define	MDBX_64BIT_ATOMIC   1
#define	MDBX_64BIT_CAS   1
#define	MDBX_UNALIGNED_OK   0 /* no unaligned access allowed */
#define	MDBX_CACHELINE_SIZE   64
#define	MDBX_AUXILARY_IOV_MAX   64
#define	MDBX_BUILD_METADATA   ""
#define	MDBX_DEBUG   0...2

Detailed Description

Copyright

SPDX-License-Identifier: Apache-2.0

Author

Леонид Юрьев aka Leonid Yuriev leo@y.nosp@m.urie.nosp@m.v.ru

Date

2015-2024

The libmdbx build options.

Macro Definition Documentation

MDBX_64BIT_ATOMIC

#define MDBX_64BIT_ATOMIC   1

MDBX_64BIT_CAS

#define MDBX_64BIT_CAS   1

MDBX_APPLE_SPEED_INSTEADOF_DURABILITY

#define MDBX_APPLE_SPEED_INSTEADOF_DURABILITY   MDBX_OSX_WANNA_DURABILITY

Choices MDBX_OSX_WANNA_DURABILITY or MDBX_OSX_WANNA_SPEED for OSX & iOS

MDBX_ASSUME_MALLOC_OVERHEAD

#define MDBX_ASSUME_MALLOC_OVERHEAD   (sizeof(void *) * 2u)

Presumed malloc size overhead for each allocation to adjust allocations to be more aligned.

MDBX_AUXILARY_IOV_MAX

#define MDBX_AUXILARY_IOV_MAX   64

MDBX_AVOID_MSYNC

#define MDBX_AVOID_MSYNC   0

Controls dirty pages tracking, spilling and persisting in MDBX_WRITEMAP mode, i.e. disables in-memory database updating with consequent flush-to-disk/msync syscall.

0/OFF = Don't track dirty pages at all, don't spill ones, and use msync() to persist data. This is by-default on Linux and other systems where kernel provides properly LRU tracking and effective flushing on-demand.

1/ON = Tracking of dirty pages but with LRU labels for spilling and explicit persist ones by write(). This may be reasonable for goofy systems (Windows) which low performance of msync() and/or zany LRU tracking.

MDBX_BUILD_METADATA

#define MDBX_BUILD_METADATA   ""

MDBX_CACHELINE_SIZE

#define MDBX_CACHELINE_SIZE   64

MDBX_CPU_WRITEBACK_INCOHERENT

#define MDBX_CPU_WRITEBACK_INCOHERENT   0

MDBX_DEBUG

#define MDBX_DEBUG   0...2

Controls enabling of debugging features.

• MDBX_DEBUG = 0 (by default) Disables any debugging features at all, including logging and assertion controls. Logging level and corresponding debug flags changing by mdbx_setup_debug() will not have effect.
• MDBX_DEBUG > 0 Enables code for the debugging features (logging, assertions checking and internal audit). Simultaneously sets the default logging level to the MDBX_DEBUG value. Also enables MDBX_DBG_AUDIT if MDBX_DEBUG >= 2.

MDBX_DISABLE_VALIDATION

#define MDBX_DISABLE_VALIDATION   0

Disable some checks to reduce an overhead and detection probability of database corruption to a values closer to the LMDB.

MDBX_DPL_PREALLOC_FOR_RADIXSORT

#define MDBX_DPL_PREALLOC_FOR_RADIXSORT   1

MDBX_ENABLE_BIGFOOT

#define MDBX_ENABLE_BIGFOOT   1

Enables chunking long list of retired pages during huge transactions commit to avoid use sequences of pages.

MDBX_ENABLE_DBI_LOCKFREE

#define MDBX_ENABLE_DBI_LOCKFREE   1

Управляет механизмом отложенного освобождения и поддержки пути быстрого открытия DBI-хендлов без захвата блокировок.

MDBX_ENABLE_DBI_SPARSE

#define MDBX_ENABLE_DBI_SPARSE   1

Управляет механизмом поддержки разреженных наборов DBI-хендлов для снижения накладных расходов при запуске и обработке транзакций.

MDBX_ENABLE_PGOP_STAT

#define MDBX_ENABLE_PGOP_STAT   1

Controls gathering statistics for page operations.

MDBX_ENABLE_PROFGC

#define MDBX_ENABLE_PROFGC   0

Controls profiling of GC search and updates.

MDBX_ENABLE_REFUND

#define MDBX_ENABLE_REFUND   1

Controls online database auto-compactification during write-transactions.

MDBX_ENV_CHECKPID

#define MDBX_ENV_CHECKPID   1

Controls checking PID against reuse DB environment after the fork()

MDBX_ENVCOPY_WRITEBUF

#define MDBX_ENVCOPY_WRITEBUF   1048576u

Size of buffer used during copying a environment/database file.

MDBX_FORCE_ASSERTIONS

#define MDBX_FORCE_ASSERTIONS   0

Forces assertion checking.

MDBX_HAVE_BUILTIN_CPU_SUPPORTS

#define MDBX_HAVE_BUILTIN_CPU_SUPPORTS   0

If defined then enables integration with Valgrind, a memory analyzing tool. If defined then enables use C11 atomics, otherwise detects ones availability automatically. If defined then enables use the GCC's __builtin_cpu_supports() for runtime dispatching depending on the CPU's capabilities.

Note

Defining MDBX_HAVE_BUILTIN_CPU_SUPPORTS to 0 should avoided unless build for particular single-target platform, since on AMD64/x86 this disables dynamic choice (at runtime) of SSE2 / AVX2 / AVX512 instructions with fallback to non-accelerated baseline code.

MDBX_LOCKING

#define MDBX_LOCKING   MDBX_LOCKING_SYSV

Advanced: Choices the locking implementation (autodetection by default).

MDBX_LOCKING_POSIX1988

#define MDBX_LOCKING_POSIX1988   1988

POSIX-1 Shared anonymous semaphores for MDBX_LOCKING

MDBX_LOCKING_POSIX2001

#define MDBX_LOCKING_POSIX2001   2001

POSIX-2001 Shared Mutexes for MDBX_LOCKING

MDBX_LOCKING_POSIX2008

#define MDBX_LOCKING_POSIX2008   2008

POSIX-2008 Robust Mutexes for MDBX_LOCKING

MDBX_LOCKING_SYSV

#define MDBX_LOCKING_SYSV   5

SystemV IPC semaphores for MDBX_LOCKING

MDBX_LOCKING_WIN32FILES

#define MDBX_LOCKING_WIN32FILES   -1

Win32 File Locking API for MDBX_LOCKING

MDBX_MMAP_INCOHERENT_CPU_CACHE

#define MDBX_MMAP_INCOHERENT_CPU_CACHE   0

MDBX_MMAP_INCOHERENT_FILE_WRITE

#define MDBX_MMAP_INCOHERENT_FILE_WRITE   0

MDBX_MMAP_NEEDS_JOLT

#define MDBX_MMAP_NEEDS_JOLT   1

Assume system needs explicit syscall to sync/flush/write modified mapped memory.

MDBX_MMAP_NEEDS_JOLT_CONFIG

#define MDBX_MMAP_NEEDS_JOLT_CONFIG   "AUTO=" MDBX_STRINGIFY(MDBX_MMAP_NEEDS_JOLT)

MDBX_OSX_WANNA_DURABILITY

#define MDBX_OSX_WANNA_DURABILITY   0

Using fcntl(F_FULLFSYNC) with 5-10 times slowdown

MDBX_OSX_WANNA_SPEED

#define MDBX_OSX_WANNA_SPEED   1

Using fsync() with chance of data lost on power failure

MDBX_PNL_ASCENDING

#define MDBX_PNL_ASCENDING   0

Controls sort order of internal page number lists. This mostly experimental/advanced option with not for regular MDBX users.

Warning

The database format depend on this option and libmdbx built with different option value are incompatible.

MDBX_PNL_PREALLOC_FOR_RADIXSORT

#define MDBX_PNL_PREALLOC_FOR_RADIXSORT   1

MDBX_TRUST_RTC

#define MDBX_TRUST_RTC   1

Does a system have battery-backed Real-Time Clock or just a fake.

MDBX_TXN_CHECKOWNER

#define MDBX_TXN_CHECKOWNER   1

Controls checking transaction owner thread against misuse transactions from other threads.

MDBX_UNALIGNED_OK

#define MDBX_UNALIGNED_OK   0 /* no unaligned access allowed */

MDBX_USE_COPYFILERANGE

#define MDBX_USE_COPYFILERANGE   0

Advanced: Using copy_file_range() syscall (autodetection by default).

MDBX_USE_MINCORE

#define MDBX_USE_MINCORE   1

Controls using Unix' mincore() to determine whether DB-pages are resident in memory.

MDBX_USE_MINCORE_CONFIG

#define MDBX_USE_MINCORE_CONFIG   "AUTO=" MDBX_STRINGIFY(MDBX_USE_MINCORE)

MDBX_USE_OFDLOCKS

#define MDBX_USE_OFDLOCKS   0

Advanced: Using POSIX OFD-locks (autodetection by default).

MDBX_USE_SENDFILE

#define MDBX_USE_SENDFILE   0

Advanced: Using sendfile() syscall (autodetection by default).

MDBX_WITHOUT_MSVC_CRT

#define MDBX_WITHOUT_MSVC_CRT   0

Avoid dependence from MSVC CRT and use ntdll.dll instead.